This is the only part of the code that you should modify in example.php:

/**
* Configuration params, make sure to write exactly the ones
* instagram provide you at http://instagr.am/developer/
*/
$config = array(
    'client_id' => '<your_client_id>',
    'client_secret' => '<your_client_secret>',
    'grant_type' => 'authorization_code',
    'redirect_uri' => 'http://your.call/back/url.php',
);

If you have any question, don’t hesitate to post your comment and check back often, I read them frequently.

In order to use the official API, you have to sign up first for a client key at http://instagr.am/developer/. You will need to register a new client or use the data from an existing one, just keep in mind these are the important data that you need before you can interact with the API:

Client Id: let’s call it a public key. It is necessary so the API knows your application. This is public available information, for the purpose of the example provided with my implementation we are going to query Instagram’s service directly using the client key as part of the URL.

Client secret: this is the private key that once paired with the client id is exchanged with Instagram’s service. The client secret needs to be private, but you have to make it available in some form inside your code so it can be sent and to get the authentication token back.

Callback url: maybe on of the most important aspects in this example. Make sure the callback URL is exactly the same where you are going to put the script that acts as an entry point for the Instagram callback. For this particular example, this script is going to be called “instagram.php”, meaning that you’ll have to point Instagram to something like http://example.com/instagram.php.

So this is as easy as one, two, three.

1. Grab the code from GitHub in you preferred format: zip or tar.gz and Unpack it in the same folder you told Instagram your callback was going to live.

2. The example we create in this post, authenticates and displays the most popular photos according to the data sent back by the API. The implementation provides access to all public methods, so you can create you own stuff. Amongst others, you can search for media, perform ‘follow’ actions or search media by location.

3. Just make sure to modify the code, so you can put your own client properties in the $config array at the beginning of the file:

/**
* Configuration params, make sure to write exactly the ones
* instagram provide you at http://instagr.am/developer/
*/
$config = array(
        'site_url' => 'https://api.instagram.com/oauth/access_token',
        'client_id' => '', // Your client id
        'client_secret' => '', // Your client secret
        'grant_type' => 'authorization_code',
        'redirect_uri' => '', // The redirect URI you provided when signed up for the service
     );

And now, the code of the instagram.php script:

require_once 'Instagram.php';

/**
* Configuration params, make sure to write exactly the ones
* instagram provide you at http://instagr.am/developer/
*/
$config = array(
        'site_url' => 'https://api.instagram.com/oauth/access_token',
        'client_id' => '', // Your client id
        'client_secret' => '', // Your client secret
        'grant_type' => 'authorization_code',
        'redirect_uri' => '', // The redirect URI you provided when signed up for the service
     );

// Instantiate the API handler object
$instagram = new Instagram($config);
$popular = $instagram->getPopularMedia();

// After getting the response, let's iterate the payload
echo "<ul>\n";
$response = json_decode($popular, true);
foreach ($response['data'] as $data) {
    $link = $data['link'];
    $caption = $data['caption']['text'];
    $author = $data['caption']['from']['username'];
    $thumbnail = $data['images']['thumbnail']['url'];
?>
<li><a href="<?= $link ?>"><img src="<?= $thumbnail ?>" title="<?= $caption ?>" width="150" height="150" border="0" align="absmiddle"></a> by <?= $author ?></li>
<?
}
echo "</ul>\n";

Finally, point you browser to the authorization URL and enjoy your coding!
https://api.instagram.com/oauth/authorize/?client_id=CLIENT_ID&redirect_uri=REDIRECT_URL.

You can get more details about manipulating the API at http://instagr.am/developer/

I will try to show how to have the Zend Framework installed with as many projects as you want (if your server quota allows you to) in the same web space and all these projects sharing the same ZF copy.

Suppose that your home directory is /home/mauricio/. From now on, I am going to refer to it as <root>. Create the following file structure under it:

library/
  Zend/
myfirstproject/
  application/
    controllers/
    views/
      scripts/
mysecondproject/
  application/
    controllers/
    views/
      scripts/
public_html/
  myfirstproject/
  mysecondproject/

Now download, extract and upload the “Zend” directory contained in the zip or gz file into the “<root>/library” directory of the structure that you have just created. This copy of the Zend Framework will be shared by all projects. If needed, you can upgrade to a future version of ZF just by changing its content.

Keep in mind that this example is based on the fact that the public folder on the hosting environment is “<root>/public_html”. Some providers call it “www”, so… in this example our public folder will be called “public_html”, make the appropriate changes to suit your needs.

