Beranda>Kode sumber PHP>Kategori lainnya
Unduh

Gambar Sederhana

Kelas PHP yang membuat bekerja dengan gambar menjadi sesederhana mungkin.

Dikembangkan dan dikelola oleh Cory LaViska.

Jika proyek ini membuat Anda menyukai manipulasi gambar PHP lagi, mohon pertimbangkan untuk mensponsori saya untuk mendukung pengembangannya.

Ringkasan 

 <?php
try {
  // Create a new SimpleImage object
  $ image = new  claviska  SimpleImage ();

  // Magic ! 
  $ image
    -> fromFile ( ' image.jpg ' )                     // load image . jpg
    -> autoOrient ()                              // adjust orientation based on exif data
    -> resize ( 320 , 200 )                          // resize to 320 x200 pixels
    -> flip ( ' x ' )                                 // flip horizontally
    -> colorize ( ' DarkBlue ' )                      // tint dark blue
    -> border ( ' black ' , 10 )                       // add a 10 pixel black border
    -> overlay ( ' watermark.png ' , ' bottom right ' )  // add a watermark image
    -> toFile ( ' new-image.png ' , ' image/png ' )      // convert to PNG and save a copy to new-image . png
    -> toScreen ();                               // output to the screen

  // And much more ! 
} catch ( Exception $ err ) {
  // Handle errors
  echo $ err -> getMessage ();
}

Persyaratan

  • PHP 8.0+
  • ekstensi GD

Fitur

  • Mendukung membaca, menulis, dan mengonversi format GIF, JPEG, PNG, WEBP, BMP, AVIF.
  • Membaca dan menulis file, URI data, dan string gambar.
  • Manipulasi: memotong, mengubah ukuran, overlay/tanda air, menambahkan teks TTF
  • Gambar: busur, batas, titik, elips, garis, poligon, persegi panjang, persegi panjang bulat
  • Filter: mengaburkan, mencerahkan, mewarnai, kontras, menggelapkan, desaturasi, deteksi tepi, emboss, invert, opacity, pixelate, sepia, pertajam, sketsa
  • Utilitas: penyesuaian warna, menggelapkan/mencerahkan warna, mengekstrak warna
  • Properti: data Exif, tinggi/lebar, tipe pantomim, orientasi
  • Argumen warna dapat diteruskan dalam warna CSS apa pun (misalnya LightBlue ), warna hex, atau array RGB(A).
  • Dukungan untuk transparansi alfa (GIF, PNG, WEBP, AVIF)
  • Metode yang dapat dirantai
  • Menggunakan pengecualian
  • Muat dengan Komposer atau secara manual (hanya satu file)
  • Versi Semantik

Instalasi

Instal dengan Komposer: 

 composer require claviska/simpleimage

Atau sertakan perpustakaan secara manual: 

 <?php
require ' src/claviska/SimpleImage.php ' ;

Tentang

SimpleImage dikembangkan dan dikelola oleh Cory LaViska. Hak Cipta Situs Yang Indah, LLC.

Jika Anda senang menggunakan SimpleImage, terutama dalam aplikasi komersial, mohon pertimbangkan untuk mensponsori saya untuk mendukung pengembangannya.

Terima kasih!

Lisensi

Berlisensi di bawah lisensi MIT.

API

Urutan kehebatan:

  1. Muat gambar
  2. Memanipulasi gambar
  3. Simpan/keluarkan gambar

Kiat API:

  • Tanda bintang menunjukkan argumen yang diperlukan.
  • Metode yang mengembalikan objek SimpleImage dapat dirantai.
  • Anda dapat meneruskan URI file atau data ke konstruktor untuk menghindari pemanggilan fromFile atau fromDataUri .
  • Metode statis dapat dipanggil dengan $image::methodName() atau claviskaSimpleImage::methodName() .
  • Warna dapat berupa warna CSS (misalnya white ), string hex (misalnya '#ffffff'), atau array RGBA.
  • Anda dapat menyalurkan transparansi ke normalizeColor ketika Anda meneruskan warna CSS atau string hex: white|0.25

Loader

fromDataUri($uri)

Memuat gambar dari URI data.

  • $uri * (string) - URI data.

