(PHP 4 >= 4.0.2, PHP 5)
curl_setopt — Menyetel opsi transportasi cURL.
bool curl_setopt ( sumber daya $ch , int $option , campuran $value )
Menetapkan opsi untuk pegangan sesi cURL yang diberikan.
bab
Pegangan cURL dikembalikan oleh curl_init().
pilihan
Opsi CURLOPT_XXX perlu disetel.
nilai
Nilai yang akan ditetapkan pada opsi.
Untuk parameter opsional dari opsi berikut, nilai harus ditetapkan ke nilai tipe bool:
| Pilihan | Nilai opsional | Komentar |
|---|---|---|
| CURLOPT_AUTOREFERER | Saat mengalihkan berdasarkan Lokasi:, informasi Referer: di header diatur secara otomatis. | |
| CURLOPT_BINARYTRANSFER | Mengembalikan keluaran mentah ketika CURLOPT_RETURNTRANSFER diaktifkan. | |
| CURLOPT_COOKIESESSION | Jika diaktifkan, curl hanya akan meneruskan satu cookie sesi dan mengabaikan cookie lainnya. Secara default, curl akan mengembalikan semua cookie ke server. Cookie sesi mengacu pada cookie yang digunakan untuk menentukan apakah sesi sisi server valid. | |
| CURLOPT_CRLF | Jika diaktifkan, ubah baris baru Unix menjadi pengangkutan kembali dan umpan baris. | |
| CURLOPT_DNS_USE_GLOBAL_CACHE | Jika diaktifkan, cache DNS global diaktifkan. Ini aman untuk thread dan diaktifkan secara default. | |
| CURLOPT_FAILONERROR | Menampilkan kode status HTTP. Perilaku defaultnya adalah mengabaikan pesan HTTP dengan angka kurang dari atau sama dengan 400. | |
| CURLOPT_FILETIME | Saat diaktifkan, upaya untuk mengubah informasi dalam dokumen jarak jauh. Informasi hasil akan dikembalikan melalui opsi CURLINFO_FILETIME dari fungsi curl_getinfo(). curl_getinfo(). | |
| CURLOPT_FOLLOWLOCATION | Jika diaktifkan, "Lokasi:" yang dikembalikan oleh server akan ditempatkan di header dan dikembalikan ke server secara rekursif. Gunakan CURLOPT_MAXREDIRS untuk membatasi jumlah pengembalian rekursif. | |
| CURLOPT_FORBID_REUSE | Koneksi terpaksa terputus setelah interaksi selesai dan tidak dapat digunakan kembali. | |
| CURLOPT_FRESH_CONNECT | Memaksa koneksi baru diperoleh, menggantikan koneksi yang ada di cache. | |
| CURLOPT_FTP_USE_EPRT | Jika diaktifkan, gunakan perintah EPRT (atau LPRT) saat FTP diunduh. Bila diatur ke FALSE menonaktifkan EPRT dan LPRT, gunakan perintah PORT saja. | |
| CURLOPT_FTP_USE_EPSV | Saat diaktifkan, perintah EPSV pertama kali dicoba sebelum kembali ke mode PASV selama transfer FTP. Menonaktifkan perintah EPSV ketika diatur ke FALSE . | |
| CURLOPT_FTPAPPEND | Saat diaktifkan, tambahkan penulisan ke file alih-alih menimpanya. | |
| CURLOPT_FTPASCII | Alias untuk CURLOPT_TRANSFERTEXT . | |
| CURLOPT_FTPLISTONLY | Jika diaktifkan, hanya nama direktori FTP yang dicantumkan. | |
| CURLOPT_HEADER | Saat diaktifkan, informasi file header akan dikeluarkan sebagai aliran data. | |
| CURLINFO_HEADER_OUT | Minta string untuk pelacakan pegangan saat diaktifkan. | Tersedia mulai dengan PHP 5.1.3. Awalan CURLINFO_ disengaja. |
| CURLOPT_HTTPGET | Jika diaktifkan, metode HTTP akan disetel ke GET. Karena GET adalah default, metode ini hanya akan digunakan jika diubah. | |
| CURLOPT_HTTPPROXYTUNNEL | Jika diaktifkan, transmisi dilakukan melalui proksi HTTP. | |
| CURLOPT_MUTE | Saat diaktifkan, semua parameter yang diubah dalam fungsi cURL akan dikembalikan ke nilai defaultnya. | |
| CURLOPT_NETRC | Setelah koneksi dibuat, akses file ~/.netrc untuk mendapatkan informasi nama pengguna dan kata sandi untuk terhubung ke situs jarak jauh. | |
| CURLOPT_NOBODY | Jika diaktifkan, bagian BODY dari HTML tidak akan ditampilkan. | |
| CURLOPT_NOPROGRESS | Matikan bilah kemajuan transfer ikal saat diaktifkan. Pengaturan default item ini diaktifkan.
| |
| CURLOPT_NOSIGNAL | Saat diaktifkan, abaikan semua sinyal yang diteruskan oleh curl ke php. Item ini diaktifkan secara default selama transmisi multi-thread SAPI. | Ditambahkan di cURL 7.10. |
| CURLOPT_POST | Jika diaktifkan, permintaan POST reguler seperti: application/x-www-form-urlencoded akan dikirim, sama seperti pengiriman formulir. | |
| CURLOPT_PUT | Jika diaktifkan untuk mengizinkan HTTP mengirim file, CURLOPT_INFILE dan CURLOPT_INFILESIZE harus disetel. | |
| CURLOPT_RETURNTRANSFER | Mengembalikan informasi yang diperoleh curl_exec() dalam bentuk aliran file alih-alih mengeluarkannya secara langsung. | |
| CURLOPT_SSL_VERIFYPEER | Ketika dinonaktifkan, CURL akan menghentikan validasi dari server. Setel sertifikat menggunakan opsi CURLOPT_CAINFO . Setel direktori sertifikat menggunakan opsi CURLOPT_CAPATH . Jika CURLOPT_SSL_VERIFYPEER (default 2) diaktifkan, CURLOPT_SSL_VERIFYHOST perlu disetel ke TRUE jika tidak, setel ke FALSE . | Defaultnya adalah TRUE sejak cURL 7.10. Dimulai dengan cURL 7.10, instalasi bundel dilakukan secara default. |
| CURLOPT_TRANSFERTEXT | Jika diaktifkan, gunakan mode ASCII untuk transfer FTP. Untuk LDAP, ini mengambil informasi teks biasa, bukan HTML. Pada sistem Windows, sistem tidak mengatur STDOUT ke mode biner. | |
| CURLOPT_UNRESTRICTED_AUTH | Tambahkan informasi nama pengguna dan kata sandi secara terus-menerus ke beberapa lokasi di header yang dibuat menggunakan CURLOPT_FOLLOWLOCATION , meskipun nama domain telah berubah. | |
| CURLOPT_UPLOAD | Izinkan pengunggahan file bila diaktifkan. | |
| CURLOPT_VERBOSE | Jika diaktifkan, semua informasi akan dilaporkan dan disimpan di STDERR atau CURLOPT_STDERR yang ditentukan. |
Untuk parameter opsional dari opsi berikut, nilai harus ditetapkan ke nilai tipe integer:
| Pilihan | Nilai opsional | Komentar |
|---|---|---|
| CURLOPT_BUFFERSIZE | Ukuran cache dibaca ke dalam data yang diperoleh setiap saat, namun tidak ada jaminan bahwa nilai ini akan terisi setiap saat. | Ditambahkan di cURL 7.10. |
| CURLOPT_CLOSE KEBIJAKAN | Baik CURLCLOSEPOLICY_LEAST_RECENTLY_USED atau CURLCLOSEPOLICY_OLDEST, ada tiga CURLCLOSEPOLICY lainnya, namun cURL belum mendukungnya. | |
| CURLOPT_CONNECTTIMEOUT | Waktu menunggu sebelum memulai sambungan. Jika disetel ke 0, maka akan menunggu tanpa batas waktu. | |
| CURLOPT_CONNECTTIMEOUT_MS | Waktu menunggu upaya koneksi, dalam milidetik. Jika disetel ke 0, tunggu tanpa batas waktu. | Ditambahkan di cURL 7.16.2. Tersedia mulai dengan PHP 5.2.3. |
| CURLOPT_DNS_CACHE_TIMEOUT | Atur waktu untuk menyimpan informasi DNS di memori, defaultnya adalah 120 detik. | |
| CURLOPT_FTPSSLAUTH | Metode otentikasi FTP: CURLFTPAUTH_SSL (coba SSL dulu), CURLFTPAUTH_TLS (coba TLS dulu) atau CURLFTPAUTH_DEFAULT (biarkan cURL memutuskan secara otomatis). | Ditambahkan di cURL 7.12.2. |
| CURLOPT_HTTP_VERSION | CURL_HTTP_VERSION_NONE (default, biarkan curl memutuskan versi mana yang akan digunakan), CURL_HTTP_VERSION_1_0 (memaksa HTTP/1.0) atau CURL_HTTP_VERSION_1_1 (memaksa HTTP/1.1). | |
| CURLOPT_INFILESIZE | Tetapkan batas ukuran file yang diunggah dalam byte. | |
| CURLOPT_LOW_SPEED_LIMIT | Ketika kecepatan transmisi kurang dari CURLOPT_LOW_SPEED_LIMIT (byte/detik), PHP akan menggunakan CURLOPT_LOW_SPEED_TIME untuk menentukan apakah akan membatalkan transmisi karena terlalu lambat. | |
| CURLOPT_LOW_SPEED_TIME | Ketika kecepatan transmisi kurang dari CURLOPT_LOW_SPEED_LIMIT (byte/detik), PHP akan menggunakan CURLOPT_LOW_SPEED_TIME untuk menentukan apakah akan membatalkan transmisi karena terlalu lambat. | |
| CURLOPT_MAXCONNECTS | Jumlah maksimum koneksi yang diperbolehkan, jika terlampaui, CURLOPT_CLOSEPOLICY akan digunakan untuk menentukan koneksi mana yang harus dihentikan. | |
| CURLOPT_MAXREDIRS | Menentukan jumlah maksimum pengalihan HTTP. Opsi ini digunakan dengan CURLOPT_FOLLOWLOCATION . | |
| CURLOPT_PORT | Digunakan untuk menentukan port koneksi. (opsional) | |
| CURLOPT_PROTOCOLS | Bitfield mengacu pada CURLPROTO_* . Jika diaktifkan, nilai bitfield membatasi protokol mana yang dapat digunakan libcurl selama transfer. Ini akan memungkinkan Anda mengkompilasi libcurl untuk mendukung banyak protokol, tetapi hanya menggunakan sebagian dari protokol tersebut yang diizinkan untuk digunakan. Secara default libcurl akan menggunakan semua protokol yang didukungnya. Lihat CURLOPT_REDIR_PROTOCOLS .Opsi protokol yang tersedia adalah: CURLPROTO_HTTP, CURLPROTO_HTTPS, CURLPROTO_FTP, CURLPROTO_FTPS, CURLPROTO_SCP, CURLPROTO_SFTP, CURLPROTO_TELNET, CURLPROTO_LDAP, CURLPROTO_LDAPS, CURLPROTO_DICT, CURLPROTO_FILE, CURLPROTO_TFTP, CURLPROTO_ALL | Ditambahkan di cURL 7.19.4. |
| CURLOPT_PROTOCOLS | Bitfield mengacu pada CURLPROTO_* . Jika diaktifkan, nilai bitfield membatasi protokol mana yang dapat digunakan libcurl selama transfer. Ini akan memungkinkan Anda mengkompilasi libcurl untuk mendukung banyak protokol, tetapi hanya menggunakan sebagian dari protokol tersebut yang diizinkan untuk digunakan. Secara default libcurl akan menggunakan semua protokol yang didukungnya. Lihat CURLOPT_REDIR_PROTOCOLS .Opsi protokol yang tersedia adalah: CURLPROTO_HTTP, CURLPROTO_HTTPS, CURLPROTO_FTP, CURLPROTO_FTPS, CURLPROTO_SCP, CURLPROTO_SFTP, CURLPROTO_TELNET, CURLPROTO_LDAP, CURLPROTO_LDAPS, CURLPROTO_DICT, CURLPROTO_FILE, CURLPROTO_TFTP, CURLPROTO_ALL | Ditambahkan di cURL 7.19.4. |
| CURLOPT_PROXYAUTH | Metode verifikasi untuk koneksi proksi HTTP. Gunakan tanda bitfield di CURLOPT_HTTPAUTH untuk mengatur opsi yang sesuai. Untuk autentikasi proksi, saat ini hanya CURLAUTH_BASIC dan CURLAUTH_NTLM yang didukung. | Ditambahkan di cURL 7.10.7. |
| CURLOPT_PROXYPORT | Port server proksi. Port juga dapat diatur di CURLOPT_PROXY . | |
| CURLOPT_PROXYTYPE | Entah CURLPROXY_HTTP (default) atau CURLPROXY_SOCKS5 . | Ditambahkan di cURL 7.10. |
| CURLOPT_REDIR_PROTOCOLS | Nilai bitfield di CURLPROTO_* . Jika diaktifkan, nilai bitfield akan membatasi protokol yang dapat digunakan oleh thread transport saat mengikuti pengalihan ketika CURLOPT_FOLLOWLOCATION diaktifkan. Ini akan memungkinkan Anda untuk membatasi thread transport ke subset protokol yang diizinkan saat mengarahkan. Secara default libcurl akan mengizinkan semua protokol kecuali FILE dan SCP. Ini sedikit berbeda dari versi pra-rilis 7.19.4 yang mengikuti semua protokol yang didukung tanpa syarat. Untuk konstanta protokol, lihat CURLOPT_PROTOCOLS . | Ditambahkan di cURL 7.19.4. |
| CURLOPT_RESUME_FROM | Berikan offset byte saat melanjutkan transfer (digunakan untuk melanjutkan transfer). | |
| CURLOPT_SSL_VERIFYHOST | 1 Periksa apakah ada nama umum di sertifikat SSL server. Catatan Penerjemah: Nama Umum (Common Name) secara umum berarti mengisi nama domain (domain) atau subdomain (subdomain) yang akan Anda ajukan sertifikat SSL. 2 Periksa apakah nama umum ada dan cocok dengan nama host yang diberikan. | |
| CURLOPT_SSLVERSION | Versi SSL yang akan digunakan (2 atau 3). Secara default PHP akan mendeteksi nilai ini dengan sendirinya, meskipun dalam beberapa kasus mungkin perlu diatur secara manual. | |
| CURLOPT_TIMECONDITION | Jika telah diedit setelah waktu tertentu yang ditentukan oleh CURLOPT_TIMEVALUE , gunakan CURL_TIMECOND_IFMODSINCE untuk mengembalikan halaman. Jika CURLOPT_HEADER salah , gunakan CURL_TIMECOND_IFUNMODSINCE. , nilai defaultnya adalah CURL_TIMECOND_IFUNMODSINCE . | |
| CURLOPT_TIMEOUT | Tetapkan jumlah detik maksimum yang diizinkan untuk dijalankan oleh cURL. | |
| CURLOPT_TIMEOUT_MS | Menetapkan jumlah milidetik maksimum yang boleh dijalankan oleh cURL. | Ditambahkan di cURL 7.16.2. Tersedia mulai PHP 5.2.3 dan seterusnya. |
| CURLOPT_TIMEVALUE | Tetapkan stempel waktu yang digunakan oleh CURLOPT_TIMECONDITION . Secara default, CURL_TIMECOND_IFMODSINCE digunakan. |
Untuk parameter opsional dari opsi berikut, nilai harus ditetapkan ke nilai tipe string:
| Pilihan | Nilai opsional | Komentar |
|---|---|---|
| CURLOPT_CAINFO | Nama file yang menyimpan satu atau lebih sertifikat untuk verifikasi oleh server. Parameter ini hanya bermakna bila digunakan dengan CURLOPT_SSL_VERIFYPEER . . | |
| CURLOPT_CAPATH | Direktori yang menyimpan beberapa sertifikat CA. Opsi ini digunakan dengan CURLOPT_SSL_VERIFYPEER . | |
| CURLOPT_COOKIE | Setel konten bagian "Cookie:" dari permintaan HTTP. Beberapa cookie dipisahkan dengan titik koma diikuti dengan spasi (misalnya, " buah=apel; warna=merah "). | |
| CURLOPT_COOKIEFILE | Nama file yang berisi data cookie. Format file cookie dapat berupa format Netscape, atau hanya informasi header HTTP murni yang dapat disimpan dalam file. | |
| CURLOPT_COOKIEJAR | File yang menyimpan informasi cookie setelah koneksi selesai. | |
| CURLOPT_CUSTOMREQUEST | Gunakan pesan permintaan khusus alih-alih "GET" atau "HEAD" untuk permintaan HTTP. Ini berguna untuk melakukan "HAPUS" atau permintaan HTTP lainnya yang lebih rahasia. Nilai yang valid adalah "GET" , "POST" , "CONNECT" , dll. Artinya, jangan masukkan seluruh permintaan HTTP di sini. Misalnya, memasukkan "GET /index.html HTTP/1.0rnrn" salah.
| |
| CURLOPT_EGDSOCKET | Mirip dengan CURLOPT_RANDOM_FILE , kecuali soket Daemon Pengumpulan Entropi. | |
| CURLOPT_ENCODING | Nilai "Accept-Encoding:" di header permintaan HTTP. Pengkodean yang didukung adalah "identity" , "deflate" dan "gzip" . Jika string kosong "" , semua jenis pengkodean yang didukung akan dikirim dalam header permintaan. | Ditambahkan di cURL 7.10. |
| CURLOPT_FTPPORT | Nilai ini akan digunakan untuk mendapatkan alamat IP yang diperlukan untuk perintah FTP "POST". Perintah "POST" memberitahu server jarak jauh untuk terhubung ke alamat IP yang kita tentukan. String ini dapat berupa alamat IP teks biasa, nama host, nama antarmuka jaringan (di bawah UNIX) atau hanya '-' untuk menggunakan alamat IP default. | |
| CURLOPT_INTERFACE | Nama antarmuka pengirim jaringan dapat berupa nama antarmuka, alamat IP, atau nama host. | |
| CURLOPT_KRB4LEVEL | Tingkat keamanan KRB4 (Kerberos 4). Salah satu nilai berikut ini valid (diurutkan dari terendah hingga tertinggi): "clear" , "safe" , "confidential" , "private". Jika string tidak cocok dengan semua ini, "pribadi" akan digunakan. Menyetel opsi ini ke NULL akan menonaktifkan otentikasi keamanan KRB4. Saat ini sertifikasi keamanan KRB4 hanya dapat digunakan untuk transfer FTP. | |
| CURLOPT_POSTFIELDS | Semua data dikirim menggunakan operasi "POST" dalam protokol HTTP. Untuk mengirim file, awali nama file dengan @ dan gunakan jalur lengkap. Parameter ini dapat diteruskan sebagai string berkode urlen seperti ' para1=val1¶2=val2&... ' atau menggunakan array dengan nama bidang sebagai kunci dan data bidang sebagai nilainya. Jika value adalah array, header Content-Type akan disetel ke multipart/form-data . | |
| CURLOPT_PROXY | Saluran proksi HTTP. | |
| CURLOPT_PROXYUSERPWD | String dalam format "[nama pengguna]:[kata sandi]" yang digunakan untuk terhubung ke proxy. | |
| CURLOPT_RANDOM_FILE | Nama file yang digunakan untuk menghasilkan benih nomor acak SSL. | |
| CURLOPT_RANGE | Dalam bentuk "XY" , dimana X dan Y merupakan pilihan opsional untuk memperoleh rentang data, dalam byte. Thread transport HTTP juga mendukung beberapa duplikat yang dipisahkan dengan koma seperti "XY,NM" . | |
| CURLOPT_REFERER | Konten "Referer:" di header permintaan HTTP. | |
| CURLOPT_SSL_CIPHER_LIST | Daftar algoritma enkripsi SSL. Misalnya RC4-SHA dan TLSv1 keduanya merupakan daftar enkripsi yang tersedia. | |
| CURLOPT_SSLCERT | Nama file yang berisi sertifikat dalam format PEM. | |
| CURLOPT_SSLCERTPASSWD | Kata sandi diperlukan untuk menggunakan sertifikat CURLOPT_SSLCERT . | |
| CURLOPT_SSLCERTTYPE | Jenis sertifikat. Format yang didukung adalah "PEM" (default), "DER" dan "ENG" . | Ditambahkan di cURL 7.9.3. |
| CURLOPT_SSLENGINE | Variabel mesin kripto yang digunakan untuk kunci pribadi SSL yang ditentukan dalam CURLOPT_SSLKEY . | |
| CURLOPT_SSLENGINE_DEFAULT | Variabel yang digunakan untuk operasi enkripsi asimetris. | |
| CURLOPT_SSLKEY | Nama file yang berisi kunci pribadi SSL. | |
| CURLOPT_SSLKEYPASSWD | Kata sandi untuk kunci pribadi SSL ditentukan dalam CURLOPT_SSLKEY .
| |
| CURLOPT_SSLKEYTYPE | Jenis enkripsi kunci pribadi yang ditentukan dalam CURLOPT_SSLKEY . Jenis kunci yang didukung adalah "PEM" (nilai default), "DER" dan "ENG" . | |
| CURLOPT_URL | Alamat URL yang ingin diperoleh juga dapat diatur di fungsi curl_init() . | |
| CURLOPT_USERAGENT | Sertakan string header "Agen-Pengguna:" dalam permintaan HTTP. | |
| CURLOPT_USRPWD | Berikan nama pengguna dan kata sandi yang diperlukan untuk koneksi dalam format: "[nama pengguna]:[kata sandi]" . |
Untuk parameter opsional dari opsi berikut, nilai harus ditetapkan ke array:
| Pilihan | Nilai opsional | Komentar |
|---|---|---|
| CURLOPT_HTTP200ALIASES | 200 array kode respons, respons dalam array dianggap sebagai respons yang benar, jika tidak maka dianggap kesalahan. | Ditambahkan di cURL 7.10.3. |
| CURLOPT_HTTPHEADER | Array yang digunakan untuk mengatur bidang header HTTP. Gunakan array dalam bentuk berikut untuk menyetel: array('Jenis konten: teks/polos', 'Panjang konten: 100') | |
| CURLOPT_POSTQUOTE | Satu set perintah FTP yang dijalankan di server setelah permintaan FTP dijalankan. | |
| CURLOPT_QUOTE | Satu set perintah FTP yang akan dieksekusi di server sebelum permintaan FTP. |
Untuk parameter opsional dari opsi berikut, nilai harus ditetapkan ke sumber daya aliran (misalnya, menggunakan fopen()):
| Pilihan | Nilai opsional |
|---|---|
| CURLOPT_FILE | Tetapkan lokasi file keluaran. Nilainya adalah jenis sumber daya. |
| CURLOPT_INFILE | Alamat file yang perlu dibaca saat mengunggah file. Nilainya adalah jenis sumber daya. |
| CURLOPT_STDERR | Tetapkan alamat keluaran kesalahan, nilainya adalah jenis sumber daya, menggantikan STDERR default. |
| CURLOPT_WRITEHEADER | Tetapkan alamat file tempat konten bagian header ditulis, dan nilainya adalah jenis sumber daya. |
Untuk parameter opsional dari opsi berikut, nilai harus ditetapkan ke nama fungsi panggilan balik:
| Pilihan | Nilai opsional |
|---|---|
| CURLOPT_HEADERFUNCTION | Mengatur fungsi panggilan balik. Fungsi ini memiliki dua parameter. Yang pertama adalah pegangan sumber daya cURL, dan yang kedua adalah data header keluaran. Output data header harus bergantung pada fungsi ini, yang mengembalikan ukuran data tertulis. |
| CURLOPT_PASSWDFUNCTION | Tetapkan fungsi panggilan balik dengan tiga parameter. Yang pertama adalah pegangan sumber daya cURL, yang kedua adalah perintah kata sandi, dan parameter ketiga adalah panjang kata sandi maksimum yang diperbolehkan. Mengembalikan nilai kata sandi. |
| CURLOPT_PROGRESSFUNCTION | Siapkan fungsi panggilan balik dengan tiga parameter. Yang pertama adalah pegangan sumber daya cURL, yang kedua adalah sumber daya deskriptor file, dan yang ketiga adalah panjangnya. Mengembalikan data yang terkandung. |
| CURLOPT_READFUNGSI | Nama fungsi panggilan balik. Fungsi ini harus menerima tiga parameter. Yang pertama adalah sumber daya cURL; yang kedua adalah sumber daya aliran yang diteruskan ke cURL melalui opsi CURLOPT_INFILE ; Fungsi panggilan balik harus mengembalikan string yang panjangnya kurang dari atau sama dengan jumlah data yang diminta (parameter ketiga). Umumnya dibaca dari sumber aliran masuk. Mengembalikan string kosong sebagai sinyal EOF (akhir file). |
| CURLOPT_WRITEFUNCTION | Nama fungsi panggilan balik. Fungsi ini harus menerima dua parameter. Yang pertama adalah sumber daya cURL; yang kedua adalah string data yang akan ditulis. Data harus disimpan dalam fungsi. Fungsi tersebut harus mengembalikan jumlah byte yang diteruskan untuk menulis data, jika tidak, transfer akan terganggu oleh kesalahan. |
Mengembalikan TRUE jika berhasil, atau FALSE jika gagal.
| Versi | menjelaskan |
|---|---|
| 5.2.10 | Memperkenalkan CURLOPT_PROTOCOLS , dan CURLOPT_REDIR_PROTOCOLS . |
| 5.1.0 | Diperkenalkan CURLOPT_AUTOREFERER , CURLOPT_BINARYTRANSFER , CURLOPT_FTPSSLAUTH , CURLOPT_PROXYAUTH , dan CURLOPT_TIMECONDITION . |
| 5.0.0 | Diperkenalkan CURLOPT_FTP_USE_EPRT , CURLOPT_NOSIGNAL , CURLOPT_UNRESTRICTED_AUTH , CURLOPT_BUFFERSIZE , CURLOPT_HTTPAUTH , CURLOPT_PROXYPORT , CURLOPT_PROXYTYPE , CURLOPT_SSLCERTTYPE , dan CURLOPT_HTTP200ALIASES . |
Inisialisasi sesi cURL baru dan dapatkan halaman web
<?php// Buat sumber daya cURL baru $ch = curl_init();// Tetapkan URL dan opsi terkait curl_setopt($ch, CURLOPT_URL, "http://www.example.com/"); , CURLOPT_HEADER, salah);// Ambil URL dan teruskan ke browser curl_exec($ch);//Tutup sumber daya cURL dan lepaskan sumber daya sistem curl_close($ch);?>
Contoh unggah file:
<?php/* http://localhost/upload.php:print_r($_POST);print_r($_FILES);*/$ch = curl_init();$data = array('nama' => 'Foo', 'file' => '@/home/user/test.png');curl_setopt($ch, CURLOPT_URL, 'http://localhost/upload.php');curl_setopt($ch, CURLOPT_POST, 1);curl_setopt($ch, CURLOPT_POSTFIELDS, $data);curl_exec($ch);?>Hasil output dari contoh di atas adalah sebagai berikut:
Array( [nama] => Foo)Array( [file] => Array ( [nama] => test.png [ketik] => image/png [tmp_name] => /tmp/phpcpjNeQ [kesalahan] => 0 [ ukuran] => 279 ))
Saat meneruskan array ke CURLOPT_POSTFIELDS, cURL akan mengkodekan data menjadi multipart/form-data, sedangkan saat meneruskan string yang dikodekan URL, data akan dikodekan ke dalam application/x-www-form-urlencoded.