The first folders: “myfirstproject” and “mysecondproject” will contain the application files that won’t be visible to the outside world. Notice that under public_html exist another two folders under the same names, these two folder will contain the bootstrap or the entry point for the application which must be of public access and all the images, style sheets and other media that your application requires.

Your .htaccess file under <root>/public_html/myfirstproject/ should look like this:

RewriteEngine On
RewriteCond %{REQUEST_FILENAME} -s [OR]
RewriteCond %{REQUEST_FILENAME} -l [OR]
RewriteCond %{REQUEST_FILENAME} -d
RewriteRule ^.*$ - [NC,L]
RewriteRule ^.*$ index.php [NC,L]

And the bootstrap file index.php under the same location, should look like this:

<?php
/**
* <root>/public_html/myfirstproject/index.php
*
*/

// The library folder contains Zend Framework files
define('LIBRARY_PATH',     realpath(dirname(__FILE__) . '/../../library/'));
define('APP_PATH',         realpath(dirname(__FILE__) . '/../../myfirstproject/application/'));
define('CONTROLLERS_PATH', APP_PATH . '/controllers/');

// library is appended to the include_path
set_include_path(get_include_path() . PATH_SEPARATOR . LIBRARY_PATH);
include_once 'Zend/Loader.php';
Zend_Loader::registerAutoload();

/**
* The most important step is to set the controllers directory pointing to
* <root>/myfirstproject/application/controllers
*/
$front = Zend_Controller_Front::getInstance();
$front->setControllerDirectory(CONTROLLERS_PATH);
$front->dispatch();

That was the trick, let’s finish this creating our IndexController and its view. The first one should be placed on <root>/myfirsproject/application/controllers/IndexController.php:

<?php

/**
* <root>/myfirstproject/application/controllers/IndexController.php
*
*/
class IndexController extends Zend_Controller_Action
{
  public function indexAction()
  {
  }
}

The view should be anything you like, my bet is for:

<!-- <root>/myfirstproject/application/views/scripts/index.phtml -->
<html>

<head><title>It works!</title></head>

<body>
<h2>It works!</h2>
</body>
</html>

That’s all, you can start building more views, controllers and helpers. To get your second project working just follow the same steps that you did for “myfirstproject” folder. The same way, you can create as many projects as you want, keep in mind that they all share the same Zend Framework library.

Besides the huge attention that this problem caught, I was really impressed by the open and detailed response that Google gave to all of its customers. One good thing about the Gfail issue was the creation of the new Google apps status dashboard, where –as its name says– people can see the status of the main Google services with very detailed information, like this PDF report about the past Gmail issue.

How I wish that many companies follow this lead…

Full details on this link!

What really impressed me was the love and commitement that all of the organizers showed about PHP. Some people say that you get what you pay for… well, the event registration was only 20 euros and some of the best-known PHP community speakers were there.

There were simultaneous talks, so I couldn’t attend all of them:

Marcus Bointon started with e-mail in PHP, not only showed the benefits of PHP Mailer, he also dug into the mass mailing topic, giving some interesting facts and recommendations about handling the delivery of  huge amounts of e-mails.

The next talk was as entertaining as interesting, Arno Schneider who does a really good job designing very appealing slides, explained his disagreement with Rasmus Lerdorf about PHP frameworks, showed some real world examples and took many of us back to our early programming days when our code was a mess.

Scott MacVicar and Derick Rethans were the last ones, they talked about SQLite 3 and Xdebug respectively. A pair of interesting and mature projects, both of which I’ve had the time to test drive.

My trip to Barcelona was totally worth it. I want to give a huge thanks to the organizers and encourage them to keep up with their loyalty and hard work towards the community, creating this type of good quality events and hoping for nothing in return.

So I’m glad to have this new blog!

Como ejemplos anteriores, este es bastante sencillo:

El indexAction() muestra la vista con el formulario que debe ser validado, si no se usa MVC olvidémoslo.

validateAction() es donde todo sucede, primero se declara una clase con un validador personalizado (que explicaré luego). La validación encadenada es creada, cada una especifica la clase de validación que se utiliza con sus respectivos parámetros y los mensajes predeterminados a mostrar.

Los mensajes personalizados son una característica bastante útil, especialmente cuando se desarrollan aplicaciones multi-lenguaje.

Luego se crea un array con los filtros a aplicar, no todos los datos son filtrados. En este caso, solo la edad, la dirección y el número telefónico son “limpiados” para evitar que lleguen caracteres prohibidos.

