Symfony4.2入門教學【第一篇】安裝

你更傾向影片教學？查看教學影片。

建立新的Symfony應用，首先請確認你使用PHP 7.1或更高的版本，並安裝composer。如果還沒，請先在系統上安裝composer，如果想要使用虛擬機器(Virtual Machine, VM)，請查看Homestead。

建立新的專案執行指令：

composer create-project symfony/website-skeleton my-project

這將會建立一個新的my-project目錄，在裡面下載一些相依套件，並產生你所需的基本資料夾和檔案。換句話說，你的應用程式已經準備好了。

website-skeleton。如果你想要建立規模小一點的服務，例如console applications或APIs，可以考慮使用更簡易的skeleton專案。

composer create-project symfony/skeleton my-project

# optional: install the web server bundle (explained next)
cd my-project
composer require symfony/web-server-bundle --dev

執行Symfony應用

在正式環境，我們應該利用網頁伺服器軟體，如Nginx或Apache(參考如何使用網頁伺服器)，但在開發環境時，使用Symfony的PHP網頁伺服器是更方便的方法。

進到新專案的目錄下，啟動伺服器：

cd my-project
php bin/console server:run

打開瀏覽器輸入http://localhost:8000/，如果一切順利的話，就會看到預設的首頁。稍後，如果你開發工作告一段落，請可以在終端機按Ctrl+C來關閉伺服器。

如果你在啟動Symfony專案遇到問題，有可能你的系統缺少一些必要的安裝，可以使用工具Symfony Requirements Checker，來確認系統已經準備完畢。

如果你使用的是VM,你可以透過執行下面指令，讓伺服器綁定(bind)所有IP位址：

php bin/console server:start 0.0.0.0:8000

目錄可以透過網路存取的情況下，這台機器不建議接收所有介面(listen to all interfaces)。

用git管理專案

就像多數的程式專案一樣，你可以將專案儲存到像是GitHub、GitLab和Bitbucket的服務上。用指令Git初始本地端儲存庫(Repository)，你就可以將程式推(push)到遠端儲存庫。

git init
git add .
git commit -m "Initial commit"

Symfony專案已經建好.gitignore的檔案，當你安裝更多套件時，系統會透過插件Flex(原文)自動去編寫、更新。

現有的Symfony專案設定方式

如果你想編寫一個現有Symfony專案，你只要先取得這個專案，再用composer安裝所需的套件。假設你的工作團隊有使用Git，可以用下面的指令來建立你的專案：

# clone the project to download its contents
cd projects/
git clone ...

# make Composer install the projects dependencies into vendor/
cd my-project/
composer install

你大概也需要檔案.env設定環境參數以符合你的系統需求，或另外做一些專案特有的項目(像是建立資料庫schema)。當你第一次編寫一個現有的Symfony專案，執行下面的指令會顯示這個應用的相關資訊，對你可能會有很大的幫助：

php bin/console about

確認安全漏洞

Symfony提供"Security Checker"這個工具，能確認你的專案相依套件中是否有任何已知的安全漏洞，請查看Security Checker的說明來建置。

The Symfony Demo Application

The Symfony Demo Application完整展現了最合適、推薦的開發方式，是一個功能齊全的應用，在程式碼也有相應的註解和有用的建議，對於Symfony的初學者能當作很好的學習工具。

想要查看程式碼並在本機端建立這個專案，請參考symfony/symfony-demo。

開始寫程式

前置作業都完成了，就可以馬上開始建立第一個頁面(原文)囉！


文章原文：
https://symfony.com/doc/4.2/setup.html

系列文章：

• Symfony4.2入門教學【第二篇】建立第一個頁面
• Symfony4.2入門教學【第三篇】路由(Routes)
• Symfony4.2入門教學【第四篇】控制器(Controller)
• Symfony4.2入門教學【第五篇】模板(Templates)
• Symfony4.2入門教學【第六篇】設定(Configuration)