Symfony怎么用

這篇文章主要介紹了Symfony怎么用，具有一定借鑒價(jià)值，感興趣的朋友可以參考下，希望大家閱讀完這篇文章之后大有收獲，下面讓小編帶著大家一起了解一下。

Symfony是一個(gè)強(qiáng)大的基于PHP的Web開發(fā)框架,在這里我們用十分鐘的時(shí)間來做一個(gè)簡(jiǎn)單的增刪改查的程序， 任何不熟悉Symfony的人都可以通過這個(gè)教程完成自己的第一個(gè)Symfony程序。

如果需要這個(gè)樣例程序的全部源代碼，可以訪問 這里 ，或者通過下面的方式獲取源代碼：

$git clone https://github.com/saharabear/symfony-sample.git

項(xiàng)目初始化

首先，需要你在自己的電腦中安裝PHP環(huán)境并安裝git.這方面的內(nèi)容屬于基礎(chǔ)內(nèi)容，網(wǎng)絡(luò)上有大量的教程，在這里就不多介紹了，不過要提示的一點(diǎn)是：PHP從5.4開始， 已經(jīng)內(nèi)置了測(cè)試用服務(wù)器，Symfony也擁抱了這個(gè)由PHP內(nèi)置的服務(wù)器，只需要在命令行中使用$php app/console server:run 就可以 啟動(dòng)基于Symfony框架的PHP程序進(jìn)行測(cè)試，因此不必要使用XAMPP這一類復(fù)雜的集成環(huán)境，直接安裝PHP并保證在命令行下可以執(zhí)行php命令就可以了。

然后，我們需要建立一個(gè)新的目錄，名字叫symfony-sample，Symfony使用一個(gè)叫composer的程序管理各種類庫的依賴關(guān)系，因此如果你的機(jī)器上 安裝了composer,就可以直接跳過這一步，如果沒有安裝，可以用下面的命令安裝最新版本的composer.

$cd symfony-sample
$curl -sS https://getcomposer.org/installer | php

如果希望了解更多關(guān)于composer的信息，可以參考這個(gè)網(wǎng)站。

安裝完成composer后，我們可以開始安裝當(dāng)前最新版本的Symfony2.6.0

$php composer.phar create-project symfony/framework-standard-edition mysampleproject/ 2.6.0

安裝過程中，需要填寫數(shù)據(jù)庫等信息，在這個(gè)例子中，我們會(huì)使用mysql數(shù)據(jù)庫，因此你可以一路按回車鍵，先不要關(guān)心這一切配置應(yīng)該如何填寫。反正 Symfony會(huì)在安裝成功后，生成一個(gè)配置文件，叫app/config/parameters.yml,下面我會(huì)提供一個(gè)parameters.yml文件的 內(nèi)容樣本，只要復(fù)制進(jìn)去就可以了，先不必關(guān)注這么多細(xì)節(jié)。

剛才創(chuàng)建mysampleproject以后，在symfony-sample目錄下生成了mysampleproject目錄，我習(xí)慣于將程序放在項(xiàng)目的根目錄下，因此執(zhí)行下面的幾個(gè)命令， 就可以把項(xiàng)目從symfony-sample/mysampleproject目錄中，移到symfony-sample目錄中

