第一天－－开始一个工程

第一天－－开始一个工程

挑战

我 们将要开始的Symfony日历是一个24个教程的集合，是在12月1日到圣诞节之间一天一天发布的。确实如此，每一天，包括周末，而一个新的教程也会马 上发布。每一个教程都是在一小时以内，从中我们可以看到正在发展中的web 2.0程序的开发。到圣诞节时，最终的程序将会放在网上，而源码也会开源。这个程序将会是可用的，有用的，有趣的。

24次小于一小时的时 间相当于不到一天的时间，而这正是我们认为一个开发者学习Symfony所需要的时间。每一天都会有新的特性加入到程序中，而我们将会充分利用这些开发来 展示Symfony的功能，以及在Symfony web开发中的一些有益的实践。每一天，我们都会认识到使用Symfony开发一个web程序是多么的快速与高效，而我们也将会了解更多的内容。

我们认为这些挑战已经足够了，而且因为我们是懒人，我们对于21天的冬天时间并没有安排。社区最需要的特性将会添加到程序当中，无需准备，而我们将会使其工作。

工程

我 们将要设计的程序是一个琐碎的"显示与通知"程序，就像一份要做事情的列表，一个电话本，或是一个书店。但是我们希望在原始的工程上使用Symfony， 而且工程有用，并且具有许多特性和一个合适的尺寸。这个目标就是要证明Symfony可以用于在复杂的条件下，使用样式与少量的工作来开发专业的程序。

我 们也希望有许多来实际使用这个程序，从而可以显示Symfony站点也可以支持一个重要的负载。这也就是为什么这个程序需要提供实际的服务，回答存在的需 求，或是创建一个新版本的原因。网站的运行是一个实在的压力测试，这就意味着我们需要你，以及更多的读者来使用这个站点并且在实际的生活讨论他，从而可以 检测他可以支持多少的访问者。

工程的内容对于其他天来说是保密的。今天我们还有许多工作要做，而不会描述一个完整的web 2.0程序。这些为我们提供了足够的时间来考虑新的特性。然而，我们需要一个名字，所以我们就称这个工程为askeet。

今天的内容

今天的目标就是要在一个网络浏览器中显示一个程序页面，并且要设置一个专业的开发环境。这包括安装Symfony，创建程序，配置网络服务器，以及设置源码版本控制系统。

这对于已经完成了前面教程的读者来是很容易的，而对于其他人来说也并不难。而所有的人都会学到一些新的东西。

我们认为你会使用一个安装有Apache,MySQL与PHP5的类Unix系统。如果你运行一个Windows系统，也并不痛苦：他也可以工作的很好，我们只需要在cmd提示符下输入一些命令。

安装Symfony

安装Symfony最简单的方法就是使用PEAR包。然而，为了可以使用频道－－以及访问Symfony频道－－我们需要更新到PEAR 1.4.0或是更高版本：

$ pear upgrade PEAR

现在我们可以添加Symfony频道：

$ pear channel-discover pear.symfony-project.com

现在我们就准备好安装Symfony的最新的稳定版本以及相应的依赖包了：
$ pear install symfony/symfony

可以通过使用命令行来检测Symfony版本以确定Symfony是否已经成功安装：
$ symfony -V

如 果我们想知道这个新的命令行工具可以为我们做哪些事情，我们可以输入symfony -T来列出所有可用的选项。我们也许希望阅读Running symfony一节来了解如何由一个tgz文档或是svn库来安装Symfony。在symfony wiki中也有一个社区贡献的非PEAR安装的版本。

设置工程

在Symfony 中，共享相同数据模型的程序(application)组织在工程(project)中。对于askeet工程，我们已经他有一个前端也一个后端：这就成 为两个程序。工程是程序的外壳，他需要首先被创建。为要完成这要的工作，我们所需要的就是一个目录以及一个symfony init-project命令行：

$ mkdir /home/sfprojects/askeet
$ cd /home/sfprojects/askeet
$ symfony init-project askeet

现在我们使用symfony init-app命令来创建前端程序：

$ symfony init-app frontend

Wow,实在是太快了。

配置网络服务

配置网络服务器

现 在我们需要改变我们的Apache配置从而可以访问新的程序。在一个专业的环境下，更好的方法是将新的程序设置为一个虚拟主机，而这也正是我们这里要描述 的。然而，如果我们更喜欢将其添加为一个alias，我们可以查看web server configuration一节来进行配置。

打开Apache/conf/目录下的httpd.conf文件，并且在末尾添加下面的内容：
<VirtualHost *:80>
ServerName askeet
DocumentRoot "/home/sfprojects/askeet/web"
DirectoryIndex index.php
Alias /sf /usr/local/lib/php/data/symfony/web/sf

