Класс на PHP для CURL
Опубликовано: 05.09.2018
Этот скрипт является оберткой функций CURL расширения для выполнения запросов доступа к HTTP- и FTP-серверам.
Скрипт может выполнять несколько типов операций:
Пинговать сервер заданного URL, чтобы проверить, отвечает ли он как ожидалось; Отправлять запрос на URL и получать заголовки и содержимое; Отправлять запрос HTTP аутентификации; Посылать HTTP запросы на URL методом POST; Загружать файлы через FTP сервер; Скачивать файлы с FTP сервера.
Ещё скрипт имеет функцию установки любого значения User Agent для браузера, а также может обрабатывать куки (cookies).
PHP cURL Tutorial #4: Post Files To Server Using CURLFile Class
Лицензия LGPL.
Системные требования скрипта:
PHP не младше 5.0 версии.
Исходник скрипта
/* * Project: Absynthe cURL * File: acurl.class.php5 * Author: Sylvain 'Absynthe' Rabot <[email protected]> * Website: http://absynthe.is.free.fr/acurl/ * Version: alpha 1 * Date: 05/06/2007 * License: LGPL */ /** * Take a look at the declaration of methods. * All parameters initialized to false in declarations are optional if you set them with set_option(). * If you set values with both set_option and argument, arguments not FALSE will be taken. * Puting arguments doesn't overwrite values set by set_option, arguments are temporary. * * Location header is taken into account automatically, * you will receive headers and content of the page pointed by the redirection * * @example : * <code> * * $acurl = new acurl(); * * $acurl->set_option('url', 'http://absynthe.is.free.fr/'); * $acurl->set_option('port', 80); * $acurl->set_option('login', 'Absynthe'); * $acurl->set_option('password', 'mypassword'); * $acurl->set_option('headers', true); * $acurl->set_option('cookie', '/path/to/my/cookie.txt'); * $acurl->set_option('user_agent', 'Mozilla/5.0 (Windows; U; Windows NT 5.1; fr; rv:1.8.1.4) Gecko/20070515 Firefox/2.0.0.4'); * * $answer = $acurl->ping(); * $answer = $acurl->http_request(); * $answer = $acurl->http_auth_request(); * $answer = $acurl->http_post_request('var=foo&var1=fooo'); * $answer = $acurl->http_post_request(array('var' => 'foo', 'var1' => 'fooo')); * $answer = $acurl->http_post_auth_request('var=foo&var1=fooo'); * $answer = $acurl->http_post_auth_request(array('var' => 'foo', 'var1' => 'fooo')); * * $answer = $acurl->ftp_upload('/path/to/my/file.txt', 'ftp.abstraction.fr/path/to/file.txt', 21, 'Absynthe', 'mypassword'); * $answer = $acurl->ftp_download('/path/to/my/file.txt', 'ftp.abstraction.fr/path/to/file.txt', 21, 'Absynthe', 'mypassword'); * * </code> */ class acurl { /* Init ---------------------------------- */ private $handler = false; private $url = false; private $port = false; private $login = false; private $password = false; private $headers = false; private $cookie = false; private $user_agent = false; /** * Constructor of the object * * @param string $url : URL of the page * @param int $port : Port used to get the page * @param string $login : HTTP login * @param string $password : HTTP password * @param boolean $headers : set it to true if you want headers in the answer * @param string $cookie : path to the cookie file if you want to use the object like a web browser * @param string $user_agent : if you need to look like a web browser */ public function __construct($url = false, $port = false, $login = false, $password = false, $headers = false, $cookie = false, $user_agent = false) { if (!function_exists('curl_init')) { trigger_error('Sorry but PHP is not compiled with cURL', E_USER_ERROR); exit; } $this->handler = curl_init(); $this->url = $url; $this->port = $port; $this->login = $login; $this->password = $password; $this->headers = $headers; $this->cookie = $cookie; $this->user_agent = $user_agent; } /** * Destructor */ public function __destruct() { if (is_resource($this->handler)) curl_close($this->handler); } /** * Wake up method to enable unserialization */ public function __wakeup() { if (!is_resource($this->handler)) $this->handler = curl_init(); } /** * Set object options * * @param string $var * @param string $value */ public function set_option($var, $value) { $var = strtolower($var); $this->$var = $value; } /** * Ping an URL * * @param string $url : URL to ping * @param int $port : Port used to ping * @param int $post : Ping with post request * @return boolean */ public function ping($url = false, $port = false, $post = false) { /* Init ---------------------------------- */ $this->test_var($url, $this->url); $this->test_var($port, $this->port); /* cURL Setup ---------------------------------- */ curl_setopt($this->handler, CURLOPT_URL, $url); curl_setopt($this->handler, CURLOPT_HEADER, false); curl_setopt($this->handler, CURLOPT_RETURNTRANSFER, false); curl_setopt($this->handler, CURLOPT_NOBODY, true); if ($port !== false) curl_setopt($this->handler, CURLOPT_PORT, $port); /* Preparation of post request ---------------------------------- */ if ($post !== false) { curl_setopt($this->handler, CURLOPT_POST, true); if (is_array($post)) { $string = ''; foreach ($post as $key => $value) $string .= "$key=$value&"; curl_setopt($this->handler, CURLOPT_POSTFIELDS, $string); } else { curl_setopt($this->handler, CURLOPT_POSTFIELDS, $post); } } /* Execution ---------------------------------- */ return curl_exec($this->handler); } /** * Retrieve content through HTTP * * @param string $url : URL of the page * @param int $port : Port used to get the page * @param boolean $headers : set it to true if you want headers in the answer * @param string $cookie : path to the cookie file if you want to use the object like a web browser * @param string $user_agent : if you need to look like a web browser * @return string / array */ public function http_request($url = false, $port = false, $headers = false, $cookie = false, $user_agent = false) { /* Init ---------------------------------- */ $this->test_var($url, $this->url); $this->test_var($port, $this->port); $this->test_var($headers, $this->headers); $this->test_var($cookie, $this->cookie); $this->test_var($user_agent, $this->user_agent); /* cURL Setup ---------------------------------- */ curl_setopt($this->handler, CURLOPT_URL, $url); curl_setopt($this->handler, CURLOPT_HEADER, $headers); curl_setopt($this->handler, CURLOPT_RETURNTRANSFER, true); curl_setopt($this->handler, CURLOPT_FOLLOWLOCATION, true); curl_setopt($this->handler, CURLOPT_AUTOREFERER, true); if ($port !== false) curl_setopt($this->handler, CURLOPT_PORT, $port); if (is_file($cookie)) { curl_setopt($this->handler, CURLOPT_COOKIE, $cookie); curl_setopt($this->handler, CURLOPT_COOKIEJAR, $cookie); curl_setopt($this->handler, CURLOPT_COOKIEFILE, $cookie); } if ($user_agent !== false) curl_setopt($this->handler, CURLOPT_USERAGENT, $this->user_agent); /* Execution ---------------------------------- */ if ($headers) return array("headers" => curl_exec($this->handler), "content" => curl_exec($this->handler)); else return curl_exec($this->handler); } /** * Retrieve content through HTTP with authentication * * @param string $url : URL of the page * @param int $port : Port used to get the page * @param string $login : HTTP login * @param string $password : HTTP password * @param boolean $headers : set it to true if you want headers in the answer * @param string $cookie : path to the cookie file if you want to use the object like a web browser * @param string $user_agent : if you need to look like a web browser * @return string / array */ public function http_auth_request($url = false, $port = false, $login = false, $password = false, $headers = false, $cookie = false, $user_agent = false) { /* Init ---------------------------------- */ $this->test_var($url, $this->url); $this->test_var($port, $this->port); $this->test_var($login, $this->login); $this->test_var($password, $this->password); $this->test_var($headers, $this->headers); $this->test_var($cookie, $this->cookie); $this->test_var($user_agent, $this->user_agent); /* cURL Setup ---------------------------------- */ curl_setopt($this->handler, CURLOPT_URL, $url); curl_setopt($this->handler, CURLOPT_HEADER, $headers); curl_setopt($this->handler, CURLOPT_RETURNTRANSFER, true); curl_setopt($this->handler, CURLOPT_FOLLOWLOCATION, true); curl_setopt($this->handler, CURLOPT_AUTOREFERER, true); curl_setopt($this->handler, CURLOPT_HTTPAUTH, CURLAUTH_BASIC); curl_setopt($this->handler, CURLOPT_USERPWD, "$login:$password"); if ($port !== false) curl_setopt($this->handler, CURLOPT_PORT, $this->port); if (is_file($cookie)) { curl_setopt($this->handler, CURLOPT_COOKIE, $cookie); curl_setopt($this->handler, CURLOPT_COOKIEJAR, $cookie); curl_setopt($this->handler, CURLOPT_COOKIEFILE, $cookie); } /* Execution ---------------------------------- */ if ($headers) return array("headers" => curl_exec($this->handler), "content" => curl_exec($this->handler)); else return curl_exec($this->handler); } /** * Send a post request and retrieve the content * * @param string/array $post : Post request * @param string $url : URL of the page * @param int $port : Port used to get the page * @param boolean $headers : set it to true if you want headers in the answer * @param string $cookie : path to the cookie file if you want to use the object like a web browser * @param string $user_agent : if you need to look like a web browser * @return string/array */ public function http_post_request($post, $url = false, $port = false, $headers = false, $cookie = false, $user_agent = false) { /* Init ---------------------------------- */ $this->test_var($url, $this->url); $this->test_var($port, $this->port); $this->test_var($headers, $this->headers); $this->test_var($cookie, $this->cookie); $this->test_var($user_agent, $this->user_agent); /* cURL Setup ---------------------------------- */ curl_setopt($this->handler, CURLOPT_URL, $url); curl_setopt($this->handler, CURLOPT_HEADER, $headers); curl_setopt($this->handler, CURLOPT_RETURNTRANSFER, true); curl_setopt($this->handler, CURLOPT_FOLLOWLOCATION, true); curl_setopt($this->handler, CURLOPT_AUTOREFERER, true); curl_setopt($this->handler, CURLOPT_POST, true); if (is_string($post)) curl_setopt($this->handler, CURLOPT_POSTFIELDS, $post); if ($port !== false) curl_setopt($this->handler, CURLOPT_PORT, $port); if ($user_agent !== false) curl_setopt($this->handler, CURLOPT_USERAGENT, $this->user_agent); if (is_file($cookie)) { curl_setopt($this->handler, CURLOPT_COOKIE, $cookie); curl_setopt($this->handler, CURLOPT_COOKIEJAR, $cookie); curl_setopt($this->handler, CURLOPT_COOKIEFILE, $cookie); } /* Preparation of post request ---------------------------------- */ if (is_array($post)) { $string = ''; foreach ($post as $key => $value) $string .= "$key=$value&"; curl_setopt($this->handler, CURLOPT_POSTFIELDS, $string); } else { curl_setopt($this->handler, CURLOPT_POSTFIELDS, $post); } /* Execution ---------------------------------- */ if ($headers) return array("headers" => curl_exec($this->handler), "content" => curl_exec($this->handler)); else return curl_exec($this->handler); } /** * Send a post request and retrieve the content with HTTP authentication * * @param string/array $post : Post request * @param string $url : URL of the page * @param int $port : Port used to get the page * @param string $login : HTTP login * @param string $password : HTTP password * @param boolean $headers : set it to true if you want headers in the answer * @param string $cookie : path to the cookie file if you want to use the object like a web browser * @param string $user_agent : if you need to look like a web browser * @return string/array */ public function http_auth_post_request($post, $url = false, $port = false, $login = false, $password = false, $headers = false, $cookie = false, $user_agent = false) { /* Init ---------------------------------- */ $this->test_var($url, $this->url); $this->test_var($port, $this->port); $this->test_var($login, $this->login); $this->test_var($password, $this->password); $this->test_var($headers, $this->headers); $this->test_var($cookie, $this->cookie); $this->test_var($user_agent, $this->user_agent); /* cURL Setup ---------------------------------- */ curl_setopt($this->handler, CURLOPT_URL, $url); curl_setopt($this->handler, CURLOPT_HEADER, $headers); curl_setopt($this->handler, CURLOPT_RETURNTRANSFER, true); curl_setopt($this->handler, CURLOPT_FOLLOWLOCATION, true); curl_setopt($this->handler, CURLOPT_AUTOREFERER, true); curl_setopt($this->handler, CURLOPT_HTTPAUTH, CURLAUTH_BASIC); curl_setopt($this->handler, CURLOPT_USERPWD, "$login:$password"); curl_setopt($this->handler, CURLOPT_POST, true); if (is_string($post)) curl_setopt($this->handler, CURLOPT_POSTFIELDS, $post); if ($user_agent !== false) curl_setopt($this->handler, CURLOPT_USERAGENT, $this->user_agent); if (is_file($cookie)) { curl_setopt($this->handler, CURLOPT_COOKIE, $cookie); curl_setopt($this->handler, CURLOPT_COOKIEJAR, $cookie); curl_setopt($this->handler, CURLOPT_COOKIEFILE, $cookie); } /* Preparation of post request ---------------------------------- */ if (is_array($post)) { $string = ''; foreach ($post as $key => $value) $string .= "$key=$value&"; curl_setopt($this->handler, CURLOPT_POSTFIELDS, $string); } else { curl_setopt($this->handler, CURLOPT_POSTFIELDS, $post); } /* Execution ---------------------------------- */ if ($headers) return array("headers" => curl_exec($this->handler), "content" => curl_exec($this->handler)); else return curl_exec($this->handler); } /** * Upload a file to a ftp * * @param string $path : path to the file to upload * @param string $url : url of the ftp with the path where to upload * @param int $port : Port used to get the page * @param string $login : FTP login * @param string $password : FTP password * @return boolean */ public function ftp_upload($path, $url = false, $port = false, $login = false, $password = false) { /* Init ---------------------------------- */ $this->test_var($url, $this->url); $this->test_var($port, $this->port); $this->test_var($login, $this->login); $this->test_var($password, $this->password); /* Checkpoint ---------------------------------- */ if (is_file($path)) { if (!$fhandler = fopen($path, 'r')); return false; } else { return false; } /* Var updates if needed ---------------------------------- */ $file = pathinfo($path); if (!preg_match("#^(ftp:\/\/)#i", $url)) $url = "ftp://".$url; if ($login !== false && $password !== false) if (!preg_match("#ftp:\/\/([[:alnum:]-\._])+:([[:alnum:]-\._])+@(.*)#i", $url)) $url = preg_replace("#(ftp:\/\/)(.*)#i", "\\1$login:$password@\\2", $url); if (!preg_match("#(\/)^#i", $url)) $url .= "/".$file['basename']; else $url .= $file['basename']; /* cURL Setup ---------------------------------- */ curl_setopt($this->handler, CURLOPT_URL, $url); curl_setopt($this->handler, CURLOPT_UPLOAD, true); curl_setopt($this->handler, CURLOPT_INFILE, $fhandler); curl_setopt($this->handler, CURLOPT_INFILESIZE, filesize($path)); if ($port !== false) curl_setopt($this->handler, CURLOPT_PORT, $port); /* Execution ---------------------------------- */ return curl_exec($this->handler); } /** * Download a file from a FTP * * @param string $path : path where to ulpoad * @param string $url : url of the ftp with the path of the file to download * @param int $port : Port used to get the page * @param string $login : FTP login * @param string $password : FTP password * @return boolean */ public function ftp_download($path, $url = false, $port = false, $login = false, $password = false) { /* Init ---------------------------------- */ $this->test_var($url, $this->url); $this->test_var($port, $this->port); $this->test_var($login, $this->login); $this->test_var($password, $this->password); /* Var updates if needed ---------------------------------- */ if (!preg_match("#^(ftp:\/\/)#i", $url)) $url = "ftp://".$url; if ($login !== false && $password !== false) if (!preg_match("#ftp:\/\/([[:alnum:]-\._])+:([[:alnum:]-\._])+@(.*)#i", $url)) $url = preg_replace("#(ftp:\/\/)(.*)#i", "\\1$login:$password@\\2", $url); /* cURL Setup ---------------------------------- */ curl_setopt($this->handler, CURLOPT_URL, $url); curl_setopt($this->handler, CURLOPT_HEADER, false); curl_setopt($this->handler, CURLOPT_RETURNTRANSFER, true); curl_setopt($this->handler, CURLOPT_FOLLOWLOCATION, true); curl_setopt($this->handler, CURLOPT_AUTOREFERER, true); if ($port !== false) curl_setopt($this->handler, CURLOPT_PORT, $port); /* Execution ---------------------------------- */ $content = curl_exec($this->handler); /* Writing ---------------------------------- */ if($fhandler = fopen($path, 'w+')) if (fwrite($fhandler, $content)) return true; else return false; else return false; } /** * Set a variable to $default parameter if it's false * @param anything $var * @param anything $default */ private function test_var(&$var, $default) { if ($var === false) $var = $default; } }Скачать архивы
php tutorial for beginners in urdu: how to scrap a website using php and curl and DOMDocument class
Сильван Работ
4853