$mv mysampleproject/* ./
$rm -rf mysampleproject

理論上來講，我們已經(jīng)完成了Symfony項(xiàng)目的創(chuàng)建，不過剛才提到的parameters.yml文件還沒有解釋。這個(gè)parameters.yml是Symfony的全局配置文件， 無論是數(shù)據(jù)庫配置信息還是其他的各種配置，都可以放在這個(gè)文件中。下面是我們需要使用的測(cè)試用的parameters.yml,記得把最后一行的值修改為一個(gè)隨機(jī)值

# This file is auto-generated during the composer install
parameters:
  database_driver: pdo_mysql
  database_host: localhost
  database_port: 3306
  database_name: symfony
  database_user: root
  database_password: root
  mailer_transport: smtp
  mailer_host: localhost
  mailer_user: null
  mailer_password: null
  locale: en
  secret: ChangeThisLineAsYouWish_ioiuqwoieru

直接用這段，替換掉app/config/parameters.yml文件中的內(nèi)容，然后編輯app/config/config.yml,找到下面幾行，把最后一行添加進(jìn)去并保存。

driver:  "%database_driver%"
host:   "%database_host%"
port:   "%database_port%"
dbname:  "%database_name%"
user:   "%database_user%"
password: "%database_password%"
charset: UTF8
path:   "%database_path%"

好了，這樣我們就完成了基本的Symfony程序的配置，你現(xiàn)在有了一個(gè)配置好了數(shù)據(jù)庫，郵件發(fā)送器，日志系統(tǒng)的基本程序原型。下面，我們就開始編寫自己的Symfony程序。

建立Bundle

先說一下什么是Bundle。Symfony是以DI為核心的，可能你不知道什么是DI，沒關(guān)系，這不重要，你可以把Symfony的DI理解成為一個(gè)功能池，把程序中的所有功能都做成Bundle，或者你把Bundle理解成一組php文件組合而成的程序就可以。 比如用戶注冊(cè)，登錄功能做成一個(gè)Bundle,你也可以把一個(gè)論壇的發(fā)帖回貼功能做成一個(gè)Bundle，自然也可以把文章管理做成一個(gè)Bundle，然后用一個(gè)Bundle去調(diào)用和配置不同的Bundle，那么你就可以把網(wǎng)站組裝起來了，而你寫的各種Bundle，在其他的應(yīng)用程序中還可以繼續(xù)復(fù)用，這樣寫的Bundle越多，可復(fù)用性就越強(qiáng)，制作新項(xiàng)目的時(shí)候也越有利。

我們現(xiàn)在就來建立自己的Bundle.在命令行中，使用命令：

$php app/console generate:bundle
Bundle namespace: Symfony/Bundle/SampleBundle
Bundle name [SymfonySampleBundle]:
Target directory [/home/saharabear/workspace/symfony-sample/src]:
Configuration format (yml, xml, php, or annotation): yml
Do you want to generate the whole directory structure [no]? yes
Do you confirm generation [yes]? yes
Generating the bundle code: OK
Checking that the bundle is autoloaded: OK
Confirm automatic update of your Kernel [yes]? yes
Enabling the bundle inside the Kernel: OK
Confirm automatic update of the Routing [yes]? yes

這樣就成功建立了我們的Bundle，名字叫SymfonySampleBundle，我們使用的Bundle namespace是Symfony/Bundle/SampleBundle，這是一種約定，我們還可以建立其他的Bundle，比如Symfony/Bundle/PostBundle, 或者Symfony/Bundle/ArticleBundle，而對(duì)應(yīng)的Bundle name就分別是SymfonyPostBundle或者SymfonyArticleBundle。你也可以自己建立這幾個(gè)Bundle，這并不會(huì)影響當(dāng)前我們的教程。

對(duì)了，在我們建立的Bundle中，分別會(huì)生成下面幾個(gè)目錄：

① Entity:這個(gè)目錄并不是必須的，很多情況下只有在生成實(shí)體的時(shí)候才會(huì)生成，放置模型，也就是MVC中的M
② Controller:這個(gè)目錄會(huì)生成DefaultController.php，你可以在這里建立自己的Controller控制器，也就是MVC中的C
③ Resources:這個(gè)目錄下面還有子目錄，其中views放置的是模板，也就是MVC中的V，而public放置的是靜態(tài)文件，比如js, css, images等等
④ Tests:放置單元測(cè)試與集成測(cè)試的代碼，在這個(gè)樣例程序中暫時(shí)不需要
⑤ DependencyInjection:與DI相關(guān)的目錄，暫時(shí)也不需要去了解
⑥ SymfonySampleBundle.php:當(dāng)前這個(gè)Bundle的定義文件

更多細(xì)節(jié)可以去閱讀Symfony 的官方文檔，而當(dāng)前的重點(diǎn)是把這個(gè)Symfony的樣例程序運(yùn)行起來。

設(shè)計(jì)實(shí)體

在MVC的設(shè)計(jì)理念中，M是最重要的，因?yàn)镸表達(dá)的內(nèi)容是業(yè)務(wù)邏輯。我覺得如果這個(gè)地方往深入去探討，會(huì)一直探討到富血模型或者貧血模型，不過目前在這個(gè)教程中根本 不需要考慮這么多，你只需要知道實(shí)體就是MVC中的M，用于表達(dá)業(yè)務(wù)邏輯。比如說，我們要開發(fā)一個(gè)文章管理的系統(tǒng)，那么文章本身就代表的業(yè)務(wù)邏輯。比如，我們的文章要有 標(biāo)題，內(nèi)容，作者，那么這三項(xiàng)就屬于業(yè)務(wù)邏輯，而標(biāo)題不能夠?yàn)榭?，不能超過200長(zhǎng)度，內(nèi)容不能為空，作者卻是可以為空的，這些也屬于業(yè)務(wù)邏輯。同時(shí)，這個(gè)文章需要被 存儲(chǔ)起來，比如存儲(chǔ)到數(shù)據(jù)庫中，那么這個(gè)M就應(yīng)該能夠映射到數(shù)據(jù)庫的表中。我們把這個(gè)M，叫實(shí)體。

還是少說廢話，直接上代碼。那么如何建立實(shí)體呢？當(dāng)然不是從頭一點(diǎn)一點(diǎn)地寫，而是直接用下面的命令生成：

$php app/console generate:doctrine:entity
Welcome to the Doctrine2 entity generator
This command helps you generate Doctrine2 entities.
First, you need to give the entity name you want to generate.
You must use the shortcut notation like AcmeBlogBundle:Post.
The Entity shortcut name: SymfonySampleBundle:Article
Determine the format to use for the mapping information.
Configuration format (yml, xml, php, or annotation) [annotation]:yml
Instead of starting with a blank entity, you can add some fields now.
Note that the primary key will be added automatically (named id).
Available types: array, simple_array, json_array, object,
boolean, integer, smallint, bigint, string, text, datetime, datetimetz,
date, time, decimal, float, blob, guid.
New field name (press to stop adding fields): title
Field type [string]:
Field length [255]: 200
New field name (press to stop adding fields): content
Field type [string]: text
New field name (press to stop adding fields): author
Field type [string]:
Field length [255]: 20
New field name (press to stop adding fields):
Do you want to generate an empty repository class [no]? yes
Summary before generation
You are going to generate a "SymfonySampleBundle:Article" Doctrine2 entity
using the "yml" format.
Do you confirm generation [yes]? yes
Entity generation
Generating the entity code: OK
You can now start using the generated code!

經(jīng)過這些命令，你會(huì)發(fā)現(xiàn)在Entity中建立了新的文件Article.php,代碼如下：

namespace Symfony\Bundle\SampleBundle\Entity;
use Doctrine\ORM\Mapping as ORM;
/**
 * Article
 *
 * @ORM\Table()
 * @ORM\Entity(repositoryClass="Symfony\Bundle\SampleBundle\Entity\ArticleRepository")
 */
