I’ve been working with Zend Framework quite sometime for web projects. I found it’s quite interesting to find that Zend Framework does not have any class to perform image manipulation even though a proposal for Zend_Image had been submitted to Zend community as a wrapper of existing PHP interfaces: GD and ImageMagick but unfortunately the proposal was not considered.

And for your information, GD which stands for ‘Gif Draw’ is a standard PHP installation, unlike ImageMagick. If you wish to utilize these libraries, you need to have php extensions called php_gd2 and php_imagick respectively installed and enabled on the web server.

The noticeable difference between GD and ImageMagick is that GD simply does not support image format like TIFF (Tagged Image File Format). If TIFF is not your issue then go for GD. And if you wish to make your development easier, you may be interested to use Thumbnail class by our fellow developer. But if you’re looking into ImageMagick I’m going to show you the steps (from another site) on how to install ImageMagick on your Windows web server as Windows installation is a bit tricky since “pecl install imagick” does NOT work properly.

1. Download and install ImageMagick software from http://www.imagemagick.org/script/binary-releases.php#windows.
2. Download pecl-5.2-dev.zip (choose the version relevant to your PHP) from http://snaps.php.net/win32/
3. Copy php_imagick.dll from the archive you’ve downloaded to your PHP extension folder.
4. Add the following line to php.ini (in the extensions section):
   extension=php_imagick.dll

   or on WampServer click WampServer icon on taskbar, go to PHP > php.ini and add the above entry.

5. Restart your server.
6. Try this example script below to verify your installation.

   header('Content-type: image/tif');
   
   $image = new Imagick('example.tif');
   // Create thumbnail for the specified image file.
   $image->thumbnailImage(100, 0);
   
   echo $image;

   The script should display the image thumbnail with a maximum width of 100 pixels.

If you find the above steps are difficult to follow you may want to download php_imagick.dll here and start from step 3. And if you need help with these libraries, check the manual pages for GD and ImageMagick.

Lastly if you find this post helpful, kindly leave your rating below to indicate that this post is really useful and at the same time let others know about this post. And if your wish to let other communities know about this post kindly click the sociable icons below. Thanks!

So far I’ve been working with some IDEs out there like Microsoft Visual Studio (including Express edition), Eclipse for PHP, Zend Studio, and PHP Designer, and to me Visual Studio is the most developer-friendly IDE. But this task is still repetitive to me and personally I am into the notion of DRY (Don’t Repeat Yourself).

Well, I finally found a way to resolve this in PHP and I’m going to share this. The code is extended based on a sample file from Zend QuickStart.

/**
 * This class is a helper class that allows developer to
 * create an object model easily by simply inheriting and
 * declaring their desired variables as public in the child class
 * and seamlessly creates a pair of getter and setter functions.
 */
class JLoe_Model_Object
{
  /**
   * The regular expression for get method name.
   *
   * @var string
   */
  const REGEX_GET = '/get.*/';

  /**
   * The regular expression for set method name.
   *
   * @var string
   */
  const REGEX_SET = '/set.*/';

  /**
   * Get the value of a property with method syntax.
   *
   * Map method calls to get and set the declared public variables.
   * This is used to help to create magic get and set functions seamlessly.
   *
   * @param  string $method method name
   * @param  mixed  $param  parameter values to be passed
   * @return property value or this object
   */
  public function __call( $method, $param )
  {
    // Check whether it's a get or set method, else throw exception
    if ( preg_match( self::REGEX_GET, $method ) ) {
      $isGet = true;
      $propName = str_replace( 'get', '', $method );
    }
    elseif ( preg_match( self::REGEX_SET, $method ) ) {
      $isGet = false;
      $propName = str_replace( 'set', '', $method );
    }
    else { throw new JLoe_Model_Exception( 'Invalid method' ); }

    // Check whether property name exists
    $propName = ucfirst( $propName );
    if ( ! property_exists( $this, $propName ) ) {
      throw new JLoe_Model_Exception( 'Invalid method' );
    }

    // Perform respective method call
    if ( $isGet ) { return $this->$propName; }
    else
    {
      $this->$propName = $param[0];
      return $this;
    }
  }