Finalmente Zend_Filter_Input entra en el juego, recibiendo todos los datos del formulario y chequeando todos en un solo llamado al método isValid().

Adicionalmente, estoy usando FlashMessenger para almacenar los mensajes de éxito o error y mostrarlos en el próximo llamado HTTP. Recuerde que los mensajes del FlashMessenger no pueden ser mostrados en la misma acción que se instancian.

Cualquier duda o comentario en macuenca@[ElCorreodeGoogle].com

class ValidatorController extends Zend_Controller_Action
{
    /**
     * Renders the form
     *
     */
    public function indexAction()
    {
        show_source(PATH_CONTROLLERS . 'ExampleController.php');
    }

    /**
     * Validates the input
     *
     */
    public function validateAction()
    {
        /**
         * The included class is an example of custom validators
         */
        require_once PATH_CLASSES . 'My_Validate_Url.php';
        $validurl = new My_Validate_Url();
        $validurl->setMessage('Invalid URL', My_Validate_URL::NOT_MATCH);
        $validurl->setMessage('Empty', My_Validate_URL::STRING_EMPTY);
        $validators = array(
             'address' => array('Alnum', new Zend_Validate_Alnum(true),
                                'messages' => array(
                                'Address not valid', // Default error message
                                // Specific error messages
                                array(Zend_Validate_Alnum::NOT_ALNUM =>
                                      'Address contains invalid characters',
                                      Zend_Validate_Alnum::STRING_EMPTY =>
                                      'Address field is mandatory'))),
             'phone'   => array('Digits', new Zend_Validate_Digits(),
                                'messages' => array(
                                'Wrong phone number format',
                                array(Zend_Validate_Digits::NOT_DIGITS =>
                                      'Phone number can only have digits',
                                      Zend_Validate_Digits::STRING_EMPTY =>
                                      'Phone number can not be empty'))),
             'age'     => array('Digits', new Zend_Validate_Between(16, 59),
                                'messages' => array(
                                'You do not qualify because of your age',
                                array(Zend_Validate_Between::NOT_BETWEEN =>
                                      'Age is not between the allowed range'))),
             'id'      => array('StringLength', new Zend_Validate_StringLength(8, 10),
                                'messages' => array(
                                'ID not valid',
                                array(Zend_Validate_StringLength::TOO_LONG =>
                                      'ID is too long',
                                      Zend_Validate_StringLength::TOO_SHORT =>
                                      'ID is too short'))),
             'date'    => array('Date', new Zend_Validate_Date(),
                                'messages' => array(
                                'Wrong date',
                                array(Zend_Validate_Date::INVALID =>
                                      'Date not recognized as valid',
                                      Zend_Validate_Date::FALSEFORMAT =>
                                      'Date format is incorrect',
                                      Zend_Validate_Date::NOT_YYYY_MM_DD =>
                                     'Date format must be YYYY-MM-DD'))),
              'url'      => $validurl
           );

        /**
         * Age, address and phone are also filtered
         * The true param in Zend_Filter_Alnum tells it to allows whitespaces
         */
        $filters = array('age'      => 'Int',
                         'address'  => array('Alnum', new Zend_Filter_Alnum(true)),
                         'phone'    => 'Digits');

        // Now we chain the validators, the filters and pass the post params on
        $input = new Zend_Filter_Input($filters, $validators);
        $input->setData($this->getRequest()->getParams());

        // Check whether errors occur
        if ($input->isValid())
        {
            $this->_helper->FlashMessenger->addMessage('Success!');
            $this->_helper->redirector('index');
        } else {
            $messages = $input->getMessages();
            foreach ($messages as $key => $value)
            {
                // Store all messages in FlashMessenger
                foreach ($value as $msg)
                {
                    $this->_helper->FlashMessenger->addMessage($msg);
                }
            }
        }

        // There are errors, the index action will show them...
        $this->_helper->redirector('index');
    }
}

You can see the custom validator in action in this post.

This is the code:

class My_Validate_Url extends Zend_Validate_Abstract
{
    /**
     * Validation failure message key for when the value is an empty string
     */
    const STRING_EMPTY = 'stringEmpty';
    const NOT_MATCH    = 'urlNotMatch';

    /**
     * @var array
     */
    protected $_messageTemplates = array(
        self::NOT_MATCH    => "'%value%' does not match an url",
        self::STRING_EMPTY => "'%value% is an empty string"
    );

