共计 4191 个字符,预计需要花费 11 分钟才能阅读完成。
本文是高性能 php 开发框架 Symfony2 的一篇入门教材,Symfony2 是一个基于 PHP 语言的 Web 开发框架,有着开发速度快、性能高等特点。本文以一个程序示例的实现过程详细叙述了 Symfony2 框架的配置与程序开发。
一、下载
首先是下载 Symfony2,到 http://symfony.com/download 下载。本人以 Ubuntu 系统为例,采用.tgz 的压缩包,解压源文件到 /var/www 目录中并执行:
tar zxvf Symfony_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 <- 生产环境下的前端控制器
...
如果你需要安装 (如果你下载的是 without vendor 版本) 或更新 vendor(第三方)内容时,可以使用:
cd /var/www/Symfony
php bin/vendors install
二、配置
Symfony2 的配置很简单,只需要在浏览器中输入:
http://localhost/Symfony/web/config.php
然后按照提示来进行就可以了。其中值得注意的就是 app/cache 和 app/logs 目录的权限问题,由于我是在 Ubuntu 下安装的,所以可以使用(其中 firehare 是我的用户名,大家在这里可以用你的用户名代替):
# 为了保险起见
rm -rf app/cache/*
rm -rf app/logs/*
#设置 ACL
sudo setfacl -R -m u:www-data:rwx -m u:firehare:rwx app/cache app/logs
sudo setfacl -dR -m u:www-data:rwx -m u:firehare:rwx app/cache app/logs
如果系统不支持 setfacl 命令的话,要检查 2 个地方:
setfacl 是否已经安装,如果没有的话,可以通过以下命令安装(在 Ubuntu 11.10 中好象已经缺省安装了,包为叫 acl):
sudo apt-get install setfacl
如果 setfacl 已经安装,那么请查看 /etc/fstab 文件,看看是否添加了 acl 选项:
# /var was on /dev/sda7 during installation
UUID=c2cc4104-b421-479a-b21a-1108f8895110 /var ext4 defaults,acl 0 2
然后根据页面提示填写数据库名等信息,再将这些信息拷到 /var/www/Symfony/app/config/parameters.ini 文件中,如下所示:
; These parameters can be imported into other config files
; by enclosing the key with % (like %database_user%)
; Comments start with ';', as in php.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:
php app/console gen:bundle "AcmeHelloBundle" src
为了确保 Acme 名称空间可以被自动加载,请在你的 app/autoload.php 文件添加下列语句:$loader->registerNamespaces(array(
// ...
// 添加自定义的名称空间
'Acme' => __DIR__.'/../src',
// ...
));
最后是将该 Bundle 注册到 Symfony2 中,请在你的 app/AppKernel.php 文件中添加下列语句:// app/AppKernel.php
public function registerBundles()
{
$bundles = array(
// ...
new AcmeHelloBundleAcmeHelloBundle(),);
// ...
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
namespace AcmeHelloBundleController;
use SymfonyComponentHttpFoundationResponse;
class HelloController
{public function indexAction($name)
{return new Response('<html><body>Hello '.$name.'!</body></html>');
}
}
这样,当我们在浏览器中输入
http://localhost/hello/index/World
就会显示 Hello World! 这样的字样。
4.创建模板:
为了能够重用布局文件中的区块,可以使用模板来代替控制器中的 HTML 语句。首先创建页面布局文件:
{# app/Resources/views/layout.html.twig #}
<!DOCTYPE html>
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>{% block title %}Hello Application{% endblock %}</title>
</head>
<body>
{% block body %}{% endblock %}
</body>
</html>
注意,该文件位于 app/Resources/views/ 目录中,作用范围是整个应用程序的全局模板文件。在该文件中定义了两个区块:title 和 body。接下来就是创建一个专用于 Hello 控制器的模板,如下所示:
{# src/Acme/HelloBundle/Resources/views/Hello/index.html.twig #}
{% extends '::layout.html.twig' %}
{% block body %}
Hello {{name}}!
{% endblock %}
在该文件中,它继承了全局模板,并且定义了区块 body,这样就覆写了全局模板中的 body 区块。如果系统在渲染到该模板时,会将区块 body 覆写全局模板的区块 body,再进行渲染。
最后,将控制器中的 HTML 语句改成渲染上述模板即可:
// src/Acme/HelloBundle/Controller/HelloController.php
namespace AcmeHelloBundleController;
use SymfonyBundleFrameworkBundleControllerController;
class HelloController extends Controller
{public function indexAction($name)
{return $this->render('AcmeHelloBundle:Hello:index.html.twig', array('name' => $name));
}
}
