Your IP : 216.73.216.95
<?php
/** @file
* This file is part of Google Chart PHP library.
*
* Copyright (c) 2010 Rémi Lanvin <remi@cloudconnected.fr>
*
* Licensed under the MIT license.
*
* For the full copyright and license information, please view the LICENSE file.
*/
/**
* Basic feature to query the API.
*
* This class implement basic features to query Google Chart API using GET or
* POST, as well as a simple way to set/get parameters.
*
* Every object that behave like a chart (regular charts, freestanding icons),
* must inherit from this class.
*
* @internal
*/
class GoogleChartApi
{
/**
* Google Chart API base url.
*/
const BASE_URL = 'http://chart.apis.google.com/chart';
// HTTPS url = https://chart.googleapis.com/chart
/**
* GET method
*/
const GET = 0;
/**
* POST method
*/
const POST = 1;
/**
* An array to store every additional parameters for the final request.
* Everything written in this array will be added to the final request without
* processing. It can be used to override any parameter.
*/
protected $parameters = array();
/**
* GET or POST
*/
protected $query_method = self::POST;
/**
* Set a parameter.
*
* @param $name (string)
* @param $value (mixed)
*/
public function __set($name, $value)
{
$this->parameters[$name] = $value;
}
/**
* Return a parameter value.
*
* @param $name (string)
* @return mixed
*/
public function __get($name)
{
return isset($this->parameters[$name]) ? $this->parameters[$name] : null;
}
/**
* Unset a parameter.
*
* @param $name (string)
*/
public function __unset($name)
{
unset($this->parameters[$name]);
}
/**
* Compute the whole query as an array.
*
* This function here does nothing (only returns the parameters array).
* It has to be overrided by child classes in order to add some logic.
*
* @internal
*/
protected function computeQuery()
{
return $this->parameters;
}
/**
* @name Function to query Google Chart API
*/
//@{
/**
* Set whether you want the class to use GET or POST for querying the API.
*
* Default method is POST.
*
* @param $method One of the following:
* - GoogleChart::GET
* - GoogleChart::POST
* @return $this
*/
public function setQueryMethod($method)
{
if ( $method !== self::POST && $method !== self::GET )
throw new Exception(sprintf(
'Query method must be either GoogleChart::POST or GoogleChart::GET, "%s" given.',
$method
));
$this->query_method = $method;
return $this;
}
/**
* Returns the full URL.
*
* Use this method if you need to link Google's URL directly, or if you
* prefer to use your own library to GET the chart.
*
* @return string
*/
public function getUrl($escape_amp = true)
{
$q = $this->computeQuery();
$url = self::BASE_URL.'?'.http_build_query($q, '', $escape_amp? '&' : '&');
return $url;
}
/**
* Returns the query parameters as an array.
*
* Use this method if you want to do the POST yourself, or for troubleshooting
* a chart.
*
* @return array
*/
public function getQuery()
{
return $this->computeQuery();
}
/**
* Return an HTML img tag with Google's URL.
*
* Use this for troubleshooting or rapid application development.
*
* @return string
*/
public function toHtml()
{
$str = sprintf(
'<img src="%s" alt="" />',
$this->getUrl()
);
return $str;
}
/**
* Query Google Chart and returns the image.
*
* @see setQueryMethod
*
* @return binary image
*/
public function getImage()
{
$image = null;
switch ( $this->query_method ) {
case self::GET:
$url = $this->getUrl(false);
$image = file_get_contents($url);
break;
case self::POST:
$image = self::post($this->computeQuery());
break;
}
return $image;
}
/**
* Returns the image as a GD resource.
* @return ressource or false
* @since 0.6
*/
public function getImageGD()
{
return imagecreatefromstring($this->getImage());
}
/**
* Shortcut for getImage().
*/
public function __toString()
{
try {
return (string) $this->getImage();
} catch (Exception $e) {
trigger_error($e->getMessage(), E_USER_ERROR);
}
}
//@}
/**
* Performs a POST.
*/
static public function post(array $q = array())
{
$context = stream_context_create(array(
'http' => array(
'method' => 'POST',
'header' => 'Content-type: application/x-www-form-urlencoded',
'content' => http_build_query($q, '', '&')
)
));
return file_get_contents(self::BASE_URL, false, $context);
}
/**
* Check if a color is valid RRGGBB format.
*
* @param $color (string)
* @return bool
*/
static public function validColor($color)
{
return preg_match('/^[0-9A-F]{6}$/i', $color);
}
/* --------------------------------------------------------------------------
* Debug
* -------------------------------------------------------------------------- */
public function getValidationUrl($escape_amp = true)
{
$q = $this->computeQuery();
$q['chof'] = 'validate';
$url = self::BASE_URL.'?'.http_build_query($q, '', $escape_amp?'&':'&');
return $url;
}
public function validate()
{
$q = $this->computeQuery();
$q['chof'] = 'validate';
return self::post($q);
}
}