class Article
{
  /**
   * @var integer
   *
   * @ORM\Column(name="id", type="integer")
   * @ORM\Id
   * @ORM\GeneratedValue(strategy="AUTO")
   */
  private $id;
  /**
   * @var string
   *
   * @ORM\Column(name="title", type="string", length=200)
   */
  private $title;
  /**
   * @var string
   *
   * @ORM\Column(name="content", type="text")
   */
  private $content;
  /**
   * @var string
   *
   * @ORM\Column(name="author", type="string", length=20)
   */
  private $author;
  /**
   * Get id
   *
   * @return integer
   */
  public function getId()
  {
    return $this->id;
  }
  /**
   * Set title
   *
   * @param string $title
   * @return Article
   */
  public function setTitle($title)
  {
    $this->title = $title;
    return $this;
  }
  /**
   * Get title
   *
   * @return string
   */
  public function getTitle()
  {
    return $this->title;
  }
  /**
   * Set content
   *
   * @param string $content
   * @return Article
   */
  public function setContent($content)
  {
    $this->content = $content;
    return $this;
  }
  /**
   * Get content
   *
   * @return string
   */
  public function getContent()
  {
    return $this->content;
  }
  /**
   * Set author
   *
   * @param string $author
   * @return Article
   */
  public function setAuthor($author)
  {
    $this->author = $author;
    return $this;
  }
  /**
   * Get author
   *
   * @return string
   */
  public function getAuthor()
  {
    return $this->author;
  }
}

你可以一行不改地使用這些代碼。這時(shí)候我們?cè)賮碜鰩讉€(gè)神奇的操作：

復(fù)制代碼 代碼如下:

$php app/console doctrine:schema:update --force

這個(gè)操作，已經(jīng)幫助你通過Article.php建立了數(shù)據(jù)庫和數(shù)據(jù)表，你不需要自己操作這個(gè)過程，下面我們還會(huì)對(duì)Article.php進(jìn)行改造，而到時(shí)候只需要重新 執(zhí)行上面的這個(gè)操作，Symfony會(huì)幫助你自動(dòng)修改數(shù)據(jù)庫的表結(jié)構(gòu)。

添加約束

上面我們創(chuàng)建了Article.php，既然這個(gè)實(shí)體代表了具體的業(yè)務(wù)邏輯，因此我們要考慮幾個(gè)現(xiàn)實(shí)的問題：

