Running Symfony
Download as ODP, PDF0 likes1,635 views
The document provides instructions for installing and setting up the Symfony PHP framework. It discusses different installation methods like using the sandbox, PEAR, or SVN. It also covers generating a new Symfony project and application, configuring the web server, and troubleshooting common issues. Version control of Symfony projects using Subversion is also described.
![Wildan Maulana | wildan [at] tobethink.com #3 The Definitive Guide to symfony Running Symfony Doc. v. 0.1 - 14/04/09](https://image.slidesharecdn.com/3-runningsymfony-090420222143-phpapp02/85/Running-Symfony-1-320.jpg)
Running Symfony
- 1. Wildan Maulana | wildan [at] tobethink.com #3 The Definitive Guide to symfony Running Symfony Doc. v. 0.1 - 14/04/09
- 2. Requirement Symfony requires at least PHP 5.2. Make sure you have it installed by opening a command line and typing this command: > php -v PHP 5.2.6-2ubuntu4 with Suhosin-Patch 0.9.6.2 (cli) (built: Oct 14 2008 20:06:32) Copyright (c) 1997-2008 The PHP Group Zend Engine v2.2.0, Copyright (c) 1998-2008 Zend Technologies
- 3. Symfony Installation Method Use sandbox if you just wanna see what is symfony capable of
- 4. Use PEAR installation method, it is recommended for most people
- 5. Use Subversion (SVN) installation, it is meant to be used by advanced PHP developers, who want to take advantage of the latest patches, add features of their own, and/or contribute to the symfony project. Btw, I prefer using SVN installation method
- 6. Installing the Sandbox The sandbox is a simple archive of files. It contains an empty symfony project including all the required libraries (symfony, lime, Prototype with Scriptaculous, Doctrine and Propel with Phing), a default application, and basic configuration. It will work out of the box, without specific server configuration or any additional packages.
- 7. Download from : http://www.symfony-project.org/get/sf_sandbox_1_2.tgz Unpack it to the root web directory (I assume you to use sf_sandbox/ directory)
- 8. Test the installation : > php symfony -V You will see sandbox version number : symfony version 1.2.0 (/path/to/the/symfony/lib/dir/used/by/the/sandbox) Try to browse the sandbox by requesting this URL : http://localhost/sf_sandbox/web/frontend_dev.php/
- 9. Installing symfony Libraries Using symfony PEAR package
- 11. Installing the symfony PEAR Package Add the symfony channel to PEAR > pear channel-discover pear.symfony-project.com
- 12. To see the libraries available in this channel, type the following: > pear remote-list -c symfony
- 13. Now you are ready to install the latest stable version of symfony. Issue this command: > pear install symfony/symfony
- 15. Starting to download symfony-1.2.0.tgz (1,283,270 bytes)
- 20. Check that the installation succeeded > symfony -V
- 21. symfony version 1.2.0 (/path/to/the/pear/symfony/lib/dir)
- 22. Installing the symfony PEAR Package The symfony libraries are now installed in directories as follows: $php_dir/symfony/ contains the main libraries.
- 23. $data_dir/symfony / contains the web assets used by symfony default modules.
- 24. $doc_dir/symfony/ contains the documentation.
- 25. $test_dir/symfony/ contains symfony core unit and functional tests. The _dir variables are part of your PEAR configuration. To see their values, type the following: > pear config-show
- 26. Checking Out symfony from the SVN Repository # > mkdir /path/to/symfony
- 27. # > cd /path/to/symfony
- 28. # > svn checkout http://svn.symfony-project.com/tags/RELEASE_1_2_0/
- 30. symfony version 1.2.0 (/path/to/the/svn/symfony/lib/dir) <?php require_once '/path/to/symfony/lib/autoload/sfCoreAutoload.class.php'; sfCoreAutoload::register(); class ProjectConfiguration extends sfProjectConfiguration { // ... }
- 31. Setting Up an Application Creating the Project
- 33. Creating Project For a PEAR installation, issue these commands: > mkdir ~/myproject > cd ~/myproject > symfony generate:project myproject For an SVN installation, create a project with these commands: > mkdir ~/myproject > cd ~/myproject > php /path/to/symfony/data/bin/symfony generate:project myproject apps/ cache/ config/ data/ doc/ lib/ log/ plugins/ test/ web/ Symfony will create a directory structure that looks like this:
- 34. Creating the Application The project is not ready for viewing before you create at least one application in it.
- 35. To initialize application use the symfony generate:app command >php symfony generate:app frontend
- 36. This will create a frontend/ directory in the apps/ folder of the project root, with a default application configuration and a set of directories ready to host the file of your website: apps/ frontend/ config/ i18n/ lib/ modules/ templates/ web/ index.php frontend_dev.php index.php -> front controller in production environment frontend_dev.php -> front controller in development environment
- 37. Configuring the Web Server There are several cases : Setting Up a Virtual Host
- 38. Setting Up an Alias
- 39. Configuring a Shared-Host Server
- 40. Setting Up a Virtual Host <VirtualHost *:80> ServerName myapp.example.com DocumentRoot "/home/steve/myproject/web" DirectoryIndex index.php Alias /sf /$sf_symfony_data_dir/web/sf <Directory "/$sf_symfony_data_dir/web/sf"> AllowOverride All Allow from All </Directory> <Directory "/home/steve/myproject/web"> AllowOverride All Allow from All </Directory> </VirtualHost> Don't fortget to setup your DNS entry for your application address first
- 41. Setting Up an Alias
- 42. Configuring a Shared-Host Server This is a little trickier, since host usually has spesific directory layout that you can't change
- 43. .htaccess Options +FollowSymLinks +ExecCGI <IfModule mod_rewrite.c> RewriteEngine On # uncomment the following line, if you are having trouble # getting no_script_name to work #RewriteBase / # we skip all files with .something #RewriteCond %{REQUEST_URI} \..+$ #RewriteCond %{REQUEST_URI} !\.html$ #RewriteRule .* - [L] # we check if the .html version is here (caching) RewriteRule ^$ index.html [QSA] RewriteRule ^([^.]+)$ $1.html [QSA] RewriteCond %{REQUEST_FILENAME} !-f # no, so we redirect to our front web controller RewriteRule ^(.*)$ index.php [QSA,L] </IfModule>
- 44. Browse Your New App http://www.example.com/frontend_dev.php/
- 45. Troubleshooting Parse error, unexpected ',', expecting '(' in .../symfony.php on line 19.
- 46. Allowed memory size of 8388608 bytes exhausted
- 47. Strict Standards: Implicit cloning object of class 'sfTimer'because of 'zend.ze1_compatibility_mode'
- 48. sfCacheException [message] Unable to write cache file"/usr/myproject/cache/frontend/prod/config/config_config_handlers.yml.php"
- 49. The include path of your system must include the path to the php command, and the include path of your php.ini must contain a path to PEAR (if you use PEAR).
- 50. Sometimes, there is more than one php.ini on a server's file system (for instance, if you use the WAMP package). Call phpinfo() to know the exact location of the php.ini file used by your application.
- 51. Symfony Resources The symfony installation forum (http://www.symfony-project.org/forum/)
- 52. The archives of the users mailing-list (http://groups.google.fr/group/symfony-users)
- 53. The symfony wiki (http://trac.symfony-project.org/
- 54. Source Versioning > svnadmin create $SVNREP_DIR/myproject
- 55. > svn mkdir -m "layout creation" file:///$SVNREP_DIR/myproject/trunk file:///$SVNREP_DIR/myproject/tags file:///$SVNREP_DIR/myproject/branches
- 56. > cd ~/myproject
- 57. rm -rf cache/*
- 58. rm -rf log/*
- 59. svn import -m "initial import" . file:///$SVNREP_DIR/myproject/trunk
- 60. > svn ls file:///$SVNREP_DIR/myproject/trunk/
- 61. > cd ~
- 62. > mv myproject myproject.origin
- 63. > svn co file:///$SVNREP_DIR/myproject/trunk myproject
- 64. > ls myproject
- 65. > cd ~/myproject
- 66. > chmod 777 cache
- 67. > chmod 777 log
- 68. > svn propedit svn:ignore log
- 69. > svn propedit svn:ignore cache
- 70. > export SVN_EDITOR=<name of editor>
- 71. > svn propedit svn:ignore log
- 72. > svn propedit svn:ignore cache
- 73. Write * , save and quit.
- 74. You're finished
- 75. Summary For symfony 1 st time user, your best option is using the sandbox version
- 76. For real development, consider to use the SVN version
- 77. Once your project is initiated, it is a good habit to start a version-control process.
- 78. Q&A
- 79. Reference The Definitive Guide to symfony, Fabien Potencier , Apress