高性能PHP框架Symfony2经典入门教程
Symfony2是一个基于PHP语言的Web开发框架,有着开发速度快、性能高等特点。本文以一个程序示例的实现过程详细叙述了Symfony2框架的配置与程序开发。
一、下载
首先是下载Symfony2,到http://symfony.com/download或者本站下载https://www.nhooo.com/codes/187833.html。本人以Ubuntu系统为例,采用.tgz的压缩包,解压源文件到/var/www目录中并执行:
tarzxvfSymfony_Standard_Vendors_2.0.###.tgz-C/var/www
上面的###是指版本号,我下的时候是BETA5。
当解压之后,Symfony2的目录如下:
/var/www/<-Web根目录 Symfony/<-Symfony2解压目录 app/<-存放symfony的核心文件的目录 cache/<-存放缓存文件的目录 config/<-存放应用程序全局配置的目录 logs/<-存放日志的目录 src/<-应用程序源代码 ... vendor/<-供应商或第三方的模组和插件 ... web/<-Web入口 app.php<-生产环境下的前端控制器 ...
如果你需要安装(如果你下载的是withoutvendor版本)或更新vendor(第三方)内容时,可以使用:
cd/var/www/Symfony phpbin/vendorsinstall
二、配置
Symfony2的配置很简单,只需要在浏览器中输入:
http://localhost/Symfony/web/config.php
然后按照提示来进行就可以了。其中值得注意的就是app/cache和app/logs目录的权限问题,由于我是在Ubuntu下安装的,所以可以使用(其中firehare是我的用户名,大家在这里可以用你的用户名代替):
#为了保险起见 rm-rfapp/cache/* rm-rfapp/logs/* #设置ACL sudosetfacl-R-mu:www-data:rwx-mu:firehare:rwxapp/cacheapp/logs sudosetfacl-dR-mu:www-data:rwx-mu:firehare:rwxapp/cacheapp/logs
如果系统不支持setfacl命令的话,要检查2个地方:
setfacl是否已经安装,如果没有的话,可以通过以下命令安装(在Ubuntu11.10中好象已经缺省安装了,包为叫acl):
sudoapt-getinstallsetfacl
如果setfacl已经安装,那么请查看/etc/fstab文件,看看是否添加了acl选项:
#/varwason/dev/sda7duringinstallation UUID=c2cc4104-b421-479a-b21a-1108f8895110/varext4defaults,acl02
然后根据页面提示填写数据库名等信息,再将这些信息拷到/var/www/Symfony/app/config/parameters.ini文件中,如下所示:
;Theseparameterscanbeimportedintootherconfigfiles ;byenclosingthekeywith%(like%database_user%) ;Commentsstartwith';',asinphp.ini [parameters] database_driver="pdo_mysql" database_host="localhost" database_name="symfony" database_user="symfony" database_password="symfony" mailer_transport="smtp" mailer_host="localhost" mailer_user="" mailer_password="" locale="zh_CN" secret="29f96e9e70c2797cb77dd088d3954d3c38d9b33f"
如果全部OK的话,在你浏览器中输入下列地址时,你将得到一个Demo页:
http://localhost/Symfony/web/app_dev.php
三、程序示例:
1.创建Bundle:
首先创建一个Bundle:
phpapp/consolegen:bundle"AcmeHelloBundle"src 为了确保Acme名称空间可以被自动加载,请在你的app/autoload.php文件添加下列语句: $loader->registerNamespaces(array( //... //添加自定义的名称空间 'Acme'=>__DIR__.'/../src', //... )); 最后是将该Bundle注册到Symfony2中,请在你的app/AppKernel.php文件中添加下列语句: //app/AppKernel.php publicfunctionregisterBundles() { $bundles=array( //... newAcmeHelloBundleAcmeHelloBundle(), ); //... return$bundles; }
2.创建路由
路由可以创建在app/config/routing.yml中,但为了有个好的编程习惯和代码组织,可以将它放在所建Bundle目录中的Resources/config/routing.yml中,而在app/config/routing.yml中只保留到该路由文件的引用,如下所示:
#app/config/routing.yml homepage: pattern:/ defaults:{_controller:FrameworkBundle:Default:index} hello: resource:"@AcmeHelloBundle/Resources/config/routing.yml"
而真正的路由则写在src/Acme/HelloBundle/Resources/config/routing.yml路由文件中,如下所示:
#src/Acme/HelloBundle/Resources/config/routing.yml hello: pattern:/hello/{name} defaults:{_controller:AcmeHelloBundle:Hello:index,name:'pu'}
3.创建控制器:
控制器的名字一定得是HelloController.php,原因很简单,因为你路由已经把控制器的名字给定下来了,在上面路由文件中的第4行和第7行中的控制器都是以AcmeHelloBundle:Hello开头的,其中AcmeHelloBundle表示Bundle名,而Hello则表示控制器名,所以控制器必须是HelloController.php,Controller名缀是命名约定。而至于后面的index和say则是控制器类中的方法。下面就定义了index方法,当然方法名为indexAction这个也是命名约定:
//src/Acme/HelloBundle/Controller/HelloController.php namespaceAcmeHelloBundleController; useSymfonyComponentHttpFoundationResponse; classHelloController { publicfunctionindexAction($name) { returnnewResponse('<html><body>Hello'.$name.'!</body></html>'); } }
这样,当我们在浏览器中输入
http://localhost/hello/index/World
就会显示HelloWorld!这样的字样。
4.创建模板:
为了能够重用布局文件中的区块,可以使用模板来代替控制器中的HTML语句。首先创建页面布局文件:
{#app/Resources/views/layout.html.twig#} <!DOCTYPEhtml> <html> <head> <metahttp-equiv="Content-Type"content="text/html;charset=utf-8"/> <title>{%blocktitle%}HelloApplication{%endblock%}</title> </head> <body> {%blockbody%}{%endblock%} </body> </html>
注意,该文件位于app/Resources/views/目录中,作用范围是整个应用程序的全局模板文件。在该文件中定义了两个区块:title和body。接下来就是创建一个专用于Hello控制器的模板,如下所示:
{#src/Acme/HelloBundle/Resources/views/Hello/index.html.twig#} {%extends'::layout.html.twig'%} {%blockbody%} Hello{{name}}! {%endblock%}
在该文件中,它继承了全局模板,并且定义了区块body,这样就覆写了全局模板中的body区块。如果系统在渲染到该模板时,会将区块body覆写全局模板的区块body,再进行渲染。
最后,将控制器中的HTML语句改成渲染上述模板即可:
//src/Acme/HelloBundle/Controller/HelloController.php namespaceAcmeHelloBundleController; useSymfonyBundleFrameworkBundleControllerController; classHelloControllerextendsController { publicfunctionindexAction($name) { return$this->render('AcmeHelloBundle:Hello:index.html.twig',array('name'=>$name)); } }