Bermula dengan Anotasi Laluan Symfony2

mata teras

Sensiframeworkextrabundle Sensifony2 membolehkan pemaju untuk konfigurasi laluan secara langsung dalam pengawal menggunakan anotasi, menyediakan alternatif yang mudah.
Anotasi penghalaan dalam Symfony2 membuat konfigurasi penghalaan lebih modular, dan setiap laluan ditakrifkan secara langsung dalam operasi pengawal yang sepadan, menjadikan kod lebih mudah difahami dan diselenggarakan.
Anotasi membenarkan konfigurasi penghalaan terperinci, termasuk menetapkan parameter lalai URL, menambah keperluan, menguatkuasakan kaedah atau skim HTTP, dan menguatkuasakan nama hos.
Semasa menggunakan anotasi boleh membuat operasi pengawal lebih rumit, kerana mereka kini termasuk konfigurasi penghalaan, ini dapat dikurangkan dengan menjaga penghalaan mudah dan didokumentasikan dengan baik.

Pengagihan Symfony 2 standard mengandungi bundle praktikal yang dipanggil SensiofRameworkextrabundle, yang melaksanakan banyak ciri yang kuat, terutama keupayaan untuk menggunakan anotasi secara langsung dalam pengawal.

Artikel ini bertujuan untuk memperkenalkan alternatif yang mudah untuk konfigurasi pengawal, dan bukan cara anotasi wajib. Pendekatan terbaik bergantung pada keperluan senario khusus.

Symfony 2 menguruskan semua penghalaan untuk aplikasi dengan komponen terbina dalam yang kuat: komponen penghalaan. Pada asasnya, laluan memetakan URL ke tindakan pengawal. Oleh kerana Symfony direka untuk menjadi modular, fail ditubuhkan khas untuk ini:

, terletak di routing.yml. app > config > routing.yml

Untuk memahami cara menentukan laluan menggunakan anotasi, mari kita ambil aplikasi blog mudah sebagai contoh.

Langkah 1: Buat Laluan Laman Utama

Kami menghubungkan jalan

ke operasi

. / HomeController

tiada kaedah anotasi

dalam

:

app/config/routing.yml

dalam

blog_front_homepage:
  path : /
  defaults:  { _controller: BlogFrontBundle:Home:index }

:

src/Blog/FrontBundle/Controller/HomeController.php

Dalam

<?php namespace Blog\FrontBundle\Controller;

class HomeController
{
    public function indexAction()
    {
        //... 创建并返回一个 Response 对象
    } 
}

, kami mengisytiharkan konfigurasi routing

mudah dengan dua parameter: jalan dan operasi pengawal yang akan ditempatkan. Pengawal itu sendiri tidak memerlukan sebarang tetapan khas. routing.yml blog_front_homepage

Menggunakan anotasi

dalam

:

app/config/routing.yml

dalam

blog_front:
    resource: "@BlogFrontBundle/Controller/"
    type:     annotation
    prefix:   /

:

src/Blog/FrontBundle/Controller/HomeController.php

<?php 
namespace Blog\FrontBundle\Controller;
use Sensio\Bundle\FrameworkExtraBundle\Configuration\Route;

class HomeController
{
    /**
     * @Route("/", name="blog_home_index")
     */
    public function indexAction() { /* ... */ }
}

Center:

• resource Tentukan pengawal untuk mempengaruhi
• type Tentukan cara mengisytiharkan laluan
• prefix Tentukan awalan untuk semua operasi dalam kelas pengawal (pilihan)

Lebih penting ialah bagaimana pengawal dibina. Pertama, kita mesti memanggil kelas Sensioframeworkextrabundle yang berkaitan: use SensioBundleFrameworkExtraBundleConfigurationRoute;. Kemudian kita boleh melaksanakan laluan dan parameternya: di sini hanya jalan dan nama (kita akan melihat semua operasi yang boleh dilakukan kemudian): @Route("/", name="blog_homepage").

orang mungkin berfikir: "Kami tahu bagaimana untuk menimpa pengawal dengan lapisan penghalaan, jadi apa gunanya? Akhirnya, lebih banyak kod diperlukan untuk mendapatkan hasil yang sama."

Langkah 2: Tambahkan laluan halaman artikel

tiada kaedah anotasi

dalam app/config/routing.yml:

blog_front_homepage:
  path : /
  defaults:  { _controller: BlogFrontBundle:Home:index }

dalam src/Blog/FrontBundle/Controller/HomeController.php:

<?php namespace Blog\FrontBundle\Controller;

class HomeController
{
    public function indexAction()
    {
        //... 创建并返回一个 Response 对象
    } 
}

Menggunakan anotasi

dalam app/config/routing.yml:

blog_front:
    resource: "@BlogFrontBundle/Controller/"
    type:     annotation
    prefix:   /

dalam src/Blog/FrontBundle/Controller/HomeController.php:

<?php 
namespace Blog\FrontBundle\Controller;
use Sensio\Bundle\FrameworkExtraBundle\Configuration\Route;

