如何安装和使用Symfony组件

3.4 版本
维护中的版本

如果你要启动一个“使用了一或多个组件”的全新项目(或者你已经拥有一个项目),最简单的办法是用Composer来整合所有东西。Composer在下载组件时足够智能,以至你只需坐等自动下载,然后直接使用类库。

本文通过Finder组件带你入门,但却适用于其他任何组件。

使用Finder组件 

  1. 如果你是新建项目,为项目新建一个目录。

  2. 打开命令行,使用Composer抓取类库。

1
$  composer require symfony/finder

symfony/finder是被写入文件体系最上层的名字(译注:参考组件自带的composer.json第一个name选项即知),为的是应对你想要的任何组件。

请先安装Composer,如果你的系统中没有的话。根据不同系统下的安装,你的目录下可能会有一个composer.phar文件,如果是这种情况,不要急!只需运行php composer.phar require symfony/finder命令。(译注:windows下,把composer安装目录下的composer.phar拷到任何一个目录下,都可以执行前述类似的命令)

  1. 写代码!

一旦Composer把组件下载完毕,你要做的是,包容Composer生成的vendor/autoload.php文件。这个文件负责所有的类库的自动加载,以便你能立即使用:

1
2
3
4
5
6
7
8
9
10
11
12
// File example: src/script.php
 
// update this to the path to the "vendor/" directory, relative to this file
// 修改下面这行代码,使相对于script.php这个文件的“vendor/”目录,能够被正确包容进来
require_once __DIR__.'/../vendor/autoload.php';
 
use Symfony\Component\Finder\Finder;
 
$finder = new Finder();
$finder->in('../data/');
 
// ...

使用全部组件 

如果你希望使用Symfony的全部组件,毋须一个一个地添加,你可以使用symfony/symfony这个包:

1
$  composer require symfony/symfony

这会把Bundle和Bridge的相关类库也给包括进来,你不一定用得到。(译注:Symfony的三要素就是组件、bundle和桥)

又该如何? 

现在,组件已经被安装和自动加载,参考特定组件的文档,以便掌握如何使用它。

have fun!

本文,包括例程代码在内,采用的是 Creative Commons BY-SA 3.0 创作共用授权。

登录symfonychina 发表评论或留下问题(我们会尽量回复)