Pasang dan sediakan rangka kerja Symfony
Selamat datang ke Symfony! Memulakan projek Symfony baharu adalah mudah, dan program Symfony pertama anda yang berfungsi boleh dikonfigurasikan dalam beberapa minit.
Untuk memudahkan penciptaan program baharu, Symfony menyediakan pemasang, memuat turunnya adalah langkah pertama anda.
Pasang Symfony Installer ¶
Menggunakan Symfony Installer ialah satu-satunya cara yang disyorkan untuk mencipta Symfony baharu Pemasang hanyalah program php Anda hanya perlu memasangnya sekali untuk mencipta program Symfony tanpa had.
Pemasang memerlukan php5.4 atau lebih tinggi. Jika anda masih menggunakan PHP 5.3 lama, anda tidak boleh menggunakan pemasang Symfony.
Jika anda menggunakan penyelesaian berpakej untuk persekitaran pemasangan, seperti WAMP, XAMP atau MAMP, sila semak sama ada mereka menggunakan versi terbaharu PHP . Anda boleh menggunakan arahan berikut pada baris arahan untuk menyemak versi PHP:
$ php --version
Bergantung pada sistem pengendalian, kaedah pemasangan pemasang Symfony juga berbeza.
Linux dan MAC OS pada sistem anda.
sistem Windows ¶
Pada Windows, laksanakan arahan berikut:
$ sudo curl -LsS https://symfony.com/installer -o /usr/local/bin/symfony $ sudo chmod a+x /usr/local/bin/symfony
Ia akan memuat turun fail symfony , dan kemudian alihkan fail ini ke folder tempat anda ingin mencipta projek Symfony Anda boleh but pelbagai pemasangan melalui arahan berikut: 🎜#Selepas pemasang Symfony disediakan, gunakan arahan baharu new untuk. cipta projek Symfony:
c:\>php -r "readfile('http://symfony.com/installer');" > symfonysymfony文件，然后把这文件移动到你想创建Symfony项目的文件夹里，通过下述命令可引导各种安装：
c:\>move symfony c:\projects c:\projects\> php symfony
创建Symfony程序 ¶
当Symfony安装器被设置好之后，使用全新命令new来创建Symfony项目：
# Linux, Mac OS X $ symfony new my_project_name # Windows c:\> cd projects/ c:\projects\> php symfony new my_project_name
这命令创建了一个新的my_project_nameArahan ini Direktori my_project_name baru dicipta, yang mengandungi projek baharu berdasarkan versi stabil terkini program Symfony. Selain itu, pemasang juga akan menyemak sama ada sistem anda mempunyai keperluan teknikal untuk melaksanakan program Symfony. Jika ia tidak dipenuhi, anda akan melihat senarai keperluan untuk "apa yang perlu diubah".
Atas sebab keselamatan, semua versi Symfony ditandatangani secara digital sebelum pengedaran. Jika anda perlu mengesahkan nombor versi yang disepadukan ke dalam program, ikut langkah dalam artikel ini.
Jika pemasang tidak berfungsi atau tidak mengeluarkan apa-apa, pastikan sistem anda mempunyai sambungan phar yang dipasang dan didayakan.
Jadikan program anda dijalankan pada versi Symfony tertentu ¶
Sekiranya anda perlu menjalankan projek pada versi Symfony tertentu, gunakan perintah new dengan parameter pilihan kedua: new命令的同时附带第二个可选参数：
# use the most recent version in any Symfony branch 不同分支的最新版本 $symfony new my_project_name 2.8 $symfony new my_project_name 3.0 # use a specific Symfony version 指定版本 $symfony new my_project_name 2.7.3$ symfony new my_project_name 2.8.1 # use a beta or RC version (useful for testing new Symfony versions) 新版可用于测试 $symfony new my_project 3.0.0-BETA1$ symfony new my_project 2.7.0-RC1
安装器还支持一个特殊版本lts，即最新的长期维护版本Symfony LTS version
$ symfony new my_project_name lts
参考Symfony发布进程来深入理解为何有多种框架版本存在，以及哪种更适合你的项目。
不使用安装器来创建Symfony程序 ¶
如果你仍然在用php5.3，或者你因某种原因不能执行安装器，你可以基于composer来安装Symfony。
Composer是个依赖管理器，被现代php程序广泛使用，它也可用于安装Symfony框架。如果你不需要全局安装composer，请往下看。
全局安装Composer ¶
请参考全局安装Composer。
用Composer创建Symfony程序 ¶
若你已安装过Composer，执行create-project命令来创建基于稳定版本的Symfony程序：
$ composer create-project symfony/framework-standard-edition my_project_name
若需指定版本，提供版本号作为create-project的第二个参数
$ composer create-project symfony/framework-standard-edition my_project_name "3.0.*"
如果你的网络连接很慢，你可能会认为Composer没有做任何事。这时，请在前述命令中添加-vvv旗标，以输出Composer正在做的每一件事的细节。
运行Symfony ¶
在开发时，Symfony利用了PHP内置的web服务器。因此，运行Symfony程序关乎项目所在目录并执行如下命令：
$ cd my_project_name/ $ php bin/console server:run
然后，打开浏览器访问http://localhost:8000/
http://localhost:8000/config.phpPemasang juga menyokong versi khas
lts, iaitu versi penyelenggaraan jangka panjang terkini versi Symfony LTS$ cd my_project_name/ $ composer update
Rujuk proses keluaran Symfony untuk memahami dengan mendalam mengapa terdapat berbilang versi rangka kerja dan yang mana satu lebih sesuai untuk anda projek. Buat program Symfony tanpa menggunakan pemasang ¶
Jika anda masih menggunakan php5.3, atau anda tidak boleh melaksanakan pemasang atas sebab tertentu, anda boleh memasang Symfony berdasarkan komposer.
Pasang Komposer secara global ¶Sila rujuk Pasang Komposer secara global.
$ php bin/console security:check🎜 Jika anda perlu menentukan versi, berikan nombor versi sebagai parameter kedua
create-project🎜# Linux, Mac OS X $ symfony demo # Windows c:\projects\> php symfony demo🎜
-vvv pada arahan sebelumnya untuk mengeluarkan butiran semua yang dilakukan oleh Komposer. 🎜🎜🎜Menjalankan Symfony ¶
🎜Semasa pembangunan, Symfony menggunakan pelayan web terbina dalam PHP. Oleh itu, menjalankan program Symfony bergantung pada direktori di mana projek itu terletak dan laksanakan arahan berikut: 🎜$ cd my_project_name/ $ composer install🎜 Kemudian, buka penyemak imbas dan lawati pautan
http://localhost:8000/, dan anda akan melihat halaman alu-aluan Symfony: 🎜🎜 🎜🎜🎜Selain halaman alu-aluan, anda juga mungkin melihat halaman kosong dan halaman ralat, yang biasanya disebabkan oleh salah konfigurasi kebenaran direktori. Bergantung pada sistem pengendalian anda, terdapat beberapa penyelesaian. Ini dijelaskan dalam bahagian "Menetapkan Kebenaran". 🎜🎜🎜🎜Pelayan terbina dalam PHP hanya wujud dalam php5.4 dan ke atas. Jika ia adalah versi lama PHP, anda harus mengkonfigurasi hos maya (🎜Virtual Host🎜) untuk projek Symfony pada pelayan web sistem pengendalian. 🎜🎜🎜Arahan server:run hanya sesuai untuk peringkat pembangunan. Jika anda menggunakan pelayan web tradisional seperti Apache atau Nginx, rujuk artikel Mengkonfigurasi pelayan web. server:run命令只适合于开发阶段。如果你使用传统的web服务器比如Apache或Nginx，参考配置web服务器这篇文章。
检查Symfony运行环境的配置 ¶
Symfony程序内置了一个服务器环境检查器，用来显示有关设置是否适合于Symfony。访问下面链接即可检查：
rrreee如果显示有问题，在继续使用Symfony之前修复它们。
更新Symfony程序 ¶
至此，你已创建了可以立即投入开发的全功能Symfony项目。Symfony程序依赖的是大量外部类库，它们可以下载到vendor/目录下，并且被Composer进行排他管理。
频繁更新这些三方类库是最佳实践，可以防止bug和漏洞。执行Composer的update
Semak konfigurasi persekitaran berjalan Symfony ¶
Program Symfony mempunyai penyemak persekitaran pelayan terbina dalam untuk menunjukkan sama ada tetapan yang berkaitan sesuai untuk Symfony. Semaknya dengan melawati pautan di bawah:rrreee
Jika terdapat isu paparan, selesaikannya sebelum terus menggunakan Symfony.vendor/ dan diuruskan secara eksklusif oleh Composer. Pasang program demo Symfony ¶
Program demo Symfony berfungsi sepenuhnya dan menunjukkan kaedah pembangunan yang disyorkan. Ia bertujuan sebagai alat pembelajaran untuk pemula Symfony, dengan ulasan yang luas dan petua berguna dalam kod sumber.
Untuk memuat turun program demo, laksanakan perintah demo pemasang Symfony dari mana-mana sahaja pada sistem anda: demo命令：
一旦下载完毕，进入symfony_demo目录，并运行PHP内置web server，执行php bin/console server:run命令，然后访问浏览器的http://localhost:8000链接，即可开始使用Symfony演示程序。
安装Symfony分发包 ¶
Symfony项目的“分发包”，是指全功能的程序，包括了Symfony核心类库，一组必备的bundles，一套合理的目录结构，以及一些默认的配置。实际上，当你按之前的介绍创建了Symfony程序之后，你已经下载了由Symfony提供的默认分发包——被称为Symfony标准版（Symfony Standard Edition）。
Symfony标准版，是目前最普及的分发，也是Symfony开发者的首选。不过，Symfony社区也提供了其他分发包供你选择使用。
Symfony CMF标准版是需要Symfony CMF的首选分发包，CMF是基于Symfony的开源项目，方便开发者向框架添加CMS（内容管理系统）功能。
Symfony REST Edition展示了如何构建一个RESTFul API程序，该分发整合了FOSRestBundle和其他几个关联bundles。
使用源码控制 ¶
如果你正使用Git这样的版本控制系统，你可以安全提交你的全部项目代码。这是因为Symfony程序中已经包含了一个专门准备给Symfony的.gitignore文件。
对于把你的项目代码托管到Git“究竟有多好”的介绍，参考如何创建和存储一个Symfony项目到Git中。
检查版本化的Symfony程序 ¶
当你使用Composer来管理程序的依赖时，推荐在提交代码到宝库时，忽略掉整个的vendor文件夹。这意味着当你从Git宝库中查看Symfony程序时，里面是没有vendor目录的，当然整个程序也是难以启动的。
若要令程序运行，检查Symfony程序，然后执行install这个Composer命令，下载和安装程序所需的全部依赖：
为何Composer知道要安装哪个特殊的依赖？这是因为当Symfony程序被提交到宝库时，composer.json和composer.lock文件也被提交。这两个文件告诉了Composer在安装Symfony时需要哪些依赖（及其特定版本）。
开始开发 ¶
现在你有了一个全功能的Symfony程序，可以开始开发了！你的分发包中包含了一些样例代码 - 查看程序中的README.mdrrreee
symfony_demo , jalankan pelayan web terbina dalam PHP, laksanakan perintah php bin/console server:run, dan kemudian akses pelayar http://localhost:8000< / kod> pautan untuk mula menggunakan program demo Symfony. #🎜🎜##🎜🎜#Pasang pakej pengedaran Symfony ¶#🎜🎜##🎜🎜#"Pakej pengedaran" projek Symfony merujuk kepada program berciri penuh, termasuk perpustakaan kelas teras Symfony dan satu set yang diperlukan berkas. Struktur direktori yang munasabah dan beberapa konfigurasi lalai. Malah, apabila anda mencipta program Symfony seperti yang diterangkan di atas, anda telah memuat turun pakej pengedaran lalai yang disediakan oleh Symfony - dipanggil Symfony Standard Edition (Symfony Standard Edition). #🎜🎜##🎜🎜#Symfony Standard Edition kini merupakan pengedaran paling popular dan pilihan pertama untuk pembangun Symfony. Walau bagaimanapun, komuniti Symfony juga menyediakan pakej pengedaran lain untuk anda pilih. #🎜🎜#- #🎜🎜#Symfony CMF Standard Edition ialah pakej pengedaran pilihan yang memerlukan Symfony CMF ialah projek sumber terbuka berdasarkan Symfony, yang memudahkan pembangun menambah fungsi CMS (sistem pengurusan kandungan). kepada rangka kerja. #🎜🎜#
- #🎜🎜#Symfony REST Edition menunjukkan cara membina program RESTFul API Pengedaran ini menyepadukan FOSRestBundle dan beberapa berkas lain yang berkaitan. #🎜🎜#
#🎜🎜#Gunakan kawalan sumber ¶#🎜🎜##🎜🎜#Jika anda menggunakan sistem kawalan versi seperti Git, anda boleh menyerahkan semua kod projek anda dengan selamat. Ini kerana program Symfony sudah mengandungi fail .gitignore yang disediakan khas untuk Symfony. #🎜🎜##🎜🎜#Untuk pengenalan kepada "seberapa baik" mengehos kod projek anda dalam Git, lihat Cara Mencipta dan Menyimpan Projek Symfony dalam Git. #🎜🎜#Semak program Symfony versi ¶
#🎜🎜#Apabila anda menggunakan Komposer untuk mengurus kebergantungan program, adalah disyorkan untuk mengabaikan keseluruhan vendor< semasa menyerahkan kod ke repositori > folder. Ini bermakna apabila anda melihat program Symfony dari repositori Git, tiada direktori vendor di dalamnya, dan sudah tentu keseluruhan program sukar untuk dimulakan. #🎜🎜##🎜🎜#Untuk menjalankan program, semak atur cara Symfony, dan kemudian laksanakan perintah install Composer untuk memuat turun dan memasang semua kebergantungan yang diperlukan untuk program: #🎜🎜#rrreee #🎜🎜 #Mengapa Komposer tahu kebergantungan khas yang mana untuk dipasang? Ini kerana apabila program Symfony diserahkan ke repositori, fail composer.json dan composer.lock turut diserahkan. Kedua-dua fail ini memberitahu Komposer kebergantungan (dan versi khusus mereka) yang diperlukan semasa memasang Symfony. #🎜🎜##🎜🎜#Mula membangunkan ¶#🎜🎜##🎜🎜#Sekarang anda mempunyai program Symfony yang berfungsi sepenuhnya, anda boleh mula membangunkan! Pakej pengedaran anda termasuk beberapa kod sampel - lihat fail README.md dalam program (dibuka dengan Notepad) untuk butiran rutin dalam pakej pengedaran. #🎜🎜#Jika anda baru menggunakan Symfony, rujuk Mencipta Halaman Symfony Pertama Anda, di mana anda boleh belajar cara membuat halaman, menukar konfigurasi dan perkara lain yang anda mahu lakukan dalam program baharu anda.