Mengembalikan objek SimpleImage.

fromFile($file)

Memuat gambar dari file.

  • $file * (string) - File gambar yang akan dimuat.

Mengembalikan objek SimpleImage.

fromNew($width, $height, $color)

Menciptakan gambar baru.

  • $width * (int) - Lebar gambar.
  • $height * (int) - Ketinggian gambar.
  • $color (string|array) - Warna isian opsional untuk gambar baru (default 'transparan').

Mengembalikan objek SimpleImage.

fromString($string)

Membuat gambar baru dari string.

  • $string * (string) - Data gambar mentah sebagai string. Contoh: 
     $string = file_get_contents('image.jpg');

Mengembalikan objek SimpleImage.

Penabung

toDataUri($mimeType, $options)

Menghasilkan URI data.

  • $mimeType (string) - Format gambar yang akan dihasilkan sebagai tipe mime (default pada tipe mime asli).
  • $options (array|int) - Array opsi atau kualitas gambar sebagai persentase (default 100).

Mengembalikan string yang berisi URI data.

toDownload($filename, $mimeType, $options)

Memaksa gambar untuk diunduh ke mesin klien. Harus dipanggil sebelum output apa pun dikirim ke layar.

  • $filename * (string) - Nama file (tanpa jalur) yang akan dikirim ke klien (misalnya 'image.jpeg').
  • $mimeType (string) - Format gambar yang akan dihasilkan sebagai tipe mime (default pada tipe mime asli).
  • $options (array|int) - Array opsi atau kualitas gambar sebagai persentase (default 100).

Mengembalikan objek SimpleImage.

toFile($file, $mimeType, $options)

Menulis gambar ke file.

  • $mimeType (string) - Format gambar yang akan dihasilkan sebagai tipe mime (default pada tipe mime asli).
  • $options (array|int) - Array opsi atau kualitas gambar sebagai persentase (default 100).

Mengembalikan objek SimpleImage.

toScreen($mimeType, $options)

Menampilkan gambar ke layar. Harus dipanggil sebelum output apa pun dikirim ke layar.

  • $mimeType (string) - Format gambar yang akan dihasilkan sebagai tipe mime (default pada tipe mime asli).
  • $options (array|int) - Array opsi atau kualitas gambar sebagai persentase (default 100).

Mengembalikan objek SimpleImage.

toString($mimeType, $options)

Menghasilkan string gambar.

  • $mimeType (string) - Format gambar yang akan dihasilkan sebagai tipe mime (default pada tipe mime asli).
  • $options (array|int) - Array opsi atau kualitas gambar sebagai persentase (default 100).

Mengembalikan objek SimpleImage.

generate($mimeType, $options)

Menghasilkan gambar.

  • $mimeType (string) - Format gambar yang akan dihasilkan sebagai tipe mime (default pada tipe mime asli).
  • $options (array|int) - Array opsi atau kualitas gambar sebagai persentase (default 100).

Mengembalikan array: [mimeType, data]

Rangkaian pilihan

Daripada memberikan kualitas sebagai bilangan bulat sebagai parameter fungsi terakhir, Anda juga dapat mengatur berbagai opsi bergantung pada tipe Mime yang ditargetkan menggunakan array asosiatif. 

 $ image -> toFile ( $ file , ' image/avif ' , [
    // JPG , WEBP , AVIF ( default 100 )
    ' quality ' => 100 ,

    // AVIF ( default - 1 which is 6 )
    // range of slow and small file 0 to 10 fast but big file
    ' speed ' => - 1 ,
]);
 $ image -> toFile ( $ file , ' image/bmp ' , [
    // BMP : boolean ( default true )
    ' compression ' => true ,

    // BMP , JPG ( default null , keep the same )
    ' interlace ' => null ,
]);
 $ image -> toFile ( $ file , ' image/gif ' , [
    // GIF , PNG ( default true )
    ' alpha ' => true ,
]);
 $ image -> toFile ( $ file , ' image/jpeg ' , [
    // BMP , JPG ( default null , keep the same )
    ' interlace ' => null ,

    // JPG , WEBP , AVIF ( default 100 )
    ' quality ' => 100 ,
]);
 $ image -> toFile ( $ file , ' image/png ' , [
    // GIF , PNG ( default true )
    ' alpha ' => true ,

    // PNG : 0 - 10 , defaults to zlib ( default 6 )
    ' compression ' => - 1 ,

    // PNG ( default - 1 )
    ' filters ' => - 1 ,

    // has no effect on PNG images , since the format is lossless
    // ' quality' = > 100 ,
]);
 $ image -> toFile ( $ file , ' image/webp ' , [
    // JPG , WEBP , AVIF ( default 100 )
    ' quality ' => 100 ,
]);

