Symfony學(xué)習(xí)十分鐘入門經(jīng)典教程
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
安裝過程中,需要填寫數(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長度,內(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è)神奇的操作:
這個(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
好了,我們已經(jīng)完成了這十分鐘的博客,一切的代碼都在Controller/ArticleController.php,Form/ArticleType.php,Resource/views/Article/*.html.twig中,我們已經(jīng)完成了最基本的文章管理功能。當(dāng)然在你熟悉Symfony以后,未必需要完全依靠Symfony幫你生成這些增刪改查操作,可是起碼Symfony用一個(gè)命令讓一切都先運(yùn)行起來了,這不就是我們所要的原型嗎?
本文永久地址:http://blog.it985.com/5133.html
本文出自 IT985博客 ,轉(zhuǎn)載時(shí)請(qǐng)注明出處及相應(yīng)鏈接。
更多關(guān)于PHP框架相關(guān)內(nèi)容感興趣的讀者可查看本站專題:《php優(yōu)秀開發(fā)框架總結(jié)》,《codeigniter入門教程》,《CI(CodeIgniter)框架進(jìn)階教程》,《Yii框架入門及常用技巧總結(jié)》及《ThinkPHP入門教程》
希望本文所述對(duì)大家基于Symfony框架的PHP程序設(shè)計(jì)有所幫助。
- Symfony2聯(lián)合查詢實(shí)現(xiàn)方法
- Symfony2使用Doctrine進(jìn)行數(shù)據(jù)庫查詢方法實(shí)例總結(jié)
- 高性能PHP框架Symfony2經(jīng)典入門教程
- symfony表單與頁面實(shí)現(xiàn)技巧
- Symfony頁面的基本創(chuàng)建實(shí)例詳解
- Symfony2實(shí)現(xiàn)從數(shù)據(jù)庫獲取數(shù)據(jù)的方法小結(jié)
- Symfony2學(xué)習(xí)筆記之模板用法詳解
- Symfony數(shù)據(jù)校驗(yàn)方法實(shí)例分析
- Symfony2框架學(xué)習(xí)筆記之表單用法詳解
- Symfony2創(chuàng)建頁面實(shí)例詳解
- Symfony2安裝的方法(2種方法)
- Symfony查詢方法實(shí)例小結(jié)
相關(guān)文章
PHP循環(huán)遍歷數(shù)組的3種方法list()、each()和while總結(jié)
這篇文章主要介紹了PHP循環(huán)遍歷數(shù)組的3種方法list()、each()和while總結(jié),本文重點(diǎn)在于對(duì)這3種方法的混合使用講解上,需要的朋友可以參考下2014-11-11laravel 查詢數(shù)據(jù)庫獲取結(jié)果實(shí)現(xiàn)判斷是否為空
今天小編就為大家分享一篇laravel 查詢數(shù)據(jù)庫獲取結(jié)果實(shí)現(xiàn)判斷是否為空,具有很好的參考價(jià)值,希望對(duì)大家有所幫助。一起跟隨小編過來看看吧2019-10-10php使用函數(shù)pathinfo()、parse_url()和basename()解析URL
眾所周知在PHP中函數(shù)pathinfo()、parse_url()和basename(),這三個(gè)都是解析URL的函數(shù),但是也存在一些區(qū)別,下面列舉了一些實(shí)例,通過實(shí)例更容易理解這三個(gè)函數(shù)的使用方法和技巧,有需要的朋友可以參考借鑒,感興趣的朋友們下面來一起學(xué)習(xí)學(xué)習(xí)吧。2016-11-11淺談php中變量的數(shù)據(jù)類型判斷函數(shù)
下面小編就為大家?guī)硪黄獪\談php中變量的數(shù)據(jù)類型判斷函數(shù)。小編覺得挺不錯(cuò)的,現(xiàn)在就分享給大家,也給大家做個(gè)參考。一起跟隨小編過來看看吧2017-03-03在laravel中實(shí)現(xiàn)事務(wù)回滾的方法
今天小編就為大家分享一篇在laravel中實(shí)現(xiàn)事務(wù)回滾的方法,具有很好的參考價(jià)值,希望對(duì)大家有所幫助。一起跟隨小編過來看看吧2019-10-10php的mkdir()函數(shù)創(chuàng)建文件夾比較安全的權(quán)限設(shè)置方法
這篇文章主要介紹了php的mkdir()函數(shù)創(chuàng)建文件夾比較安全的權(quán)限設(shè)置方法,遇到的情況是系統(tǒng)umask影響了mkdir的指定權(quán)限參數(shù)比期望要小,使用chmod函數(shù)則沒有這個(gè)問題,需要的朋友可以參考下2014-07-07php截取字符串函數(shù)substr,iconv_substr,mb_substr示例以及優(yōu)劣分析
php進(jìn)行中文字符串的截取時(shí),會(huì)經(jīng)常用到二個(gè)函數(shù)iconv_substr和mb_substr,對(duì)這二個(gè)函數(shù)應(yīng)該如何選擇呢?參考下本文介紹的例子就明白了。2014-06-06