    public function isValid($value)
    {
        $valueString = (string) $value;

        $this->_setValue($valueString);

        if ('' === $valueString) {
            $this->_error(self::STRING_EMPTY);
            return false;
        } elseif (!preg_match('#https?://([-\w\.])+(:\d+)?(/([\w/_\.]*(\?\S+)?)?)?#', $valueString)) {
            $this->_error(self::NOT_MATCH);
            return false;
        }

        return true;
    }
}

Like all my examples, this is pretty straightforward:

The indexAction() only shows the view that contains the form to be validated, if you’re not using MVC you can leave it behind.
validateAction() is where all the magic happens, first a class for a custom validator (explained in other post) is declared. Then the validator chain is created, each one specifying the validator class being used with its respective parameters and the custom messages to show. The custom messages is a real nice feature, specially when developing multi-language applications.
Then the filters array is created, not all input is filtered. In this case, just the age, address and phone are “cleaned” to avoid forbidden characters.
Finally Zend_Filter_Input comes into the game, receiving all the form’s data and checking everything at once with its isValid() method.

Additionally, I’m using FlashMessenger to store the messages and show them in the following page reload. Keep in mind that FlashMessenger’s message can not be displayed in the same action where they are instantiated.

Any questions feel free to write me to macuenca@Google’sEmailService.com

class ValidatorController extends Zend_Controller_Action
{
    /**
     * Renders the form
     *
     */
    public function indexAction()
    {
        show_source(PATH_CONTROLLERS . 'ExampleController.php');
    }

    /**
     * Validates the input
     *
     */
    public function validateAction()
    {
        /**
         * The included class is an example of custom validators
         */
        require_once PATH_CLASSES . 'My_Validate_Url.php';
        $validurl = new My_Validate_Url();
        $validurl->setMessage('Invalid URL', My_Validate_URL::NOT_MATCH);
        $validurl->setMessage('Empty', My_Validate_URL::STRING_EMPTY);
        $validators = array(
             'address' => array('Alnum', new Zend_Validate_Alnum(true),
                                'messages' => array(
                                'Address not valid', // Default error message
                                // Specific error messages
                                array(Zend_Validate_Alnum::NOT_ALNUM =>
                                      'Address contains invalid characters',
                                      Zend_Validate_Alnum::STRING_EMPTY =>
                                      'Address field is mandatory'))),
             'phone'   => array('Digits', new Zend_Validate_Digits(),
                                'messages' => array(
                                'Wrong phone number format',
                                array(Zend_Validate_Digits::NOT_DIGITS =>
                                      'Phone number can only have digits',
                                      Zend_Validate_Digits::STRING_EMPTY =>
                                      'Phone number can not be empty'))),
             'age'     => array('Digits', new Zend_Validate_Between(16, 59),
                                'messages' => array(
                                'You do not qualify because of your age',
                                array(Zend_Validate_Between::NOT_BETWEEN =>
                                      'Age is not between the allowed range'))),
             'id'      => array('StringLength', new Zend_Validate_StringLength(8, 10),
                                'messages' => array(
                                'ID not valid',
                                array(Zend_Validate_StringLength::TOO_LONG =>
                                      'ID is too long',
                                      Zend_Validate_StringLength::TOO_SHORT =>
                                      'ID is too short'))),
             'date'    => array('Date', new Zend_Validate_Date(),
                                'messages' => array(
                                'Wrong date',
                                array(Zend_Validate_Date::INVALID =>
                                      'Date not recognized as valid',
                                      Zend_Validate_Date::FALSEFORMAT =>
                                      'Date format is incorrect',
                                      Zend_Validate_Date::NOT_YYYY_MM_DD =>
                                     'Date format must be YYYY-MM-DD'))),
              'url'      => $validurl
           );

        /**
         * Age, address and phone are also filtered
         * The true param in Zend_Filter_Alnum tells it to allows whitespaces
         */
        $filters = array('age'      => 'Int',
                         'address'  => array('Alnum', new Zend_Filter_Alnum(true)),
                         'phone'    => 'Digits');

        // Now we chain the validators, the filters and pass the post params on
        $input = new Zend_Filter_Input($filters, $validators);
        $input->setData($this->getRequest()->getParams());

        // Check whether errors occur
        if ($input->isValid())
        {
            $this->_helper->FlashMessenger->addMessage('Success!');
            $this->_helper->redirector('index');
        } else {
            $messages = $input->getMessages();
            foreach ($messages as $key => $value)
            {
                // Store all messages in FlashMessenger
                foreach ($value as $msg)
                {
                    $this->_helper->FlashMessenger->addMessage($msg);
                }
            }
        }

        // There are errors, the index action will show them...
        $this->_helper->redirector('index');
    }
}