Utilitas

getAspectRatio()

Mendapatkan rasio aspek gambar saat ini.

Mengembalikan rasio aspek sebagai float.

getExif()

Mendapatkan data exic gambar.

Mengembalikan array data Exif atau null jika tidak ada data yang tersedia.

getHeight()

Mendapatkan tinggi gambar saat ini.

Mengembalikan tinggi sebagai bilangan bulat.

getMimeType()

Mendapatkan tipe pantomim dari gambar yang dimuat.

Mengembalikan string tipe mime.

getOrientation()

Mendapatkan orientasi gambar saat ini.

Mengembalikan string: 'lanskap', 'potret', atau 'persegi'

getResolution()

Mendapatkan resolusi gambar saat ini dalam DPI.

Mengembalikan array bilangan bulat: [0 => 96, 1 ​​=> 96]

getWidth()

Mendapatkan lebar gambar saat ini.

Mengembalikan lebar sebagai bilangan bulat.

hasImage()

Memeriksa apakah objek SimpleImage telah memuat gambar.

Mengembalikan boolean.

reset()

Menghancurkan sumber daya gambar.

Mengembalikan objek SimpleImage.

Manipulasi

autoOrient()

Memutar gambar sehingga orientasinya benar berdasarkan data aktrisnya. Metode ini aman untuk dipanggil pada gambar yang tidak memiliki data exif (tidak ada perubahan yang dilakukan). Mengembalikan objek SimpleImage.

bestFit($maxWidth, $maxHeight)

Ubah ukuran gambar secara proporsional agar sesuai dengan lebar dan tinggi tertentu.

  • $maxWidth * (int) - Lebar maksimum gambar.
  • $maxHeight * (int) - Ketinggian maksimum gambar.

Mengembalikan objek SimpleImage.

crop($x1, $y1, $x2, $y2)

Pangkas gambarnya.

  • $x1 - Koordinat x kiri atas.
  • $y1 - Koordinat y kiri atas.
  • $x2 - Koordinat x kanan bawah.
  • $y2 - Koordinat x kanan bawah.

Mengembalikan objek SimpleImage.

fitToHeight($height) (TIDAK DIGUNAKAN LAGI)

Ubah ukuran gambar secara proporsional ke ketinggian tertentu.

Metode ini tidak digunakan lagi di versi 3.2.2 dan akan dihapus di versi 4.0. Silakan gunakan resize(null, $height) sebagai gantinya.

  • $height * (int) - Ketinggian untuk mengubah ukuran gambar.

Mengembalikan objek SimpleImage.

fitToWidth($width) (TIDAK DIGUNAKAN LAGI)

Ubah ukuran gambar secara proporsional ke lebar tertentu.

Metode ini tidak digunakan lagi di versi 3.2.2 dan akan dihapus di versi 4.0. Silakan gunakan resize($width, null) sebagai gantinya.

  • $width * (int) - Lebar untuk mengubah ukuran gambar.

Mengembalikan objek SimpleImage.

flip($direction)

Balikkan gambar secara horizontal atau vertikal.

  • $direction * (string) - Arah membalik: x|y|keduanya

Mengembalikan objek SimpleImage.

maxColors($max, $dither)

Mengurangi gambar ke jumlah warna maksimum.

  • $max * (int) - Jumlah maksimum warna yang akan digunakan.
  • $dither (bool) - Apakah akan menggunakan efek dithering atau tidak (defaultnya benar).

Mengembalikan objek SimpleImage.

overlay($overlay, $anchor, $opacity, $xOffset, $yOffset)