  /**
   * Map variable access onto the underlying method representation.
   *
   * Allow to map the variable access with the respective get method.
   *
   * @param  string $name the property name to access
   * @return mixed value depending on the underlying method called
   */
  public function __get( $name )
  {
    $method = 'get' . $name;
    if ( ('mapper' == $name) || !method_exists($this, $method) )
    {
      throw new JLoe_Model_Exception( 'Invalid property' );
    }
    return $this->$method();
  }

  /**
   * Map variable access onto the underlying method representation.
   *
   * Allow to map the variable access with the respective set method.
   *
   * @param  string $name the property name to access
   * @return instance of the inherited class
   */
  public function __set( $name, $value )
  {
    $method = 'set' . $name;
    if ( ('mapper' == $name) || !method_exists($this, $method) )
    {
      throw new JLoe_Model_Exception( 'Invalid property' );
    }
    $this->$method( $value );
  }
}

And with this, you can code your model class with just a few lines. Here goes a sample.

class Quot_Model_Quote extends JLoe_Model_Object
{
  /**
   * Quote id.
   *
   * @var int
   */
  public $Id;

  /**
   * The quote
   *
   * @var string
   */
  public $Quote;

  /**
   * Tags for this quote.
   *
   * @var array
   */
  protected $_tags;
  public function getTags() { return $this->_tags; }
  public function setTags( $tags )
  {
    // Put your own logic here
    $this->_tags = $tags;
  }
}

Here if you wish to allow other class to access it via its variable name, getter, or setter functions, you just need to declare the variable as public as depicted on line 8 and 15. On the other hand, if you wish to limit access to a variable, you can always declare the variable as protected and create your desired getter or setter functions associated with the variable as shown on line 22 to 27.

And now you may access the class as follows.

$quote = new JLoe_Model_Quote();

$quote->Id   = $id;
$quote->Name = $name;
$quote->Tags = $tags;
// You may also use this
$quote
  ->setId( $id )
  ->setName( $name )
  ->setTags( $tags )

$id   = $quote->Id;
$name = $quote->Name;
$tags = $quote->tags;
// Similar with
$id   = $quote->getId();
$name = $quote->getName();
$tags = $quote->getTags();

It’s that easy. Now I can write my model class quickly and easily for other PHP projects. Yey!

/**
 * Read the remote file and send the content as the response
 *
 * @author Jonathan Loe
 * @date   May 05 2009
 */
protected function readAndSendRemoteContent( $url )
{
  // Set the configuration parameters
  $config = array( 'adapter' => 'Zend_Http_Client_Adapter_Socket' );

  // Instantiate a client object
  $client = new Zend_Http_Client( $url, $config );
  $response = $client->request();

  $this->getResponse()
    ->setHeader( 'Content-type', $response->getHeader( 'Content-type' ) )
    ->appendBody( $response->getRawBody() )
    ->sendResponse();
}

First line of code is to set the adapter as Zend_Http_Client_Adapter_Socket. Next line is to specify the remote url along with the adapter set in the config and make the request. My last code is to send whatever was received and send it to the client as a response with the same ‘Content-type’. $this refers to the instance of the Zend controller class.

It’s that simple hey?

PS: If you’re looking for other samples which demonstrate use of the native functions. Here are a few links you may be interested in.

Links:

• Reading a Remote File Using PHP
• How to download a remote file in php and then save it

For readers who have no idea what SOAP is. Here’s a short explanation about SOAP as defined by TechTarget.

SOAP (Simple Object Access Protocol) is a way for a program running in one kind of operating system (such as Windows 2000) to communicate with a program in the same or another kind of an operating system (such as Linux) by using the World Wide Web’s Hypertext Transfer Protocol (HTTP)and its Extensible Markup Language (XML) as the mechanisms for information exchange.

Here I will share my step-by-step guide on how to start your SOAP application using PHP and Zend as your Model View Controller (MVC) framework. First, I have the following application and framework installed. But I will not explain in detail about them in this post.

