安裝 & 設定 Symfony 框架

此篇文章會解釋各種安裝 Symfony 的方式，以及如何解決大部分在安裝過程中發生的問題。

產生 Symfony 應用程式

Symfony 提供了一個專用的指令「Symfony Installer」來簡化 Symfony 應用程式的建立。該指令相容於 PHP 5.4 並只需要在你的系統中安裝一次：

1
2
3
4
5
6
7

# Linux and macOS systems
$ sudo mkdir -p /usr/local/bin
$ sudo curl -LsS https://symfony.com/installer -o /usr/local/bin/symfony
$ sudo chmod a+x /usr/local/bin/symfony

# Windows systems
c:\> php -r "file_put_contents('symfony', file_get_contents('https://symfony.com/installer'));"

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13

# for example, if WAMP is used ...
c:\> move symfony c:\wamp\bin\php
# create symfony.bat in the same folder
c:\> cd c:\wamp\bin\php
c:\> (echo @ECHO OFF & echo php "%~dp0symfony" %*) > symfony.bat
# ... then, execute the command as:
c:\> symfony

# moving it to your projects folder ...
c:\> move symfony c:\projects
# ... then, execute the command as
c:\> cd projects
c:\projects\> php symfony

當你的「Symfony Installer」已安裝完成，使用 new 這個指令產生你的第 1 個 Symfony 應用程式

1

$ symfony new my_project_name 3.4

該指令會產生一個新資料夾 my_project_name/，包含了最新的 Symfony 穩定版本。此外 Installer 會檢查你的系統是否滿足執行 Symfony 應用程式所需的系統需求，若是無法滿足，你會看到一組修正清單來滿足系統需求。

開發時指定 Symfony 版本

如果你的專案需要指定 Symfony 版本時，可以使用 new 指令的第二個參數：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14

# 使用最新的版本在任何的 Symfony 分支
$ symfony new my_project_name 2.8
$ symfony new my_project_name 3.1

# 使用指定的 Symfony 版本
$ symfony new my_project_name 2.8.3
$ symfony new my_project_name 3.1.5

# 使用 beta 或 RC 版本 (在測試 Symfony 新版本時很有用)
$ symfony new my_project 2.7.0-BETA1
$ symfony new my_project 2.7.0-RC1

# 使用最新的 'lts' 版本 (Long Term Support version 長期支援版本)
$ symfony new my_project_name lts

每個版本都有各自 專屬 文件，你可以在任何一個文件頁面上做切換。

使用 Composer 建立 Symfony 專案

如果你無法使用 Symfony Installer 的話，你可以使用 Composer 來建立 Symfony 專案，這是現代 PHP 專案在使用的套件管理工具。

如果你還沒有安裝 Composer 在你的電腦上，請先照 installing Composer globally 的文件安裝 Composer，然後執行 create-project 的指令安裝一個最新穩定版本的 Symfony 專案。

1

$ composer create-project symfony/framework-standard-edition my_project_name

你也可以用 create-project 指令的第二個參數，來安裝其他的 Symfony 版本：

1

$ composer create-project symfony/framework-standard-edition my_project_name "3.4.*"

運行 Symfony 專案

在生產環境的伺服器上，Symfony 使用 Apache 或 Nginx 這類的 Web Server (請見 configuring a web server to run Symfony)。然而，在你本地端開發的機器上，你也可以使用 Sumfony 提供的 Web Server (使用 PHP 內建的 Web Server)。

首先，安裝 Symfony Web Server，然後執行這個指令：

1
2

$ cd my_project_name/
$ php bin/console server:run

打開你的瀏覽器並訪問 http://localhost:8000/ 網址，可以見到 Symfony 的歡迎頁面：

如果你沒看到歡迎頁面，而是看到空白頁或錯誤的頁面，這是資料夾權限設定錯誤造成的。解決這個問題的方法在「Setting up or Fixing File Permissions」有做解說。

當你結束你 Symfony 專案的開發後，在終端機或是 command console 中輸入Ctrl+C 來停止 Web Server。

檢查 Symfony 專案的設定和安裝環境

Symfony Installer 會檢查你的系統是否已經可以運行 Symfony 專案。然而，在 console 下的 PHP 設定會與 Web Server 的設定不同。因此，Symfony 提供了一個視覺化的設定檢查工具。訪問以下的網址來檢查你的設定，並在進行下一步之前修正相關問題。

http://localhost:8000/config.php

修正檔案權限問題

如果你有任何檔案權限錯誤或是看到空白畫面，請見 Setting up or Fixing File Permissions 來取得更多資訊。

更新 Symfony 專案

到這邊你已經建立了一個有完整功能的 Symfony 專案！每個 Symfony 專案依賴一些第三方套件，存放於 vendor 資料夾，並使用 Composer 來管理。

定期地更新這些套件是很好的作法，可以避免一些臭蟲或是安全漏洞。執行 update 的 Composer 指令來一次更新全部的套件 (這會需要花費些許分鐘來完成，具體花費的時間看你專案套件依賴的複雜程度而定)：

1
2

$ cd my_project_name/
$ composer update

1

$ php bin/console security:check

安裝 Symfony Demo 版本或其他發行版本

你已經下載了 Symfony Standard Edition：預設的 Symfony 初始專案，透過這份文件，你將使用該專案來開發你的應用程式！

Symfony 也有其他的初始專案範本提供您使用：

• The Symfony Demo Application
  這是個完整功能的專案，展示了 Symfony 專案的建議開發方式。該專案被認為是一個 Symfony 新手的學習工具，其原始碼包含大量的註解和有用的註解。

• The Symfony CMF Standard Edition
  這是一個包含了 Symfony CMF 的初始專案，Symfony CMF 可以讓開發者更簡易地加入 CMS 的功能到 Symfony 專案上。

• The Symfony REST Edition
  該專案展示了如何使用 FOSRestBundle 和其他相關的 Bundle 來建立一個提供 RESTful API 的專案。

安裝現有的 Symfony 專案

在一個協作開發的 Symfony 專案中，我們會將程式碼上傳到一個共享的版本庫中。

建議不要將一些檔案 (parameters.yml) 和資料夾 (vendor/, cache, logs) 上傳到版本庫內。

接下來，我們可以照以下的步驟來下載現有的 Symfony 專案：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10

# clone 並下載專案內容
$ cd projects/
$ git clone ...

# 讓 Composer 安裝專案所依賴的套件到 vendor/ 資料夾
$ cd my_project_name/
$ composer install

# Composer 會請你輸入一些參數的數值
$ ...

Keep Going!

完成了設定之後，該是時候來 建立你的第一個頁面