Tempatkan gambar di atas gambar saat ini.

  • $overlay * (string|SimpleImage) - Gambar yang akan di overlay. Ini bisa berupa nama file, URI data, atau objek SimpleImage.
  • $anchor (string) - Titik jangkar: 'tengah', 'atas', 'bawah', 'kiri', 'kanan', 'kiri atas', 'kanan atas', 'kiri bawah', 'kanan bawah' ( default 'pusat')
  • $opacity (float) - Tingkat opacity overlay 0-1 (default 1).
  • $xOffset (int) - Offset horizontal dalam piksel (default 0).
  • $yOffset (int) - Offset vertikal dalam piksel (default 0).
  • $calculateOffsetFromEdge (bool) - Hitung Offset mengacu pada tepi gambar. $xOffset dan $yOffset tidak berpengaruh pada jangkar tengah. (defaultnya salah).

Mengembalikan objek SimpleImage.

resize($width, $height)

Ubah ukuran gambar ke dimensi yang ditentukan. Jika hanya satu dimensi yang ditentukan, ukuran gambar akan diubah secara proporsional.

  • $width * (int) - Lebar gambar baru.
  • $height * (int) - Tinggi gambar baru.

Mengembalikan objek SimpleImage.

resolution($res_x, $res_y)

Mengubah resolusi (DPI) suatu gambar.

  • $res_x * (int) - Resolusi horizontal, dalam DPI.
  • $res_y (int) - Resolusi vertikal, dalam DPI.

Mengembalikan objek SimpleImage.

rotate($angle, $backgroundColor)

Memutar gambar.

  • $angle * (int) - Sudut rotasi (-360 - 360).
  • $backgroundColor (string|array) - Warna latar belakang yang digunakan untuk area zona yang tidak tertutup setelah rotasi (default 'transparan').

Mengembalikan objek SimpleImage.

text($text, $options, &$boundary)

Menambahkan teks ke gambar.

  • $text* (string) - Teks yang diinginkan.
  • $options (array) - Berbagai pilihan.
    • fontFile * (string) - File font TrueType (atau kompatibel) yang akan digunakan.
    • size (int) - Ukuran font dalam piksel (default 12).
    • color (string|array) - Warna teks (default hitam).
    • anchor (string) - Titik jangkar: 'tengah', 'atas', 'bawah', 'kiri', 'kanan', 'kiri atas', 'kanan atas', 'kiri bawah', 'kanan bawah' (default 'tengah').
    • xOffset (int) - Offset horizontal dalam piksel (default 0).
    • yOffset (int) - Offset vertikal dalam piksel (default 0).
    • shadow (array) - Parameter bayangan teks.
      • x * (int) - Offset horizontal dalam piksel.
      • y * (int) - Offset vertikal dalam piksel.
      • color * (string|array) - Warna bayangan teks.
    • calculateOffsetFromEdge (bool) - Hitung Offset mengacu pada tepi gambar (default salah).
    • baselineAlign (bool) - Sejajarkan font teks dengan garis dasar. (standarnya benar).
  • $boundary (array) - Jika diteruskan, variabel ini akan berisi array dengan koordinat yang mengelilingi teks: [x1, y1, x2, y2, width, height]. Ini dapat digunakan untuk menghitung posisi teks setelah ditambahkan ke gambar.

Mengembalikan objek SimpleImage.

thumbnail($width, $height, $anchor)

Membuat gambar mini. Fungsi ini mencoba untuk mendapatkan gambar sedekat mungkin dengan dimensi yang disediakan, lalu memotong sisa luapan untuk memaksakan ukuran yang diinginkan. Berguna untuk menghasilkan gambar mini.

  • $width * (int) - Lebar thumbnail.
  • $height * (int) - Tinggi thumbnail.
  • $anchor (string) - Titik jangkar: 'tengah', 'atas', 'bawah', 'kiri', 'kanan', 'kiri atas', 'kanan atas', 'kiri bawah', 'kanan bawah' ( default 'pusat').

Mengembalikan objek SimpleImage.

Menggambar

arc($x, $y, $width, $height, $start, $end, $color, $thickness)

