--- /dev/null
+<?php\r
+/**\r
+ * Class for performing HTTP requests\r
+ *\r
+ * PHP versions 4 and 5\r
+ *\r
+ * LICENSE:\r
+ *\r
+ * Copyright (c) 2002-2007, Richard Heyes\r
+ * All rights reserved.\r
+ *\r
+ * Redistribution and use in source and binary forms, with or without\r
+ * modification, are permitted provided that the following conditions\r
+ * are met:\r
+ *\r
+ * o Redistributions of source code must retain the above copyright\r
+ * notice, this list of conditions and the following disclaimer.\r
+ * o Redistributions in binary form must reproduce the above copyright\r
+ * notice, this list of conditions and the following disclaimer in the\r
+ * documentation and/or other materials provided with the distribution.\r
+ * o The names of the authors may not be used to endorse or promote\r
+ * products derived from this software without specific prior written\r
+ * permission.\r
+ *\r
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS\r
+ * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT\r
+ * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR\r
+ * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT\r
+ * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,\r
+ * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT\r
+ * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,\r
+ * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY\r
+ * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT\r
+ * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE\r
+ * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.\r
+ *\r
+ * @category HTTP\r
+ * @package HTTP_Request\r
+ * @author Richard Heyes <richard@phpguru.org>\r
+ * @author Alexey Borzov <avb@php.net>\r
+ * @copyright 2002-2007 Richard Heyes\r
+ * @license http://opensource.org/licenses/bsd-license.php New BSD License\r
+ * @version CVS: $Id: Request.php,v 1.63 2008/10/11 11:07:10 avb Exp $\r
+ * @link http://pear.php.net/package/HTTP_Request/\r
+ */\r
+\r
+/**\r
+ * PEAR and PEAR_Error classes (for error handling)\r
+ */\r
+require_once 'PEAR.php';\r
+/**\r
+ * Socket class\r
+ */\r
+require_once 'Net/Socket.php';\r
+/**\r
+ * URL handling class\r
+ */\r
+require_once 'Net/URL.php';\r
+\r
+/**#@+\r
+ * Constants for HTTP request methods\r
+ */\r
+define('HTTP_REQUEST_METHOD_GET', 'GET', true);\r
+define('HTTP_REQUEST_METHOD_HEAD', 'HEAD', true);\r
+define('HTTP_REQUEST_METHOD_POST', 'POST', true);\r
+define('HTTP_REQUEST_METHOD_PUT', 'PUT', true);\r
+define('HTTP_REQUEST_METHOD_DELETE', 'DELETE', true);\r
+define('HTTP_REQUEST_METHOD_OPTIONS', 'OPTIONS', true);\r
+define('HTTP_REQUEST_METHOD_TRACE', 'TRACE', true);\r
+/**#@-*/\r
+\r
+/**#@+\r
+ * Constants for HTTP request error codes\r
+ */\r
+define('HTTP_REQUEST_ERROR_FILE', 1);\r
+define('HTTP_REQUEST_ERROR_URL', 2);\r
+define('HTTP_REQUEST_ERROR_PROXY', 4);\r
+define('HTTP_REQUEST_ERROR_REDIRECTS', 8);\r
+define('HTTP_REQUEST_ERROR_RESPONSE', 16);\r
+define('HTTP_REQUEST_ERROR_GZIP_METHOD', 32);\r
+define('HTTP_REQUEST_ERROR_GZIP_READ', 64);\r
+define('HTTP_REQUEST_ERROR_GZIP_DATA', 128);\r
+define('HTTP_REQUEST_ERROR_GZIP_CRC', 256);\r
+/**#@-*/\r
+\r
+/**#@+\r
+ * Constants for HTTP protocol versions\r
+ */\r
+define('HTTP_REQUEST_HTTP_VER_1_0', '1.0', true);\r
+define('HTTP_REQUEST_HTTP_VER_1_1', '1.1', true);\r
+/**#@-*/\r
+\r
+if (extension_loaded('mbstring') && (2 & ini_get('mbstring.func_overload'))) {\r
+ /**\r
+ * Whether string functions are overloaded by their mbstring equivalents\r
+ */\r
+ define('HTTP_REQUEST_MBSTRING', true);\r
+} else {\r
+ /**\r
+ * @ignore\r
+ */\r
+ define('HTTP_REQUEST_MBSTRING', false);\r
+}\r
+\r
+/**\r
+ * Class for performing HTTP requests\r
+ *\r
+ * Simple example (fetches yahoo.com and displays it):\r
+ * <code>\r
+ * $a = &new HTTP_Request('http://www.yahoo.com/');\r
+ * $a->sendRequest();\r
+ * echo $a->getResponseBody();\r
+ * </code>\r
+ *\r
+ * @category HTTP\r
+ * @package HTTP_Request\r
+ * @author Richard Heyes <richard@phpguru.org>\r
+ * @author Alexey Borzov <avb@php.net>\r
+ * @version Release: 1.4.4\r
+ */\r
+class HTTP_Request\r
+{\r
+ /**#@+\r
+ * @access private\r
+ */\r
+ /**\r
+ * Instance of Net_URL\r
+ * @var Net_URL\r
+ */\r
+ var $_url;\r
+\r
+ /**\r
+ * Type of request\r
+ * @var string\r
+ */\r
+ var $_method;\r
+\r
+ /**\r
+ * HTTP Version\r
+ * @var string\r
+ */\r
+ var $_http;\r
+\r
+ /**\r
+ * Request headers\r
+ * @var array\r
+ */\r
+ var $_requestHeaders;\r
+\r
+ /**\r
+ * Basic Auth Username\r
+ * @var string\r
+ */\r
+ var $_user;\r
+\r
+ /**\r
+ * Basic Auth Password\r
+ * @var string\r
+ */\r
+ var $_pass;\r
+\r
+ /**\r
+ * Socket object\r
+ * @var Net_Socket\r
+ */\r
+ var $_sock;\r
+\r
+ /**\r
+ * Proxy server\r
+ * @var string\r
+ */\r
+ var $_proxy_host;\r
+\r
+ /**\r
+ * Proxy port\r
+ * @var integer\r
+ */\r
+ var $_proxy_port;\r
+\r
+ /**\r
+ * Proxy username\r
+ * @var string\r
+ */\r
+ var $_proxy_user;\r
+\r
+ /**\r
+ * Proxy password\r
+ * @var string\r
+ */\r
+ var $_proxy_pass;\r
+\r
+ /**\r
+ * Post data\r
+ * @var array\r
+ */\r
+ var $_postData;\r
+\r
+ /**\r
+ * Request body\r
+ * @var string\r
+ */\r
+ var $_body;\r
+\r
+ /**\r
+ * A list of methods that MUST NOT have a request body, per RFC 2616\r
+ * @var array\r
+ */\r
+ var $_bodyDisallowed = array('TRACE');\r
+\r
+ /**\r
+ * Methods having defined semantics for request body\r
+ *\r
+ * Content-Length header (indicating that the body follows, section 4.3 of\r
+ * RFC 2616) will be sent for these methods even if no body was added\r
+ *\r
+ * @var array\r
+ */\r
+ var $_bodyRequired = array('POST', 'PUT');\r
+\r
+ /**\r
+ * Files to post\r
+ * @var array\r
+ */\r
+ var $_postFiles = array();\r
+\r
+ /**\r
+ * Connection timeout.\r
+ * @var float\r
+ */\r
+ var $_timeout;\r
+\r
+ /**\r
+ * HTTP_Response object\r
+ * @var HTTP_Response\r
+ */\r
+ var $_response;\r
+\r
+ /**\r
+ * Whether to allow redirects\r
+ * @var boolean\r
+ */\r
+ var $_allowRedirects;\r
+\r
+ /**\r
+ * Maximum redirects allowed\r
+ * @var integer\r
+ */\r
+ var $_maxRedirects;\r
+\r
+ /**\r
+ * Current number of redirects\r
+ * @var integer\r
+ */\r
+ var $_redirects;\r
+\r
+ /**\r
+ * Whether to append brackets [] to array variables\r
+ * @var bool\r
+ */\r
+ var $_useBrackets = true;\r
+\r
+ /**\r
+ * Attached listeners\r
+ * @var array\r
+ */\r
+ var $_listeners = array();\r
+\r
+ /**\r
+ * Whether to save response body in response object property\r
+ * @var bool\r
+ */\r
+ var $_saveBody = true;\r
+\r
+ /**\r
+ * Timeout for reading from socket (array(seconds, microseconds))\r
+ * @var array\r
+ */\r
+ var $_readTimeout = null;\r
+\r
+ /**\r
+ * Options to pass to Net_Socket::connect. See stream_context_create\r
+ * @var array\r
+ */\r
+ var $_socketOptions = null;\r
+ /**#@-*/\r
+\r
+ /**\r
+ * Constructor\r
+ *\r
+ * Sets up the object\r
+ * @param string The url to fetch/access\r
+ * @param array Associative array of parameters which can have the following keys:\r
+ * <ul>\r
+ * <li>method - Method to use, GET, POST etc (string)</li>\r
+ * <li>http - HTTP Version to use, 1.0 or 1.1 (string)</li>\r
+ * <li>user - Basic Auth username (string)</li>\r
+ * <li>pass - Basic Auth password (string)</li>\r
+ * <li>proxy_host - Proxy server host (string)</li>\r
+ * <li>proxy_port - Proxy server port (integer)</li>\r
+ * <li>proxy_user - Proxy auth username (string)</li>\r
+ * <li>proxy_pass - Proxy auth password (string)</li>\r
+ * <li>timeout - Connection timeout in seconds (float)</li>\r
+ * <li>allowRedirects - Whether to follow redirects or not (bool)</li>\r
+ * <li>maxRedirects - Max number of redirects to follow (integer)</li>\r
+ * <li>useBrackets - Whether to append [] to array variable names (bool)</li>\r
+ * <li>saveBody - Whether to save response body in response object property (bool)</li>\r
+ * <li>readTimeout - Timeout for reading / writing data over the socket (array (seconds, microseconds))</li>\r
+ * <li>socketOptions - Options to pass to Net_Socket object (array)</li>\r
+ * </ul>\r
+ * @access public\r
+ */\r
+ function HTTP_Request($url = '', $params = array())\r
+ {\r
+ $this->_method = HTTP_REQUEST_METHOD_GET;\r
+ $this->_http = HTTP_REQUEST_HTTP_VER_1_1;\r
+ $this->_requestHeaders = array();\r
+ $this->_postData = array();\r
+ $this->_body = null;\r
+\r
+ $this->_user = null;\r
+ $this->_pass = null;\r
+\r
+ $this->_proxy_host = null;\r
+ $this->_proxy_port = null;\r
+ $this->_proxy_user = null;\r
+ $this->_proxy_pass = null;\r
+\r
+ $this->_allowRedirects = false;\r
+ $this->_maxRedirects = 3;\r
+ $this->_redirects = 0;\r
+\r
+ $this->_timeout = null;\r
+ $this->_response = null;\r
+\r
+ foreach ($params as $key => $value) {\r
+ $this->{'_' . $key} = $value;\r
+ }\r
+\r
+ if (!empty($url)) {\r
+ $this->setURL($url);\r
+ }\r
+\r
+ // Default useragent\r
+ $this->addHeader('User-Agent', 'PEAR HTTP_Request class ( http://pear.php.net/ )');\r
+\r
+ // We don't do keep-alives by default\r
+ $this->addHeader('Connection', 'close');\r
+\r
+ // Basic authentication\r
+ if (!empty($this->_user)) {\r
+ $this->addHeader('Authorization', 'Basic ' . base64_encode($this->_user . ':' . $this->_pass));\r
+ }\r
+\r
+ // Proxy authentication (see bug #5913)\r
+ if (!empty($this->_proxy_user)) {\r
+ $this->addHeader('Proxy-Authorization', 'Basic ' . base64_encode($this->_proxy_user . ':' . $this->_proxy_pass));\r
+ }\r
+\r
+ // Use gzip encoding if possible\r
+ if (HTTP_REQUEST_HTTP_VER_1_1 == $this->_http && extension_loaded('zlib')) {\r
+ $this->addHeader('Accept-Encoding', 'gzip');\r
+ }\r
+ }\r
+\r
+ /**\r
+ * Generates a Host header for HTTP/1.1 requests\r
+ *\r
+ * @access private\r
+ * @return string\r
+ */\r
+ function _generateHostHeader()\r
+ {\r
+ if ($this->_url->port != 80 AND strcasecmp($this->_url->protocol, 'http') == 0) {\r
+ $host = $this->_url->host . ':' . $this->_url->port;\r
+\r
+ } elseif ($this->_url->port != 443 AND strcasecmp($this->_url->protocol, 'https') == 0) {\r
+ $host = $this->_url->host . ':' . $this->_url->port;\r
+\r
+ } elseif ($this->_url->port == 443 AND strcasecmp($this->_url->protocol, 'https') == 0 AND strpos($this->_url->url, ':443') !== false) {\r
+ $host = $this->_url->host . ':' . $this->_url->port;\r
+\r
+ } else {\r
+ $host = $this->_url->host;\r
+ }\r
+\r
+ return $host;\r
+ }\r
+\r
+ /**\r
+ * Resets the object to its initial state (DEPRECATED).\r
+ * Takes the same parameters as the constructor.\r
+ *\r
+ * @param string $url The url to be requested\r
+ * @param array $params Associative array of parameters\r
+ * (see constructor for details)\r
+ * @access public\r
+ * @deprecated deprecated since 1.2, call the constructor if this is necessary\r
+ */\r
+ function reset($url, $params = array())\r
+ {\r
+ $this->HTTP_Request($url, $params);\r
+ }\r
+\r
+ /**\r
+ * Sets the URL to be requested\r
+ *\r
+ * @param string The url to be requested\r
+ * @access public\r
+ */\r
+ function setURL($url)\r
+ {\r
+ $this->_url = &new Net_URL($url, $this->_useBrackets);\r
+\r
+ if (!empty($this->_url->user) || !empty($this->_url->pass)) {\r
+ $this->setBasicAuth($this->_url->user, $this->_url->pass);\r
+ }\r
+\r
+ if (HTTP_REQUEST_HTTP_VER_1_1 == $this->_http) {\r
+ $this->addHeader('Host', $this->_generateHostHeader());\r
+ }\r
+\r
+ // set '/' instead of empty path rather than check later (see bug #8662)\r
+ if (empty($this->_url->path)) {\r
+ $this->_url->path = '/';\r
+ }\r
+ }\r
+\r
+ /**\r
+ * Returns the current request URL\r
+ *\r
+ * @return string Current request URL\r
+ * @access public\r
+ */\r
+ function getUrl()\r
+ {\r
+ return empty($this->_url)? '': $this->_url->getUrl();\r
+ }\r
+\r
+ /**\r
+ * Sets a proxy to be used\r
+ *\r
+ * @param string Proxy host\r
+ * @param int Proxy port\r
+ * @param string Proxy username\r
+ * @param string Proxy password\r
+ * @access public\r
+ */\r
+ function setProxy($host, $port = 8080, $user = null, $pass = null)\r
+ {\r
+ $this->_proxy_host = $host;\r
+ $this->_proxy_port = $port;\r
+ $this->_proxy_user = $user;\r
+ $this->_proxy_pass = $pass;\r
+\r
+ if (!empty($user)) {\r
+ $this->addHeader('Proxy-Authorization', 'Basic ' . base64_encode($user . ':' . $pass));\r
+ }\r
+ }\r
+\r
+ /**\r
+ * Sets basic authentication parameters\r
+ *\r
+ * @param string Username\r
+ * @param string Password\r
+ */\r
+ function setBasicAuth($user, $pass)\r
+ {\r
+ $this->_user = $user;\r
+ $this->_pass = $pass;\r
+\r
+ $this->addHeader('Authorization', 'Basic ' . base64_encode($user . ':' . $pass));\r
+ }\r
+\r
+ /**\r
+ * Sets the method to be used, GET, POST etc.\r
+ *\r
+ * @param string Method to use. Use the defined constants for this\r
+ * @access public\r
+ */\r
+ function setMethod($method)\r
+ {\r
+ $this->_method = $method;\r
+ }\r
+\r
+ /**\r
+ * Sets the HTTP version to use, 1.0 or 1.1\r
+ *\r
+ * @param string Version to use. Use the defined constants for this\r
+ * @access public\r
+ */\r
+ function setHttpVer($http)\r
+ {\r
+ $this->_http = $http;\r
+ }\r
+\r
+ /**\r
+ * Adds a request header\r
+ *\r
+ * @param string Header name\r
+ * @param string Header value\r
+ * @access public\r
+ */\r
+ function addHeader($name, $value)\r
+ {\r
+ $this->_requestHeaders[strtolower($name)] = $value;\r
+ }\r
+\r
+ /**\r
+ * Removes a request header\r
+ *\r
+ * @param string Header name to remove\r
+ * @access public\r
+ */\r
+ function removeHeader($name)\r
+ {\r
+ if (isset($this->_requestHeaders[strtolower($name)])) {\r
+ unset($this->_requestHeaders[strtolower($name)]);\r
+ }\r
+ }\r
+\r
+ /**\r
+ * Adds a querystring parameter\r
+ *\r
+ * @param string Querystring parameter name\r
+ * @param string Querystring parameter value\r
+ * @param bool Whether the value is already urlencoded or not, default = not\r
+ * @access public\r
+ */\r
+ function addQueryString($name, $value, $preencoded = false)\r
+ {\r
+ $this->_url->addQueryString($name, $value, $preencoded);\r
+ }\r
+\r
+ /**\r
+ * Sets the querystring to literally what you supply\r
+ *\r
+ * @param string The querystring data. Should be of the format foo=bar&x=y etc\r
+ * @param bool Whether data is already urlencoded or not, default = already encoded\r
+ * @access public\r
+ */\r
+ function addRawQueryString($querystring, $preencoded = true)\r
+ {\r
+ $this->_url->addRawQueryString($querystring, $preencoded);\r
+ }\r
+\r
+ /**\r
+ * Adds postdata items\r
+ *\r
+ * @param string Post data name\r
+ * @param string Post data value\r
+ * @param bool Whether data is already urlencoded or not, default = not\r
+ * @access public\r
+ */\r
+ function addPostData($name, $value, $preencoded = false)\r
+ {\r
+ if ($preencoded) {\r
+ $this->_postData[$name] = $value;\r
+ } else {\r
+ $this->_postData[$name] = $this->_arrayMapRecursive('urlencode', $value);\r
+ }\r
+ }\r
+\r
+ /**\r
+ * Recursively applies the callback function to the value\r
+ *\r
+ * @param mixed Callback function\r
+ * @param mixed Value to process\r
+ * @access private\r
+ * @return mixed Processed value\r
+ */\r
+ function _arrayMapRecursive($callback, $value)\r
+ {\r
+ if (!is_array($value)) {\r
+ return call_user_func($callback, $value);\r
+ } else {\r
+ $map = array();\r
+ foreach ($value as $k => $v) {\r
+ $map[$k] = $this->_arrayMapRecursive($callback, $v);\r
+ }\r
+ return $map;\r
+ }\r
+ }\r
+\r
+ /**\r
+ * Adds a file to form-based file upload\r
+ *\r
+ * Used to emulate file upload via a HTML form. The method also sets\r
+ * Content-Type of HTTP request to 'multipart/form-data'.\r
+ *\r
+ * If you just want to send the contents of a file as the body of HTTP\r
+ * request you should use setBody() method.\r
+ *\r
+ * @access public\r
+ * @param string name of file-upload field\r
+ * @param mixed file name(s)\r
+ * @param mixed content-type(s) of file(s) being uploaded\r
+ * @return bool true on success\r
+ * @throws PEAR_Error\r
+ */\r
+ function addFile($inputName, $fileName, $contentType = 'application/octet-stream')\r
+ {\r
+ if (!is_array($fileName) && !is_readable($fileName)) {\r
+ return PEAR::raiseError("File '{$fileName}' is not readable", HTTP_REQUEST_ERROR_FILE);\r
+ } elseif (is_array($fileName)) {\r
+ foreach ($fileName as $name) {\r
+ if (!is_readable($name)) {\r
+ return PEAR::raiseError("File '{$name}' is not readable", HTTP_REQUEST_ERROR_FILE);\r
+ }\r
+ }\r
+ }\r
+ $this->addHeader('Content-Type', 'multipart/form-data');\r
+ $this->_postFiles[$inputName] = array(\r
+ 'name' => $fileName,\r
+ 'type' => $contentType\r
+ );\r
+ return true;\r
+ }\r
+\r
+ /**\r
+ * Adds raw postdata (DEPRECATED)\r
+ *\r
+ * @param string The data\r
+ * @param bool Whether data is preencoded or not, default = already encoded\r
+ * @access public\r
+ * @deprecated deprecated since 1.3.0, method setBody() should be used instead\r
+ */\r
+ function addRawPostData($postdata, $preencoded = true)\r
+ {\r
+ $this->_body = $preencoded ? $postdata : urlencode($postdata);\r
+ }\r
+\r
+ /**\r
+ * Sets the request body (for POST, PUT and similar requests)\r
+ *\r
+ * @param string Request body\r
+ * @access public\r
+ */\r
+ function setBody($body)\r
+ {\r
+ $this->_body = $body;\r
+ }\r
+\r
+ /**\r
+ * Clears any postdata that has been added (DEPRECATED).\r
+ *\r
+ * Useful for multiple request scenarios.\r
+ *\r
+ * @access public\r
+ * @deprecated deprecated since 1.2\r
+ */\r
+ function clearPostData()\r
+ {\r
+ $this->_postData = null;\r
+ }\r
+\r
+ /**\r
+ * Appends a cookie to "Cookie:" header\r
+ *\r
+ * @param string $name cookie name\r
+ * @param string $value cookie value\r
+ * @access public\r
+ */\r
+ function addCookie($name, $value)\r
+ {\r
+ $cookies = isset($this->_requestHeaders['cookie']) ? $this->_requestHeaders['cookie']. '; ' : '';\r
+ $this->addHeader('Cookie', $cookies . $name . '=' . $value);\r
+ }\r
+\r
+ /**\r
+ * Clears any cookies that have been added (DEPRECATED).\r
+ *\r
+ * Useful for multiple request scenarios\r
+ *\r
+ * @access public\r
+ * @deprecated deprecated since 1.2\r
+ */\r
+ function clearCookies()\r
+ {\r
+ $this->removeHeader('Cookie');\r
+ }\r
+\r
+ /**\r
+ * Sends the request\r
+ *\r
+ * @access public\r
+ * @param bool Whether to store response body in Response object property,\r
+ * set this to false if downloading a LARGE file and using a Listener\r
+ * @return mixed PEAR error on error, true otherwise\r
+ */\r
+ function sendRequest($saveBody = true)\r
+ {\r
+ if (!is_a($this->_url, 'Net_URL')) {\r
+ return PEAR::raiseError('No URL given', HTTP_REQUEST_ERROR_URL);\r
+ }\r
+\r
+ $host = isset($this->_proxy_host) ? $this->_proxy_host : $this->_url->host;\r
+ $port = isset($this->_proxy_port) ? $this->_proxy_port : $this->_url->port;\r
+\r
+ if (strcasecmp($this->_url->protocol, 'https') == 0) {\r
+ // Bug #14127, don't try connecting to HTTPS sites without OpenSSL\r
+ if (version_compare(PHP_VERSION, '4.3.0', '<') || !extension_loaded('openssl')) {\r
+ return PEAR::raiseError('Need PHP 4.3.0 or later with OpenSSL support for https:// requests',\r
+ HTTP_REQUEST_ERROR_URL);\r
+ } elseif (isset($this->_proxy_host)) {\r
+ return PEAR::raiseError('HTTPS proxies are not supported', HTTP_REQUEST_ERROR_PROXY);\r
+ }\r
+ $host = 'ssl://' . $host;\r
+ }\r
+\r
+ // magic quotes may fuck up file uploads and chunked response processing\r
+ $magicQuotes = ini_get('magic_quotes_runtime');\r
+ ini_set('magic_quotes_runtime', false);\r
+\r
+ // RFC 2068, section 19.7.1: A client MUST NOT send the Keep-Alive\r
+ // connection token to a proxy server...\r
+ if (isset($this->_proxy_host) && !empty($this->_requestHeaders['connection']) &&\r
+ 'Keep-Alive' == $this->_requestHeaders['connection'])\r
+ {\r
+ $this->removeHeader('connection');\r
+ }\r
+\r
+ $keepAlive = (HTTP_REQUEST_HTTP_VER_1_1 == $this->_http && empty($this->_requestHeaders['connection'])) ||\r
+ (!empty($this->_requestHeaders['connection']) && 'Keep-Alive' == $this->_requestHeaders['connection']);\r
+ $sockets = &PEAR::getStaticProperty('HTTP_Request', 'sockets');\r
+ $sockKey = $host . ':' . $port;\r
+ unset($this->_sock);\r
+\r
+ // There is a connected socket in the "static" property?\r
+ if ($keepAlive && !empty($sockets[$sockKey]) &&\r
+ !empty($sockets[$sockKey]->fp))\r
+ {\r
+ $this->_sock =& $sockets[$sockKey];\r
+ $err = null;\r
+ } else {\r
+ $this->_notify('connect');\r
+ $this->_sock =& new Net_Socket();\r
+ $err = $this->_sock->connect($host, $port, null, $this->_timeout, $this->_socketOptions);\r
+ }\r
+ PEAR::isError($err) or $err = $this->_sock->write($this->_buildRequest());\r
+\r
+ if (!PEAR::isError($err)) {\r
+ if (!empty($this->_readTimeout)) {\r
+ $this->_sock->setTimeout($this->_readTimeout[0], $this->_readTimeout[1]);\r
+ }\r
+\r
+ $this->_notify('sentRequest');\r
+\r
+ // Read the response\r
+ $this->_response = &new HTTP_Response($this->_sock, $this->_listeners);\r
+ $err = $this->_response->process(\r
+ $this->_saveBody && $saveBody,\r
+ HTTP_REQUEST_METHOD_HEAD != $this->_method\r
+ );\r
+\r
+ if ($keepAlive) {\r
+ $keepAlive = (isset($this->_response->_headers['content-length'])\r
+ || (isset($this->_response->_headers['transfer-encoding'])\r
+ && strtolower($this->_response->_headers['transfer-encoding']) == 'chunked'));\r
+ if ($keepAlive) {\r
+ if (isset($this->_response->_headers['connection'])) {\r
+ $keepAlive = strtolower($this->_response->_headers['connection']) == 'keep-alive';\r
+ } else {\r
+ $keepAlive = 'HTTP/'.HTTP_REQUEST_HTTP_VER_1_1 == $this->_response->_protocol;\r
+ }\r
+ }\r
+ }\r
+ }\r
+\r
+ ini_set('magic_quotes_runtime', $magicQuotes);\r
+\r
+ if (PEAR::isError($err)) {\r
+ return $err;\r
+ }\r
+\r
+ if (!$keepAlive) {\r
+ $this->disconnect();\r
+ // Store the connected socket in "static" property\r
+ } elseif (empty($sockets[$sockKey]) || empty($sockets[$sockKey]->fp)) {\r
+ $sockets[$sockKey] =& $this->_sock;\r
+ }\r
+\r
+ // Check for redirection\r
+ if ( $this->_allowRedirects\r
+ AND $this->_redirects <= $this->_maxRedirects\r
+ AND $this->getResponseCode() > 300\r
+ AND $this->getResponseCode() < 399\r
+ AND !empty($this->_response->_headers['location'])) {\r
+\r
+\r
+ $redirect = $this->_response->_headers['location'];\r
+\r
+ // Absolute URL\r
+ if (preg_match('/^https?:\/\//i', $redirect)) {\r
+ $this->_url = &new Net_URL($redirect);\r
+ $this->addHeader('Host', $this->_generateHostHeader());\r
+ // Absolute path\r
+ } elseif ($redirect{0} == '/') {\r
+ $this->_url->path = $redirect;\r
+\r
+ // Relative path\r
+ } elseif (substr($redirect, 0, 3) == '../' OR substr($redirect, 0, 2) == './') {\r
+ if (substr($this->_url->path, -1) == '/') {\r
+ $redirect = $this->_url->path . $redirect;\r
+ } else {\r
+ $redirect = dirname($this->_url->path) . '/' . $redirect;\r
+ }\r
+ $redirect = Net_URL::resolvePath($redirect);\r
+ $this->_url->path = $redirect;\r
+\r
+ // Filename, no path\r
+ } else {\r
+ if (substr($this->_url->path, -1) == '/') {\r
+ $redirect = $this->_url->path . $redirect;\r
+ } else {\r
+ $redirect = dirname($this->_url->path) . '/' . $redirect;\r
+ }\r
+ $this->_url->path = $redirect;\r
+ }\r
+\r
+ $this->_redirects++;\r
+ return $this->sendRequest($saveBody);\r
+\r
+ // Too many redirects\r
+ } elseif ($this->_allowRedirects AND $this->_redirects > $this->_maxRedirects) {\r
+ return PEAR::raiseError('Too many redirects', HTTP_REQUEST_ERROR_REDIRECTS);\r
+ }\r
+\r
+ return true;\r
+ }\r
+\r
+ /**\r
+ * Disconnect the socket, if connected. Only useful if using Keep-Alive.\r
+ *\r
+ * @access public\r
+ */\r
+ function disconnect()\r
+ {\r
+ if (!empty($this->_sock) && !empty($this->_sock->fp)) {\r
+ $this->_notify('disconnect');\r
+ $this->_sock->disconnect();\r
+ }\r
+ }\r
+\r
+ /**\r
+ * Returns the response code\r
+ *\r
+ * @access public\r
+ * @return mixed Response code, false if not set\r
+ */\r
+ function getResponseCode()\r
+ {\r
+ return isset($this->_response->_code) ? $this->_response->_code : false;\r
+ }\r
+\r
+ /**\r
+ * Returns the response reason phrase\r
+ *\r
+ * @access public\r
+ * @return mixed Response reason phrase, false if not set\r
+ */\r
+ function getResponseReason()\r
+ {\r
+ return isset($this->_response->_reason) ? $this->_response->_reason : false;\r
+ }\r
+\r
+ /**\r
+ * Returns either the named header or all if no name given\r
+ *\r
+ * @access public\r
+ * @param string The header name to return, do not set to get all headers\r
+ * @return mixed either the value of $headername (false if header is not present)\r
+ * or an array of all headers\r
+ */\r
+ function getResponseHeader($headername = null)\r
+ {\r
+ if (!isset($headername)) {\r
+ return isset($this->_response->_headers)? $this->_response->_headers: array();\r
+ } else {\r
+ $headername = strtolower($headername);\r
+ return isset($this->_response->_headers[$headername]) ? $this->_response->_headers[$headername] : false;\r
+ }\r
+ }\r
+\r
+ /**\r
+ * Returns the body of the response\r
+ *\r
+ * @access public\r
+ * @return mixed response body, false if not set\r
+ */\r
+ function getResponseBody()\r
+ {\r
+ return isset($this->_response->_body) ? $this->_response->_body : false;\r
+ }\r
+\r
+ /**\r
+ * Returns cookies set in response\r
+ *\r
+ * @access public\r
+ * @return mixed array of response cookies, false if none are present\r
+ */\r
+ function getResponseCookies()\r
+ {\r
+ return isset($this->_response->_cookies) ? $this->_response->_cookies : false;\r
+ }\r
+\r
+ /**\r
+ * Builds the request string\r
+ *\r
+ * @access private\r
+ * @return string The request string\r
+ */\r
+ function _buildRequest()\r
+ {\r
+ $separator = ini_get('arg_separator.output');\r
+ ini_set('arg_separator.output', '&');\r
+ $querystring = ($querystring = $this->_url->getQueryString()) ? '?' . $querystring : '';\r
+ ini_set('arg_separator.output', $separator);\r
+\r
+ $host = isset($this->_proxy_host) ? $this->_url->protocol . '://' . $this->_url->host : '';\r
+ $port = (isset($this->_proxy_host) AND $this->_url->port != 80) ? ':' . $this->_url->port : '';\r
+ $path = $this->_url->path . $querystring;\r
+ $url = $host . $port . $path;\r
+\r
+ if (!strlen($url)) {\r
+ $url = '/';\r
+ }\r
+\r
+ $request = $this->_method . ' ' . $url . ' HTTP/' . $this->_http . "\r\n";\r
+\r
+ if (in_array($this->_method, $this->_bodyDisallowed) ||\r
+ (0 == strlen($this->_body) && (HTTP_REQUEST_METHOD_POST != $this->_method ||\r
+ (empty($this->_postData) && empty($this->_postFiles)))))\r
+ {\r
+ $this->removeHeader('Content-Type');\r
+ } else {\r
+ if (empty($this->_requestHeaders['content-type'])) {\r
+ // Add default content-type\r
+ $this->addHeader('Content-Type', 'application/x-www-form-urlencoded');\r
+ } elseif ('multipart/form-data' == $this->_requestHeaders['content-type']) {\r
+ $boundary = 'HTTP_Request_' . md5(uniqid('request') . microtime());\r
+ $this->addHeader('Content-Type', 'multipart/form-data; boundary=' . $boundary);\r
+ }\r
+ }\r
+\r
+ // Request Headers\r
+ if (!empty($this->_requestHeaders)) {\r
+ foreach ($this->_requestHeaders as $name => $value) {\r
+ $canonicalName = implode('-', array_map('ucfirst', explode('-', $name)));\r
+ $request .= $canonicalName . ': ' . $value . "\r\n";\r
+ }\r
+ }\r
+\r
+ // Method does not allow a body, simply add a final CRLF\r
+ if (in_array($this->_method, $this->_bodyDisallowed)) {\r
+\r
+ $request .= "\r\n";\r
+\r
+ // Post data if it's an array\r
+ } elseif (HTTP_REQUEST_METHOD_POST == $this->_method &&\r
+ (!empty($this->_postData) || !empty($this->_postFiles))) {\r
+\r
+ // "normal" POST request\r
+ if (!isset($boundary)) {\r
+ $postdata = implode('&', array_map(\r
+ create_function('$a', 'return $a[0] . \'=\' . $a[1];'),\r
+ $this->_flattenArray('', $this->_postData)\r
+ ));\r
+\r
+ // multipart request, probably with file uploads\r
+ } else {\r
+ $postdata = '';\r
+ if (!empty($this->_postData)) {\r
+ $flatData = $this->_flattenArray('', $this->_postData);\r
+ foreach ($flatData as $item) {\r
+ $postdata .= '--' . $boundary . "\r\n";\r
+ $postdata .= 'Content-Disposition: form-data; name="' . $item[0] . '"';\r
+ $postdata .= "\r\n\r\n" . urldecode($item[1]) . "\r\n";\r
+ }\r
+ }\r
+ foreach ($this->_postFiles as $name => $value) {\r
+ if (is_array($value['name'])) {\r
+ $varname = $name . ($this->_useBrackets? '[]': '');\r
+ } else {\r
+ $varname = $name;\r
+ $value['name'] = array($value['name']);\r
+ }\r
+ foreach ($value['name'] as $key => $filename) {\r
+ $fp = fopen($filename, 'r');\r
+ $basename = basename($filename);\r
+ $type = is_array($value['type'])? @$value['type'][$key]: $value['type'];\r
+\r
+ $postdata .= '--' . $boundary . "\r\n";\r
+ $postdata .= 'Content-Disposition: form-data; name="' . $varname . '"; filename="' . $basename . '"';\r
+ $postdata .= "\r\nContent-Type: " . $type;\r
+ $postdata .= "\r\n\r\n" . fread($fp, filesize($filename)) . "\r\n";\r
+ fclose($fp);\r
+ }\r
+ }\r
+ $postdata .= '--' . $boundary . "--\r\n";\r
+ }\r
+ $request .= 'Content-Length: ' .\r
+ (HTTP_REQUEST_MBSTRING? mb_strlen($postdata, 'iso-8859-1'): strlen($postdata)) .\r
+ "\r\n\r\n";\r
+ $request .= $postdata;\r
+\r
+ // Explicitly set request body\r
+ } elseif (0 < strlen($this->_body)) {\r
+\r
+ $request .= 'Content-Length: ' .\r
+ (HTTP_REQUEST_MBSTRING? mb_strlen($this->_body, 'iso-8859-1'): strlen($this->_body)) .\r
+ "\r\n\r\n";\r
+ $request .= $this->_body;\r
+\r
+ // No body: send a Content-Length header nonetheless (request #12900),\r
+ // but do that only for methods that require a body (bug #14740)\r
+ } else {\r
+\r
+ if (in_array($this->_method, $this->_bodyRequired)) {\r
+ $request .= "Content-Length: 0\r\n";\r
+ }\r
+ $request .= "\r\n";\r
+ }\r
+\r
+ return $request;\r
+ }\r
+\r
+ /**\r
+ * Helper function to change the (probably multidimensional) associative array\r
+ * into the simple one.\r
+ *\r
+ * @param string name for item\r
+ * @param mixed item's values\r
+ * @return array array with the following items: array('item name', 'item value');\r
+ * @access private\r
+ */\r
+ function _flattenArray($name, $values)\r
+ {\r
+ if (!is_array($values)) {\r
+ return array(array($name, $values));\r
+ } else {\r
+ $ret = array();\r
+ foreach ($values as $k => $v) {\r
+ if (empty($name)) {\r
+ $newName = $k;\r
+ } elseif ($this->_useBrackets) {\r
+ $newName = $name . '[' . $k . ']';\r
+ } else {\r
+ $newName = $name;\r
+ }\r
+ $ret = array_merge($ret, $this->_flattenArray($newName, $v));\r
+ }\r
+ return $ret;\r
+ }\r
+ }\r
+\r
+\r
+ /**\r
+ * Adds a Listener to the list of listeners that are notified of\r
+ * the object's events\r
+ *\r
+ * Events sent by HTTP_Request object\r
+ * - 'connect': on connection to server\r
+ * - 'sentRequest': after the request was sent\r
+ * - 'disconnect': on disconnection from server\r
+ *\r
+ * Events sent by HTTP_Response object\r
+ * - 'gotHeaders': after receiving response headers (headers are passed in $data)\r
+ * - 'tick': on receiving a part of response body (the part is passed in $data)\r
+ * - 'gzTick': on receiving a gzip-encoded part of response body (ditto)\r
+ * - 'gotBody': after receiving the response body (passes the decoded body in $data if it was gzipped)\r
+ *\r
+ * @param HTTP_Request_Listener listener to attach\r
+ * @return boolean whether the listener was successfully attached\r
+ * @access public\r
+ */\r
+ function attach(&$listener)\r
+ {\r
+ if (!is_a($listener, 'HTTP_Request_Listener')) {\r
+ return false;\r
+ }\r
+ $this->_listeners[$listener->getId()] =& $listener;\r
+ return true;\r
+ }\r
+\r
+\r
+ /**\r
+ * Removes a Listener from the list of listeners\r
+ *\r
+ * @param HTTP_Request_Listener listener to detach\r
+ * @return boolean whether the listener was successfully detached\r
+ * @access public\r
+ */\r
+ function detach(&$listener)\r
+ {\r
+ if (!is_a($listener, 'HTTP_Request_Listener') ||\r
+ !isset($this->_listeners[$listener->getId()])) {\r
+ return false;\r
+ }\r
+ unset($this->_listeners[$listener->getId()]);\r
+ return true;\r
+ }\r
+\r
+\r
+ /**\r
+ * Notifies all registered listeners of an event.\r
+ *\r
+ * @param string Event name\r
+ * @param mixed Additional data\r
+ * @access private\r
+ * @see HTTP_Request::attach()\r
+ */\r
+ function _notify($event, $data = null)\r
+ {\r
+ foreach (array_keys($this->_listeners) as $id) {\r
+ $this->_listeners[$id]->update($this, $event, $data);\r
+ }\r
+ }\r
+}\r
+\r
+\r
+/**\r
+ * Response class to complement the Request class\r
+ *\r
+ * @category HTTP\r
+ * @package HTTP_Request\r
+ * @author Richard Heyes <richard@phpguru.org>\r
+ * @author Alexey Borzov <avb@php.net>\r
+ * @version Release: 1.4.4\r
+ */\r
+class HTTP_Response\r
+{\r
+ /**\r
+ * Socket object\r
+ * @var Net_Socket\r
+ */\r
+ var $_sock;\r
+\r
+ /**\r
+ * Protocol\r
+ * @var string\r
+ */\r
+ var $_protocol;\r
+\r
+ /**\r
+ * Return code\r
+ * @var string\r
+ */\r
+ var $_code;\r
+\r
+ /**\r
+ * Response reason phrase\r
+ * @var string\r
+ */\r
+ var $_reason;\r
+\r
+ /**\r
+ * Response headers\r
+ * @var array\r
+ */\r
+ var $_headers;\r
+\r
+ /**\r
+ * Cookies set in response\r
+ * @var array\r
+ */\r
+ var $_cookies;\r
+\r
+ /**\r
+ * Response body\r
+ * @var string\r
+ */\r
+ var $_body = '';\r
+\r
+ /**\r
+ * Used by _readChunked(): remaining length of the current chunk\r
+ * @var string\r
+ */\r
+ var $_chunkLength = 0;\r
+\r
+ /**\r
+ * Attached listeners\r
+ * @var array\r
+ */\r
+ var $_listeners = array();\r
+\r
+ /**\r
+ * Bytes left to read from message-body\r
+ * @var null|int\r
+ */\r
+ var $_toRead;\r
+\r
+ /**\r
+ * Constructor\r
+ *\r
+ * @param Net_Socket socket to read the response from\r
+ * @param array listeners attached to request\r
+ */\r
+ function HTTP_Response(&$sock, &$listeners)\r
+ {\r
+ $this->_sock =& $sock;\r
+ $this->_listeners =& $listeners;\r
+ }\r
+\r
+\r
+ /**\r
+ * Processes a HTTP response\r
+ *\r
+ * This extracts response code, headers, cookies and decodes body if it\r
+ * was encoded in some way\r
+ *\r
+ * @access public\r
+ * @param bool Whether to store response body in object property, set\r
+ * this to false if downloading a LARGE file and using a Listener.\r
+ * This is assumed to be true if body is gzip-encoded.\r
+ * @param bool Whether the response can actually have a message-body.\r
+ * Will be set to false for HEAD requests.\r
+ * @throws PEAR_Error\r
+ * @return mixed true on success, PEAR_Error in case of malformed response\r
+ */\r
+ function process($saveBody = true, $canHaveBody = true)\r
+ {\r
+ do {\r
+ $line = $this->_sock->readLine();\r
+ if (!preg_match('!^(HTTP/\d\.\d) (\d{3})(?: (.+))?!', $line, $s)) {\r
+ return PEAR::raiseError('Malformed response', HTTP_REQUEST_ERROR_RESPONSE);\r
+ } else {\r
+ $this->_protocol = $s[1];\r
+ $this->_code = intval($s[2]);\r
+ $this->_reason = empty($s[3])? null: $s[3];\r
+ }\r
+ while ('' !== ($header = $this->_sock->readLine())) {\r
+ $this->_processHeader($header);\r
+ }\r
+ } while (100 == $this->_code);\r
+\r
+ $this->_notify('gotHeaders', $this->_headers);\r
+\r
+ // RFC 2616, section 4.4:\r
+ // 1. Any response message which "MUST NOT" include a message-body ...\r
+ // is always terminated by the first empty line after the header fields\r
+ // 3. ... If a message is received with both a\r
+ // Transfer-Encoding header field and a Content-Length header field,\r
+ // the latter MUST be ignored.\r
+ $canHaveBody = $canHaveBody && $this->_code >= 200 &&\r
+ $this->_code != 204 && $this->_code != 304;\r
+\r
+ // If response body is present, read it and decode\r
+ $chunked = isset($this->_headers['transfer-encoding']) && ('chunked' == $this->_headers['transfer-encoding']);\r
+ $gzipped = isset($this->_headers['content-encoding']) && ('gzip' == $this->_headers['content-encoding']);\r
+ $hasBody = false;\r
+ if ($canHaveBody && ($chunked || !isset($this->_headers['content-length']) ||\r
+ 0 != $this->_headers['content-length']))\r
+ {\r
+ if ($chunked || !isset($this->_headers['content-length'])) {\r
+ $this->_toRead = null;\r
+ } else {\r
+ $this->_toRead = $this->_headers['content-length'];\r
+ }\r
+ while (!$this->_sock->eof() && (is_null($this->_toRead) || 0 < $this->_toRead)) {\r
+ if ($chunked) {\r
+ $data = $this->_readChunked();\r
+ } elseif (is_null($this->_toRead)) {\r
+ $data = $this->_sock->read(4096);\r
+ } else {\r
+ $data = $this->_sock->read(min(4096, $this->_toRead));\r
+ $this->_toRead -= HTTP_REQUEST_MBSTRING? mb_strlen($data, 'iso-8859-1'): strlen($data);\r
+ }\r
+ if ('' == $data && (!$this->_chunkLength || $this->_sock->eof())) {\r
+ break;\r
+ } else {\r
+ $hasBody = true;\r
+ if ($saveBody || $gzipped) {\r
+ $this->_body .= $data;\r
+ }\r
+ $this->_notify($gzipped? 'gzTick': 'tick', $data);\r
+ }\r
+ }\r
+ }\r
+\r
+ if ($hasBody) {\r
+ // Uncompress the body if needed\r
+ if ($gzipped) {\r
+ $body = $this->_decodeGzip($this->_body);\r
+ if (PEAR::isError($body)) {\r
+ return $body;\r
+ }\r
+ $this->_body = $body;\r
+ $this->_notify('gotBody', $this->_body);\r
+ } else {\r
+ $this->_notify('gotBody');\r
+ }\r
+ }\r
+ return true;\r
+ }\r
+\r
+\r
+ /**\r
+ * Processes the response header\r
+ *\r
+ * @access private\r
+ * @param string HTTP header\r
+ */\r
+ function _processHeader($header)\r
+ {\r
+ if (false === strpos($header, ':')) {\r
+ return;\r
+ }\r
+ list($headername, $headervalue) = explode(':', $header, 2);\r
+ $headername = strtolower($headername);\r
+ $headervalue = ltrim($headervalue);\r
+\r
+ if ('set-cookie' != $headername) {\r
+ if (isset($this->_headers[$headername])) {\r
+ $this->_headers[$headername] .= ',' . $headervalue;\r
+ } else {\r
+ $this->_headers[$headername] = $headervalue;\r
+ }\r
+ } else {\r
+ $this->_parseCookie($headervalue);\r
+ }\r
+ }\r
+\r
+\r
+ /**\r
+ * Parse a Set-Cookie header to fill $_cookies array\r
+ *\r
+ * @access private\r
+ * @param string value of Set-Cookie header\r
+ */\r
+ function _parseCookie($headervalue)\r
+ {\r
+ $cookie = array(\r
+ 'expires' => null,\r
+ 'domain' => null,\r
+ 'path' => null,\r
+ 'secure' => false\r
+ );\r
+\r
+ // Only a name=value pair\r
+ if (!strpos($headervalue, ';')) {\r
+ $pos = strpos($headervalue, '=');\r
+ $cookie['name'] = trim(substr($headervalue, 0, $pos));\r
+ $cookie['value'] = trim(substr($headervalue, $pos + 1));\r
+\r
+ // Some optional parameters are supplied\r
+ } else {\r
+ $elements = explode(';', $headervalue);\r
+ $pos = strpos($elements[0], '=');\r
+ $cookie['name'] = trim(substr($elements[0], 0, $pos));\r
+ $cookie['value'] = trim(substr($elements[0], $pos + 1));\r
+\r
+ for ($i = 1; $i < count($elements); $i++) {\r
+ if (false === strpos($elements[$i], '=')) {\r
+ $elName = trim($elements[$i]);\r
+ $elValue = null;\r
+ } else {\r
+ list ($elName, $elValue) = array_map('trim', explode('=', $elements[$i]));\r
+ }\r
+ $elName = strtolower($elName);\r
+ if ('secure' == $elName) {\r
+ $cookie['secure'] = true;\r
+ } elseif ('expires' == $elName) {\r
+ $cookie['expires'] = str_replace('"', '', $elValue);\r
+ } elseif ('path' == $elName || 'domain' == $elName) {\r
+ $cookie[$elName] = urldecode($elValue);\r
+ } else {\r
+ $cookie[$elName] = $elValue;\r
+ }\r
+ }\r
+ }\r
+ $this->_cookies[] = $cookie;\r
+ }\r
+\r
+\r
+ /**\r
+ * Read a part of response body encoded with chunked Transfer-Encoding\r
+ *\r
+ * @access private\r
+ * @return string\r
+ */\r
+ function _readChunked()\r
+ {\r
+ // at start of the next chunk?\r
+ if (0 == $this->_chunkLength) {\r
+ $line = $this->_sock->readLine();\r
+ if (preg_match('/^([0-9a-f]+)/i', $line, $matches)) {\r
+ $this->_chunkLength = hexdec($matches[1]);\r
+ // Chunk with zero length indicates the end\r
+ if (0 == $this->_chunkLength) {\r
+ $this->_sock->readLine(); // make this an eof()\r
+ return '';\r
+ }\r
+ } else {\r
+ return '';\r
+ }\r
+ }\r
+ $data = $this->_sock->read($this->_chunkLength);\r
+ $this->_chunkLength -= HTTP_REQUEST_MBSTRING? mb_strlen($data, 'iso-8859-1'): strlen($data);\r
+ if (0 == $this->_chunkLength) {\r
+ $this->_sock->readLine(); // Trailing CRLF\r
+ }\r
+ return $data;\r
+ }\r
+\r
+\r
+ /**\r
+ * Notifies all registered listeners of an event.\r
+ *\r
+ * @param string Event name\r
+ * @param mixed Additional data\r
+ * @access private\r
+ * @see HTTP_Request::_notify()\r
+ */\r
+ function _notify($event, $data = null)\r
+ {\r
+ foreach (array_keys($this->_listeners) as $id) {\r
+ $this->_listeners[$id]->update($this, $event, $data);\r
+ }\r
+ }\r
+\r
+\r
+ /**\r
+ * Decodes the message-body encoded by gzip\r
+ *\r
+ * The real decoding work is done by gzinflate() built-in function, this\r
+ * method only parses the header and checks data for compliance with\r
+ * RFC 1952\r
+ *\r
+ * @access private\r
+ * @param string gzip-encoded data\r
+ * @return string decoded data\r
+ */\r
+ function _decodeGzip($data)\r
+ {\r
+ if (HTTP_REQUEST_MBSTRING) {\r
+ $oldEncoding = mb_internal_encoding();\r
+ mb_internal_encoding('iso-8859-1');\r
+ }\r
+ $length = strlen($data);\r
+ // If it doesn't look like gzip-encoded data, don't bother\r
+ if (18 > $length || strcmp(substr($data, 0, 2), "\x1f\x8b")) {\r
+ return $data;\r
+ }\r
+ $method = ord(substr($data, 2, 1));\r
+ if (8 != $method) {\r
+ return PEAR::raiseError('_decodeGzip(): unknown compression method', HTTP_REQUEST_ERROR_GZIP_METHOD);\r
+ }\r
+ $flags = ord(substr($data, 3, 1));\r
+ if ($flags & 224) {\r
+ return PEAR::raiseError('_decodeGzip(): reserved bits are set', HTTP_REQUEST_ERROR_GZIP_DATA);\r
+ }\r
+\r
+ // header is 10 bytes minimum. may be longer, though.\r
+ $headerLength = 10;\r
+ // extra fields, need to skip 'em\r
+ if ($flags & 4) {\r
+ if ($length - $headerLength - 2 < 8) {\r
+ return PEAR::raiseError('_decodeGzip(): data too short', HTTP_REQUEST_ERROR_GZIP_DATA);\r
+ }\r
+ $extraLength = unpack('v', substr($data, 10, 2));\r
+ if ($length - $headerLength - 2 - $extraLength[1] < 8) {\r
+ return PEAR::raiseError('_decodeGzip(): data too short', HTTP_REQUEST_ERROR_GZIP_DATA);\r
+ }\r
+ $headerLength += $extraLength[1] + 2;\r
+ }\r
+ // file name, need to skip that\r
+ if ($flags & 8) {\r
+ if ($length - $headerLength - 1 < 8) {\r
+ return PEAR::raiseError('_decodeGzip(): data too short', HTTP_REQUEST_ERROR_GZIP_DATA);\r
+ }\r
+ $filenameLength = strpos(substr($data, $headerLength), chr(0));\r
+ if (false === $filenameLength || $length - $headerLength - $filenameLength - 1 < 8) {\r
+ return PEAR::raiseError('_decodeGzip(): data too short', HTTP_REQUEST_ERROR_GZIP_DATA);\r
+ }\r
+ $headerLength += $filenameLength + 1;\r
+ }\r
+ // comment, need to skip that also\r
+ if ($flags & 16) {\r
+ if ($length - $headerLength - 1 < 8) {\r
+ return PEAR::raiseError('_decodeGzip(): data too short', HTTP_REQUEST_ERROR_GZIP_DATA);\r
+ }\r
+ $commentLength = strpos(substr($data, $headerLength), chr(0));\r
+ if (false === $commentLength || $length - $headerLength - $commentLength - 1 < 8) {\r
+ return PEAR::raiseError('_decodeGzip(): data too short', HTTP_REQUEST_ERROR_GZIP_DATA);\r
+ }\r
+ $headerLength += $commentLength + 1;\r
+ }\r
+ // have a CRC for header. let's check\r
+ if ($flags & 1) {\r
+ if ($length - $headerLength - 2 < 8) {\r
+ return PEAR::raiseError('_decodeGzip(): data too short', HTTP_REQUEST_ERROR_GZIP_DATA);\r
+ }\r
+ $crcReal = 0xffff & crc32(substr($data, 0, $headerLength));\r
+ $crcStored = unpack('v', substr($data, $headerLength, 2));\r
+ if ($crcReal != $crcStored[1]) {\r
+ return PEAR::raiseError('_decodeGzip(): header CRC check failed', HTTP_REQUEST_ERROR_GZIP_CRC);\r
+ }\r
+ $headerLength += 2;\r
+ }\r
+ // unpacked data CRC and size at the end of encoded data\r
+ $tmp = unpack('V2', substr($data, -8));\r
+ $dataCrc = $tmp[1];\r
+ $dataSize = $tmp[2];\r
+\r
+ // finally, call the gzinflate() function\r
+ // don't pass $dataSize to gzinflate, see bugs #13135, #14370\r
+ $unpacked = gzinflate(substr($data, $headerLength, -8));\r
+ if (false === $unpacked) {\r
+ return PEAR::raiseError('_decodeGzip(): gzinflate() call failed', HTTP_REQUEST_ERROR_GZIP_READ);\r
+ } elseif ($dataSize != strlen($unpacked)) {\r
+ return PEAR::raiseError('_decodeGzip(): data size check failed', HTTP_REQUEST_ERROR_GZIP_READ);\r
+ } elseif ((0xffffffff & $dataCrc) != (0xffffffff & crc32($unpacked))) {\r
+ return PEAR::raiseError('_decodeGzip(): data CRC check failed', HTTP_REQUEST_ERROR_GZIP_CRC);\r
+ }\r
+ if (HTTP_REQUEST_MBSTRING) {\r
+ mb_internal_encoding($oldEncoding);\r
+ }\r
+ return $unpacked;\r
+ }\r
+} // End class HTTP_Response\r
+?>\r
--- /dev/null
+<?php\r
+/**\r
+ * Listener for HTTP_Request and HTTP_Response objects\r
+ *\r
+ * PHP versions 4 and 5\r
+ * \r
+ * LICENSE:\r
+ *\r
+ * Copyright (c) 2002-2007, Richard Heyes\r
+ * All rights reserved.\r
+ *\r
+ * Redistribution and use in source and binary forms, with or without\r
+ * modification, are permitted provided that the following conditions\r
+ * are met:\r
+ *\r
+ * o Redistributions of source code must retain the above copyright\r
+ * notice, this list of conditions and the following disclaimer.\r
+ * o Redistributions in binary form must reproduce the above copyright\r
+ * notice, this list of conditions and the following disclaimer in the\r
+ * documentation and/or other materials provided with the distribution.\r
+ * o The names of the authors may not be used to endorse or promote\r
+ * products derived from this software without specific prior written\r
+ * permission.\r
+ *\r
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS\r
+ * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT\r
+ * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR\r
+ * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT\r
+ * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,\r
+ * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT\r
+ * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,\r
+ * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY\r
+ * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT\r
+ * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE\r
+ * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.\r
+ *\r
+ * @category HTTP\r
+ * @package HTTP_Request\r
+ * @author Alexey Borzov <avb@php.net>\r
+ * @copyright 2002-2007 Richard Heyes\r
+ * @license http://opensource.org/licenses/bsd-license.php New BSD License\r
+ * @version CVS: $Id: Listener.php,v 1.3 2007/05/18 10:33:31 avb Exp $\r
+ * @link http://pear.php.net/package/HTTP_Request/ \r
+ */\r
+\r
+/**\r
+ * Listener for HTTP_Request and HTTP_Response objects\r
+ *\r
+ * This class implements the Observer part of a Subject-Observer\r
+ * design pattern.\r
+ *\r
+ * @category HTTP\r
+ * @package HTTP_Request\r
+ * @author Alexey Borzov <avb@php.net>\r
+ * @version Release: 1.4.4\r
+ */\r
+class HTTP_Request_Listener \r
+{\r
+ /**\r
+ * A listener's identifier\r
+ * @var string\r
+ */\r
+ var $_id;\r
+\r
+ /**\r
+ * Constructor, sets the object's identifier\r
+ *\r
+ * @access public\r
+ */\r
+ function HTTP_Request_Listener()\r
+ {\r
+ $this->_id = md5(uniqid('http_request_', 1));\r
+ }\r
+\r
+\r
+ /**\r
+ * Returns the listener's identifier\r
+ *\r
+ * @access public\r
+ * @return string\r
+ */\r
+ function getId()\r
+ {\r
+ return $this->_id;\r
+ }\r
+\r
+\r
+ /**\r
+ * This method is called when Listener is notified of an event\r
+ *\r
+ * @access public\r
+ * @param object an object the listener is attached to\r
+ * @param string Event name\r
+ * @param mixed Additional data\r
+ * @abstract\r
+ */\r
+ function update(&$subject, $event, $data = null)\r
+ {\r
+ echo "Notified of event: '$event'\n";\r
+ if (null !== $data) {\r
+ echo "Additional data: ";\r
+ var_dump($data);\r
+ }\r
+ }\r
+}\r
+?>\r
--- /dev/null
+<?php
+// +-----------------------------------------------------------------------+
+// | Copyright (c) 2007-2008, Christian Schmidt, Peytz & Co. A/S |
+// | All rights reserved. |
+// | |
+// | Redistribution and use in source and binary forms, with or without |
+// | modification, are permitted provided that the following conditions |
+// | are met: |
+// | |
+// | o Redistributions of source code must retain the above copyright |
+// | notice, this list of conditions and the following disclaimer. |
+// | o Redistributions in binary form must reproduce the above copyright |
+// | notice, this list of conditions and the following disclaimer in the |
+// | documentation and/or other materials provided with the distribution.|
+// | o The names of the authors may not be used to endorse or promote |
+// | products derived from this software without specific prior written |
+// | permission. |
+// | |
+// | THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS |
+// | "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT |
+// | LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR |
+// | A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT |
+// | OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, |
+// | SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT |
+// | LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, |
+// | DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY |
+// | THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT |
+// | (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE |
+// | OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. |
+// | |
+// +-----------------------------------------------------------------------+
+// | Author: Christian Schmidt <schmidt at php dot net> |
+// +-----------------------------------------------------------------------+
+//
+// $Id: URL2.php,v 1.10 2008/04/26 21:57:08 schmidt Exp $
+//
+// Net_URL2 Class (PHP5 Only)
+
+// This code is released under the BSD License - http://www.opensource.org/licenses/bsd-license.php
+/**
+ * @license BSD License
+ */
+class Net_URL2
+{
+ /**
+ * Do strict parsing in resolve() (see RFC 3986, section 5.2.2). Default
+ * is true.
+ */
+ const OPTION_STRICT = 'strict';
+
+ /**
+ * Represent arrays in query using PHP's [] notation. Default is true.
+ */
+ const OPTION_USE_BRACKETS = 'use_brackets';
+
+ /**
+ * URL-encode query variable keys. Default is true.
+ */
+ const OPTION_ENCODE_KEYS = 'encode_keys';
+
+ /**
+ * Query variable separators when parsing the query string. Every character
+ * is considered a separator. Default is specified by the
+ * arg_separator.input php.ini setting (this defaults to "&").
+ */
+ const OPTION_SEPARATOR_INPUT = 'input_separator';
+
+ /**
+ * Query variable separator used when generating the query string. Default
+ * is specified by the arg_separator.output php.ini setting (this defaults
+ * to "&").
+ */
+ const OPTION_SEPARATOR_OUTPUT = 'output_separator';
+
+ /**
+ * Default options corresponds to how PHP handles $_GET.
+ */
+ private $options = array(
+ self::OPTION_STRICT => true,
+ self::OPTION_USE_BRACKETS => true,
+ self::OPTION_ENCODE_KEYS => true,
+ self::OPTION_SEPARATOR_INPUT => 'x&',
+ self::OPTION_SEPARATOR_OUTPUT => 'x&',
+ );
+
+ /**
+ * @var string|bool
+ */
+ private $scheme = false;
+
+ /**
+ * @var string|bool
+ */
+ private $userinfo = false;
+
+ /**
+ * @var string|bool
+ */
+ private $host = false;
+
+ /**
+ * @var int|bool
+ */
+ private $port = false;
+
+ /**
+ * @var string
+ */
+ private $path = '';
+
+ /**
+ * @var string|bool
+ */
+ private $query = false;
+
+ /**
+ * @var string|bool
+ */
+ private $fragment = false;
+
+ /**
+ * @param string $url an absolute or relative URL
+ * @param array $options
+ */
+ public function __construct($url, $options = null)
+ {
+ $this->setOption(self::OPTION_SEPARATOR_INPUT,
+ ini_get('arg_separator.input'));
+ $this->setOption(self::OPTION_SEPARATOR_OUTPUT,
+ ini_get('arg_separator.output'));
+ if (is_array($options)) {
+ foreach ($options as $optionName => $value) {
+ $this->setOption($optionName);
+ }
+ }
+
+ if (preg_match('@^([a-z][a-z0-9.+-]*):@i', $url, $reg)) {
+ $this->scheme = $reg[1];
+ $url = substr($url, strlen($reg[0]));
+ }
+
+ if (preg_match('@^//([^/#?]+)@', $url, $reg)) {
+ $this->setAuthority($reg[1]);
+ $url = substr($url, strlen($reg[0]));
+ }
+
+ $i = strcspn($url, '?#');
+ $this->path = substr($url, 0, $i);
+ $url = substr($url, $i);
+
+ if (preg_match('@^\?([^#]*)@', $url, $reg)) {
+ $this->query = $reg[1];
+ $url = substr($url, strlen($reg[0]));
+ }
+
+ if ($url) {
+ $this->fragment = substr($url, 1);
+ }
+ }
+
+ /**
+ * Returns the scheme, e.g. "http" or "urn", or false if there is no
+ * scheme specified, i.e. if this is a relative URL.
+ *
+ * @return string|bool
+ */
+ public function getScheme()
+ {
+ return $this->scheme;
+ }
+
+ /**
+ * @param string|bool $scheme
+ *
+ * @return void
+ * @see getScheme()
+ */
+ public function setScheme($scheme)
+ {
+ $this->scheme = $scheme;
+ }
+
+ /**
+ * Returns the user part of the userinfo part (the part preceding the first
+ * ":"), or false if there is no userinfo part.
+ *
+ * @return string|bool
+ */
+ public function getUser()
+ {
+ return $this->userinfo !== false ? preg_replace('@:.*$@', '', $this->userinfo) : false;
+ }
+
+ /**
+ * Returns the password part of the userinfo part (the part after the first
+ * ":"), or false if there is no userinfo part (i.e. the URL does not
+ * contain "@" in front of the hostname) or the userinfo part does not
+ * contain ":".
+ *
+ * @return string|bool
+ */
+ public function getPassword()
+ {
+ return $this->userinfo !== false ? substr(strstr($this->userinfo, ':'), 1) : false;
+ }
+
+ /**
+ * Returns the userinfo part, or false if there is none, i.e. if the
+ * authority part does not contain "@".
+ *
+ * @return string|bool
+ */
+ public function getUserinfo()
+ {
+ return $this->userinfo;
+ }
+
+ /**
+ * Sets the userinfo part. If two arguments are passed, they are combined
+ * in the userinfo part as username ":" password.
+ *
+ * @param string|bool $userinfo userinfo or username
+ * @param string|bool $password
+ *
+ * @return void
+ */
+ public function setUserinfo($userinfo, $password = false)
+ {
+ $this->userinfo = $userinfo;
+ if ($password !== false) {
+ $this->userinfo .= ':' . $password;
+ }
+ }
+
+ /**
+ * Returns the host part, or false if there is no authority part, e.g.
+ * relative URLs.
+ *
+ * @return string|bool
+ */
+ public function getHost()
+ {
+ return $this->host;
+ }
+
+ /**
+ * @param string|bool $host
+ *
+ * @return void
+ */
+ public function setHost($host)
+ {
+ $this->host = $host;
+ }
+
+ /**
+ * Returns the port number, or false if there is no port number specified,
+ * i.e. if the default port is to be used.
+ *
+ * @return int|bool
+ */
+ public function getPort()
+ {
+ return $this->port;
+ }
+
+ /**
+ * @param int|bool $port
+ *
+ * @return void
+ */
+ public function setPort($port)
+ {
+ $this->port = intval($port);
+ }
+
+ /**
+ * Returns the authority part, i.e. [ userinfo "@" ] host [ ":" port ], or
+ * false if there is no authority none.
+ *
+ * @return string|bool
+ */
+ public function getAuthority()
+ {
+ if (!$this->host) {
+ return false;
+ }
+
+ $authority = '';
+
+ if ($this->userinfo !== false) {
+ $authority .= $this->userinfo . '@';
+ }
+
+ $authority .= $this->host;
+
+ if ($this->port !== false) {
+ $authority .= ':' . $this->port;
+ }
+
+ return $authority;
+ }
+
+ /**
+ * @param string|false $authority
+ *
+ * @return void
+ */
+ public function setAuthority($authority)
+ {
+ $this->user = false;
+ $this->pass = false;
+ $this->host = false;
+ $this->port = false;
+ if (preg_match('@^(([^\@]+)\@)?([^:]+)(:(\d*))?$@', $authority, $reg)) {
+ if ($reg[1]) {
+ $this->userinfo = $reg[2];
+ }
+
+ $this->host = $reg[3];
+ if (isset($reg[5])) {
+ $this->port = intval($reg[5]);
+ }
+ }
+ }
+
+ /**
+ * Returns the path part (possibly an empty string).
+ *
+ * @return string
+ */
+ public function getPath()
+ {
+ return $this->path;
+ }
+
+ /**
+ * @param string $path
+ *
+ * @return void
+ */
+ public function setPath($path)
+ {
+ $this->path = $path;
+ }
+
+ /**
+ * Returns the query string (excluding the leading "?"), or false if "?"
+ * isn't present in the URL.
+ *
+ * @return string|bool
+ * @see self::getQueryVariables()
+ */
+ public function getQuery()
+ {
+ return $this->query;
+ }
+
+ /**
+ * @param string|bool $query
+ *
+ * @return void
+ * @see self::setQueryVariables()
+ */
+ public function setQuery($query)
+ {
+ $this->query = $query;
+ }
+
+ /**
+ * Returns the fragment name, or false if "#" isn't present in the URL.
+ *
+ * @return string|bool
+ */
+ public function getFragment()
+ {
+ return $this->fragment;
+ }
+
+ /**
+ * @param string|bool $fragment
+ *
+ * @return void
+ */
+ public function setFragment($fragment)
+ {
+ $this->fragment = $fragment;
+ }
+
+ /**
+ * Returns the query string like an array as the variables would appear in
+ * $_GET in a PHP script.
+ *
+ * @return array
+ */
+ public function getQueryVariables()
+ {
+ $pattern = '/[' .
+ preg_quote($this->getOption(self::OPTION_SEPARATOR_INPUT), '/') .
+ ']/';
+ $parts = preg_split($pattern, $this->query, -1, PREG_SPLIT_NO_EMPTY);
+ $return = array();
+
+ foreach ($parts as $part) {
+ if (strpos($part, '=') !== false) {
+ list($key, $value) = explode('=', $part, 2);
+ } else {
+ $key = $part;
+ $value = null;
+ }
+
+ if ($this->getOption(self::OPTION_ENCODE_KEYS)) {
+ $key = rawurldecode($key);
+ }
+ $value = rawurldecode($value);
+
+ if ($this->getOption(self::OPTION_USE_BRACKETS) &&
+ preg_match('#^(.*)\[([0-9a-z_-]*)\]#i', $key, $matches)) {
+
+ $key = $matches[1];
+ $idx = $matches[2];
+
+ // Ensure is an array
+ if (empty($return[$key]) || !is_array($return[$key])) {
+ $return[$key] = array();
+ }
+
+ // Add data
+ if ($idx === '') {
+ $return[$key][] = $value;
+ } else {
+ $return[$key][$idx] = $value;
+ }
+ } elseif (!$this->getOption(self::OPTION_USE_BRACKETS)
+ && !empty($return[$key])
+ ) {
+ $return[$key] = (array) $return[$key];
+ $return[$key][] = $value;
+ } else {
+ $return[$key] = $value;
+ }
+ }
+
+ return $return;
+ }
+
+ /**
+ * @param array $array (name => value) array
+ *
+ * @return void
+ */
+ public function setQueryVariables(array $array)
+ {
+ if (!$array) {
+ $this->query = false;
+ } else {
+ foreach ($array as $name => $value) {
+ if ($this->getOption(self::OPTION_ENCODE_KEYS)) {
+ $name = rawurlencode($name);
+ }
+
+ if (is_array($value)) {
+ foreach ($value as $k => $v) {
+ $parts[] = $this->getOption(self::OPTION_USE_BRACKETS)
+ ? sprintf('%s[%s]=%s', $name, $k, $v)
+ : ($name . '=' . $v);
+ }
+ } elseif (!is_null($value)) {
+ $parts[] = $name . '=' . $value;
+ } else {
+ $parts[] = $name;
+ }
+ }
+ $this->query = implode($this->getOption(self::OPTION_SEPARATOR_OUTPUT),
+ $parts);
+ }
+ }
+
+ /**
+ * @param string $name
+ * @param mixed $value
+ *
+ * @return array
+ */
+ public function setQueryVariable($name, $value)
+ {
+ $array = $this->getQueryVariables();
+ $array[$name] = $value;
+ $this->setQueryVariables($array);
+ }
+
+ /**
+ * @param string $name
+ *
+ * @return void
+ */
+ public function unsetQueryVariable($name)
+ {
+ $array = $this->getQueryVariables();
+ unset($array[$name]);
+ $this->setQueryVariables($array);
+ }
+
+ /**
+ * Returns a string representation of this URL.
+ *
+ * @return string
+ */
+ public function getURL()
+ {
+ // See RFC 3986, section 5.3
+ $url = "";
+
+ if ($this->scheme !== false) {
+ $url .= $this->scheme . ':';
+ }
+
+ $authority = $this->getAuthority();
+ if ($authority !== false) {
+ $url .= '//' . $authority;
+ }
+ $url .= $this->path;
+
+ if ($this->query !== false) {
+ $url .= '?' . $this->query;
+ }
+
+ if ($this->fragment !== false) {
+ $url .= '#' . $this->fragment;
+ }
+
+ return $url;
+ }
+
+ /**
+ * Returns a normalized string representation of this URL. This is useful
+ * for comparison of URLs.
+ *
+ * @return string
+ */
+ public function getNormalizedURL()
+ {
+ $url = clone $this;
+ $url->normalize();
+ return $url->getUrl();
+ }
+
+ /**
+ * Returns a normalized Net_URL2 instance.
+ *
+ * @return Net_URL2
+ */
+ public function normalize()
+ {
+ // See RFC 3886, section 6
+
+ // Schemes are case-insensitive
+ if ($this->scheme) {
+ $this->scheme = strtolower($this->scheme);
+ }
+
+ // Hostnames are case-insensitive
+ if ($this->host) {
+ $this->host = strtolower($this->host);
+ }
+
+ // Remove default port number for known schemes (RFC 3986, section 6.2.3)
+ if ($this->port &&
+ $this->scheme &&
+ $this->port == getservbyname($this->scheme, 'tcp')) {
+
+ $this->port = false;
+ }
+
+ // Normalize case of %XX percentage-encodings (RFC 3986, section 6.2.2.1)
+ foreach (array('userinfo', 'host', 'path') as $part) {
+ if ($this->$part) {
+ $this->$part = preg_replace('/%[0-9a-f]{2}/ie', 'strtoupper("\0")', $this->$part);
+ }
+ }
+
+ // Path segment normalization (RFC 3986, section 6.2.2.3)
+ $this->path = self::removeDotSegments($this->path);
+
+ // Scheme based normalization (RFC 3986, section 6.2.3)
+ if ($this->host && !$this->path) {
+ $this->path = '/';
+ }
+ }
+
+ /**
+ * Returns whether this instance represents an absolute URL.
+ *
+ * @return bool
+ */
+ public function isAbsolute()
+ {
+ return (bool) $this->scheme;
+ }
+
+ /**
+ * Returns an Net_URL2 instance representing an absolute URL relative to
+ * this URL.
+ *
+ * @param Net_URL2|string $reference relative URL
+ *
+ * @return Net_URL2
+ */
+ public function resolve($reference)
+ {
+ if (is_string($reference)) {
+ $reference = new self($reference);
+ }
+ if (!$this->isAbsolute()) {
+ throw new Exception('Base-URL must be absolute');
+ }
+
+ // A non-strict parser may ignore a scheme in the reference if it is
+ // identical to the base URI's scheme.
+ if (!$this->getOption(self::OPTION_STRICT) && $reference->scheme == $this->scheme) {
+ $reference->scheme = false;
+ }
+
+ $target = new self('');
+ if ($reference->scheme !== false) {
+ $target->scheme = $reference->scheme;
+ $target->setAuthority($reference->getAuthority());
+ $target->path = self::removeDotSegments($reference->path);
+ $target->query = $reference->query;
+ } else {
+ $authority = $reference->getAuthority();
+ if ($authority !== false) {
+ $target->setAuthority($authority);
+ $target->path = self::removeDotSegments($reference->path);
+ $target->query = $reference->query;
+ } else {
+ if ($reference->path == '') {
+ $target->path = $this->path;
+ if ($reference->query !== false) {
+ $target->query = $reference->query;
+ } else {
+ $target->query = $this->query;
+ }
+ } else {
+ if (substr($reference->path, 0, 1) == '/') {
+ $target->path = self::removeDotSegments($reference->path);
+ } else {
+ // Merge paths (RFC 3986, section 5.2.3)
+ if ($this->host !== false && $this->path == '') {
+ $target->path = '/' . $this->path;
+ } else {
+ $i = strrpos($this->path, '/');
+ if ($i !== false) {
+ $target->path = substr($this->path, 0, $i + 1);
+ }
+ $target->path .= $reference->path;
+ }
+ $target->path = self::removeDotSegments($target->path);
+ }
+ $target->query = $reference->query;
+ }
+ $target->setAuthority($this->getAuthority());
+ }
+ $target->scheme = $this->scheme;
+ }
+
+ $target->fragment = $reference->fragment;
+
+ return $target;
+ }
+
+ /**
+ * Removes dots as described in RFC 3986, section 5.2.4, e.g.
+ * "/foo/../bar/baz" => "/bar/baz"
+ *
+ * @param string $path a path
+ *
+ * @return string a path
+ */
+ private static function removeDotSegments($path)
+ {
+ $output = '';
+
+ // Make sure not to be trapped in an infinite loop due to a bug in this
+ // method
+ $j = 0;
+ while ($path && $j++ < 100) {
+ // Step A
+ if (substr($path, 0, 2) == './') {
+ $path = substr($path, 2);
+ } elseif (substr($path, 0, 3) == '../') {
+ $path = substr($path, 3);
+
+ // Step B
+ } elseif (substr($path, 0, 3) == '/./' || $path == '/.') {
+ $path = '/' . substr($path, 3);
+
+ // Step C
+ } elseif (substr($path, 0, 4) == '/../' || $path == '/..') {
+ $path = '/' . substr($path, 4);
+ $i = strrpos($output, '/');
+ $output = $i === false ? '' : substr($output, 0, $i);
+
+ // Step D
+ } elseif ($path == '.' || $path == '..') {
+ $path = '';
+
+ // Step E
+ } else {
+ $i = strpos($path, '/');
+ if ($i === 0) {
+ $i = strpos($path, '/', 1);
+ }
+ if ($i === false) {
+ $i = strlen($path);
+ }
+ $output .= substr($path, 0, $i);
+ $path = substr($path, $i);
+ }
+ }
+
+ return $output;
+ }
+
+ /**
+ * Returns a Net_URL2 instance representing the canonical URL of the
+ * currently executing PHP script.
+ *
+ * @return string
+ */
+ public static function getCanonical()
+ {
+ if (!isset($_SERVER['REQUEST_METHOD'])) {
+ // ALERT - no current URL
+ throw new Exception('Script was not called through a webserver');
+ }
+
+ // Begin with a relative URL
+ $url = new self($_SERVER['PHP_SELF']);
+ $url->scheme = isset($_SERVER['HTTPS']) ? 'https' : 'http';
+ $url->host = $_SERVER['SERVER_NAME'];
+ $port = intval($_SERVER['SERVER_PORT']);
+ if ($url->scheme == 'http' && $port != 80 ||
+ $url->scheme == 'https' && $port != 443) {
+
+ $url->port = $port;
+ }
+ return $url;
+ }
+
+ /**
+ * Returns the URL used to retrieve the current request.
+ *
+ * @return string
+ */
+ public static function getRequestedURL()
+ {
+ return self::getRequested()->getUrl();
+ }
+
+ /**
+ * Returns a Net_URL2 instance representing the URL used to retrieve the
+ * current request.
+ *
+ * @return Net_URL2
+ */
+ public static function getRequested()
+ {
+ if (!isset($_SERVER['REQUEST_METHOD'])) {
+ // ALERT - no current URL
+ throw new Exception('Script was not called through a webserver');
+ }
+
+ // Begin with a relative URL
+ $url = new self($_SERVER['REQUEST_URI']);
+ $url->scheme = isset($_SERVER['HTTPS']) ? 'https' : 'http';
+ // Set host and possibly port
+ $url->setAuthority($_SERVER['HTTP_HOST']);
+ return $url;
+ }
+
+ /**
+ * Sets the specified option.
+ *
+ * @param string $optionName a self::OPTION_ constant
+ * @param mixed $value option value
+ *
+ * @return void
+ * @see self::OPTION_STRICT
+ * @see self::OPTION_USE_BRACKETS
+ * @see self::OPTION_ENCODE_KEYS
+ */
+ function setOption($optionName, $value)
+ {
+ if (!array_key_exists($optionName, $this->options)) {
+ return false;
+ }
+ $this->options[$optionName] = $value;
+ }
+
+ /**
+ * Returns the value of the specified option.
+ *
+ * @param string $optionName The name of the option to retrieve
+ *
+ * @return mixed
+ */
+ function getOption($optionName)
+ {
+ return isset($this->options[$optionName])
+ ? $this->options[$optionName] : false;
+ }
+}
--- /dev/null
+<?php
+
+/**
+ * An interface for oEmbed consumption
+ *
+ * PHP version 5.1.0+
+ *
+ * Copyright (c) 2008, Digg.com, Inc.
+ *
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions are met:
+ *
+ * - Redistributions of source code must retain the above copyright notice,
+ * this list of conditions and the following disclaimer.
+ * - Redistributions in binary form must reproduce the above copyright notice,
+ * this list of conditions and the following disclaimer in the documentation
+ * and/or other materials provided with the distribution.
+ * - Neither the name of Digg.com, Inc. nor the names of its contributors
+ * may be used to endorse or promote products derived from this software
+ * without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+ * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+ * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
+ * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+ * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+ * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+ * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+ * POSSIBILITY OF SUCH DAMAGE.
+ *
+ * @category Services
+ * @package Services_oEmbed
+ * @author Joe Stump <joe@joestump.net>
+ * @copyright 2008 Digg.com, Inc.
+ * @license http://tinyurl.com/42zef New BSD License
+ * @version SVN: @version@
+ * @link http://code.google.com/p/digg
+ * @link http://oembed.com
+ */
+
+require_once 'Validate.php';
+require_once 'Net/URL2.php';
+require_once 'HTTP/Request.php';
+require_once 'Services/oEmbed/Exception.php';
+require_once 'Services/oEmbed/Exception/NoSupport.php';
+require_once 'Services/oEmbed/Object.php';
+
+/**
+ * Base class for consuming oEmbed objects
+ *
+ * <code>
+ * <?php
+ *
+ * require_once 'Services/oEmbed.php';
+ *
+ * // The URL that we'd like to find out more information about.
+ * $url = 'http://flickr.com/photos/joestump/2848795611/';
+ *
+ * // The oEmbed API URI. Not all providers support discovery yet so we're
+ * // explicitly providing one here. If one is not provided Services_oEmbed
+ * // attempts to discover it. If none is found an exception is thrown.
+ * $oEmbed = new Services_oEmbed($url, array(
+ * Services_oEmbed::OPTION_API => 'http://www.flickr.com/services/oembed/'
+ * ));
+ * $object = $oEmbed->getObject();
+ *
+ * // All of the objects have somewhat sane __toString() methods that allow
+ * // you to output them directly.
+ * echo (string)$object;
+ *
+ * ?>
+ * </code>
+ *
+ * @category Services
+ * @package Services_oEmbed
+ * @author Joe Stump <joe@joestump.net>
+ * @copyright 2008 Digg.com, Inc.
+ * @license http://tinyurl.com/42zef New BSD License
+ * @version Release: @version@
+ * @link http://code.google.com/p/digg
+ * @link http://oembed.com
+ */
+class Services_oEmbed
+{
+ /**
+ * HTTP timeout in seconds
+ *
+ * All HTTP requests made by Services_oEmbed will respect this timeout.
+ * This can be passed to {@link Services_oEmbed::setOption()} or to the
+ * options parameter in {@link Services_oEmbed::__construct()}.
+ *
+ * @var string OPTION_TIMEOUT Timeout in seconds
+ */
+ const OPTION_TIMEOUT = 'http_timeout';
+
+ /**
+ * HTTP User-Agent
+ *
+ * All HTTP requests made by Services_oEmbed will be sent with the
+ * string set by this option.
+ *
+ * @var string OPTION_USER_AGENT The HTTP User-Agent string
+ */
+ const OPTION_USER_AGENT = 'http_user_agent';
+
+ /**
+ * The API's URI
+ *
+ * If the API is known ahead of time this option can be used to explicitly
+ * set it. If not present then the API is attempted to be discovered
+ * through the auto-discovery mechanism.
+ *
+ * @var string OPTION_API
+ */
+ const OPTION_API = 'oembed_api';
+
+ /**
+ * Options for oEmbed requests
+ *
+ * @var array $options The options for making requests
+ */
+ protected $options = array(
+ self::OPTION_TIMEOUT => 3,
+ self::OPTION_API => null,
+ self::OPTION_USER_AGENT => 'Services_oEmbed 0.1.0'
+ );
+
+ /**
+ * URL of object to get embed information for
+ *
+ * @var object $url {@link Net_URL2} instance of URL of object
+ */
+ protected $url = null;
+
+ /**
+ * Constructor
+ *
+ * @param string $url The URL to fetch an oEmbed for
+ * @param array $options A list of options for the oEmbed lookup
+ *
+ * @throws {@link Services_oEmbed_Exception} if the $url is invalid
+ * @throws {@link Services_oEmbed_Exception} when no valid API is found
+ * @return void
+ */
+ public function __construct($url, array $options = array())
+ {
+ if (Validate::uri($url)) {
+ $this->url = new Net_URL2($url);
+ } else {
+ throw new Services_oEmbed_Exception('URL is invalid');
+ }
+
+ if (count($options)) {
+ foreach ($options as $key => $val) {
+ $this->setOption($key, $val);
+ }
+ }
+
+ if ($this->options[self::OPTION_API] === null) {
+ $this->options[self::OPTION_API] = $this->discover();
+ }
+ }
+
+ /**
+ * Set an option for the oEmbed request
+ *
+ * @param mixed $option The option name
+ * @param mixed $value The option value
+ *
+ * @see Services_oEmbed::OPTION_API, Services_oEmbed::OPTION_TIMEOUT
+ * @throws {@link Services_oEmbed_Exception} on invalid option
+ * @access public
+ * @return void
+ */
+ public function setOption($option, $value)
+ {
+ switch ($option) {
+ case self::OPTION_API:
+ case self::OPTION_TIMEOUT:
+ break;
+ default:
+ throw new Services_oEmbed_Exception(
+ 'Invalid option "' . $option . '"'
+ );
+ }
+
+ $func = '_set_' . $option;
+ if (method_exists($this, $func)) {
+ $this->options[$option] = $this->$func($value);
+ } else {
+ $this->options[$option] = $value;
+ }
+ }
+
+ /**
+ * Set the API option
+ *
+ * @param string $value The API's URI
+ *
+ * @throws {@link Services_oEmbed_Exception} on invalid API URI
+ * @see Validate::uri()
+ * @return string
+ */
+ protected function _set_oembed_api($value)
+ {
+ if (!Validate::uri($value)) {
+ throw new Services_oEmbed_Exception(
+ 'API URI provided is invalid'
+ );
+ }
+
+ return $value;
+ }
+
+ /**
+ * Get the oEmbed response
+ *
+ * @param array $params Optional parameters for
+ *
+ * @throws {@link Services_oEmbed_Exception} on cURL errors
+ * @throws {@link Services_oEmbed_Exception} on HTTP errors
+ * @throws {@link Services_oEmbed_Exception} when result is not parsable
+ * @return object The oEmbed response as an object
+ */
+ public function getObject(array $params = array())
+ {
+ $params['url'] = $this->url->getURL();
+ if (!isset($params['format'])) {
+ $params['format'] = 'json';
+ }
+
+ $sets = array();
+ foreach ($params as $var => $val) {
+ $sets[] = $var . '=' . urlencode($val);
+ }
+
+ $url = $this->options[self::OPTION_API] . '?' . implode('&', $sets);
+
+ $ch = curl_init();
+ curl_setopt($ch, CURLOPT_URL, $url);
+ curl_setopt($ch, CURLOPT_HEADER, false);
+ curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
+ curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, $this->options[self::OPTION_TIMEOUT]);
+ $result = curl_exec($ch);
+
+ if (curl_errno($ch)) {
+ throw new Services_oEmbed_Exception(
+ curl_error($ch), curl_errno($ch)
+ );
+ }
+
+ $code = curl_getinfo($ch, CURLINFO_HTTP_CODE);
+ if (substr($code, 0, 1) != '2') {
+ throw new Services_oEmbed_Exception('Non-200 code returned');
+ }
+
+ curl_close($ch);
+
+ switch ($params['format']) {
+ case 'json':
+ $res = json_decode($result);
+ if (!is_object($res)) {
+ throw new Services_oEmbed_Exception(
+ 'Could not parse JSON response'
+ );
+ }
+ break;
+ case 'xml':
+ libxml_use_internal_errors(true);
+ $res = simplexml_load_string($result);
+ if (!$res instanceof SimpleXMLElement) {
+ $errors = libxml_get_errors();
+ $err = array_shift($errors);
+ libxml_clear_errors();
+ libxml_use_internal_errors(false);
+ throw new Services_oEmbed_Exception(
+ $err->message, $error->code
+ );
+ }
+ break;
+ }
+
+ return Services_oEmbed_Object::factory($res);
+ }
+
+ /**
+ * Discover an oEmbed API
+ *
+ * @param string $url The URL to attempt to discover oEmbed for
+ *
+ * @throws {@link Services_oEmbed_Exception} if the $url is invalid
+ * @return string The oEmbed API endpoint discovered
+ */
+ protected function discover($url)
+ {
+ $body = $this->sendRequest($url);
+
+ // Find all <link /> tags that have a valid oembed type set. We then
+ // extract the href attribute for each type.
+ $regexp = '#<link([^>]*)type="' .
+ '(application/json|text/xml)\+oembed"([^>]*)>#i';
+
+ $m = $ret = array();
+ if (!preg_match_all($regexp, $body, $m)) {
+ throw new Services_oEmbed_Exception_NoSupport(
+ 'No valid oEmbed links found on page'
+ );
+ }
+
+ foreach ($m[0] as $i => $link) {
+ $h = array();
+ if (preg_match('/href="([^"]+)"/i', $link, $h)) {
+ $ret[$m[2][$i]] = $h[1];
+ }
+ }
+
+ return (isset($ret['json']) ? $ret['json'] : array_pop($ret));
+ }
+
+ /**
+ * Send a GET request to the provider
+ *
+ * @param mixed $url The URL to send the request to
+ *
+ * @throws {@link Services_oEmbed_Exception} on HTTP errors
+ * @return string The contents of the response
+ */
+ private function sendRequest($url)
+ {
+ $ch = curl_init();
+ curl_setopt($ch, CURLOPT_URL, $url);
+ curl_setopt($ch, CURLOPT_HEADER, false);
+ curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
+ curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, $this->options[self::OPTION_TIMEOUT]);
+ curl_setopt($ch, CURLOPT_USERAGENT, $this->options[self::OPTION_USER_AGENT]);
+ $result = curl_exec($ch);
+ if (curl_errno($ch)) {
+ throw new Services_oEmbed_Exception(
+ curl_error($ch), curl_errno($ch)
+ );
+ }
+
+ $code = curl_getinfo($ch, CURLINFO_HTTP_CODE);
+ if (substr($code, 0, 1) != '2') {
+ throw new Services_oEmbed_Exception('Non-200 code returned');
+ }
+
+ return $result;
+ }
+}
+
+?>
--- /dev/null
+<?php
+
+/**
+ * Base exception class for {@link Services_oEmbed}
+ *
+ * PHP version 5.1.0+
+ *
+ * Copyright (c) 2008, Digg.com, Inc.
+ *
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions are met:
+ *
+ * - Redistributions of source code must retain the above copyright notice,
+ * this list of conditions and the following disclaimer.
+ * - Redistributions in binary form must reproduce the above copyright notice,
+ * this list of conditions and the following disclaimer in the documentation
+ * and/or other materials provided with the distribution.
+ * - Neither the name of Digg.com, Inc. nor the names of its contributors
+ * may be used to endorse or promote products derived from this software
+ * without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+ * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+ * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
+ * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+ * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+ * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+ * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+ * POSSIBILITY OF SUCH DAMAGE.
+ *
+ * @category Services
+ * @package Services_oEmbed
+ * @author Joe Stump <joe@joestump.net>
+ * @copyright 2008 Digg.com, Inc.
+ * @license http://tinyurl.com/42zef New BSD License
+ * @version SVN: @version@
+ * @link http://code.google.com/p/digg
+ * @link http://oembed.com
+ */
+
+require_once 'PEAR/Exception.php';
+
+/**
+ * Base exception class for {@link Services_oEmbed}
+ *
+ * @category Services
+ * @package Services_oEmbed
+ * @author Joe Stump <joe@joestump.net>
+ * @copyright 2008 Digg.com, Inc.
+ * @license http://tinyurl.com/42zef New BSD License
+ * @version Release: @version@
+ * @link http://code.google.com/p/digg
+ * @link http://oembed.com
+ */
+class Services_oEmbed_Exception extends PEAR_Exception
+{
+
+}
+
+?>
--- /dev/null
+<?php
+
+/**
+ * Exception class when no oEmbed support is discovered
+ *
+ * PHP version 5.2.0+
+ *
+ * Copyright (c) 2008, Digg.com, Inc.
+ *
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions are met:
+ *
+ * - Redistributions of source code must retain the above copyright notice,
+ * this list of conditions and the following disclaimer.
+ * - Redistributions in binary form must reproduce the above copyright notice,
+ * this list of conditions and the following disclaimer in the documentation
+ * and/or other materials provided with the distribution.
+ * - Neither the name of Digg.com, Inc. nor the names of its contributors
+ * may be used to endorse or promote products derived from this software
+ * without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+ * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+ * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
+ * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+ * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+ * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+ * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+ * POSSIBILITY OF SUCH DAMAGE.
+ *
+ * @category Services
+ * @package Services_oEmbed
+ * @author Joe Stump <joe@joestump.net>
+ * @copyright 2008 Digg.com, Inc.
+ * @license http://tinyurl.com/42zef New BSD License
+ * @version SVN: @version@
+ * @link http://code.google.com/p/digg
+ * @link http://oembed.com
+ */
+
+/**
+ * Exception class when no oEmbed support is discovered
+ *
+ * @category Services
+ * @package Services_oEmbed
+ * @author Joe Stump <joe@joestump.net>
+ * @copyright 2008 Digg.com, Inc.
+ * @license http://tinyurl.com/42zef New BSD License
+ * @version Release: @version@
+ * @link http://code.google.com/p/digg
+ * @link http://oembed.com
+ */
+class Services_oEmbed_Exception_NoSupport extends Services_oEmbed_Exception
+{
+
+}
+
+?>
--- /dev/null
+<?php
+
+/**
+ * An interface for oEmbed consumption
+ *
+ * PHP version 5.1.0+
+ *
+ * Copyright (c) 2008, Digg.com, Inc.
+ *
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions are met:
+ *
+ * - Redistributions of source code must retain the above copyright notice,
+ * this list of conditions and the following disclaimer.
+ * - Redistributions in binary form must reproduce the above copyright notice,
+ * this list of conditions and the following disclaimer in the documentation
+ * and/or other materials provided with the distribution.
+ * - Neither the name of Digg.com, Inc. nor the names of its contributors
+ * may be used to endorse or promote products derived from this software
+ * without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+ * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+ * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
+ * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+ * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+ * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+ * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+ * POSSIBILITY OF SUCH DAMAGE.
+ *
+ * @category Services
+ * @package Services_oEmbed
+ * @author Joe Stump <joe@joestump.net>
+ * @copyright 2008 Digg.com, Inc.
+ * @license http://tinyurl.com/42zef New BSD License
+ * @version SVN: @version@
+ * @link http://code.google.com/p/digg
+ * @link http://oembed.com
+ */
+
+require_once 'Services/oEmbed/Object/Exception.php';
+
+/**
+ * Base class for consuming oEmbed objects
+ *
+ * @category Services
+ * @package Services_oEmbed
+ * @author Joe Stump <joe@joestump.net>
+ * @copyright 2008 Digg.com, Inc.
+ * @license http://tinyurl.com/42zef New BSD License
+ * @version Release: @version@
+ * @link http://code.google.com/p/digg
+ * @link http://oembed.com
+ */
+abstract class Services_oEmbed_Object
+{
+
+ /**
+ * Valid oEmbed object types
+ *
+ * @var array $types Array of valid object types
+ * @see Services_oEmbed_Object::factory()
+ */
+ static protected $types = array(
+ 'photo' => 'Photo',
+ 'video' => 'Video',
+ 'link' => 'Link',
+ 'rich' => 'Rich'
+ );
+
+ /**
+ * Create an oEmbed object from result
+ *
+ * @param object $object Raw object returned from API
+ *
+ * @throws {@link Services_oEmbed_Object_Exception} on object error
+ * @return object Instance of object driver
+ * @see Services_oEmbed_Object_Link, Services_oEmbed_Object_Photo
+ * @see Services_oEmbed_Object_Rich, Services_oEmbed_Object_Video
+ */
+ static public function factory($object)
+ {
+ if (!isset($object->type)) {
+ throw new Services_oEmbed_Object_Exception(
+ 'Object has no type'
+ );
+ }
+
+ $type = (string)$object->type;
+ if (!isset(self::$types[$type])) {
+ throw new Services_oEmbed_Object_Exception(
+ 'Object type is unknown or invalid: ' . $type
+ );
+ }
+
+ $file = 'Services/oEmbed/Object/' . self::$types[$type] . '.php';
+ include_once $file;
+
+ $class = 'Services_oEmbed_Object_' . self::$types[$type];
+ if (!class_exists($class)) {
+ throw new Services_oEmbed_Object_Exception(
+ 'Object class is invalid or not present'
+ );
+ }
+
+ $instance = new $class($object);
+ return $instance;
+ }
+
+ /**
+ * Instantiation is not allowed
+ *
+ * @return void
+ */
+ private function __construct()
+ {
+
+ }
+}
+
+?>
--- /dev/null
+<?php
+
+/**
+ * Base class for oEmbed objects
+ *
+ * PHP version 5.1.0+
+ *
+ * Copyright (c) 2008, Digg.com, Inc.
+ *
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions are met:
+ *
+ * - Redistributions of source code must retain the above copyright notice,
+ * this list of conditions and the following disclaimer.
+ * - Redistributions in binary form must reproduce the above copyright notice,
+ * this list of conditions and the following disclaimer in the documentation
+ * and/or other materials provided with the distribution.
+ * - Neither the name of Digg.com, Inc. nor the names of its contributors
+ * may be used to endorse or promote products derived from this software
+ * without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+ * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+ * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
+ * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+ * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+ * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+ * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+ * POSSIBILITY OF SUCH DAMAGE.
+ *
+ * @category Services
+ * @package Services_oEmbed
+ * @author Joe Stump <joe@joestump.net>
+ * @copyright 2008 Digg.com, Inc.
+ * @license http://tinyurl.com/42zef New BSD License
+ * @version SVN: @version@
+ * @link http://code.google.com/p/digg
+ * @link http://oembed.com
+ */
+
+/**
+ * Base class for oEmbed objects
+ *
+ * @category Services
+ * @package Services_oEmbed
+ * @author Joe Stump <joe@joestump.net>
+ * @copyright 2008 Digg.com, Inc.
+ * @license http://tinyurl.com/42zef New BSD License
+ * @version Release: @version@
+ * @link http://code.google.com/p/digg
+ * @link http://oembed.com
+ */
+abstract class Services_oEmbed_Object_Common
+{
+ /**
+ * Raw object returned from API
+ *
+ * @var object $object The raw object from the API
+ */
+ protected $object = null;
+
+ /**
+ * Required fields per the specification
+ *
+ * @var array $required Array of required fields
+ * @link http://oembed.com
+ */
+ protected $required = array();
+
+ /**
+ * Constructor
+ *
+ * @param object $object Raw object returned from the API
+ *
+ * @throws {@link Services_oEmbed_Object_Exception} on missing fields
+ * @return void
+ */
+ public function __construct($object)
+ {
+ $this->object = $object;
+
+ $this->required[] = 'version';
+ foreach ($this->required as $field) {
+ if (!isset($this->$field)) {
+ throw new Services_oEmbed_Object_Exception(
+ 'Object is missing required ' . $field . ' attribute'
+ );
+ }
+ }
+ }
+
+ /**
+ * Get object variable
+ *
+ * @param string $var Variable to get
+ *
+ * @see Services_oEmbed_Object_Common::$object
+ * @return mixed Attribute's value or null if it's not set/exists
+ */
+ public function __get($var)
+ {
+ if (property_exists($this->object, $var)) {
+ return $this->object->$var;
+ }
+
+ return null;
+ }
+
+ /**
+ * Is variable set?
+ *
+ * @param string $var Variable name to check
+ *
+ * @return boolean True if set, false if not
+ * @see Services_oEmbed_Object_Common::$object
+ */
+ public function __isset($var)
+ {
+ if (property_exists($this->object, $var)) {
+ return (isset($this->object->$var));
+ }
+
+ return false;
+ }
+
+ /**
+ * Require a sane __toString for all objects
+ *
+ * @return string
+ */
+ abstract public function __toString();
+}
+
+?>
--- /dev/null
+<?php
+
+/**
+ * Exception for {@link Services_oEmbed_Object}
+ *
+ * PHP version 5.1.0+
+ *
+ * Copyright (c) 2008, Digg.com, Inc.
+ *
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions are met:
+ *
+ * - Redistributions of source code must retain the above copyright notice,
+ * this list of conditions and the following disclaimer.
+ * - Redistributions in binary form must reproduce the above copyright notice,
+ * this list of conditions and the following disclaimer in the documentation
+ * and/or other materials provided with the distribution.
+ * - Neither the name of Digg.com, Inc. nor the names of its contributors
+ * may be used to endorse or promote products derived from this software
+ * without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+ * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+ * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
+ * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+ * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+ * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+ * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+ * POSSIBILITY OF SUCH DAMAGE.
+ *
+ * @category Services
+ * @package Services_oEmbed
+ * @author Joe Stump <joe@joestump.net>
+ * @copyright 2008 Digg.com, Inc.
+ * @license http://tinyurl.com/42zef New BSD License
+ * @version SVN: @version@
+ * @link http://code.google.com/p/digg
+ * @link http://oembed.com
+ */
+
+require_once 'Services/oEmbed/Exception.php';
+
+/**
+ * Exception for {@link Services_oEmbed_Object}
+ *
+ * @category Services
+ * @package Services_oEmbed
+ * @author Joe Stump <joe@joestump.net>
+ * @copyright 2008 Digg.com, Inc.
+ * @license http://tinyurl.com/42zef New BSD License
+ * @version Release: @version@
+ * @link http://code.google.com/p/digg
+ * @link http://oembed.com
+ */
+class Services_oEmbed_Object_Exception extends Services_oEmbed_Exception
+{
+
+}
+
+?>
--- /dev/null
+<?php
+
+/**
+ * Link object for {@link Services_oEmbed}
+ *
+ * PHP version 5.2.0+
+ *
+ * Copyright (c) 2008, Digg.com, Inc.
+ *
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions are met:
+ *
+ * - Redistributions of source code must retain the above copyright notice,
+ * this list of conditions and the following disclaimer.
+ * - Redistributions in binary form must reproduce the above copyright notice,
+ * this list of conditions and the following disclaimer in the documentation
+ * and/or other materials provided with the distribution.
+ * - Neither the name of Digg.com, Inc. nor the names of its contributors
+ * may be used to endorse or promote products derived from this software
+ * without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+ * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+ * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
+ * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+ * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+ * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+ * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+ * POSSIBILITY OF SUCH DAMAGE.
+ *
+ * @category Services
+ * @package Services_oEmbed
+ * @author Joe Stump <joe@joestump.net>
+ * @copyright 2008 Digg.com, Inc.
+ * @license http://tinyurl.com/42zef New BSD License
+ * @version SVN: @version@
+ * @link http://code.google.com/p/digg
+ * @link http://oembed.com
+ */
+
+require_once 'Services/oEmbed/Object/Common.php';
+
+/**
+ * Link object for {@link Services_oEmbed}
+ *
+ * @category Services
+ * @package Services_oEmbed
+ * @author Joe Stump <joe@joestump.net>
+ * @copyright 2008 Digg.com, Inc.
+ * @license http://tinyurl.com/42zef New BSD License
+ * @version Release: @version@
+ * @link http://code.google.com/p/digg
+ * @link http://oembed.com
+ */
+class Services_oEmbed_Object_Link extends Services_oEmbed_Object_Common
+{
+ /**
+ * Output a sane link
+ *
+ * @return string An HTML link of the object
+ */
+ public function __toString()
+ {
+ return '<a href="' . $this->url . '">' . $this->title . '</a>';
+ }
+}
+
+?>
--- /dev/null
+<?php
+
+/**
+ * Photo object for {@link Services_oEmbed}
+ *
+ * PHP version 5.2.0+
+ *
+ * Copyright (c) 2008, Digg.com, Inc.
+ *
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions are met:
+ *
+ * - Redistributions of source code must retain the above copyright notice,
+ * this list of conditions and the following disclaimer.
+ * - Redistributions in binary form must reproduce the above copyright notice,
+ * this list of conditions and the following disclaimer in the documentation
+ * and/or other materials provided with the distribution.
+ * - Neither the name of Digg.com, Inc. nor the names of its contributors
+ * may be used to endorse or promote products derived from this software
+ * without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+ * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+ * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
+ * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+ * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+ * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+ * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+ * POSSIBILITY OF SUCH DAMAGE.
+ *
+ * @category Services
+ * @package Services_oEmbed
+ * @author Joe Stump <joe@joestump.net>
+ * @copyright 2008 Digg.com, Inc.
+ * @license http://tinyurl.com/42zef New BSD License
+ * @version SVN: @version@
+ * @link http://code.google.com/p/digg
+ * @link http://oembed.com
+ */
+
+require_once 'Services/oEmbed/Object/Common.php';
+
+/**
+ * Photo object for {@link Services_oEmbed}
+ *
+ * @category Services
+ * @package Services_oEmbed
+ * @author Joe Stump <joe@joestump.net>
+ * @copyright 2008 Digg.com, Inc.
+ * @license http://tinyurl.com/42zef New BSD License
+ * @version Release: @version@
+ * @link http://code.google.com/p/digg
+ * @link http://oembed.com
+ */
+class Services_oEmbed_Object_Photo extends Services_oEmbed_Object_Common
+{
+ /**
+ * Required fields for photo objects
+ *
+ * @var array $required Required fields
+ */
+ protected $required = array(
+ 'url', 'width', 'height'
+ );
+
+ /**
+ * Output a valid HTML tag for image
+ *
+ * @return string HTML <img /> tag for Photo
+ */
+ public function __toString()
+ {
+ $img = '<img src="' . $this->url . '" width="' . $this->width . '" ' .
+ 'height="' . $this->height . '"';
+
+ if (isset($this->title)) {
+ $img .= ' alt="' . $this->title . '"';
+ }
+
+ return $img . ' />';
+ }
+}
+
+?>
--- /dev/null
+<?php
+
+/**
+ * Photo object for {@link Services_oEmbed}
+ *
+ * PHP version 5.2.0+
+ *
+ * Copyright (c) 2008, Digg.com, Inc.
+ *
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions are met:
+ *
+ * - Redistributions of source code must retain the above copyright notice,
+ * this list of conditions and the following disclaimer.
+ * - Redistributions in binary form must reproduce the above copyright notice,
+ * this list of conditions and the following disclaimer in the documentation
+ * and/or other materials provided with the distribution.
+ * - Neither the name of Digg.com, Inc. nor the names of its contributors
+ * may be used to endorse or promote products derived from this software
+ * without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+ * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+ * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
+ * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+ * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+ * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+ * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+ * POSSIBILITY OF SUCH DAMAGE.
+ *
+ * @category Services
+ * @package Services_oEmbed
+ * @author Joe Stump <joe@joestump.net>
+ * @copyright 2008 Digg.com, Inc.
+ * @license http://tinyurl.com/42zef New BSD License
+ * @version SVN: @version@
+ * @link http://code.google.com/p/digg
+ * @link http://oembed.com
+ */
+
+require_once 'Services/oEmbed/Object/Common.php';
+
+/**
+ * Photo object for {@link Services_oEmbed}
+ *
+ * @category Services
+ * @package Services_oEmbed
+ * @author Joe Stump <joe@joestump.net>
+ * @copyright 2008 Digg.com, Inc.
+ * @license http://tinyurl.com/42zef New BSD License
+ * @version Release: @version@
+ * @link http://code.google.com/p/digg
+ * @link http://oembed.com
+ */
+class Services_oEmbed_Object_Rich extends Services_oEmbed_Object_Common
+{
+ /**
+ * Required fields for rich objects
+ *
+ * @var array $required Required fields
+ */
+ protected $required = array(
+ 'html', 'width', 'height'
+ );
+
+ /**
+ * Output a the HTML tag for rich object
+ *
+ * @return string HTML for rich object
+ */
+ public function __toString()
+ {
+ return $this->html;
+ }
+}
+
+?>
--- /dev/null
+<?php
+
+/**
+ * Photo object for {@link Services_oEmbed}
+ *
+ * PHP version 5.2.0+
+ *
+ * Copyright (c) 2008, Digg.com, Inc.
+ *
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions are met:
+ *
+ * - Redistributions of source code must retain the above copyright notice,
+ * this list of conditions and the following disclaimer.
+ * - Redistributions in binary form must reproduce the above copyright notice,
+ * this list of conditions and the following disclaimer in the documentation
+ * and/or other materials provided with the distribution.
+ * - Neither the name of Digg.com, Inc. nor the names of its contributors
+ * may be used to endorse or promote products derived from this software
+ * without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+ * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+ * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
+ * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+ * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+ * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+ * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+ * POSSIBILITY OF SUCH DAMAGE.
+ *
+ * @category Services
+ * @package Services_oEmbed
+ * @author Joe Stump <joe@joestump.net>
+ * @copyright 2008 Digg.com, Inc.
+ * @license http://tinyurl.com/42zef New BSD License
+ * @version SVN: @version@
+ * @link http://code.google.com/p/digg
+ * @link http://oembed.com
+ */
+
+require_once 'Services/oEmbed/Object/Common.php';
+
+/**
+ * Photo object for {@link Services_oEmbed}
+ *
+ * @category Services
+ * @package Services_oEmbed
+ * @author Joe Stump <joe@joestump.net>
+ * @copyright 2008 Digg.com, Inc.
+ * @license http://tinyurl.com/42zef New BSD License
+ * @version Release: @version@
+ * @link http://code.google.com/p/digg
+ * @link http://oembed.com
+ */
+class Services_oEmbed_Object_Video extends Services_oEmbed_Object_Common
+{
+ /**
+ * Required fields for video objects
+ *
+ * @var array $required Required fields
+ */
+ protected $required = array(
+ 'html', 'width', 'height'
+ );
+
+ /**
+ * Output a valid embed tag for video
+ *
+ * @return string HTML for video
+ */
+ public function __toString()
+ {
+ return $this->html;
+ }
+}
+
+?>
-<?php\r
-/* vim: set expandtab tabstop=4 shiftwidth=4: */\r
-// +----------------------------------------------------------------------+\r
-// | Copyright (c) 1997-2006 Pierre-Alain Joye,Tomas V.V.Cox, Amir Saied |\r
-// +----------------------------------------------------------------------+\r
-// | This source file is subject to the New BSD license, That is bundled |\r
-// | with this package in the file LICENSE, and is available through |\r
-// | the world-wide-web at |\r
-// | http://www.opensource.org/licenses/bsd-license.php |\r
-// | If you did not receive a copy of the new BSDlicense and are unable |\r
-// | to obtain it through the world-wide-web, please send a note to |\r
-// | pajoye@php.net so we can mail you a copy immediately. |\r
-// +----------------------------------------------------------------------+\r
-// | Author: Tomas V.V.Cox <cox@idecnet.com> |\r
-// | Pierre-Alain Joye <pajoye@php.net> |\r
-// | Amir Mohammad Saied <amir@php.net> |\r
-// +----------------------------------------------------------------------+\r
-//\r
-/**\r
- * Validation class\r
- *\r
- * Package to validate various datas. It includes :\r
- * - numbers (min/max, decimal or not)\r
- * - email (syntax, domain check)\r
- * - string (predifined type alpha upper and/or lowercase, numeric,...)\r
- * - date (min, max, rfc822 compliant)\r
- * - uri (RFC2396)\r
- * - possibility valid multiple data with a single method call (::multiple)\r
- *\r
- * @category Validate\r
- * @package Validate\r
- * @author Tomas V.V.Cox <cox@idecnet.com>\r
- * @author Pierre-Alain Joye <pajoye@php.net>\r
- * @author Amir Mohammad Saied <amir@php.net>\r
- * @copyright 1997-2006 Pierre-Alain Joye,Tomas V.V.Cox,Amir Mohammad Saied\r
- * @license http://www.opensource.org/licenses/bsd-license.php New BSD License\r
- * @version CVS: $Id: Validate.php,v 1.123 2007/12/12 16:45:51 davidc Exp $\r
- * @link http://pear.php.net/package/Validate\r
- */\r
-\r
-/**\r
- * Methods for common data validations\r
- */\r
-define('VALIDATE_NUM', '0-9');\r
-define('VALIDATE_SPACE', '\s');\r
-define('VALIDATE_ALPHA_LOWER', 'a-z');\r
-define('VALIDATE_ALPHA_UPPER', 'A-Z');\r
-define('VALIDATE_ALPHA', VALIDATE_ALPHA_LOWER . VALIDATE_ALPHA_UPPER);\r
-define('VALIDATE_EALPHA_LOWER', VALIDATE_ALPHA_LOWER . 'áéíóúýàèìòùäëïöüÿâêîôûãñõ¨åæç½ðøþß');\r
-define('VALIDATE_EALPHA_UPPER', VALIDATE_ALPHA_UPPER . 'ÁÉÍÓÚÝÀÈÌÒÙÄËÏÖܾÂÊÎÔÛÃÑÕ¦ÅÆǼÐØÞ');\r
-define('VALIDATE_EALPHA', VALIDATE_EALPHA_LOWER . VALIDATE_EALPHA_UPPER);\r
-define('VALIDATE_PUNCTUATION', VALIDATE_SPACE . '\.,;\:&"\'\?\!\(\)');\r
-define('VALIDATE_NAME', VALIDATE_EALPHA . VALIDATE_SPACE . "'" . "-");\r
-define('VALIDATE_STREET', VALIDATE_NUM . VALIDATE_NAME . "/\\ºª\.");\r
-\r
-define('VALIDATE_ITLD_EMAILS', 1);\r
-define('VALIDATE_GTLD_EMAILS', 2);\r
-define('VALIDATE_CCTLD_EMAILS', 4);\r
-define('VALIDATE_ALL_EMAILS', 8);\r
-\r
-/**\r
- * Validation class\r
- *\r
- * Package to validate various datas. It includes :\r
- * - numbers (min/max, decimal or not)\r
- * - email (syntax, domain check)\r
- * - string (predifined type alpha upper and/or lowercase, numeric,...)\r
- * - date (min, max)\r
- * - uri (RFC2396)\r
- * - possibility valid multiple data with a single method call (::multiple)\r
- *\r
- * @category Validate\r
- * @package Validate\r
- * @author Tomas V.V.Cox <cox@idecnet.com>\r
- * @author Pierre-Alain Joye <pajoye@php.net>\r
- * @author Amir Mohammad Saied <amir@php.net>\r
- * @copyright 1997-2006 Pierre-Alain Joye,Tomas V.V.Cox,Amir Mohammad Saied\r
- * @license http://www.opensource.org/licenses/bsd-license.php New BSD License\r
- * @version Release: @package_version@\r
- * @link http://pear.php.net/package/Validate\r
- */\r
-class Validate\r
-{\r
- /**\r
- * International Top-Level Domain\r
- *\r
- * This is an array of the known international\r
- * top-level domain names.\r
- *\r
- * @access protected\r
- * @var array $_iTld (International top-level domains)\r
- */\r
- var $_itld = array(\r
- 'arpa',\r
- 'root',\r
- );\r
-\r
- /**\r
- * Generic top-level domain\r
- *\r
- * This is an array of the official\r
- * generic top-level domains.\r
- *\r
- * @access protected\r
- * @var array $_gTld (Generic top-level domains)\r
- */\r
- var $_gtld = array(\r
- 'aero',\r
- 'biz',\r
- 'cat',\r
- 'com',\r
- 'coop',\r
- 'edu',\r
- 'gov',\r
- 'info',\r
- 'int',\r
- 'jobs',\r
- 'mil',\r
- 'mobi',\r
- 'museum',\r
- 'name',\r
- 'net',\r
- 'org',\r
- 'pro',\r
- 'travel',\r
- 'asia',\r
- 'post',\r
- 'tel',\r
- 'geo',\r
- );\r
-\r
- /**\r
- * Country code top-level domains\r
- *\r
- * This is an array of the official country\r
- * codes top-level domains\r
- *\r
- * @access protected\r
- * @var array $_ccTld (Country Code Top-Level Domain)\r
- */\r
- var $_cctld = array(\r
- 'ac',\r
- 'ad','ae','af','ag',\r
- 'ai','al','am','an',\r
- 'ao','aq','ar','as',\r
- 'at','au','aw','ax',\r
- 'az','ba','bb','bd',\r
- 'be','bf','bg','bh',\r
- 'bi','bj','bm','bn',\r
- 'bo','br','bs','bt',\r
- 'bu','bv','bw','by',\r
- 'bz','ca','cc','cd',\r
- 'cf','cg','ch','ci',\r
- 'ck','cl','cm','cn',\r
- 'co','cr','cs','cu',\r
- 'cv','cx','cy','cz',\r
- 'de','dj','dk','dm',\r
- 'do','dz','ec','ee',\r
- 'eg','eh','er','es',\r
- 'et','eu','fi','fj',\r
- 'fk','fm','fo','fr',\r
- 'ga','gb','gd','ge',\r
- 'gf','gg','gh','gi',\r
- 'gl','gm','gn','gp',\r
- 'gq','gr','gs','gt',\r
- 'gu','gw','gy','hk',\r
- 'hm','hn','hr','ht',\r
- 'hu','id','ie','il',\r
- 'im','in','io','iq',\r
- 'ir','is','it','je',\r
- 'jm','jo','jp','ke',\r
- 'kg','kh','ki','km',\r
- 'kn','kp','kr','kw',\r
- 'ky','kz','la','lb',\r
- 'lc','li','lk','lr',\r
- 'ls','lt','lu','lv',\r
- 'ly','ma','mc','md',\r
- 'me','mg','mh','mk',\r
- 'ml','mm','mn','mo',\r
- 'mp','mq','mr','ms',\r
- 'mt','mu','mv','mw',\r
- 'mx','my','mz','na',\r
- 'nc','ne','nf','ng',\r
- 'ni','nl','no','np',\r
- 'nr','nu','nz','om',\r
- 'pa','pe','pf','pg',\r
- 'ph','pk','pl','pm',\r
- 'pn','pr','ps','pt',\r
- 'pw','py','qa','re',\r
- 'ro','rs','ru','rw',\r
- 'sa','sb','sc','sd',\r
- 'se','sg','sh','si',\r
- 'sj','sk','sl','sm',\r
- 'sn','so','sr','st',\r
- 'su','sv','sy','sz',\r
- 'tc','td','tf','tg',\r
- 'th','tj','tk','tl',\r
- 'tm','tn','to','tp',\r
- 'tr','tt','tv','tw',\r
- 'tz','ua','ug','uk',\r
- 'us','uy','uz','va',\r
- 'vc','ve','vg','vi',\r
- 'vn','vu','wf','ws',\r
- 'ye','yt','yu','za',\r
- 'zm','zw',\r
- );\r
-\r
-\r
- /**\r
- * Validate a number\r
- *\r
- * @param string $number Number to validate\r
- * @param array $options array where:\r
- * 'decimal' is the decimal char or false when decimal not allowed\r
- * i.e. ',.' to allow both ',' and '.'\r
- * 'dec_prec' Number of allowed decimals\r
- * 'min' minimum value\r
- * 'max' maximum value\r
- *\r
- * @return boolean true if valid number, false if not\r
- *\r
- * @access public\r
- */\r
- function number($number, $options = array())\r
- {\r
- $decimal = $dec_prec = $min = $max = null;\r
- if (is_array($options)) {\r
- extract($options);\r
- }\r
-\r
- $dec_prec = $dec_prec ? "{1,$dec_prec}" : '+';\r
- $dec_regex = $decimal ? "[$decimal][0-9]$dec_prec" : '';\r
-\r
- if (!preg_match("|^[-+]?\s*[0-9]+($dec_regex)?\$|", $number)) {\r
- return false;\r
- }\r
-\r
- if ($decimal != '.') {\r
- $number = strtr($number, $decimal, '.');\r
- }\r
-\r
- $number = (float)str_replace(' ', '', $number);\r
- if ($min !== null && $min > $number) {\r
- return false;\r
- }\r
-\r
- if ($max !== null && $max < $number) {\r
- return false;\r
- }\r
- return true;\r
- }\r
-\r
- /**\r
- * Converting a string to UTF-7 (RFC 2152)\r
- *\r
- * @param $string string to be converted\r
- *\r
- * @return string converted string\r
- *\r
- * @access private\r
- */\r
- function __stringToUtf7($string) {\r
- $return = '';\r
- $utf7 = array(\r
- 'A', 'B', 'C', 'D', 'E', 'F', 'G', 'H', 'I', 'J', 'K',\r
- 'L', 'M', 'N', 'O', 'P', 'Q', 'R', 'S', 'T', 'U', 'V',\r
- 'W', 'X', 'Y', 'Z', 'a', 'b', 'c', 'd', 'e', 'f', 'g',\r
- 'h', 'i', 'j', 'k', 'l', 'm', 'n', 'o', 'p', 'q', 'r',\r
- 's', 't', 'u', 'v', 'w', 'x', 'y', 'z', '0', '1', '2',\r
- '3', '4', '5', '6', '7', '8', '9', '+', ','\r
- );\r
-\r
- $state = 0;\r
- if (!empty($string)) {\r
- $i = 0;\r
- while ($i <= strlen($string)) {\r
- $char = substr($string, $i, 1);\r
- if ($state == 0) {\r
- if ((ord($char) >= 0x7F) || (ord($char) <= 0x1F)) {\r
- if ($char) {\r
- $return .= '&';\r
- }\r
- $state = 1;\r
- } elseif ($char == '&') {\r
- $return .= '&-';\r
- } else {\r
- $return .= $char;\r
- }\r
- } elseif (($i == strlen($string) ||\r
- !((ord($char) >= 0x7F)) || (ord($char) <= 0x1F))) {\r
- if ($state != 1) {\r
- if (ord($char) > 64) {\r
- $return .= '';\r
- } else {\r
- $return .= $utf7[ord($char)];\r
- }\r
- }\r
- $return .= '-';\r
- $state = 0;\r
- } else {\r
- switch($state) {\r
- case 1:\r
- $return .= $utf7[ord($char) >> 2];\r
- $residue = (ord($char) & 0x03) << 4;\r
- $state = 2;\r
- break;\r
- case 2:\r
- $return .= $utf7[$residue | (ord($char) >> 4)];\r
- $residue = (ord($char) & 0x0F) << 2;\r
- $state = 3;\r
- break;\r
- case 3:\r
- $return .= $utf7[$residue | (ord($char) >> 6)];\r
- $return .= $utf7[ord($char) & 0x3F];\r
- $state = 1;\r
- break;\r
- }\r
- }\r
- $i++;\r
- }\r
- return $return;\r
- }\r
- return '';\r
- }\r
-\r
- /**\r
- * Validate an email according to full RFC822 (inclusive human readable part)\r
- *\r
- * @param string $email email to validate,\r
- * will return the address for optional dns validation\r
- * @param array $options email() options\r
- *\r
- * @return boolean true if valid email, false if not\r
- *\r
- * @access private\r
- */\r
- function __emailRFC822(&$email, &$options)\r
- {\r
- if (Validate::__stringToUtf7($email) != $email) {\r
- return false;\r
- }\r
- static $address = null;\r
- static $uncomment = null;\r
- if (!$address) {\r
- // atom = 1*<any CHAR except specials, SPACE and CTLs>\r
- $atom = '[^][()<>@,;:\\".\s\000-\037\177-\377]+\s*';\r
- // qtext = <any CHAR excepting <">, ; => may be folded\r
- // "\" & CR, and including linear-white-space>\r
- $qtext = '[^"\\\\\r]';\r
- // quoted-pair = "\" CHAR ; may quote any char\r
- $quoted_pair = '\\\\.';\r
- // quoted-string = <"> *(qtext/quoted-pair) <">; Regular qtext or\r
- // ; quoted chars.\r
- $quoted_string = '"(?:' . $qtext . '|' . $quoted_pair . ')*"\s*';\r
- // word = atom / quoted-string\r
- $word = '(?:' . $atom . '|' . $quoted_string . ')';\r
- // local-part = word *("." word) ; uninterpreted\r
- // ; case-preserved\r
- $local_part = $word . '(?:\.\s*' . $word . ')*';\r
- // dtext = <any CHAR excluding "[", ; => may be folded\r
- // "]", "\" & CR, & including linear-white-space>\r
- $dtext = '[^][\\\\\r]';\r
- // domain-literal = "[" *(dtext / quoted-pair) "]"\r
- $domain_literal = '\[(?:' . $dtext . '|' . $quoted_pair . ')*\]\s*';\r
- // sub-domain = domain-ref / domain-literal\r
- // domain-ref = atom ; symbolic reference\r
- $sub_domain = '(?:' . $atom . '|' . $domain_literal . ')';\r
- // domain = sub-domain *("." sub-domain)\r
- $domain = $sub_domain . '(?:\.\s*' . $sub_domain . ')*';\r
- // addr-spec = local-part "@" domain ; global address\r
- $addr_spec = $local_part . '@\s*' . $domain;\r
- // route = 1#("@" domain) ":" ; path-relative\r
- $route = '@' . $domain . '(?:,@\s*' . $domain . ')*:\s*';\r
- // route-addr = "<" [route] addr-spec ">"\r
- $route_addr = '<\s*(?:' . $route . ')?' . $addr_spec . '>\s*';\r
- // phrase = 1*word ; Sequence of words\r
- $phrase = $word . '+';\r
- // mailbox = addr-spec ; simple address\r
- // / phrase route-addr ; name & addr-spec\r
- $mailbox = '(?:' . $addr_spec . '|' . $phrase . $route_addr . ')';\r
- // group = phrase ":" [#mailbox] ";"\r
- $group = $phrase . ':\s*(?:' . $mailbox . '(?:,\s*' . $mailbox . ')*)?;\s*';\r
- // address = mailbox ; one addressee\r
- // / group ; named list\r
- $address = '/^\s*(?:' . $mailbox . '|' . $group . ')$/';\r
- $uncomment =\r
- '/((?:(?:\\\\"|[^("])*(?:' . $quoted_string .\r
- ')?)*)((?<!\\\\)\((?:(?2)|.)*?(?<!\\\\)\))/';\r
- }\r
- // strip comments\r
- $email = preg_replace($uncomment, '$1 ', $email);\r
- return preg_match($address, $email);\r
- }\r
-\r
- /**\r
- * Full TLD Validation function\r
- *\r
- * This function is used to make a much more proficient validation\r
- * against all types of official domain names.\r
- *\r
- * @access protected\r
- * @param string $email The email address to check.\r
- * @param array $options The options for validation\r
- * @return bool True if validating succeeds\r
- */\r
- function _fullTLDValidation($email, $options)\r
- {\r
- $validate = array();\r
-\r
- switch ($options) {\r
- /** 1 */\r
- case VALIDATE_ITLD_EMAILS:\r
- array_push($validate, 'itld');\r
- break;\r
-\r
- /** 2 */\r
- case VALIDATE_GTLD_EMAILS:\r
- array_push($validate, 'gtld');\r
- break;\r
-\r
- /** 3 */\r
- case VALIDATE_ITLD_EMAILS | VALIDATE_GTLD_EMAILS:\r
- array_push($validate, 'itld');\r
- array_push($validate, 'gtld');\r
- break;\r
-\r
- /** 4 */\r
- case VALIDATE_CCTLD_EMAILS:\r
- array_push($validate, 'cctld');\r
- break;\r
-\r
- /** 5 */\r
- case VALIDATE_CCTLD_EMAILS | VALIDATE_ITLD_EMAILS:\r
- array_push($validate, 'cctld');\r
- array_push($validate, 'itld');\r
- break;\r
-\r
- /** 6 */\r
- case VALIDATE_CCTLD_EMAILS ^ VALIDATE_ITLD_EMAILS:\r
- array_push($validate, 'cctld');\r
- array_push($validate, 'itld');\r
- break;\r
-\r
- /** 7 - 8 */\r
- case VALIDATE_CCTLD_EMAILS | VALIDATE_ITLD_EMAILS | VALIDATE_GTLD_EMAILS:\r
- case VALIDATE_ALL_EMAILS:\r
- array_push($validate, 'cctld');\r
- array_push($validate, 'itld');\r
- array_push($validate, 'gtld');\r
- break;\r
- }\r
-\r
- /**\r
- * Debugging still, not implemented but code is somewhat here.\r
- */\r
-\r
- $self = new Validate;\r
-\r
- $toValidate = array();\r
-\r
- foreach ($validate as $valid) {\r
- $tmpVar = '_' . (string)$valid;\r
- $toValidate[$valid] = $self->{$tmpVar};\r
- }\r
-\r
- $e = $self->executeFullEmailValidation($email, $toValidate);\r
-\r
- return $e;\r
- }\r
- // {{{ protected function executeFullEmailValidation\r
- /**\r
- * Execute the validation\r
- *\r
- * This function will execute the full email vs tld\r
- * validation using an array of tlds passed to it.\r
- *\r
- * @access public\r
- * @param string $email The email to validate.\r
- * @param array $arrayOfTLDs The array of the TLDs to validate\r
- * @return true or false (Depending on if it validates or if it does not)\r
- */\r
- function executeFullEmailValidation($email, $arrayOfTLDs)\r
- {\r
- $emailEnding = explode('.', $email);\r
- $emailEnding = $emailEnding[count($emailEnding)-1];\r
- \r
- foreach ($arrayOfTLDs as $validator => $keys) {\r
- if (in_array($emailEnding, $keys)) {\r
- return true;\r
- }\r
- }\r
- return false;\r
- }\r
- // }}}\r
-\r
- /**\r
- * Validate an email\r
- *\r
- * @param string $email email to validate\r
- * @param mixed boolean (BC) $check_domain Check or not if the domain exists\r
- * array $options associative array of options\r
- * 'check_domain' boolean Check or not if the domain exists\r
- * 'use_rfc822' boolean Apply the full RFC822 grammar\r
- *\r
- * @return boolean true if valid email, false if not\r
- *\r
- * @access public\r
- */\r
- function email($email, $options = null)\r
- {\r
- $check_domain = false;\r
- $use_rfc822 = false;\r
- if (is_bool($options)) {\r
- $check_domain = $options;\r
- } elseif (is_array($options)) {\r
- extract($options);\r
- }\r
-\r
- /**\r
- * @todo Fix bug here.. even if it passes this, it won't be passing\r
- * The regular expression below\r
- */\r
- if (isset($fullTLDValidation)) {\r
- $valid = Validate::_fullTLDValidation($email, $fullTLDValidation);\r
-\r
- if (!$valid) {\r
- return false;\r
- }\r
- }\r
-\r
- // the base regexp for address\r
- $regex = '&^(?: # recipient:\r
- ("\s*(?:[^"\f\n\r\t\v\b\s]+\s*)+")| #1 quoted name\r
- ([-\w!\#\$%\&\'*+~/^`|{}]+(?:\.[-\w!\#\$%\&\'*+~/^`|{}]+)*)) #2 OR dot-atom\r
- @(((\[)? #3 domain, 4 as IPv4, 5 optionally bracketed\r
- (?:(?:(?:(?:25[0-5])|(?:2[0-4][0-9])|(?:[0-1]?[0-9]?[0-9]))\.){3}\r
- (?:(?:25[0-5])|(?:2[0-4][0-9])|(?:[0-1]?[0-9]?[0-9]))))(?(5)\])|\r
- ((?:[a-z0-9](?:[-a-z0-9]*[a-z0-9])?\.)*[a-z0-9](?:[-a-z0-9]*[a-z0-9])?) #6 domain as hostname\r
- \.((?:([^- ])[-a-z]*[-a-z]))) #7 TLD \r
- $&xi';\r
- \r
- if ($use_rfc822? Validate::__emailRFC822($email, $options) :\r
- preg_match($regex, $email)) {\r
- if ($check_domain && function_exists('checkdnsrr')) {\r
- list (, $domain) = explode('@', $email);\r
- if (checkdnsrr($domain, 'MX') || checkdnsrr($domain, 'A')) {\r
- return true;\r
- }\r
- return false;\r
- }\r
- return true;\r
- }\r
- return false;\r
- }\r
-\r
- /**\r
- * Validate a string using the given format 'format'\r
- *\r
- * @param string $string String to validate\r
- * @param array $options Options array where:\r
- * 'format' is the format of the string\r
- * Ex: VALIDATE_NUM . VALIDATE_ALPHA (see constants)\r
- * 'min_length' minimum length\r
- * 'max_length' maximum length\r
- *\r
- * @return boolean true if valid string, false if not\r
- *\r
- * @access public\r
- */\r
- function string($string, $options)\r
- {\r
- $format = null;\r
- $min_length = $max_length = 0;\r
- if (is_array($options)) {\r
- extract($options);\r
- }\r
- if ($format && !preg_match("|^[$format]*\$|s", $string)) {\r
- return false;\r
- }\r
- if ($min_length && strlen($string) < $min_length) {\r
- return false;\r
- }\r
- if ($max_length && strlen($string) > $max_length) {\r
- return false;\r
- }\r
- return true;\r
- }\r
-\r
- /**\r
- * Validate an URI (RFC2396)\r
- * This function will validate 'foobarstring' by default, to get it to validate\r
- * only http, https, ftp and such you have to pass it in the allowed_schemes\r
- * option, like this:\r
- * <code>\r
- * $options = array('allowed_schemes' => array('http', 'https', 'ftp'))\r
- * var_dump(Validate::uri('http://www.example.org', $options));\r
- * </code>\r
- *\r
- * NOTE 1: The rfc2396 normally allows middle '-' in the top domain\r
- * e.g. http://example.co-m should be valid\r
- * However, as '-' is not used in any known TLD, it is invalid\r
- * NOTE 2: As double shlashes // are allowed in the path part, only full URIs\r
- * including an authority can be valid, no relative URIs\r
- * the // are mandatory (optionally preceeded by the 'sheme:' )\r
- * NOTE 3: the full complience to rfc2396 is not achieved by default\r
- * the characters ';/?:@$,' will not be accepted in the query part\r
- * if not urlencoded, refer to the option "strict'"\r
- *\r
- * @param string $url URI to validate\r
- * @param array $options Options used by the validation method.\r
- * key => type\r
- * 'domain_check' => boolean\r
- * Whether to check the DNS entry or not\r
- * 'allowed_schemes' => array, list of protocols\r
- * List of allowed schemes ('http',\r
- * 'ssh+svn', 'mms')\r
- * 'strict' => string the refused chars\r
- * in query and fragment parts\r
- * default: ';/?:@$,'\r
- * empty: accept all rfc2396 foreseen chars\r
- *\r
- * @return boolean true if valid uri, false if not\r
- *\r
- * @access public\r
- */\r
- function uri($url, $options = null)\r
- {\r
- $strict = ';/?:@$,';\r
- $domain_check = false;\r
- $allowed_schemes = null;\r
- if (is_array($options)) {\r
- extract($options);\r
- }\r
- if (preg_match(\r
- '&^(?:([a-z][-+.a-z0-9]*):)? # 1. scheme\r
- (?:// # authority start\r
- (?:((?:%[0-9a-f]{2}|[-a-z0-9_.!~*\'();:\&=+$,])*)@)? # 2. authority-userinfo\r
- (?:((?:[a-z0-9](?:[-a-z0-9]*[a-z0-9])?\.)*[a-z](?:[a-z0-9]+)?\.?) # 3. authority-hostname OR\r
- |([0-9]{1,3}(?:\.[0-9]{1,3}){3})) # 4. authority-ipv4\r
- (?::([0-9]*))?) # 5. authority-port\r
- ((?:/(?:%[0-9a-f]{2}|[-a-z0-9_.!~*\'():@\&=+$,;])*)*/?)? # 6. path\r
- (?:\?([^#]*))? # 7. query\r
- (?:\#((?:%[0-9a-f]{2}|[-a-z0-9_.!~*\'();/?:@\&=+$,])*))? # 8. fragment\r
- $&xi', $url, $matches)) {\r
- $scheme = isset($matches[1]) ? $matches[1] : '';\r
- $authority = isset($matches[3]) ? $matches[3] : '' ;\r
- if (is_array($allowed_schemes) &&\r
- !in_array($scheme,$allowed_schemes)\r
- ) {\r
- return false;\r
- }\r
- if (!empty($matches[4])) {\r
- $parts = explode('.', $matches[4]);\r
- foreach ($parts as $part) {\r
- if ($part > 255) {\r
- return false;\r
- }\r
- }\r
- } elseif ($domain_check && function_exists('checkdnsrr')) {\r
- if (!checkdnsrr($authority, 'A')) {\r
- return false;\r
- }\r
- }\r
- if ($strict) {\r
- $strict = '#[' . preg_quote($strict, '#') . ']#';\r
- if ((!empty($matches[7]) && preg_match($strict, $matches[7]))\r
- || (!empty($matches[8]) && preg_match($strict, $matches[8]))) {\r
- return false;\r
- }\r
- }\r
- return true;\r
- }\r
- return false;\r
- }\r
-\r
- /**\r
- * Validate date and times. Note that this method need the Date_Calc class\r
- *\r
- * @param string $date Date to validate\r
- * @param array $options array options where :\r
- * 'format' The format of the date (%d-%m-%Y)\r
- * or rfc822_compliant\r
- * 'min' The date has to be greater\r
- * than this array($day, $month, $year)\r
- * or PEAR::Date object\r
- * 'max' The date has to be smaller than\r
- * this array($day, $month, $year)\r
- * or PEAR::Date object\r
- *\r
- * @return boolean true if valid date/time, false if not\r
- *\r
- * @access public\r
- */\r
- function date($date, $options)\r
- {\r
- $max = $min = false;\r
- $format = '';\r
- if (is_array($options)) {\r
- extract($options);\r
- }\r
-\r
- if (strtolower($format) == 'rfc822_compliant') {\r
- $preg = '&^(?:(Mon|Tue|Wed|Thu|Fri|Sat|Sun),) \s+\r
- (?:(\d{2})?) \s+\r
- (?:(Jan|Feb|Mar|Apr|May|Jun|Jul|Aug|Sep|Oct|Nov|Dec)?) \s+\r
- (?:(\d{2}(\d{2})?)?) \s+\r
- (?:(\d{2}?)):(?:(\d{2}?))(:(?:(\d{2}?)))? \s+\r
- (?:[+-]\d{4}|UT|GMT|EST|EDT|CST|CDT|MST|MDT|PST|PDT|[A-IK-Za-ik-z])$&xi';\r
-\r
- if (!preg_match($preg, $date, $matches)) {\r
- return false;\r
- }\r
-\r
- $year = (int)$matches[4];\r
- $months = array('Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun',\r
- 'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec');\r
- $month = array_keys($months, $matches[3]);\r
- $month = (int)$month[0]+1;\r
- $day = (int)$matches[2];\r
- $weekday= $matches[1];\r
- $hour = (int)$matches[6];\r
- $minute = (int)$matches[7];\r
- isset($matches[9]) ? $second = (int)$matches[9] : $second = 0;\r
-\r
- if ((strlen($year) != 4) ||\r
- ($day > 31 || $day < 1)||\r
- ($hour > 23) ||\r
- ($minute > 59) ||\r
- ($second > 59)) {\r
- return false;\r
- }\r
- } else {\r
- $date_len = strlen($format);\r
- for ($i = 0; $i < $date_len; $i++) {\r
- $c = $format{$i};\r
- if ($c == '%') {\r
- $next = $format{$i + 1};\r
- switch ($next) {\r
- case 'j':\r
- case 'd':\r
- if ($next == 'j') {\r
- $day = (int)Validate::_substr($date, 1, 2);\r
- } else {\r
- $day = (int)Validate::_substr($date, 0, 2);\r
- }\r
- if ($day < 1 || $day > 31) {\r
- return false;\r
- }\r
- break;\r
- case 'm':\r
- case 'n':\r
- if ($next == 'm') {\r
- $month = (int)Validate::_substr($date, 0, 2);\r
- } else {\r
- $month = (int)Validate::_substr($date, 1, 2);\r
- }\r
- if ($month < 1 || $month > 12) {\r
- return false;\r
- }\r
- break;\r
- case 'Y':\r
- case 'y':\r
- if ($next == 'Y') {\r
- $year = Validate::_substr($date, 4);\r
- $year = (int)$year?$year:'';\r
- } else {\r
- $year = (int)(substr(date('Y'), 0, 2) .\r
- Validate::_substr($date, 2));\r
- }\r
- if (strlen($year) != 4 || $year < 0 || $year > 9999) {\r
- return false;\r
- }\r
- break;\r
- case 'g':\r
- case 'h':\r
- if ($next == 'g') {\r
- $hour = Validate::_substr($date, 1, 2);\r
- } else {\r
- $hour = Validate::_substr($date, 2);\r
- }\r
- if (!preg_match('/^\d+$/', $hour) || $hour < 0 || $hour > 12) {\r
- return false;\r
- }\r
- break;\r
- case 'G':\r
- case 'H':\r
- if ($next == 'G') {\r
- $hour = Validate::_substr($date, 1, 2);\r
- } else {\r
- $hour = Validate::_substr($date, 2);\r
- }\r
- if (!preg_match('/^\d+$/', $hour) || $hour < 0 || $hour > 24) {\r
- return false;\r
- }\r
- break;\r
- case 's':\r
- case 'i':\r
- $t = Validate::_substr($date, 2);\r
- if (!preg_match('/^\d+$/', $t) || $t < 0 || $t > 59) {\r
- return false;\r
- }\r
- break;\r
- default:\r
- trigger_error("Not supported char `$next' after % in offset " . ($i+2), E_USER_WARNING);\r
- }\r
- $i++;\r
- } else {\r
- //literal\r
- if (Validate::_substr($date, 1) != $c) {\r
- return false;\r
- }\r
- }\r
- }\r
- }\r
- // there is remaing data, we don't want it\r
- if (strlen($date) && (strtolower($format) != 'rfc822_compliant')) {\r
- return false;\r
- }\r
-\r
- if (isset($day) && isset($month) && isset($year)) {\r
- if (!checkdate($month, $day, $year)) {\r
- return false;\r
- }\r
-\r
- if (strtolower($format) == 'rfc822_compliant') {\r
- if ($weekday != date("D", mktime(0, 0, 0, $month, $day, $year))) {\r
- return false;\r
- }\r
- }\r
-\r
- if ($min) {\r
- include_once 'Date/Calc.php';\r
- if (is_a($min, 'Date') &&\r
- (Date_Calc::compareDates($day, $month, $year,\r
- $min->getDay(), $min->getMonth(), $min->getYear()) < 0))\r
- {\r
- return false;\r
- } elseif (is_array($min) &&\r
- (Date_Calc::compareDates($day, $month, $year,\r
- $min[0], $min[1], $min[2]) < 0))\r
- {\r
- return false;\r
- }\r
- }\r
-\r
- if ($max) {\r
- include_once 'Date/Calc.php';\r
- if (is_a($max, 'Date') &&\r
- (Date_Calc::compareDates($day, $month, $year,\r
- $max->getDay(), $max->getMonth(), $max->getYear()) > 0))\r
- {\r
- return false;\r
- } elseif (is_array($max) &&\r
- (Date_Calc::compareDates($day, $month, $year,\r
- $max[0], $max[1], $max[2]) > 0))\r
- {\r
- return false;\r
- }\r
- }\r
- }\r
-\r
- return true;\r
- }\r
-\r
- function _substr(&$date, $num, $opt = false)\r
- {\r
- if ($opt && strlen($date) >= $opt && preg_match('/^[0-9]{'.$opt.'}/', $date, $m)) {\r
- $ret = $m[0];\r
- } else {\r
- $ret = substr($date, 0, $num);\r
- }\r
- $date = substr($date, strlen($ret));\r
- return $ret;\r
- }\r
-\r
- function _modf($val, $div) {\r
- if (function_exists('bcmod')) {\r
- return bcmod($val, $div);\r
- } elseif (function_exists('fmod')) {\r
- return fmod($val, $div);\r
- }\r
- $r = $val / $div;\r
- $i = intval($r);\r
- return intval($val - $i * $div + .1);\r
- }\r
-\r
- /**\r
- * Calculates sum of product of number digits with weights\r
- *\r
- * @param string $number number string\r
- * @param array $weights reference to array of weights\r
- *\r
- * @returns int returns product of number digits with weights\r
- *\r
- * @access protected\r
- */\r
- function _multWeights($number, &$weights) {\r
- if (!is_array($weights)) {\r
- return -1;\r
- }\r
- $sum = 0;\r
-\r
- $count = min(count($weights), strlen($number));\r
- if ($count == 0) { // empty string or weights array\r
- return -1;\r
- }\r
- for ($i = 0; $i < $count; ++$i) {\r
- $sum += intval(substr($number, $i, 1)) * $weights[$i];\r
- }\r
-\r
- return $sum;\r
- }\r
-\r
- /**\r
- * Calculates control digit for a given number\r
- *\r
- * @param string $number number string\r
- * @param array $weights reference to array of weights\r
- * @param int $modulo (optionsl) number\r
- * @param int $subtract (optional) number\r
- * @param bool $allow_high (optional) true if function can return number higher than 10\r
- *\r
- * @returns int -1 calculated control number is returned\r
- *\r
- * @access protected\r
- */\r
- function _getControlNumber($number, &$weights, $modulo = 10, $subtract = 0, $allow_high = false) {\r
- // calc sum\r
- $sum = Validate::_multWeights($number, $weights);\r
- if ($sum == -1) {\r
- return -1;\r
- }\r
- $mod = Validate::_modf($sum, $modulo); // calculate control digit\r
-\r
- if ($subtract > $mod && $mod > 0) {\r
- $mod = $subtract - $mod;\r
- }\r
- if ($allow_high === false) {\r
- $mod %= 10; // change 10 to zero\r
- }\r
- return $mod;\r
- }\r
-\r
- /**\r
- * Validates a number\r
- *\r
- * @param string $number number to validate\r
- * @param array $weights reference to array of weights\r
- * @param int $modulo (optionsl) number\r
- * @param int $subtract (optional) numbier\r
- *\r
- * @returns bool true if valid, false if not\r
- *\r
- * @access protected\r
- */\r
- function _checkControlNumber($number, &$weights, $modulo = 10, $subtract = 0) {\r
- if (strlen($number) < count($weights)) {\r
- return false;\r
- }\r
- $target_digit = substr($number, count($weights), 1);\r
- $control_digit = Validate::_getControlNumber($number, $weights, $modulo, $subtract, $modulo > 10);\r
-\r
- if ($control_digit == -1) {\r
- return false;\r
- }\r
- if ($target_digit === 'X' && $control_digit == 10) {\r
- return true;\r
- }\r
- if ($control_digit != $target_digit) {\r
- return false;\r
- }\r
- return true;\r
- }\r
-\r
- /**\r
- * Bulk data validation for data introduced in the form of an\r
- * assoc array in the form $var_name => $value.\r
- * Can be used on any of Validate subpackages\r
- *\r
- * @param array $data Ex: array('name' => 'toto', 'email' => 'toto@thing.info');\r
- * @param array $val_type Contains the validation type and all parameters used in.\r
- * 'val_type' is not optional\r
- * others validations properties must have the same name as the function\r
- * parameters.\r
- * Ex: array('toto'=>array('type'=>'string','format'='toto@thing.info','min_length'=>5));\r
- * @param boolean $remove if set, the elements not listed in data will be removed\r
- *\r
- * @return array value name => true|false the value name comes from the data key\r
- *\r
- * @access public\r
- */\r
- function multiple(&$data, &$val_type, $remove = false)\r
- {\r
- $keys = array_keys($data);\r
- $valid = array();\r
- foreach ($keys as $var_name) {\r
- if (!isset($val_type[$var_name])) {\r
- if ($remove) {\r
- unset($data[$var_name]);\r
- }\r
- continue;\r
- }\r
- $opt = $val_type[$var_name];\r
- $methods = get_class_methods('Validate');\r
- $val2check = $data[$var_name];\r
- // core validation method\r
- if (in_array(strtolower($opt['type']), $methods)) {\r
- //$opt[$opt['type']] = $data[$var_name];\r
- $method = $opt['type'];\r
- unset($opt['type']);\r
-\r
- if (sizeof($opt) == 1 && is_array(reset($opt))) {\r
- $opt = array_pop($opt);\r
- }\r
- $valid[$var_name] = call_user_func(array('Validate', $method), $val2check, $opt);\r
-\r
- /**\r
- * external validation method in the form:\r
- * "<class name><underscore><method name>"\r
- * Ex: us_ssn will include class Validate/US.php and call method ssn()\r
- */\r
- } elseif (strpos($opt['type'], '_') !== false) {\r
- $validateType = explode('_', $opt['type']);\r
- $method = array_pop($validateType);\r
- $class = implode('_', $validateType);\r
- $classPath = str_replace('_', DIRECTORY_SEPARATOR, $class);\r
- $class = 'Validate_' . $class;\r
- if (!@include_once "Validate/$classPath.php") {\r
- trigger_error("$class isn't installed or you may have some permissoin issues", E_USER_ERROR);\r
- }\r
-\r
- $ce = substr(phpversion(), 0, 1) > 4 ? class_exists($class, false) : class_exists($class);\r
- if (!$ce ||\r
- !in_array($method, get_class_methods($class)))\r
- {\r
- trigger_error("Invalid validation type $class::$method", E_USER_WARNING);\r
- continue;\r
- }\r
- unset($opt['type']);\r
- if (sizeof($opt) == 1) {\r
- $opt = array_pop($opt);\r
- }\r
- $valid[$var_name] = call_user_func(array($class, $method), $data[$var_name], $opt);\r
- } else {\r
- trigger_error("Invalid validation type {$opt['type']}", E_USER_WARNING);\r
- }\r
- }\r
- return $valid;\r
- }\r
-}\r
-\r
+<?php
+/**
+ * Validation class
+ *
+ * Copyright (c) 1997-2006 Pierre-Alain Joye,Tomas V.V.Cox, Amir Saied
+ *
+ * This source file is subject to the New BSD license, That is bundled
+ * with this package in the file LICENSE, and is available through
+ * the world-wide-web at
+ * http://www.opensource.org/licenses/bsd-license.php
+ * If you did not receive a copy of the new BSDlicense and are unable
+ * to obtain it through the world-wide-web, please send a note to
+ * pajoye@php.net so we can mail you a copy immediately.
+ *
+ * Author: Tomas V.V.Cox <cox@idecnet.com>
+ * Pierre-Alain Joye <pajoye@php.net>
+ * Amir Mohammad Saied <amir@php.net>
+ *
+ *
+ * Package to validate various datas. It includes :
+ * - numbers (min/max, decimal or not)
+ * - email (syntax, domain check)
+ * - string (predifined type alpha upper and/or lowercase, numeric,...)
+ * - date (min, max, rfc822 compliant)
+ * - uri (RFC2396)
+ * - possibility valid multiple data with a single method call (::multiple)
+ *
+ * @category Validate
+ * @package Validate
+ * @author Tomas V.V.Cox <cox@idecnet.com>
+ * @author Pierre-Alain Joye <pajoye@php.net>
+ * @author Amir Mohammad Saied <amir@php.net>
+ * @copyright 1997-2006 Pierre-Alain Joye,Tomas V.V.Cox,Amir Mohammad Saied
+ * @license http://www.opensource.org/licenses/bsd-license.php New BSD License
+ * @version CVS: $Id: Validate.php,v 1.134 2009/01/28 12:27:33 davidc Exp $
+ * @link http://pear.php.net/package/Validate
+ */
+
+/**
+ * Methods for common data validations
+ */
+define('VALIDATE_NUM', '0-9');
+define('VALIDATE_SPACE', '\s');
+define('VALIDATE_ALPHA_LOWER', 'a-z');
+define('VALIDATE_ALPHA_UPPER', 'A-Z');
+define('VALIDATE_ALPHA', VALIDATE_ALPHA_LOWER . VALIDATE_ALPHA_UPPER);
+define('VALIDATE_EALPHA_LOWER', VALIDATE_ALPHA_LOWER . 'áéíóúýàèìòùäëïöüÿâêîôûãñõ¨åæç½ðøþß');
+define('VALIDATE_EALPHA_UPPER', VALIDATE_ALPHA_UPPER . 'ÁÉÍÓÚÝÀÈÌÒÙÄËÏÖܾÂÊÎÔÛÃÑÕ¦ÅÆǼÐØÞ');
+define('VALIDATE_EALPHA', VALIDATE_EALPHA_LOWER . VALIDATE_EALPHA_UPPER);
+define('VALIDATE_PUNCTUATION', VALIDATE_SPACE . '\.,;\:&"\'\?\!\(\)');
+define('VALIDATE_NAME', VALIDATE_EALPHA . VALIDATE_SPACE . "'" . "-");
+define('VALIDATE_STREET', VALIDATE_NUM . VALIDATE_NAME . "/\\ºª\.");
+
+define('VALIDATE_ITLD_EMAILS', 1);
+define('VALIDATE_GTLD_EMAILS', 2);
+define('VALIDATE_CCTLD_EMAILS', 4);
+define('VALIDATE_ALL_EMAILS', 8);
+
+/**
+ * Validation class
+ *
+ * Package to validate various datas. It includes :
+ * - numbers (min/max, decimal or not)
+ * - email (syntax, domain check)
+ * - string (predifined type alpha upper and/or lowercase, numeric,...)
+ * - date (min, max)
+ * - uri (RFC2396)
+ * - possibility valid multiple data with a single method call (::multiple)
+ *
+ * @category Validate
+ * @package Validate
+ * @author Tomas V.V.Cox <cox@idecnet.com>
+ * @author Pierre-Alain Joye <pajoye@php.net>
+ * @author Amir Mohammad Saied <amir@php.net>
+ * @copyright 1997-2006 Pierre-Alain Joye,Tomas V.V.Cox,Amir Mohammad Saied
+ * @license http://www.opensource.org/licenses/bsd-license.php New BSD License
+ * @version Release: @package_version@
+ * @link http://pear.php.net/package/Validate
+ */
+class Validate
+{
+ /**
+ * International Top-Level Domain
+ *
+ * This is an array of the known international
+ * top-level domain names.
+ *
+ * @access protected
+ * @var array $_iTld (International top-level domains)
+ */
+ var $_itld = array(
+ 'arpa',
+ 'root',
+ );
+
+ /**
+ * Generic top-level domain
+ *
+ * This is an array of the official
+ * generic top-level domains.
+ *
+ * @access protected
+ * @var array $_gTld (Generic top-level domains)
+ */
+ var $_gtld = array(
+ 'aero',
+ 'biz',
+ 'cat',
+ 'com',
+ 'coop',
+ 'edu',
+ 'gov',
+ 'info',
+ 'int',
+ 'jobs',
+ 'mil',
+ 'mobi',
+ 'museum',
+ 'name',
+ 'net',
+ 'org',
+ 'pro',
+ 'travel',
+ 'asia',
+ 'post',
+ 'tel',
+ 'geo',
+ );
+
+ /**
+ * Country code top-level domains
+ *
+ * This is an array of the official country
+ * codes top-level domains
+ *
+ * @access protected
+ * @var array $_ccTld (Country Code Top-Level Domain)
+ */
+ var $_cctld = array(
+ 'ac',
+ 'ad','ae','af','ag',
+ 'ai','al','am','an',
+ 'ao','aq','ar','as',
+ 'at','au','aw','ax',
+ 'az','ba','bb','bd',
+ 'be','bf','bg','bh',
+ 'bi','bj','bm','bn',
+ 'bo','br','bs','bt',
+ 'bu','bv','bw','by',
+ 'bz','ca','cc','cd',
+ 'cf','cg','ch','ci',
+ 'ck','cl','cm','cn',
+ 'co','cr','cs','cu',
+ 'cv','cx','cy','cz',
+ 'de','dj','dk','dm',
+ 'do','dz','ec','ee',
+ 'eg','eh','er','es',
+ 'et','eu','fi','fj',
+ 'fk','fm','fo','fr',
+ 'ga','gb','gd','ge',
+ 'gf','gg','gh','gi',
+ 'gl','gm','gn','gp',
+ 'gq','gr','gs','gt',
+ 'gu','gw','gy','hk',
+ 'hm','hn','hr','ht',
+ 'hu','id','ie','il',
+ 'im','in','io','iq',
+ 'ir','is','it','je',
+ 'jm','jo','jp','ke',
+ 'kg','kh','ki','km',
+ 'kn','kp','kr','kw',
+ 'ky','kz','la','lb',
+ 'lc','li','lk','lr',
+ 'ls','lt','lu','lv',
+ 'ly','ma','mc','md',
+ 'me','mg','mh','mk',
+ 'ml','mm','mn','mo',
+ 'mp','mq','mr','ms',
+ 'mt','mu','mv','mw',
+ 'mx','my','mz','na',
+ 'nc','ne','nf','ng',
+ 'ni','nl','no','np',
+ 'nr','nu','nz','om',
+ 'pa','pe','pf','pg',
+ 'ph','pk','pl','pm',
+ 'pn','pr','ps','pt',
+ 'pw','py','qa','re',
+ 'ro','rs','ru','rw',
+ 'sa','sb','sc','sd',
+ 'se','sg','sh','si',
+ 'sj','sk','sl','sm',
+ 'sn','so','sr','st',
+ 'su','sv','sy','sz',
+ 'tc','td','tf','tg',
+ 'th','tj','tk','tl',
+ 'tm','tn','to','tp',
+ 'tr','tt','tv','tw',
+ 'tz','ua','ug','uk',
+ 'us','uy','uz','va',
+ 'vc','ve','vg','vi',
+ 'vn','vu','wf','ws',
+ 'ye','yt','yu','za',
+ 'zm','zw',
+ );
+
+ /**
+ * Validate a tag URI (RFC4151)
+ *
+ * @param string $uri tag URI to validate
+ *
+ * @return boolean true if valid tag URI, false if not
+ *
+ * @access private
+ */
+ function __uriRFC4151($uri)
+ {
+ $datevalid = false;
+ if (preg_match(
+ '/^tag:(?<name>.*),(?<date>\d{4}-?\d{0,2}-?\d{0,2}):(?<specific>.*)(.*:)*$/', $uri, $matches)) {
+ $date = $matches['date'];
+ $date6 = strtotime($date);
+ if ((strlen($date) == 4) && $date <= date('Y')) {
+ $datevalid = true;
+ } elseif ((strlen($date) == 7) && ($date6 < strtotime("now"))) {
+ $datevalid = true;
+ } elseif ((strlen($date) == 10) && ($date6 < strtotime("now"))) {
+ $datevalid = true;
+ }
+ if (self::email($matches['name'])) {
+ $namevalid = true;
+ } else {
+ $namevalid = self::email('info@' . $matches['name']);
+ }
+ return $datevalid && $namevalid;
+ } else {
+ return false;
+ }
+ }
+
+ /**
+ * Validate a number
+ *
+ * @param string $number Number to validate
+ * @param array $options array where:
+ * 'decimal' is the decimal char or false when decimal
+ * not allowed.
+ * i.e. ',.' to allow both ',' and '.'
+ * 'dec_prec' Number of allowed decimals
+ * 'min' minimum value
+ * 'max' maximum value
+ *
+ * @return boolean true if valid number, false if not
+ *
+ * @access public
+ */
+ function number($number, $options = array())
+ {
+ $decimal = $dec_prec = $min = $max = null;
+ if (is_array($options)) {
+ extract($options);
+ }
+
+ $dec_prec = $dec_prec ? "{1,$dec_prec}" : '+';
+ $dec_regex = $decimal ? "[$decimal][0-9]$dec_prec" : '';
+
+ if (!preg_match("|^[-+]?\s*[0-9]+($dec_regex)?\$|", $number)) {
+ return false;
+ }
+
+ if ($decimal != '.') {
+ $number = strtr($number, $decimal, '.');
+ }
+
+ $number = (float)str_replace(' ', '', $number);
+ if ($min !== null && $min > $number) {
+ return false;
+ }
+
+ if ($max !== null && $max < $number) {
+ return false;
+ }
+ return true;
+ }
+
+ /**
+ * Converting a string to UTF-7 (RFC 2152)
+ *
+ * @param string $string string to be converted
+ *
+ * @return string converted string
+ *
+ * @access private
+ */
+ function __stringToUtf7($string)
+ {
+ $return = '';
+ $utf7 = array(
+ 'A', 'B', 'C', 'D', 'E', 'F', 'G', 'H', 'I', 'J', 'K',
+ 'L', 'M', 'N', 'O', 'P', 'Q', 'R', 'S', 'T', 'U', 'V',
+ 'W', 'X', 'Y', 'Z', 'a', 'b', 'c', 'd', 'e', 'f', 'g',
+ 'h', 'i', 'j', 'k', 'l', 'm', 'n', 'o', 'p', 'q', 'r',
+ 's', 't', 'u', 'v', 'w', 'x', 'y', 'z', '0', '1', '2',
+ '3', '4', '5', '6', '7', '8', '9', '+', ','
+ );
+
+
+ $state = 0;
+
+ if (!empty($string)) {
+ $i = 0;
+ while ($i <= strlen($string)) {
+ $char = substr($string, $i, 1);
+ if ($state == 0) {
+ if ((ord($char) >= 0x7F) || (ord($char) <= 0x1F)) {
+ if ($char) {
+ $return .= '&';
+ }
+ $state = 1;
+ } elseif ($char == '&') {
+ $return .= '&-';
+ } else {
+ $return .= $char;
+ }
+ } elseif (($i == strlen($string) ||
+ !((ord($char) >= 0x7F)) || (ord($char) <= 0x1F))) {
+ if ($state != 1) {
+ if (ord($char) > 64) {
+ $return .= '';
+ } else {
+ $return .= $utf7[ord($char)];
+ }
+ }
+ $return .= '-';
+ $state = 0;
+ } else {
+ switch($state) {
+ case 1:
+ $return .= $utf7[ord($char) >> 2];
+ $residue = (ord($char) & 0x03) << 4;
+ $state = 2;
+ break;
+ case 2:
+ $return .= $utf7[$residue | (ord($char) >> 4)];
+ $residue = (ord($char) & 0x0F) << 2;
+ $state = 3;
+ break;
+ case 3:
+ $return .= $utf7[$residue | (ord($char) >> 6)];
+ $return .= $utf7[ord($char) & 0x3F];
+ $state = 1;
+ break;
+ }
+ }
+ $i++;
+ }
+ return $return;
+ }
+ return '';
+ }
+
+ /**
+ * Validate an email according to full RFC822 (inclusive human readable part)
+ *
+ * @param string $email email to validate,
+ * will return the address for optional dns validation
+ * @param array $options email() options
+ *
+ * @return boolean true if valid email, false if not
+ *
+ * @access private
+ */
+ function __emailRFC822(&$email, &$options)
+ {
+ static $address = null;
+ static $uncomment = null;
+ if (!$address) {
+ // atom = 1*<any CHAR except specials, SPACE and CTLs>
+ $atom = '[^][()<>@,;:\\".\s\000-\037\177-\377]+\s*';
+ // qtext = <any CHAR excepting <">, ; => may be folded
+ // "\" & CR, and including linear-white-space>
+ $qtext = '[^"\\\\\r]';
+ // quoted-pair = "\" CHAR ; may quote any char
+ $quoted_pair = '\\\\.';
+ // quoted-string = <"> *(qtext/quoted-pair) <">; Regular qtext or
+ // ; quoted chars.
+ $quoted_string = '"(?:' . $qtext . '|' . $quoted_pair . ')*"\s*';
+ // word = atom / quoted-string
+ $word = '(?:' . $atom . '|' . $quoted_string . ')';
+ // local-part = word *("." word) ; uninterpreted
+ // ; case-preserved
+ $local_part = $word . '(?:\.\s*' . $word . ')*';
+ // dtext = <any CHAR excluding "[", ; => may be folded
+ // "]", "\" & CR, & including linear-white-space>
+ $dtext = '[^][\\\\\r]';
+ // domain-literal = "[" *(dtext / quoted-pair) "]"
+ $domain_literal = '\[(?:' . $dtext . '|' . $quoted_pair . ')*\]\s*';
+ // sub-domain = domain-ref / domain-literal
+ // domain-ref = atom ; symbolic reference
+ $sub_domain = '(?:' . $atom . '|' . $domain_literal . ')';
+ // domain = sub-domain *("." sub-domain)
+ $domain = $sub_domain . '(?:\.\s*' . $sub_domain . ')*';
+ // addr-spec = local-part "@" domain ; global address
+ $addr_spec = $local_part . '@\s*' . $domain;
+ // route = 1#("@" domain) ":" ; path-relative
+ $route = '@' . $domain . '(?:,@\s*' . $domain . ')*:\s*';
+ // route-addr = "<" [route] addr-spec ">"
+ $route_addr = '<\s*(?:' . $route . ')?' . $addr_spec . '>\s*';
+ // phrase = 1*word ; Sequence of words
+ $phrase = $word . '+';
+ // mailbox = addr-spec ; simple address
+ // / phrase route-addr ; name & addr-spec
+ $mailbox = '(?:' . $addr_spec . '|' . $phrase . $route_addr . ')';
+ // group = phrase ":" [#mailbox] ";"
+ $group = $phrase . ':\s*(?:' . $mailbox . '(?:,\s*' . $mailbox . ')*)?;\s*';
+ // address = mailbox ; one addressee
+ // / group ; named list
+ $address = '/^\s*(?:' . $mailbox . '|' . $group . ')$/';
+
+ $uncomment =
+ '/((?:(?:\\\\"|[^("])*(?:' . $quoted_string .
+ ')?)*)((?<!\\\\)\((?:(?2)|.)*?(?<!\\\\)\))/';
+ }
+ // strip comments
+ $email = preg_replace($uncomment, '$1 ', $email);
+ return preg_match($address, $email);
+ }
+
+ /**
+ * Full TLD Validation function
+ *
+ * This function is used to make a much more proficient validation
+ * against all types of official domain names.
+ *
+ * @param string $email The email address to check.
+ * @param array $options The options for validation
+ *
+ * @access protected
+ *
+ * @return bool True if validating succeeds
+ */
+ function _fullTLDValidation($email, $options)
+ {
+ $validate = array();
+ if(!empty($options["VALIDATE_ITLD_EMAILS"])) array_push($validate, 'itld');
+ if(!empty($options["VALIDATE_GTLD_EMAILS"])) array_push($validate, 'gtld');
+ if(!empty($options["VALIDATE_CCTLD_EMAILS"])) array_push($validate, 'cctld');
+
+ $self = new Validate;
+
+ $toValidate = array();
+
+ foreach ($validate as $valid) {
+ $tmpVar = '_' . (string)$valid;
+
+ $toValidate[$valid] = $self->{$tmpVar};
+ }
+
+ $e = $self->executeFullEmailValidation($email, $toValidate);
+
+ return $e;
+ }
+
+ /**
+ * Execute the validation
+ *
+ * This function will execute the full email vs tld
+ * validation using an array of tlds passed to it.
+ *
+ * @param string $email The email to validate.
+ * @param array $arrayOfTLDs The array of the TLDs to validate
+ *
+ * @access public
+ *
+ * @return true or false (Depending on if it validates or if it does not)
+ */
+ function executeFullEmailValidation($email, $arrayOfTLDs)
+ {
+ $emailEnding = explode('.', $email);
+ $emailEnding = $emailEnding[count($emailEnding)-1];
+ foreach ($arrayOfTLDs as $validator => $keys) {
+ if (in_array($emailEnding, $keys)) {
+ return true;
+ }
+ }
+ return false;
+ }
+
+ /**
+ * Validate an email
+ *
+ * @param string $email email to validate
+ * @param mixed boolean (BC) $check_domain Check or not if the domain exists
+ * array $options associative array of options
+ * 'check_domain' boolean Check or not if the domain exists
+ * 'use_rfc822' boolean Apply the full RFC822 grammar
+ *
+ * Ex.
+ * $options = array(
+ * 'check_domain' => 'true',
+ * 'fullTLDValidation' => 'true',
+ * 'use_rfc822' => 'true',
+ * 'VALIDATE_GTLD_EMAILS' => 'true',
+ * 'VALIDATE_CCTLD_EMAILS' => 'true',
+ * 'VALIDATE_ITLD_EMAILS' => 'true',
+ * );
+ *
+ * @return boolean true if valid email, false if not
+ *
+ * @access public
+ */
+ function email($email, $options = null)
+ {
+ $check_domain = false;
+ $use_rfc822 = false;
+ if (is_bool($options)) {
+ $check_domain = $options;
+ } elseif (is_array($options)) {
+ extract($options);
+ }
+
+ /**
+ * Check for IDN usage so we can encode the domain as Punycode
+ * before continuing.
+ */
+ $hasIDNA = false;
+
+ if (@include_once('Net/IDNA.php')) {
+ $hasIDNA = true;
+ }
+
+ if ($hasIDNA === true) {
+ if (strpos($email, '@') !== false) {
+ list($name, $domain) = explode('@', $email, 2);
+
+ // Check if the domain contains characters > 127 which means
+ // it's an idn domain name.
+ $chars = count_chars($domain, 1);
+ if (!empty($chars) && max(array_keys($chars)) > 127) {
+ $idna =& Net_IDNA::singleton();
+ $domain = $idna->encode($domain);
+ }
+
+ $email = "$name@$domain";
+ }
+ }
+
+ /**
+ * @todo Fix bug here.. even if it passes this, it won't be passing
+ * The regular expression below
+ */
+ if (isset($fullTLDValidation)) {
+ //$valid = Validate::_fullTLDValidation($email, $fullTLDValidation);
+ $valid = Validate::_fullTLDValidation($email, $options);
+
+ if (!$valid) {
+ return false;
+ }
+ }
+
+ // the base regexp for address
+ $regex = '&^(?: # recipient:
+ ("\s*(?:[^"\f\n\r\t\v\b\s]+\s*)+")| #1 quoted name
+ ([-\w!\#\$%\&\'*+~/^`|{}]+(?:\.[-\w!\#\$%\&\'*+~/^`|{}]+)*)) #2 OR dot-atom
+ @(((\[)? #3 domain, 4 as IPv4, 5 optionally bracketed
+ (?:(?:(?:(?:25[0-5])|(?:2[0-4][0-9])|(?:[0-1]?[0-9]?[0-9]))\.){3}
+ (?:(?:25[0-5])|(?:2[0-4][0-9])|(?:[0-1]?[0-9]?[0-9]))))(?(5)\])|
+ ((?:[a-z0-9](?:[-a-z0-9]*[a-z0-9])?\.)*[a-z0-9](?:[-a-z0-9]*[a-z0-9])?) #6 domain as hostname
+ \.((?:([^- ])[-a-z]*[-a-z]))) #7 TLD
+ $&xi';
+
+ //checks if exists the domain (MX or A)
+ if ($use_rfc822? Validate::__emailRFC822($email, $options) :
+ preg_match($regex, $email)) {
+ if ($check_domain && function_exists('checkdnsrr')) {
+ list ($account, $domain) = explode('@', $email);
+ if (checkdnsrr($domain, 'MX') || checkdnsrr($domain, 'A')) {
+ return true;
+ }
+ return false;
+ }
+ return true;
+ }
+ return false;
+ }
+
+ /**
+ * Validate a string using the given format 'format'
+ *
+ * @param string $string String to validate
+ * @param array $options Options array where:
+ * 'format' is the format of the string
+ * Ex:VALIDATE_NUM . VALIDATE_ALPHA (see constants)
+ * 'min_length' minimum length
+ * 'max_length' maximum length
+ *
+ * @return boolean true if valid string, false if not
+ *
+ * @access public
+ */
+ function string($string, $options)
+ {
+ $format = null;
+ $min_length = 0;
+ $max_length = 0;
+
+ if (is_array($options)) {
+ extract($options);
+ }
+
+ if ($format && !preg_match("|^[$format]*\$|s", $string)) {
+ return false;
+ }
+
+ if ($min_length && strlen($string) < $min_length) {
+ return false;
+ }
+
+ if ($max_length && strlen($string) > $max_length) {
+ return false;
+ }
+
+ return true;
+ }
+
+ /**
+ * Validate an URI (RFC2396)
+ * This function will validate 'foobarstring' by default, to get it to validate
+ * only http, https, ftp and such you have to pass it in the allowed_schemes
+ * option, like this:
+ * <code>
+ * $options = array('allowed_schemes' => array('http', 'https', 'ftp'))
+ * var_dump(Validate::uri('http://www.example.org', $options));
+ * </code>
+ *
+ * NOTE 1: The rfc2396 normally allows middle '-' in the top domain
+ * e.g. http://example.co-m should be valid
+ * However, as '-' is not used in any known TLD, it is invalid
+ * NOTE 2: As double shlashes // are allowed in the path part, only full URIs
+ * including an authority can be valid, no relative URIs
+ * the // are mandatory (optionally preceeded by the 'sheme:' )
+ * NOTE 3: the full complience to rfc2396 is not achieved by default
+ * the characters ';/?:@$,' will not be accepted in the query part
+ * if not urlencoded, refer to the option "strict'"
+ *
+ * @param string $url URI to validate
+ * @param array $options Options used by the validation method.
+ * key => type
+ * 'domain_check' => boolean
+ * Whether to check the DNS entry or not
+ * 'allowed_schemes' => array, list of protocols
+ * List of allowed schemes ('http',
+ * 'ssh+svn', 'mms')
+ * 'strict' => string the refused chars
+ * in query and fragment parts
+ * default: ';/?:@$,'
+ * empty: accept all rfc2396 foreseen chars
+ *
+ * @return boolean true if valid uri, false if not
+ *
+ * @access public
+ */
+ function uri($url, $options = null)
+ {
+ $strict = ';/?:@$,';
+ $domain_check = false;
+ $allowed_schemes = null;
+ if (is_array($options)) {
+ extract($options);
+ }
+ if (is_array($allowed_schemes) &&
+ in_array("tag", $allowed_schemes)
+ ) {
+ if (strpos($url, "tag:") === 0) {
+ return self::__uriRFC4151($url);
+ }
+ }
+
+ if (preg_match(
+ '&^(?:([a-z][-+.a-z0-9]*):)? # 1. scheme
+ (?:// # authority start
+ (?:((?:%[0-9a-f]{2}|[-a-z0-9_.!~*\'();:\&=+$,])*)@)? # 2. authority-userinfo
+ (?:((?:[a-z0-9](?:[-a-z0-9]*[a-z0-9])?\.)*[a-z](?:[a-z0-9]+)?\.?) # 3. authority-hostname OR
+ |([0-9]{1,3}(?:\.[0-9]{1,3}){3})) # 4. authority-ipv4
+ (?::([0-9]*))?) # 5. authority-port
+ ((?:/(?:%[0-9a-f]{2}|[-a-z0-9_.!~*\'():@\&=+$,;])*)*/?)? # 6. path
+ (?:\?([^#]*))? # 7. query
+ (?:\#((?:%[0-9a-f]{2}|[-a-z0-9_.!~*\'();/?:@\&=+$,])*))? # 8. fragment
+ $&xi', $url, $matches)) {
+ $scheme = isset($matches[1]) ? $matches[1] : '';
+ $authority = isset($matches[3]) ? $matches[3] : '' ;
+ if (is_array($allowed_schemes) &&
+ !in_array($scheme, $allowed_schemes)
+ ) {
+ return false;
+ }
+ if (!empty($matches[4])) {
+ $parts = explode('.', $matches[4]);
+ foreach ($parts as $part) {
+ if ($part > 255) {
+ return false;
+ }
+ }
+ } elseif ($domain_check && function_exists('checkdnsrr')) {
+ if (!checkdnsrr($authority, 'A')) {
+ return false;
+ }
+ }
+ if ($strict) {
+ $strict = '#[' . preg_quote($strict, '#') . ']#';
+ if ((!empty($matches[7]) && preg_match($strict, $matches[7]))
+ || (!empty($matches[8]) && preg_match($strict, $matches[8]))) {
+ return false;
+ }
+ }
+ return true;
+ }
+ return false;
+ }
+
+ /**
+ * Validate date and times. Note that this method need the Date_Calc class
+ *
+ * @param string $date Date to validate
+ * @param array $options array options where :
+ * 'format' The format of the date (%d-%m-%Y)
+ * or rfc822_compliant
+ * 'min' The date has to be greater
+ * than this array($day, $month, $year)
+ * or PEAR::Date object
+ * 'max' The date has to be smaller than
+ * this array($day, $month, $year)
+ * or PEAR::Date object
+ *
+ * @return boolean true if valid date/time, false if not
+ *
+ * @access public
+ */
+ function date($date, $options)
+ {
+ $max = false;
+ $min = false;
+ $format = '';
+
+ if (is_array($options)) {
+ extract($options);
+ }
+
+ if (strtolower($format) == 'rfc822_compliant') {
+ $preg = '&^(?:(Mon|Tue|Wed|Thu|Fri|Sat|Sun),) \s+
+ (?:(\d{2})?) \s+
+ (?:(Jan|Feb|Mar|Apr|May|Jun|Jul|Aug|Sep|Oct|Nov|Dec)?) \s+
+ (?:(\d{2}(\d{2})?)?) \s+
+ (?:(\d{2}?)):(?:(\d{2}?))(:(?:(\d{2}?)))? \s+
+ (?:[+-]\d{4}|UT|GMT|EST|EDT|CST|CDT|MST|MDT|PST|PDT|[A-IK-Za-ik-z])$&xi';
+
+ if (!preg_match($preg, $date, $matches)) {
+ return false;
+ }
+
+ $year = (int)$matches[4];
+ $months = array('Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun',
+ 'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec');
+ $month = array_keys($months, $matches[3]);
+ $month = (int)$month[0]+1;
+ $day = (int)$matches[2];
+ $weekday = $matches[1];
+ $hour = (int)$matches[6];
+ $minute = (int)$matches[7];
+ isset($matches[9]) ? $second = (int)$matches[9] : $second = 0;
+
+ if ((strlen($year) != 4) ||
+ ($day > 31 || $day < 1)||
+ ($hour > 23) ||
+ ($minute > 59) ||
+ ($second > 59)) {
+ return false;
+ }
+ } else {
+ $date_len = strlen($format);
+ for ($i = 0; $i < $date_len; $i++) {
+ $c = $format{$i};
+ if ($c == '%') {
+ $next = $format{$i + 1};
+ switch ($next) {
+ case 'j':
+ case 'd':
+ if ($next == 'j') {
+ $day = (int)Validate::_substr($date, 1, 2);
+ } else {
+ $day = (int)Validate::_substr($date, 0, 2);
+ }
+ if ($day < 1 || $day > 31) {
+ return false;
+ }
+ break;
+ case 'm':
+ case 'n':
+ if ($next == 'm') {
+ $month = (int)Validate::_substr($date, 0, 2);
+ } else {
+ $month = (int)Validate::_substr($date, 1, 2);
+ }
+ if ($month < 1 || $month > 12) {
+ return false;
+ }
+ break;
+ case 'Y':
+ case 'y':
+ if ($next == 'Y') {
+ $year = Validate::_substr($date, 4);
+ $year = (int)$year?$year:'';
+ } else {
+ $year = (int)(substr(date('Y'), 0, 2) .
+ Validate::_substr($date, 2));
+ }
+ if (strlen($year) != 4 || $year < 0 || $year > 9999) {
+ return false;
+ }
+ break;
+ case 'g':
+ case 'h':
+ if ($next == 'g') {
+ $hour = Validate::_substr($date, 1, 2);
+ } else {
+ $hour = Validate::_substr($date, 2);
+ }
+ if (!preg_match('/^\d+$/', $hour) || $hour < 0 || $hour > 12) {
+ return false;
+ }
+ break;
+ case 'G':
+ case 'H':
+ if ($next == 'G') {
+ $hour = Validate::_substr($date, 1, 2);
+ } else {
+ $hour = Validate::_substr($date, 2);
+ }
+ if (!preg_match('/^\d+$/', $hour) || $hour < 0 || $hour > 24) {
+ return false;
+ }
+ break;
+ case 's':
+ case 'i':
+ $t = Validate::_substr($date, 2);
+ if (!preg_match('/^\d+$/', $t) || $t < 0 || $t > 59) {
+ return false;
+ }
+ break;
+ default:
+ trigger_error("Not supported char `$next' after % in offset " . ($i+2), E_USER_WARNING);
+ }
+ $i++;
+ } else {
+ //literal
+ if (Validate::_substr($date, 1) != $c) {
+ return false;
+ }
+ }
+ }
+ }
+ // there is remaing data, we don't want it
+ if (strlen($date) && (strtolower($format) != 'rfc822_compliant')) {
+ return false;
+ }
+
+ if (isset($day) && isset($month) && isset($year)) {
+ if (!checkdate($month, $day, $year)) {
+ return false;
+ }
+
+ if (strtolower($format) == 'rfc822_compliant') {
+ if ($weekday != date("D", mktime(0, 0, 0, $month, $day, $year))) {
+ return false;
+ }
+ }
+
+ if ($min) {
+ include_once 'Date/Calc.php';
+ if (is_a($min, 'Date') &&
+ (Date_Calc::compareDates($day, $month, $year,
+ $min->getDay(), $min->getMonth(), $min->getYear()) < 0)
+ ) {
+ return false;
+ } elseif (is_array($min) &&
+ (Date_Calc::compareDates($day, $month, $year,
+ $min[0], $min[1], $min[2]) < 0)
+ ) {
+ return false;
+ }
+ }
+
+ if ($max) {
+ include_once 'Date/Calc.php';
+ if (is_a($max, 'Date') &&
+ (Date_Calc::compareDates($day, $month, $year,
+ $max->getDay(), $max->getMonth(), $max->getYear()) > 0)
+ ) {
+ return false;
+ } elseif (is_array($max) &&
+ (Date_Calc::compareDates($day, $month, $year,
+ $max[0], $max[1], $max[2]) > 0)
+ ) {
+ return false;
+ }
+ }
+ }
+
+ return true;
+ }
+
+ /**
+ * Substr
+ *
+ * @param string &$date Date
+ * @param string $num Length
+ * @param string $opt Unknown
+ *
+ * @access private
+ * @return string
+ */
+ function _substr(&$date, $num, $opt = false)
+ {
+ if ($opt && strlen($date) >= $opt && preg_match('/^[0-9]{'.$opt.'}/', $date, $m)) {
+ $ret = $m[0];
+ } else {
+ $ret = substr($date, 0, $num);
+ }
+ $date = substr($date, strlen($ret));
+ return $ret;
+ }
+
+ function _modf($val, $div)
+ {
+ if (function_exists('bcmod')) {
+ return bcmod($val, $div);
+ } elseif (function_exists('fmod')) {
+ return fmod($val, $div);
+ }
+ $r = $val / $div;
+ $i = intval($r);
+ return intval($val - $i * $div + .1);
+ }
+
+ /**
+ * Calculates sum of product of number digits with weights
+ *
+ * @param string $number number string
+ * @param array $weights reference to array of weights
+ *
+ * @access protected
+ *
+ * @return int returns product of number digits with weights
+ */
+ function _multWeights($number, &$weights)
+ {
+ if (!is_array($weights)) {
+ return -1;
+ }
+ $sum = 0;
+
+ $count = min(count($weights), strlen($number));
+ if ($count == 0) { // empty string or weights array
+ return -1;
+ }
+ for ($i = 0; $i < $count; ++$i) {
+ $sum += intval(substr($number, $i, 1)) * $weights[$i];
+ }
+
+ return $sum;
+ }
+
+ /**
+ * Calculates control digit for a given number
+ *
+ * @param string $number number string
+ * @param array $weights reference to array of weights
+ * @param int $modulo (optionsl) number
+ * @param int $subtract (optional) number
+ * @param bool $allow_high (optional) true if function can return number higher than 10
+ *
+ * @access protected
+ *
+ * @return int -1 calculated control number is returned
+ */
+ function _getControlNumber($number, &$weights, $modulo = 10, $subtract = 0, $allow_high = false)
+ {
+ // calc sum
+ $sum = Validate::_multWeights($number, $weights);
+ if ($sum == -1) {
+ return -1;
+ }
+ $mod = Validate::_modf($sum, $modulo); // calculate control digit
+
+ if ($subtract > $mod && $mod > 0) {
+ $mod = $subtract - $mod;
+ }
+ if ($allow_high === false) {
+ $mod %= 10; // change 10 to zero
+ }
+ return $mod;
+ }
+
+ /**
+ * Validates a number
+ *
+ * @param string $number number to validate
+ * @param array $weights reference to array of weights
+ * @param int $modulo (optional) number
+ * @param int $subtract (optional) number
+ *
+ * @access protected
+ *
+ * @return bool true if valid, false if not
+ */
+ function _checkControlNumber($number, &$weights, $modulo = 10, $subtract = 0)
+ {
+ if (strlen($number) < count($weights)) {
+ return false;
+ }
+ $target_digit = substr($number, count($weights), 1);
+ $control_digit = Validate::_getControlNumber($number, $weights, $modulo, $subtract, $modulo > 10);
+
+ if ($control_digit == -1) {
+ return false;
+ }
+ if ($target_digit === 'X' && $control_digit == 10) {
+ return true;
+ }
+ if ($control_digit != $target_digit) {
+ return false;
+ }
+ return true;
+ }
+
+ /**
+ * Bulk data validation for data introduced in the form of an
+ * assoc array in the form $var_name => $value.
+ * Can be used on any of Validate subpackages
+ *
+ * @param array $data Ex: array('name' => 'toto', 'email' => 'toto@thing.info');
+ * @param array $val_type Contains the validation type and all parameters used in.
+ * 'val_type' is not optional
+ * others validations properties must have the same name as the function
+ * parameters.
+ * Ex: array('toto'=>array('type'=>'string','format'='toto@thing.info','min_length'=>5));
+ * @param boolean $remove if set, the elements not listed in data will be removed
+ *
+ * @return array value name => true|false the value name comes from the data key
+ *
+ * @access public
+ */
+ function multiple(&$data, &$val_type, $remove = false)
+ {
+ $keys = array_keys($data);
+ $valid = array();
+
+ foreach ($keys as $var_name) {
+ if (!isset($val_type[$var_name])) {
+ if ($remove) {
+ unset($data[$var_name]);
+ }
+ continue;
+ }
+ $opt = $val_type[$var_name];
+ $methods = get_class_methods('Validate');
+ $val2check = $data[$var_name];
+ // core validation method
+ if (in_array(strtolower($opt['type']), $methods)) {
+ //$opt[$opt['type']] = $data[$var_name];
+ $method = $opt['type'];
+ unset($opt['type']);
+
+ if (sizeof($opt) == 1 && is_array(reset($opt))) {
+ $opt = array_pop($opt);
+ }
+ $valid[$var_name] = call_user_func(array('Validate', $method), $val2check, $opt);
+
+ /**
+ * external validation method in the form:
+ * "<class name><underscore><method name>"
+ * Ex: us_ssn will include class Validate/US.php and call method ssn()
+ */
+ } elseif (strpos($opt['type'], '_') !== false) {
+ $validateType = explode('_', $opt['type']);
+ $method = array_pop($validateType);
+ $class = implode('_', $validateType);
+ $classPath = str_replace('_', DIRECTORY_SEPARATOR, $class);
+ $class = 'Validate_' . $class;
+ if (!@include_once "Validate/$classPath.php") {
+ trigger_error("$class isn't installed or you may have some permissoin issues", E_USER_ERROR);
+ }
+
+ $ce = substr(phpversion(), 0, 1) > 4 ?
+ class_exists($class, false) : class_exists($class);
+ if (!$ce ||
+ !in_array($method, get_class_methods($class))
+ ) {
+ trigger_error("Invalid validation type $class::$method",
+ E_USER_WARNING);
+ continue;
+ }
+ unset($opt['type']);
+ if (sizeof($opt) == 1) {
+ $opt = array_pop($opt);
+ }
+ $valid[$var_name] = call_user_func(array($class, $method),
+ $data[$var_name], $opt);
+ } else {
+ trigger_error("Invalid validation type {$opt['type']}",
+ E_USER_WARNING);
+ }
+ }
+ return $valid;
+ }
+}
+
projects / quix0rs-gnu-social.git / commitdiff