1. 用戶必須填寫標(biāo)題和內(nèi)容
2. 用戶填寫的標(biāo)題不能超過200個(gè)字
3. 用戶可以不填寫作者

這些就屬于業(yè)務(wù)邏輯，而我們可以修改Article.php如下，以增加相應(yīng)的業(yè)務(wù)邏輯的約束：

namespace Symfony\Bundle\SampleBundle\Entity;
use Doctrine\ORM\Mapping as ORM;
use Symfony\Component\Validator\Constraints as Assert;
/**
 * Article
 *
 * @ORM\Table()
 * @ORM\Entity(repositoryClass="Symfony\Bundle\SampleBundle\Entity\ArticleRepository")
 */
class Article
{
  /**
   * @var integer
   *
   * @ORM\Column(name="id", type="integer")
   * @ORM\Id
   * @ORM\GeneratedValue(strategy="AUTO")
   */
  private $id;
  /**
   * @var string
   * @Assert\NotBlank(message="標(biāo)題不可為空")
   * @Assert\Length(
   *   max=200,
   *   maxMessage="標(biāo)題不能超過200個(gè)字"
   * )
   * @ORM\Column(name="title", type="string", length=200)
   */
  private $title;
  /**
   * @var string
   *
   * @Assert\NotBlank(message="文章內(nèi)容不可為空")
   * @ORM\Column(name="content", type="text")
   */
  private $content;
  /**
   * @var string
   *
   * @ORM\Column(name="author", type="string", length=20,nullable=true)
   */
  private $author;
  /**
   * Get id
   *
   * @return integer
   */
  public function getId()
  {
    return $this->id;
  }
  /**
   * Set title
   *
   * @param string $title
   * @return Article
   */
  public function setTitle($title)
  {
    $this->title = $title;
    return $this;
  }
  /**
   * Get title
   *
   * @return string
   */
  public function getTitle()
  {
    return $this->title;
  }
  /**
   * Set content
   *
   * @param string $content
   * @return Article
   */
  public function setContent($content)
  {
    $this->content = $content;
    return $this;
  }
  /**
   * Get content
   *
   * @return string
   */
  public function getContent()
  {
    return $this->content;
  }
  /**
   * Set author
   *
   * @param string $author
   * @return Article
   */
  public function setAuthor($author)
  {
    $this->author = $author;
    return $this;
  }
  /**
   * Get author
   *
   * @return string
   */
  public function getAuthor()
  {
    return $this->author;
  }
}

然后執(zhí)行同步數(shù)據(jù)庫的操作：

$ php app/console doctrine:schema:update --force
Updating database schema...
Database schema updated successfully! "1" queries were executed

增刪改查

好了，我們來做一個(gè)針對(duì)文章的增刪改查操作。首先請(qǐng)執(zhí)行下面的命令：

$ php app/console generate:doctrine:crud
 Welcome to the Doctrine2 CRUD generator
This command helps you generate CRUD controllers and templates.
First, you need to give the entity for which you want to generate a CRUD.
You can give an entity that does not exist yet and the wizard will help
you defining it.
You must use the shortcut notation like AcmeBlogBundle:Post.
The Entity shortcut name: SymfonySampleBundle:Article
By default, the generator creates two actions: list and show.
You can also ask it to generate "write" actions: new, update, and delete.
Do you want to generate the "write" actions [no]? yes
Determine the format to use for the generated CRUD.
Configuration format (yml, xml, php, or annotation) [annotation]: yml
Determine the routes prefix (all the routes will be "mounted" under this
prefix: /prefix/, /prefix/new, ...).
Routes prefix [/article]: /article
 Summary before generation
You are going to generate a CRUD controller for "SymfonySampleBundle:Article"
using the "yml" format.
Do you confirm generation [yes]? yes
 CRUD generation
Generating the CRUD code: OK
Generating the Form code: OK
 You can now start using the generated code!

然后請(qǐng)編輯DefaultController.php中的indexAction如下：

/**
 * @Route("/",name="welcome")
 * @Template()
 */
public function indexAction()
{
  return array();
}

編輯Resource/views/Default/index.html.twig內(nèi)容如下：

<a href="{{path('article')}}">文章管理</a>

讓我們看看神奇的事情，啟動(dòng)內(nèi)置的測(cè)試服務(wù)器：

$php app/console server:run

感謝你能夠認(rèn)真閱讀完這篇文章，希望小編分享的“Symfony怎么用”這篇文章對(duì)大家有幫助，同時(shí)也希望大家多多支持億速云，關(guān)注億速云行業(yè)資訊頻道，更多相關(guān)知識(shí)等著你來學(xué)習(xí)!