Menggambar busur.

  • $x * (int) - Koordinat x dari pusat busur.
  • $y * (int) - Koordinat y dari pusat busur.
  • $width * (int) - Lebar busur.
  • $height * (int) - Ketinggian busur.
  • $start * (int) - Awal busur dalam derajat.
  • $end * (int) - Ujung busur dalam derajat.
  • $color * (string|array) - Warna busur.
  • $thickness (int|string) - Ketebalan garis dalam piksel atau 'terisi' (default 1).

Mengembalikan objek SimpleImage.

border($color, $thickness)

Menggambar batas di sekeliling gambar.

  • $color * (string|array) - Warna batas.
  • $thickness (int) - Ketebalan perbatasan (default 1).

Mengembalikan objek SimpleImage.

dot($x, $y, $color)

Menggambar satu titik piksel.

  • $x * (int) - Koordinat x dari titik.
  • $y * (int) - Koordinat y dari titik.
  • $color * (string|array) - Warna titik.

Mengembalikan objek SimpleImage.

ellipse($x, $y, $width, $height, $color, $thickness)

Menggambar elips.

  • $x * (int) - Koordinat x dari pusat.
  • $y * (int) - Koordinat y dari pusat.
  • $width * (int) - Lebar elips.
  • $height * (int) - Ketinggian elips.
  • $color * (string|array) - Warna elips.
  • $thickness (int|string) - Ketebalan garis dalam piksel atau 'terisi' (default 1).

Mengembalikan objek SimpleImage.

fill($color)

Mengisi gambar dengan warna solid.

  • $color (string|array) - Warna isian.

Mengembalikan objek SimpleImage.

line($x1, $y1, $x2, $y2, $color, $thickness)

Menarik garis.

  • $x1 * (int) - Koordinat x untuk titik pertama.
  • $y1 * (int) - Koordinat y untuk titik pertama.
  • $x2 * (int) - Koordinat x untuk titik kedua.
  • $y2 * (int) - Koordinat y untuk titik kedua.
  • $color (string|array) - Warna garis.
  • $thickness (int) - Ketebalan garis (default 1).

Mengembalikan objek SimpleImage.

polygon($vertices, $color, $thickness)

Menggambar poligon.

  • $vertices * (array) - Simpul poligon dalam array array x/y. Contoh: 
     [
  ['x' => x1, 'y' => y1],
  ['x' => x2, 'y' => y2],
  ['x' => xN, 'y' => yN]
]
  • $color * (string|array) - Warna poligon.
  • $thickness (int|string) - Ketebalan garis dalam piksel atau 'terisi' (default 1).

Mengembalikan objek SimpleImage.

rectangle($x1, $y1, $x2, $y2, $color, $thickness)

Menggambar persegi panjang.

  • $x1 * (int) - Koordinat x kiri atas.
  • $y1 * (int) - Koordinat y kiri atas.
  • $x2 * (int) - Koordinat x kanan bawah.
  • $y2 * (int) - Koordinat y kanan bawah.
  • $color * (string|array) - Warna persegi panjang.
  • $thickness (int|string) - Ketebalan garis dalam piksel atau 'terisi' (default 1).

Mengembalikan objek SimpleImage.

roundedRectangle($x1, $y1, $x2, $y2, $radius, $color, $thickness)

Menggambar persegi panjang bulat.

  • $x1 * (int) - Koordinat x kiri atas.
  • $y1 * (int) - Koordinat y kiri atas.
  • $x2 * (int) - Koordinat x kanan bawah.
  • $y2 * (int) - Koordinat y kanan bawah.
  • $radius * (int) - Radius batas dalam piksel.
  • $color * (string|array) - Warna persegi panjang.
  • $thickness (int|string) - Ketebalan garis dalam piksel atau 'terisi' (default 1).

Mengembalikan objek SimpleImage.

Filter

blur($type, $passes)

Menerapkan filter buram.

  • $type (string) - Algoritme blur yang digunakan: 'selektif', 'gaussian' (default 'gaussian').
  • $passes (int) - Jumlah waktu untuk menerapkan filter, meningkatkan efek (default 1).

Mengembalikan objek SimpleImage.

brighten($percentage)

Menerapkan filter kecerahan untuk mencerahkan gambar.

  • $percentage * (int) - Persentase untuk mencerahkan gambar (0 - 100).

