Symfony 十分鐘入門：從安裝到完成 CRUD 完整實戰

環境需求

• PHP 7.1+ (建議 8.1+)
• Composer
• 資料庫 (MySQL/PostgreSQL/SQLite)

專案建立

# 方式一：Symfony CLI (最快)
symfony new my_blog --version=lts --webapp

# 方式二：Composer
composer create-project symfony/skeleton my_blog
cd my_blog
composer require webapp  # 安裝常用套件包

資料庫設定

編輯 .env (或 .env.local)：

DATABASE_URL="mysql://db_user:db_password@127.0.0.1:3306/my_blog?serverVersion=8.0&charset=utf8mb4"

php bin/console doctrine:database:create

建立實體

php bin/console make:entity Article
# 依提示新增欄位：
# title (string, 255, not null)
# content (text, not null)
# author (string, 100, nullable)
# createdAt (datetime, not null)
# updatedAt (datetime, nullable)

自動產生 CRUD

php bin/console make:crud Article
# 產生 Controller、Form、Repository、Twig 模板、路由

資料庫遷移

php bin/console make:migration
php bin/console doctrine:migrations:migrate

啟動測試

symfony server:start -d
# 或 php -S localhost:8000 -t public/
# 瀏覽 https://localhost:8000/article/

關鍵檔案結構

src/
├── Controller/ArticleController.php   # list, new, show, edit, delete
├── Entity/Article.php                 # 實體與驗證註解
├── Form/ArticleType.php               # 表單定義
├── Repository/ArticleRepository.php   # 查詢邏輯
templates/
├── article/
│   ├── index.html.twig   # 列表
│   ├── new.html.twig     # 新增表單
│   ├── show.html.twig    # 詳情
│   └── _form.html.twig   # 共用表單片段
config/routes/annotations.yaml        # 註解路由載入

常用指令速查

下一步學習建議

1. 深入表單驗證、資料轉換器、事件監聽器。
2. 學習 Doctrine 關聯關係、DQL、查詢建構器。
3. 掌握安全元件：登入、權限、CSRF、Voters。
4. API 開發：API Platform、Serializer、JWT。
5. 測試：PHPUnit、Panther (E2E)、Foundry (測試資料)。