<Directory "/home/sfprojects/askeet/web">
AllowOverride All
</Directory>
</VirtualHost>

/sf指向了我们的PEAR数据目录中的Symfony目录。要确定这个目录，我们可以输入pear config-show命令。Symfony程序需要访问这些目录来得到一些图片以及JavaScrit文件，从而可以正确的运行web调试工具栏以及AJAX帮助者。

在Windows中，我们可以用下面的命令来替换Alias：

Alias /sf "C:/php/pear/data/symfony/web/sf"

声明域名

askeet域名需要声明为本地域名。

如果我们运行一个Linux系统，那么已经在/etc/hosts/文件中完成了这样的工作。如果我们运行Windows XP,那么这个文件位于C:/WINDOWS/system32/drivers/etc/目录下。

添加下需的行：
127.0.0.1 askeet

如果我们不希望设置一个新的主机，我们需要在我们的网站服务器上添加一个在另一个端口上的Listen语句。这就允许我们使用本地域名。

测试新配置

重启Apache服务器，来检测我们可以访问我们的新程序：

http://askeet

恭喜

Symfony 可以使用mod_rewrite模块来移除URL中的/index.php/部分。如果我们不想使用他或者是我们的服务器并没有提供相应的功能，我们可以 移除位于web/目录下的.htaccess文件。如果我们的Apache版本并没有使用mod_rewrite来进行编译，检查我们是否安装了 mod_rewrite DSO，并且在我们的httpd.conf文件中有下面几行：

AddModule mod_rewrite.c
LoadModule rewrite_module modules/mod_rewrite.so

我们可以在Links and the Routing System一节中了解更多内容。

我们也应试着在开发环境下访问程序。我们可以输入面的URL：

http://askeet/frontend_dev.php/

此时web调试工具栏应出现在右上角，包括确认我们的Alias sf/配置正确的小图标。

web调试工具栏

如果我们在Windows环境下运行IIS服务，那么配置会有一些小小的不同。我们可以在related tutorial中查找到配置方法。

Subversion

懒 人的一条原则就是不必担心打乱现在的代码。因为我们希望快速的工作，我们希望如果对我们的修改不满意可以恢复到以前的一个版本，我们希望多个人同时在一个 工程上工作，而我们还希望你可以访问程序的每一天的版本，我们将会使用源码版本系统。因为这个原因，我们会使用Subversion。现在假设你已经安装 了一个Subversion服务器或是可以访问一个Subversion服务器。

首先，为askeet工程创建一个新的仓库：

$ svnadmin create $SVNREP_DIR/askeet
$ svn mkdir -m "layout creation" file:///$SVNREP_DIR/ask/trunk file:///$SVNREP_DIR/askeet/tags file:///$SVNREP_DIR/askeet/branches

接下来，我们需要做第一次导入，忽略cache/与log/临时文件：

$ cd /home/sfprojects/askeet
$ rm -rf cache/*
$ rm -rf log/*
$ svn import -m "initial import " . file:///$SVNREP_DIR/askeet/trunk

现在删除原始的程序目录，而使用一个检出的SVN版本：

$ cd /home/sfprojects
$ mv askeet askeet.origin
$ svn co file://$SVNDIR/askeet/trunk askeet/
$ ls askeet/

$ rm -rf askeet.origin

现在还有一件事情需要配置。如果我们向代码仓库提交我们的工作目录，我们也许会拷贝一些我们并不希望的文件，例如位于我们工程的cache与log目录中的内容。所以我们需要为这个工程向SVN设置一个忽略列表：

$ cd /home/sfprojects/askeet
$ svn propedit svn:ignore cache

这些就会启动为SVN所配置的默认的文本编辑器。添加cache的子目录，这样当提交时SVN就会忽略这些内容：
*

保存退出，我们就完成了设置工作。

对log/目录重复这样的过程：

$ svn propedit svn:ignore log

然后只输入：*

现在，确保将cache与log目录的写权限设置回合适的级别，这样我们的web服务器可以向其中写入。在命令行输入下面命令：

$ chmod 777 cache
$ chmod 777 log

如果我们希望了解更多的源码版本控制的内容，我们可以查阅project creation chapter一节。

明天见

好了，现在已经到1小时了。我们谈论了许多，但是却并没有为Symfony作任何事情。我们看一下明天的Symfony日程会涉及到哪些内容：

程序可以做什么
构建数据模型并且生成对象关系映射
搭建一个模型

原文地址 http://www.symfony-project.com