Mengembalikan objek SimpleImage.

colorize($color)

Menerapkan filter pewarnaan.

  • $color * (string|array) - Warna filter.

Mengembalikan objek SimpleImage.

contrast($percentage)

Menerapkan filter kontras.

  • $percentage * (int) - Persentase yang akan disesuaikan (-100 - 100).

Mengembalikan objek SimpleImage.

darken($percentage)

Menerapkan filter kecerahan untuk menggelapkan gambar.

  • $percentage * (int) - Persentase untuk menggelapkan gambar (0 - 100).

Mengembalikan objek SimpleImage.

desaturate()

Menerapkan filter desaturasi (skala abu-abu).

Mengembalikan objek SimpleImage.

duotone($lightColor, $darkColor)

Menerapkan filter duotone ke gambar.

  • $lightColor * (string|array) - Warna paling terang dalam duotone.
  • $darkColor * (string|array) - Warna paling gelap dalam duotone.

Mengembalikan objek SimpleImage.

edgeDetect()

Menerapkan filter deteksi tepi.

Mengembalikan objek SimpleImage.

emboss()

Menerapkan filter timbul.

Mengembalikan objek SimpleImage.

invert()

Membalikkan warna gambar.

Mengembalikan objek SimpleImage.

opacity()

Mengubah tingkat opasitas gambar.

  • $opacity * (float) - Tingkat opacity yang diinginkan (0 - 1).

Mengembalikan objek SimpleImage.

pixelate($size)

Menerapkan filter piksel.

  • $size (int) - Ukuran blok dalam piksel (default 10).

Mengembalikan objek SimpleImage.

sepia()

Mensimulasikan efek sepia dengan desaturasi gambar dan menerapkan nada sepia.

Mengembalikan objek SimpleImage.

sharpen($amount)

Mempertajam gambar.

  • $amount (int) - Jumlah penajaman (1 - 100, default 50)

Mengembalikan objek SimpleImage.

sketch()

Menerapkan filter penghapusan rata-rata untuk menghasilkan efek sketsa.

Mengembalikan objek SimpleImage.

Utilitas warna

(static) adjustColor($color, $red, $green, $blue, $alpha)

Menyesuaikan warna dengan menambah/mengurangi nilai merah/hijau/biru/alfa secara terpisah.

  • $color * (string|array) - Warna yang akan disesuaikan.
  • $red * (int) - Penyesuaian merah (-255 - 255).
  • $green * (int) - Penyesuaian hijau (-255 - 255).
  • $blue * (int) - Penyesuaian biru (-255 - 255).
  • $alpha * (float) - Penyesuaian alfa (-1 - 1).

Mengembalikan rangkaian warna RGBA.

(static) darkenColor($color, $amount)

Menggelapkan suatu warna.

  • $color * (string|array) - Warna yang akan digelapkan.
  • $amount * (int) - Jumlah yang akan digelapkan (0 - 255).

Mengembalikan susunan warna RGBA.

extractColors($count = 10, $backgroundColor = null)

Mengekstrak warna dari gambar seperti yang dilakukan manusia.™ Metode ini memerlukan perpustakaan pihak ketiga LeagueColorExtractor. Jika Anda menggunakan Komposer, Komposer akan diinstal untuk Anda secara otomatis.

  • $count (int) - Jumlah maksimal warna yang akan diekstraksi (default 5).
  • $backgroundColor (string|array) - Secara default, piksel apa pun dengan nilai alfa lebih besar dari nol akan dibuang. Hal ini karena warna transparan tidak dirasakan sebagaimana adanya. Misalnya, warna hitam transparan sepenuhnya akan terlihat putih dengan latar belakang putih. Jadi jika Anda ingin mempertimbangkan transparansi, Anda harus menentukan warna latar belakang default.

Mengembalikan array array warna RGBA.

getColorAt($x, $y)

Mendapatkan nilai RGBA dari satu piksel.

  • $x * (int) - Posisi horizontal piksel.
  • $y * (int) - Posisi vertikal piksel.

Mengembalikan susunan warna RGBA atau salah jika posisi x/y berada di luar kanvas.

(static) lightenColor($color, $amount)

