Symfony 1.x 專案建立指令全解析：init-project、init-app、init-module

適用版本提醒

本文描述 Symfony 1.x（1.0 ~ 1.4）專案建立流程。Symfony 2 起改用 composer create-project 與 make:bundle，架構差異極大，請勿混用。

專案結構概念

• Project：頂層容器，共享模型、設定、資料庫。
• Application：專案下的子系統（前台 frontend、後台 backend），各自擁有獨立設定、模組、樣板。
• Module：應用程式的功能單元（如 article、user、cart）。
• Action：模組內的具體行為（index、show、edit）。

建立專案

apps/
batch/
cache/
config/
data/
doc/
lib/
log/
test/
web/

建立應用程式

web/
  index.php          # 生產環境
  frontend_dev.php   # 開發環境

• 每個應用可有多環境（dev、test、prod），對應不同設定檔（settings.yml、databases.yml）。
• 跨應用連結需使用絕對路徑。

建立模組

actions/
config/
lib/
templates/
validate/

立即可訪問：https://localhost/frontend_dev.php/article（預設顯示 templates/indexSuccess.php）。

Pake 任務管理工具

symfony 指令底層為 Pake（PHP 版 Rake）。查看所有任務：

    ServerName myapp.example.com
    DocumentRoot "/home/steve/myproject/web"
    DirectoryIndex index.php
    Alias /sf /usr/local/lib/php/data/symfony/web/sf
    
        AllowOverride All
        Allow from All
    

• 需啟用 mod_rewrite 以支援美化網址。
• Alias /sf 指向 Symfony 核心資源目錄（Web Debug Toolbar、預設樣式等）。

版本控制（Subversion）建議流程

小結

    
Symfony 1.x 以 CLI 指令快速產生專案/應用/模組三層結構。
    
環境隔離（dev/prod）透過前端控制器與設定檔實現。
    
Pake 任務自動化重複操作，symfony -T 可查詢所有指令。
    
遷移至 Symfony 2+ 時，架構、命名空間、依賴管理、路由系統皆有根本性變更，建議重寫而非直接升級。