仅供参考, cURL 二次封装的类库 Curl_Manager

cURL是一个可以在命令行下发起http请求的工具,phpl有调用ibcurl的适配器(adapter),所以在php里可以很方便的使用这个工具。

在使用cURL的过程中是否觉得难以使用,选项太多,没有封装,使用不够方便?

为了方便使用,我对php的cURL进行了二次封装,基于组合模式,使用灵活,能满足多数应用场景,经过我长期的实践。

  • 支持 ssl/proxy
  • 支持 cookie,会记录所有请求的cookie并带上(如需获得cookie的值,需要自己解析)
  • 支持常见请求方法get/post/put/delete 等等RESTFul所需要的方法
  • 支持文件上传
  • 支持返回http报文和报头
  • 支持带cookie的follow location(如果使用curl_setopt($this->_ch, CURLOPT_FOLLOWLOCATION, true);cookie并不会自动带上)
  • 解决cURL请求lighttpd会产生417 Expectation Failed错误的问题

实际上Curl_Manager并没有开发到心目中理想的样子,但并不妨碍使用,仅供各位参考:)

测试例子:

Php代码  收藏代码
  1. <?php
  2. require_once(“Curl_Manager.php”);
  3. $manager = new Curl_Manager();
  4. $manager->set_action(‘gg’, ‘http://www.google.com/’, ‘http://willko.iteye.com/’);//设置动作,(动作名称, 动作对应url,来源referer)
  5. $manager->open()->get(‘gg’); //打开一个请求,进行get操作
  6. echo $manager->body(); // 获得报文
  7. echo $manager->header(); // 获得报头(需要自己解析)
  8. //发起ssl请求
  9. $manager->set_action(‘taobao’, ‘https://login.taobao.com/member/login.jhtml?f=top&redirectURL=http://www.taobao.com/’, ‘http://willko.iteye.com/’);
  10. $manager->ssl()->get(‘taobao’); //使用ssl方法,让当前这个请求支持ssl请求
  11. echo $manager->body();
  12. echo $manager->header();

支持cookie:

Php代码  收藏代码
  1. $manager->cookie();

带参数请求,get/post/put/delete等等使用方式一样

Php代码  收藏代码
  1. $manager->post(‘action’, array(‘k’ => ‘v’, ‘a’ => ‘b’));
  2. $manager->post(‘action’, ‘k=v&a=b’);
  3. $manager->post(‘action’, array(‘k’ => ‘v’, ‘@a’ => ‘/home/www/avatar.gif’)); //上传,需要使用绝对路径,参数名称加”@”。

Curl_Manager代码,也可以从附件下载:

Php代码  收藏代码
  1. <?php
  2. // +———————————————————————-+
  3. // | Copyright (c) 2008-2010 Willko Cheng                                 |
  4. // +———————————————————————-+
  5. // | Authors: Willko Cheng <willko@foxmail.com>                           |
  6. // | Blog: http://willko.iteye.com/                                     |
  7. // +———————————————————————-+
  8. class Curl_Manager {
  9.     private $_is_temp_cookie = false;
  10.     private $_header;
  11.     private $_body;
  12.     private $_ch;
  13.     private $_proxy;
  14.     private $_proxy_port;
  15.     private $_proxy_type = ‘HTTP’; // or SOCKS5
  16.     private $_proxy_auth = ‘BASIC’; // or NTLM
  17.     private $_proxy_user;
  18.     private $_proxy_pass;
  19.     protected $_cookie;
  20.     protected $_options;
  21.     protected $_url = array ();
  22.     protected $_referer = array ();
  23.     public function __construct($options = array()) {
  24.         $defaults = array ();
  25.         $defaults [‘timeout’] = 30;
  26.         $defaults [‘temp_root’] = sys_get_temp_dir ();
  27.         $defaults [‘user_agent’] = ‘Mozilla/5.0 (Windows; U; Windows NT 6.0; zh-CN; rv:1.8.1.20) Gecko/20081217 Firefox/2.0.0.20’;
  28.         $this->_options = array_merge ( $defaults, $options );
  29.     }
  30.     public function open() {
  31.         $this->_ch = curl_init ();
  32.         //curl_setopt($this->_ch, CURLOPT_FOLLOWLOCATION, true);
  33.         curl_setopt ( $this->_ch, CURLOPT_HEADER, true );
  34.         curl_setopt ( $this->_ch, CURLOPT_RETURNTRANSFER, true );
  35.         curl_setopt ( $this->_ch, CURLOPT_USERAGENT, $this->_options [‘user_agent’] );
  36.         curl_setopt ( $this->_ch, CURLOPT_CONNECTTIMEOUT, $this->_options [‘timeout’] );
  37.         curl_setopt ( $this->_ch, CURLOPT_HTTPHEADER, array(‘Expect:’) ); // for lighttpd 417 Expectation Failed
  38.         $this->_header = ”;
  39.         $this->_body = ”;
  40.         return $this;
  41.     }
  42.     public function close() {
  43.         if (is_resource ( $this->_ch )) {
  44.             curl_close ( $this->_ch );
  45.         }
  46.         if (isset ( $this->_cookie ) && $this->_is_temp_cookie && is_file ( $this->_cookie )) {
  47.             unlink ( $this->_cookie );
  48.         }
  49.     }
  50.     public function cookie() {
  51.         if (! isset ( $this->_cookie )) {
  52.             if (! emptyempty ( $this->_cookie ) && $this->_is_temp_cookie && is_file ( $this->_cookie )) {
  53.                 unlink ( $this->_cookie );
  54.             }
  55.             $this->_cookie = tempnam ( $this->_options [‘temp_root’], ‘curl_manager_cookie_’ );
  56.             $this->_is_temp_cookie = true;
  57.         }
  58.         curl_setopt ( $this->_ch, CURLOPT_COOKIEJAR, $this->_cookie );
  59.         curl_setopt ( $this->_ch, CURLOPT_COOKIEFILE, $this->_cookie );
  60.         return $this;
  61.     }
  62.     public function ssl() {
  63.         curl_setopt ( $this->_ch, CURLOPT_SSL_VERIFYPEER, false );
  64.         return $this;
  65.     }
  66.     public function proxy($host = null, $port = null, $type = null, $user = null, $pass = null, $auth = null) {
  67.         $this->_proxy = isset ( $host ) ? $host : $this->_proxy;
  68.         $this->_proxy_port = isset ( $port ) ? $port : $this->_proxy_port;
  69.         $this->_proxy_type = isset ( $type ) ? $type : $this->_proxy_type;
  70.         $this->_proxy_auth = isset ( $auth ) ? $auth : $this->_proxy_auth;
  71.         $this->_proxy_user = isset ( $user ) ? $user : $this->_proxy_user;
  72.         $this->_proxy_pass = isset ( $pass ) ? $pass : $this->_proxy_pass;
  73.         if (! emptyempty ( $this->_proxy )) {
  74.             curl_setopt ( $this->_ch, CURLOPT_PROXYTYPE, $this->_proxy_type == ‘HTTP’ ? CURLPROXY_HTTP : CURLPROXY_SOCKS5 );
  75.             curl_setopt ( $this->_ch, CURLOPT_PROXY, $this->_proxy );
  76.             curl_setopt ( $this->_ch, CURLOPT_PROXYPORT, $this->_proxy_port );
  77.         }
  78.         if (! emptyempty ( $this->_proxy_user )) {
  79.             curl_setopt ( $this->_ch, CURLOPT_PROXYAUTH, $this->_proxy_auth == ‘BASIC’ ? CURLAUTH_BASIC : CURLAUTH_NTLM );
  80.             curl_setopt ( $this->_ch, CURLOPT_PROXYUSERPWD, “[{$this->_proxy_user}]:[{$this->_proxy_pass}]” );
  81.         }
  82.         return $this;
  83.     }
  84.     public function post($action, $query = array()) {
  85.         if (is_array($query)) {
  86.             foreach ($query as $key => $val) {
  87.                 if ($val{0} != ‘@’) {
  88.                     $encode_key = urlencode($key);
  89.                     if ($encode_key != $key) {
  90.                         unset($query[$key]);
  91.                     }
  92.                     $query[$encode_key] = urlencode($val);
  93.                 }
  94.             }
  95.         }
  96.         curl_setopt ( $this->_ch, CURLOPT_POST, true );
  97.         curl_setopt ( $this->_ch, CURLOPT_URL, $this->_url [$action] );
  98.         curl_setopt ( $this->_ch, CURLOPT_REFERER, $this->_referer [$action] );
  99.         curl_setopt ( $this->_ch, CURLOPT_POSTFIELDS, $query );
  100.         $this->_requrest ();
  101.         return $this;
  102.     }
  103.     public function get($action, $query = array()) {
  104.         $url = $this->_url [$action];
  105.         if (! emptyempty ( $query )) {
  106.             $url .= strpos ( $url, ‘?’ ) === false ? ‘?’ : ‘&’;
  107.             $url .= is_array ( $query ) ? http_build_query ( $query ) : $query;
  108.         }
  109.         curl_setopt ( $this->_ch, CURLOPT_URL, $url );
  110.         curl_setopt ( $this->_ch, CURLOPT_REFERER, $this->_referer [$action] );
  111.         $this->_requrest ();
  112.         return $this;
  113.     }
  114.     public function put($action, $query = array()) {
  115.         curl_setopt ( $this->_ch, CURLOPT_CUSTOMREQUEST, ‘PUT’ );
  116.         return $this->post ( $action, $query );
  117.     }
  118.     public function delete($action, $query = array()) {
  119.         curl_setopt ( $this->_ch, CURLOPT_CUSTOMREQUEST, ‘DELETE’ );
  120.         return $this->post ( $action, $query );
  121.     }
  122.     public function head($action, $query = array()) {
  123.         curl_setopt ( $this->_ch, CURLOPT_CUSTOMREQUEST, ‘HEAD’ );
  124.         return $this->post ( $action, $query );
  125.     }
  126.     public function options($action, $query = array()) {
  127.         curl_setopt ( $this->_ch, CURLOPT_CUSTOMREQUEST, ‘OPTIONS’ );
  128.         return $this->post ( $action, $query );
  129.     }
  130.     public function trace($action, $query = array()) {
  131.         curl_setopt ( $this->_ch, CURLOPT_CUSTOMREQUEST, ‘TRACE’ );
  132.         return $this->post ( $action, $query );
  133.     }
  134.     public function connect() {
  135.     }
  136.     public function follow_location() {
  137.         preg_match ( ‘#Location:\s*(.+)#i’, $this->header (), $match );
  138.         if (isset ( $match [1] )) {
  139.             $this->set_action ( ‘auto_location_gateway’, $match [1], $this->effective_url () );
  140.             $this->get ( ‘auto_location_gateway’ )->follow_location ();
  141.         }
  142.         return $this;
  143.     }
  144.     public function set_action($action, $url, $referer = ”) {
  145.         $this->_url [$action] = $url;
  146.         $this->_referer [$action] = $referer;
  147.         return $this;
  148.     }
  149.     public function header() {
  150.         return $this->_header;
  151.     }
  152.     public function body() {
  153.         return $this->_body;
  154.     }
  155.     public function effective_url() {
  156.         return curl_getinfo ( $this->_ch, CURLINFO_EFFECTIVE_URL );
  157.     }
  158.     public function http_code() {
  159.         return curl_getinfo($this->_ch, CURLINFO_HTTP_CODE);
  160.     }
  161.     private function _requrest() {
  162.         $response = curl_exec ( $this->_ch );
  163.         $errno = curl_errno ( $this->_ch );
  164.         if ($errno > 0) {
  165.             throw new Curl_Manager_Exception ( curl_error ( $this->_ch ), $errno );
  166.         }
  167.         $header_size = curl_getinfo ( $this->_ch, CURLINFO_HEADER_SIZE );
  168.         $this->_header = substr ( $response, 0, $header_size );
  169.         $this->_body = substr ( $response, $header_size );
  170.     }
  171.     public function __destruct() {
  172.         $this->close ();
  173.     }
  174. }
  175. class Curl_Manager_Exception extends Exception {
  176. }

Leave a Reply

Your email address will not be published. Required fields are marked *