Mencerahkan warna.

  • $color * (string|array) - Warna untuk mencerahkan.
  • $amount * (int) - Jumlah yang akan digelapkan (0 - 255).

Mengembalikan rangkaian warna RGBA.

(static) normalizeColor($color)

Menormalkan nilai warna hex atau array ke array RGBA yang diformat dengan baik.

  • $color * (string|array) - Nama warna CSS, string hex, atau array [merah, hijau, biru, alfa].

Anda dapat menyalurkan transparansi alfa melalui string hex dan nama warna. Misalnya:

#fff|0,50 <-- 50% putih merah|0,25 <-- 25% merah

Mengembalikan array: [merah, hijau, biru, alfa]

Pengecualian

SimpleImage memberikan pengecualian standar ketika terjadi kesalahan. Anda harus selalu menggunakan blok coba/tangkap di sekitar kode Anda untuk menanganinya dengan benar. 

 <?php
try {
  $ image = new  claviska SimpleImage( ' image.jpeg ' )
  // ...
} catch ( Exception $ err ) {
  echo $ err -> getMessage ();
}

Untuk memeriksa kesalahan tertentu, bandingkan $err->getCode() dengan konstanta kesalahan yang ditentukan. 

 <?php
try {
  $ image = new  claviska SimpleImage( ' image.jpeg ' )
  // ...
} catch ( Exception $ err ) {
  if ( $ err -> getCode () === $ image :: ERR_FILE_NOT_FOUND ) {
    echo ' File not found! ' ;
  } else {
    echo $ err -> getMessage ();
  }
}

Sebagai praktik terbaik, selalu gunakan konstanta yang ditentukan, bukan nilai bilangan bulatnya. Nilainya kemungkinan akan berubah di versi mendatang, dan TIDAK AKAN dianggap sebagai perubahan yang dapat menyebabkan gangguan.

  • ERR_FILE_NOT_FOUND - File yang ditentukan tidak dapat ditemukan atau dimuat karena alasan tertentu.
  • ERR_FONT_FILE - File font yang ditentukan tidak dapat dimuat.
  • ERR_FREETYPE_NOT_ENABLED - Dukungan freetype tidak diaktifkan di versi PHP Anda.
  • ERR_GD_NOT_ENABLED - Ekstensi GD tidak diaktifkan di versi PHP Anda.
  • ERR_LIB_NOT_LOADED - Perpustakaan yang diperlukan belum dimuat.
  • ERR_INVALID_COLOR - Nilai warna yang tidak valid dimasukkan sebagai argumen.
  • ERR_INVALID_DATA_URI - URI data yang ditentukan tidak valid.
  • ERR_INVALID_IMAGE - Gambar yang ditentukan tidak valid.
  • ERR_UNSUPPORTED_FORMAT - Format gambar yang ditentukan tidak valid.
  • ERR_WEBP_NOT_ENABLED - Dukungan WEBP tidak diaktifkan di versi PHP Anda.
  • ERR_WRITE - Tidak dapat menulis ke sistem file.
  • ERR_INVALID_FLAG - Kunci bendera yang ditentukan tidak ada.