• WampServer
• Zend Framework 1.7.5

To start, first you need to enable a php extension called php_soap. In WampServer, this module has been pre-installed but you need to enable the module by the following steps.

1. Click WampServer icon on the tray.
2. Select PHP > PHP Extension.
3. And finally click php_soap to enable it.

Then, we create a simple class called Models_Writer which has a function write that returns the specified string to the calling function.

class Models_Writer
{
  /**
   * Return the specified text
   *
   * @param string $string
   * @return string
   */
  public function write( $string )
  {
    return $string;
  }
}

Followed by a simple action function called wsdlAction which renders generated WSDL for the class Models_Writer using Zend_Soap_AutoDiscover. Hey hey stop! what the heck is WSDL?. In short,

WSDL or Web Services Description Language is an XML-based language that provides a model for describing Web services.

Follow this link on wikipedia to help you along with what exactly is WSDL.

Moving on…

/**
 * Render the WSDL
 */
public function wsdlAction()
{
  $wsdl = new Zend_Soap_AutoDiscover();
  $wsdl->setUri( APP_URL . '/index/' );
  $wsdl->setClass( 'Models_Writer' );
  $wsdl->handle();
  exit;
}

As shown on line 7, APP_URL is to be replaced with the url of the application (ie. http://localhost/). You may define APP_URL inside bootstrap.php for global use. Function setUri is used to define the url used as the server. In this example, the indexAction is used to serve as the Soap server. And to verify the generated WSDL is correct, use your browser and type http://localhost/index/wsdl/ with the assumption that all Action functions in this example will be coded inside IndexController class. This url should returns with the correct WSDL. Please take note of the url though, that it must end with a backslash ‘/’.

And if browser returns with an error message below.

XML Parsing Error: XML or text declaration not at start of entity

Please make sure there isn’t any trailing spaces before the <?php and after ?> in your php file.

Next, we shall look at the code to create your Soap server.

/**
 * Serve as the web service
 */
public function indexAction()
{
  $server = new Zend_Soap_Server( APP_URL . '/index/wsdl/' );
  $server->setClass( 'Models_Writer' );
  $server->handle();
  exit;
}

The above code instantiates Zend_Soap_Server with the url to the generated WSDL and set the class as Models_Writer and finally quits upon handling the request. Ok, now the indexAction is ready to serve as a Soap server.

Finally, to make sure that the server is handling the request correctly, let’s create the Soap client that makes a Soap request to the server.

/**
 * Client to request from web service
 */
public function clientAction()
{
  $client = new Zend_Soap_Client( APP_URL . '/index/wsdl/' );
  $response = $client->write( 'hello world' );
  var_dump( $response );
  exit;
}

The above code first instantiates Zend_Soap_Client with the specified url to the WSDL. Line below then calls the function write from the server. Here, you were probably wondering where in the code have we specified the server url. Well, if you recall the previous code when we first created the WSDL, we has actually specified the Soap server url. As a result, Soap client is able to know the server url from the WSDL.

Now try access http://localhost/index/client/, the page should return you with the following line:

string(11) "hello world"

Phew! it’s along explanation for a simple task. My arms are getting cramped now. I hope you are following well with my explanation. If not, well, I have a sample file you can download and test it on your local. I hope it works well. If not, let me know of your encounter.

Well, while experimenting this I have a stumbling block which I managed to find a solution to it. Here goes the encounter.

If you encounter the following error message:

Warning: domdocument::domdocument() expects at least 1 parameter, 0 given in C:wampbinphpphp5.2.8
includesZendSoapWsdl.php on line 94
Fatal error: Call to undefined method domdocument::loadXML() in C:wampbinphpphp5.2.8
includesZendSoapWsdl.php on line 95

You need disable php_domxml on your WampServer.

I hope I give enough information. Feel free to give your feedback. If you find this post useful, please help leave your rating below. Thanks! Happy coding!

Source:

• SOAP web service with Zend Framework