想用 cURL 抓圖,前提當然是 PHP 環境已啟用 cURL 擴充。最快的確認方式就是寫一段 phpinfo(),搜尋 curl 區塊看有沒有出現。若沒有,請開啟 php.ini,把 ;extension=php_curl.dll 前面的分號移除,存檔後重啟 IIS 或 Apache 即可。
/* *@通過curl方式獲取指定的圖片到本地 *@ 完整的圖片地址 *@ 要存儲的文件名 */ function getImg($url = "", $filename = "") { //去除URL連接上面可能的引號 //$url = preg_replace( '/(?:^['"]+|['"/]+$)/', '', $url ); $hander = curl_init(); $fp = fopen($filename,'wb'); curl_setopt($hander,CURLOPT_URL,$url); curl_setopt($hander,CURLOPT_FILE,$fp); curl_setopt($hander,CURLOPT_HEADER,0); curl_setopt($hander,CURLOPT_FOLLOWLOCATION,1); //curl_setopt($hander,CURLOPT_RETURNTRANSFER,false);//以數據流的方式返回數據,當為false是直接顯示出來 curl_setopt($hander,CURLOPT_TIMEOUT,60); curl_exec($hander); curl_close($hander); fclose($fp); Return true; }
流程其實很單純:curl_init() 建立工作階段、fopen() 以二進位寫入模式(wb)開啟目標檔、CURLOPT_FILE 把回應內容直接導向檔案描述指標,最後關閉連線與檔案。呼叫方式如下:
getImg("/logo.jpg","upload/image.jpg");
<?php $url = "圖片絕對地址/thumbnail.jpg"; $filename = 'curl.jpg'; getImg($url, $filename); /* *@通過curl方式獲取制定的圖片到本地 *@ 完整的圖片地址 *@ 要存儲的文件名 */ function getImg($url = "", $filename = "") { if(is_dir(basename($filename))) { echo "The Dir was not exits"; return false; } //去除URL連接上面可能的引號 $url = preg_replace( '/(?:^['"]+|['"/]+$)/', '', $url ); $hander = curl_init(); $fp = fopen($filename,'wb'); curl_setopt($hander,CURLOPT_URL,$url); curl_setopt($hander,CURLOPT_FILE,$fp); curl_setopt($hander,CURLOPT_HEADER,0); curl_setopt($hander,CURLOPT_FOLLOWLOCATION,1); //curl_setopt($hander,CURLOPT_RETURNTRANSFER,false);//以數據流的方式返回數據,當為false是直接顯示出來 curl_setopt($hander,CURLOPT_TIMEOUT,60); /*$options = array( CURLOPT_URL=> '/thum-f3ccdd27d2000e3f9255a7e3e2c4880020110622095243.jpg', CURLOPT_FILE => $fp, CURLOPT_HEADER => 0, CURLOPT_FOLLOWLOCATION => 1, CURLOPT_TIMEOUT => 60 ); curl_setopt_array($hander, $options); */ curl_exec($hander); curl_close($hander); fclose($fp); return true; } ?>
註解中被切掉的 curl_setopt_array() 寫法值得留意:當選項很多時,用陣列一次設定會比連續呼叫好維護得多。
bool curl_setopt (int ch, string option, mixed value) 負責為單一 cURL 工作階段設定選項:option 是要設定的項目,value 是對應的值。以下依型別分類整理常用選項。
CURLOPT_INFILESIZE:上傳檔案到遠端時,告知 PHP 檔案大小。
CURLOPT_VERBOSE:設為非零值可讓 cURL 回報所有細節,除錯時很有用。
CURLOPT_HEADER:設為非零值會把 HTTP 標頭一起包含在輸出中。
CURLOPT_NOPROGRESS:不希望顯示傳輸進度條時設為非零值。注意 PHP 預設已將此選項設為非零,一般僅在除錯時才需要更動。
CURLOPT_NOBODY:輸出中不含 body 部分時設為非零值。
CURLOPT_FAILONERROR:HTTP 回應碼大於等於 300 時不顯示內容,設為非零值即可;預設行為是忽略狀態碼並回傳正常頁面。
CURLOPT_UPLOAD:準備上傳時設為非零值。
CURLOPT_POST:執行標準 HTTP POST(application/x-www-form-urlencoded,多數 HTML 表單使用)時設為非零值。
CURLOPT_FTPLISTONLY:只列出 FTP 目錄名稱。
CURLOPT_FTPAPPEND:以附加方式寫入遠端檔案,而非覆蓋。
CURLOPT_NETRC:從 ~/.netrc 查詢遠端站台的帳號密碼。
CURLOPT_FOLLOWLOCATION:伺服器回傳的 Location: 標頭會被視為 HTTP 標頭的一部分處理(此為遞迴行為)。
CURLOPT_PUT:以 HTTP 上傳檔案時設為非零值,同時必須設定 CURLOPT_INFILE 與 CURLOPT_INFILESIZE。
CURLOPT_MUTE:讓 PHP 對 cURL 函式完全靜音。
CURLOPT_TIMEOUT:設定最長等待秒數。
CURLOPT_LOW_SPEED_LIMIT:控制傳輸速率下限的位元組數。
CURLOPT_LOW_SPEED_TIME:控制多少秒內需傳完 CURLOPT_LOW_SPEED_LIMIT 規定的位元組數。
CURLOPT_RESUME_FROM:傳入位元組偏移量,指定續傳的起點。
CURLOPT_SSLVERSION:指定 SSL 版本,預設由 PHP 自行判斷,較講究安全的情境建議手動設定。
CURLOPT_TIMECONDITION:指定如何處理 CURLOPT_TIMEVALUE,可設為 TIMECOND_IFMODSINCE 或 TIMECOND_ISUNMODSINCE,僅用於 HTTP。
CURLOPT_TIMEVALUE:傳入自 1970-1-1 起的秒數,作為時間條件比較的基準。
CURLOPT_URL:要取回的 URL,也可在 curl_init() 時一併設定。
CURLOPT_USERPWD:傳入 [username]:[password] 格式的帳密。
CURLOPT_PROXYUSERPWD:傳入 [username]:[password] 格式,用於連接 HTTP 代理。
CURLOPT_RANGE:指定要抓取的範圍,格式為「X-Y」,X 或 Y 可省略;多段範圍以逗號分隔(X-Y,N-M)。
CURLOPT_POSTFIELDS:傳入 POST 操作要送出的全部資料字串。
CURLOPT_REFERER:在請求中帶入 referer 標頭。
CURLOPT_USERAGENT:在請求中帶入 user-agent 標頭。
CURLOPT_FTPPORT:傳入供 FTP PORT 指令使用的 IP;可以是 IP、主機名、網路介面名稱(UNIX)或「-」代表系統預設 IP。
CURLOPT_COOKIE:傳入包含 HTTP cookie 的標頭字串。
CURLOPT_SSLCERT:傳入 PEM 格式憑證字串。
CURLOPT_SSLCERTPASSWD:傳入使用 CURLOPT_SSLCERT 憑證所需的密碼。
CURLOPT_COOKIEFILE:傳入 cookie 資料檔名,格式可為 Netscape 或 HTTP 標頭堆疊。
CURLOPT_CUSTOMREQUEST:自訂 HTTP 請求方法,取代預設的 GET 或 HEAD。
掌握這幾個核心選項,就足以應付大部分「抓遠端圖片」與「與第三方 API 溝通」的需求。正式環境別忘了加上逾時設定與錯誤處理,避免對方站台無回應時把整個流程拖住。