Hal Berguna Untuk Diketahui

  • Argumen warna bisa berupa nama warna CSS (misalnya LightBlue ), string warna hex (misalnya #0099dd ), atau array RGB(A) (misalnya ['red' => 255, 'green' => 0, 'blue' => 0, 'alpha' => 1] ).

  • Ketika $thickness > 1, GD menggambar garis dengan ketebalan yang diinginkan dari titik asal tengah. Misalnya, sebuah persegi panjang yang digambar di [10, 10, 20, 20] dengan ketebalan 3 sebenarnya akan digambar di [9, 9, 21, 21]. Hal ini berlaku untuk semua bentuk dan bukan merupakan bug di perpustakaan SimpleImage.

Bendera contoh

Sesuaikan perilaku instance SimpleImage dengan menetapkan nilai flag instance menggunakan metode setFlag($key, $value) . 

 $ image = new  claviska  SimpleImage ( ' image.jpeg ' )-> setFlag ( " foo " , " bar " );

Anda juga dapat meneruskan array asosiatif ke konstruktor SimpleImage untuk menyetel tanda instance. 

 $ image = new  claviska  SimpleImage ( ' image.jpeg ' , [ ' foo ' => ' bar ' ]);
// . . or without an $ image
$ image = new  claviska  SimpleImage (flags: [ ' foo ' => ' bar ' ]);

Catatan: setFlag() memunculkan pengecualian ERR_INVALID_FLAG jika kuncinya tidak ada (tidak ada nilai default).

sslVerify

Menyetel sslVerify ke false (defaultnya adalah true ) akan membuat semua gambar yang dimuat melalui HTTPS melupakan validasi rekan sertifikat. Hal ini sangat berguna untuk sertifikat yang ditandatangani sendiri. 

 $ image = new  claviska  SimpleImage ( ' https://localhost/image.jpeg ' , [ ' sslVerify ' => false ]);
// Would normally throw an OpenSSL exception , but is ignored with the sslVerify flag set to false .

Perbedaan dari SimpleImage 2.x

  • Argumen warna yang dinormalisasi (warna dapat berupa nama warna CSS, warna hex, atau array RGB(A)).
  • Argumen alfa (opasitas) yang dinormalisasi: 0 (transparan) - 1 (buram)
  • Menambahkan bayangan teks ke metode text .
  • Menambahkan metode fromString() untuk memuat gambar dari string.
  • Menambahkan metode toString() untuk menghasilkan string gambar.
  • Menambahkan metode arc untuk menggambar busur.
  • Menambahkan metode border untuk menggambar batas.
  • Menambahkan metode dot untuk menggambar piksel individual.
  • Menambahkan metode ellipse untuk menggambar elips dan lingkaran.
  • Menambahkan metode line untuk menggambar garis.
  • Menambahkan metode polygon untuk menggambar poligon.
  • Menambahkan metode rectangle untuk menggambar persegi panjang.
  • Menambahkan metode roundedRectangle untuk menggambar persegi panjang bulat.
  • Menambahkan metode adjustColor untuk memodifikasi saluran warna RGBA untuk membuat variasi warna relatif.
  • Menambahkan metode darkenColor untuk menggelapkan warna.
  • Menambahkan metode extractColors untuk mendapatkan warna paling umum dari gambar.
  • Menambahkan metode getColorAt untuk mendapatkan nilai RGBA piksel tertentu.
  • Menambahkan metode lightenColor untuk mencerahkan warna.
  • Ditambahkan metode toDownload untuk memaksa gambar diunduh di mesin klien.
  • Menambahkan filter duotone untuk membuat gambar duotone.
  • Menambahkan metode sharpen untuk mempertajam gambar.
  • Mengubah namespace dari abeautifulsite menjadi claviska .
  • Mengubah metode create menjadi fromNew .
  • Mengubah metode load menjadi fromFile .
  • Mengubah metode load_base64 menjadi fromDataUri .
  • Mengubah metode output menjadi toScreen .x
  • Mengubah metode output_base64 menjadi toDataUri .
  • Mengubah metode save menjadi toFile .
  • Mengubah metode text untuk menerima serangkaian opsi, bukan banyak argumen.
  • Menghapus guratan teks dari metode text karena memberikan hasil yang kotor dan tidak mendukung transparansi.
  • Menghapus metode smooth karena argumennya dalam manual PHP tidak didokumentasikan dengan baik.
  • Menghapus metode adaptive_resize yang tidak digunakan lagi (sebagai gantinya gunakan thumbnail ).
  • Menghapus get_meta_data (gunakan getExif , getHeight , getMime , getOrientation , dan getWidth sebagai gantinya).
  • Menambahkan file .editorconfig. Harap pastikan editor Anda mendukung pengaturan ini sebelum mengirimkan kontribusi.
  • Beralih dari empat spasi menjadi dua untuk lekukan (maaf PHP-FIG!).
  • Beralih dari underscore_methods ke camelCaseMethods.
  • Metode terorganisir ke dalam kelompok berdasarkan fungsi
  • Menghapus komentar PHPDoc. Saat ini, saya tidak ingin memasukkannya ke dalam perpustakaan.
Memperluas
Informasi Tambahan
Aplikasi Terkait
Direkomendasikan untuk Anda
Informasi Terkait Semua