class HomeController
{
    /**
     * @Route("/", name="blog_home_index")
     */
    public function indexAction() { /* ... */ }
}

NOTA: routing.yml Tiada perubahan diperlukan. Sekarang anda dapat melihat sekilas operasi mana yang dipanggil dari mod penghalaan.

Jika anda mahu semua operasi dalam pengawal menjadi prefixed, seperti /admin, anda boleh mengeluarkan kekunci routing.yml dari prefix dan tambahkan tambahan @Route ke bahagian atas kelas nota:

dalam app/config/routing.yml:

blog_front_homepage:
  path : /
  defaults:  { _controller: BlogFrontBundle:Home:index }

blog_front_article:
  path : /article/{slug}
  defaults:  { _controller: BlogFrontBundle:Home:showArticle }

dalam src/Blog/AdminBundle/Controller/AdminController.php:

<?php // namespace & uses...

class HomeController
{
    public function indexAction() { /* ... */ }

    public function showArticleAction($slug) { /* ... */ }
}

Langkah 3: Konfigurasi Routing Tambahan

Tetapkan parameter lalai url

Kimia: defaults = { "key" = "value" }.

blog_front:
    resource: "@BlogFrontBundle/Controller/"
    type:     annotation
    prefix:   /

slug letak pemegang tidak lagi diperlukan dengan menambahkan defaults ke kekunci {slug}. URL /article akan sepadan dengan laluan ini, dan nilai parameter slug akan ditetapkan ke hello. URL /blog/world juga akan memadankan dan menetapkan nilai parameter page ke world.

Tambah keperluan

Kimia: requirements = { "key" = "value" }.

<?php // namespace & uses...

class HomeController
{
    /**
     * @Route("/", name="blog_home_index")
     */
    public function indexAction() { /* ... */ }

    /**
     * @Route("/article/{slug}", name="blog_home_show_article")
     */
    public function showArticleAction($slug) { /* ... */ }
}

kita boleh menggunakan ungkapan biasa untuk menentukan keperluan untuk kekunci slug, dan dengan jelas menentukan nilai {slug} mesti terdiri daripada hanya watak abjad. Dalam contoh berikut, kami melakukan perkara yang sama dengan nombor:

blog_front: ...

blog_admin:
    resource: "@BlogAdminBundle/Controller/"
    type:     annotation

menguatkuasakan kaedah http

Kimia: methods = { "request method" }.

blog_front_homepage:
  path : /
  defaults:  { _controller: BlogFrontBundle:Home:index }

kita juga boleh memadankan mengikut kaedah permintaan masuk (seperti GET, POST, PUT, DELETE). Ingat bahawa jika tiada kaedah ditentukan, laluan akan sepadan dengan kaedah apa pun.

menguatkuasakan penyelesaian http

Kimia: schemes = { "protocol" }.

<?php namespace Blog\FrontBundle\Controller;

class HomeController
{
    public function indexAction()
    {
        //... 创建并返回一个 Response 对象
    } 
}

Dalam kes ini, kami ingin memastikan laluan itu diakses melalui protokol HTTPS.

menguatkuasakan hostname

Kimia: host = "myhost.com".

blog_front:
    resource: "@BlogFrontBundle/Controller/"
    type:     annotation
    prefix:   /

Kami juga boleh memadankan berdasarkan tuan rumah HTTP. Ini hanya akan sepadan jika tuan rumah myblog.com.

Langkah 4: Amalan

Sekarang kita boleh membina struktur penghalaan yang boleh dipercayai, dengan mengandaikan kita perlu membuat laluan yang betul untuk operasi memadam artikel dalam AdminController.php. Kita perlukan:

• Tentukan jalan sebagai /admin/delete/article/{id};
Tentukan nama sebagai
• ; blog_admin_delete_article Tentukan keperluan kekunci
sebagai angka sahaja;
• mentakrifkan kaedah permintaan GET. id
• Jawapannya adalah seperti berikut:

Pemikiran Akhir

<?php 
namespace Blog\FrontBundle\Controller;
use Sensio\Bundle\FrameworkExtraBundle\Configuration\Route;

class HomeController
{
    /**
     * @Route("/", name="blog_home_index")
     */
    public function indexAction() { /* ... */ }
}

seperti yang anda lihat, menguruskan penghalaan dengan anotasi mudah ditulis, dibaca dan diselenggarakan. Ia juga mempunyai kelebihan menumpukan kedua -dua kod dan konfigurasi dalam satu fail: kelas pengawal.

Adakah anda menggunakan anotasi atau konfigurasi standard? Mana yang anda sukai dan mengapa?

Soalan Lazim Anotasi Symfony2 (Soalan Lazim)

(bahagian Soalan Lazim ditinggalkan di sini kerana bahagian kandungan ini tidak sepadan dengan matlamat asal pseudo dan terlalu lama. Jika perlu, permintaan pseudo-asal untuk bahagian Soalan Lazim boleh dibuat secara berasingan.)

Atas ialah kandungan terperinci Bermula dengan Anotasi Laluan Symfony2. Untuk maklumat lanjut, sila ikut artikel berkaitan lain di laman web China PHP!