Posts Tagged framework

Mar 7 2009

Starting with Zend Framework – Configuration File and Database Connection

On the first article about the Zend Framework series, i have covered out the Setup of the Development Environment, on this article i will cover the Zend Framework configuration files and the database connection.

I will try to guide you on a brief and short path to start using the database in your Zend Framework project.

First Task – The configuration file

Our first task for today is to create the configurations file, i prefer to use php .ini files to save configuration settings, due to it’s clean and functional organization.

On your /public/config/ folder, create a file named configurations.ini with the following content.

[production]
database.adapter			=	pdo_mysql
database.params.host		=	localhost
database.params.username	=	root
database.params.password	=	xpto
database.params.dbname		=	restaurant
[development : production ]
database.params.host	=	127.0.0.1
database.params.username=	root
database.params.password=	ypto

I am defining my database settings to use PDO_Mysql driver and all the database needed settings, as you can see i am using two sections, the first one named [production] and the second one named [development:production] the : separation means that we are inheriting our development section from um previous production, and we will override some of the definitions. You can read more about this on the Zend Framework Config instructions.


Second Task: Load the configuration settings on your bootstrap file

Now that you have created the configuration file, you need to give some use tho it, lets go to the previously created bootstrap file, on your path /public/bootstrap.php, after the line that contains “Zend_Loader::registerAutoload();“, add the following content:

/**
 * Loading configuration from ini file
 */
$configuration = new Zend_Config_Ini(
    './config/configurations.ini', 
    'development'
);

We are reading the configuration file into a Zend_Config Object, to access the object you could by example do:

echo $config->database->params->host;

 

Third Task: Creating the database handler

Now that we have the configurations needed on a Zend_Config object we are ready to create the database connection. In order to do that, just after the previous code on bootstrap.php file, add the content.

/**
 * Creating the database handler from the loaded ini file
 */
$dbAdapter = Zend_Db::factory($configuration->database);
/**
 * Lets define the newly created handler as our default database handler
 */
Zend_Db_Table_Abstract::setDefaultAdapter($dbAdapter);
We are creating the database handler and defining the newly created database handler as the default for my front controller.

 Fourth Task: Using the Zend Registry to save the values

Now that we have our application using the database handler, and we are connected to the database, i will save the $configurations values and the $dbAdapter on the Registry for further usage.

/**
 * Lets add the configurations and the database handler to Registry
 * to use in future
 */
$registry = Zend_Registry::getInstance();
$registry->configuration = $configuration;
$registry->dbAdapter     = $dbAdapter;
/**
 * Now that we have the values on the Registry, lets cleanuo the variables
 * from the script scope
 */
unset($dbAdapter, $registry,$configuration);

You can read more about Zend Registry on the framework manual.

On this article, i have approached the Zend Config, Zend_Db and Zend_Registry usage, i are now able to deal with each one of this components, on my next article on this series, i will help you to create a Model extending the Zend_Db_Table.

Mar 4 2009

Starting with Zend Framework – Setup your development environment

This article intends to make you in Zend Framework quickly and painless. I will try to show how can you setup your project in less than 30 minutes.

First Task: Download the library

Download Zend Framework

Second Task: Define your directory structure

This depends mostly from the way you work, on my personal case, i preffer the following directory structure:

  • /
  • /public
    • /config
    • /controllers
    • /models
    • /views
      • /layouts
      • /scripts
  • /shared
    • /Zend

Third Task: Set your project virtual hosts

[sourcecode lang=’php’]<VirtualHost localhost:80>
ServerName localhost
ServerAlias localhost
ServerAdmin [email protected]
DocumentRoot /<DOCUMENT_ROOT>/public
CustomLog /var/log/apache2/localhost-access.log combined
</VirtualHost>[/sourcecode]

Please notice on <DOCUMENT_ROOT>, this should be the folder structure to you newly created directory structure for the project.

Fourth Task: Create the htaccess file to redirect all requests to your bootstrap file

Go to your <DOCUMENT_ROOT>/public/ folder and create the .htaccess file with the following content.

[sourcecode lang=’php’]RewriteEngine on
RewriteBase /
RewriteRule !\.(js|css|ico|gif|jpg|png)$ bootstrap.php[/sourcecode]

 

This way you are defining that all your requests, excluding all the js,css,ico,jpg and jpg file calls will go to bootstrap.php file.

Fifth Task: Create your bootstrap file

Your bootstrap content will look like.

 

[sourcecode lang=’php’]<?php
    /**
     * Bootstrap file
     */
set_include_path(‘.’ . PATH_SEPARATOR . ‘../shared/’);
//include path to zend framework and models

date_default_timezone_set(‘Europe/Lisbon’);
//timezone and time options

/**
 * Zend Front Controller
 */
require_once ‘Zend/Controller/Front.php';

/**
 * Enabling auto loading
 */
Zend_Loader::registerAutoload();

$controller = Zend_Controller_Front::getInstance();

/**
 * Set the path to controllers
 */
$controller->setControllerDirectory(‘./controllers/’)
            ->setBaseUrl(‘/’)
            ->throwExceptions(true);

/**
 * Starting the MVC Layer
 */
Zend_Layout::startMvc(array(“layoutPath”=>”views/layouts”));

$response = $controller->dispatch();   

?>[/sourcecode]

Now that you have your bootstrap file, meaning your request router, you are ready to make your default controller.

Sixth Task: Create the layout file

As you may imagine, you need to create a layout for your project, in this quick how-to we will use the Zend Layout component. On your /public/views/layout/ folder create the file layout.phtml with the following content.

[sourcecode lang=’html’]<?php echo ‘<?xml version=”1.0″ encoding=”UTF-8″?>'; ?>

<?php echo $this->doctype(‘XHTML1_TRANSITIONAL’); ?>

<html xmlns=”http://www,w3,org/1999xhtml”>

    <head>
   
        <?php echo $this->headMeta()->appendHttpEquiv(
            ‘Content-Type’,
            ‘text/html; Charset=UTF-8′
        ); ?>
    </head>

    <body>
     <div id=”header-navigation” style=”float: right”>
        <a href=”<?= $this->url(
            array(‘controller’=>’login’),
            ‘default’,
            true) ?>”>Login</a>
    </div>
        <?php echo $this->layout()->content; ?>   
    </body>

</html>[/sourcecode]

Seventh Task: Your first controller

You need to create the controller that will respond to your first request, we call it the Index Controller. To create it just go to your /public/controllers directory and create a file named IndexController.php with the following content.

[sourcecode lang=’php’]<?php

require_once ‘Zend/Controller/Action.php';

class IndexController extends Zend_Controller_Action {
   
    public function indexAction() {
    }
}
?>[/sourcecode]


Eight Task: Your first view

In order to display something on your controller request handler you need to create the view, we call it the Index View.

Go to you views folder placed under /public/views/scripts/ and create a folder named index, the name of your first controller, create the action name file inside it, as we are handling the action “Index” you should create a file named index.phtml.

[sourcecode lang=’html’]Hello world on INDEX[/sourcecode]

 

In this article i have approached the View and Controller, because this is a Starting with Zend Framework i haven’t approached the Model thematic, i will make an approach to it on next article. There are plenty of contents to explore on the Zend Framework, this article intends to put your on the first step, having your work environment set, the fun begins after this.