bekas perkhidmatan

Bab ini bercakap tentang objek PHP khas dalam Symfony, yang membantu anda membuat instantiate, menyusun dan mendapatkan semula banyak objek dalam program anda. Objek ini, dipanggil "bekas perkhidmatan", membolehkan anda menyeragamkan dan memusatkan organisasi objek dalam program anda. Bekas menjadikan perkara mudah, ia sangat pantas, dan ia menekankan kebolehgunaan semula kod yang meningkatkan seni bina sambil mengurangkan gandingan. Memandangkan semua kelas Symfony menggunakan bekas, anda akan belajar cara melanjutkan, mengkonfigurasi dan menggunakan objek dalam Symfony. Dari perspektif yang besar, bekas perkhidmatan adalah penyumbang terbesar kepada kelajuan dan kebolehskalaan Symfony.

Akhir sekali, mengkonfigurasi dan menggunakan bekas perkhidmatan adalah mudah. Selepas mempelajari bab ini, anda boleh mencipta objek anda sendiri dengan mudah melalui bekas perkhidmatan dan anda juga boleh menyesuaikan sebarang objek dalam himpunan pihak ketiga. Anda akan mula menulis kod yang boleh diguna semula, boleh diuji dan digandingkan secara longgar kerana bekas perkhidmatan memudahkan untuk menulis kod yang baik.

Apakah perkhidmatan ¶

Ringkasnya, perkhidmatan (Perkhidmatan) boleh menjadi sebarang objek yang melaksanakan tugas "global". Ia adalah kata nama khas dalam sains komputer, digunakan untuk menerangkan objek yang dicipta "untuk menyelesaikan tugas tertentu (seperti menghantar e-mel)." Dalam program, apabila anda memerlukan fungsi khusus yang disediakan oleh perkhidmatan, anda boleh mengakses perkhidmatan pada bila-bila masa. Anda tidak perlu melakukan sesuatu yang istimewa semasa membuat perkhidmatan: hanya tulis kelas PHP yang melaksanakan tugas. Tahniah, anda telah mencipta perkhidmatan!

Apakah maksudnya? Kelebihan memikirkan masalah dari perspektif "perkhidmatan" ialah anda sudah mahu memisahkan setiap fungsi dalam program ke dalam satu siri perkhidmatan. Memandangkan setiap perkhidmatan hanya melakukan satu perkara, anda boleh mengakses perkhidmatan dengan mudah pada bila-bila masa anda memerlukannya. Menguji dan mengkonfigurasi setiap perkhidmatan menjadi lebih mudah kerana ia dipisahkan daripada fungsi lain dalam aplikasi anda. Idea ini dipanggil Seni Bina Berorientasikan Perkhidmatan dan tidak eksklusif untuk Symfony atau PHP. "Menstrukturkan" program anda melalui satu set kelas perkhidmatan bebas ialah amalan terbaik yang diuji masa dan terkenal dalam pengaturcaraan berorientasikan objek. Kemahiran ini adalah kunci untuk menjadi pembangun yang baik dalam mana-mana bahasa.

Apakah itu bekas perkhidmatan? ¶

Bekas perkhidmatan (Bekas Perkhidmatan/bekas suntikan kebergantungan) ialah objek PHP yang menguruskan instantiasi perkhidmatan (iaitu objek).

Sebagai contoh, katakan anda mempunyai kelas mudah untuk menghantar mesej e-mel. Tanpa bekas perkhidmatan, anda perlu membuat objek secara manual apabila diperlukan.

use Acme\HelloBundle\Mailer;
 $mailer = new Mailer('sendmail');
$mailer->send('ryan@example.com', ...);

Mudah sahaja. Kelas perkhidmatan mel Mailer fiksyen yang membolehkan anda mengkonfigurasi kaedah penghantaran mel (seperti sendmail, atau smtp, dsb.). Tetapi bagaimana jika anda ingin menggunakan perkhidmatan mel anda di tempat lain? Anda pastinya tidak mahu mengkonfigurasi semula objek Mailer setiap kali. Bagaimana jika anda ingin menukar cara penghantaran mel dan menukar semua sendmail dalam keseluruhan program kepada smtp? Anda perlu mencari semua tempat di mana Mailer dibuat dan mengemas kininya secara manual. Mailer 邮件服务类，允许你配置邮件的发送方法（比如 sendmail ，或 smtp ，等等）。但如果你想在其他地方使用邮件服务怎么办？你当然不希望每次都重新配置 Mailer 对象。如果你想改变邮件的传输方式，把整个程序中所有的 sendmail 改成 smtp 怎么办？你不得不找到所有创建了 Mailer 的地方，手动去更新。

在容器中创建和配置服务 ¶

上面问题的最佳答案，是让服务容器来为你创建Mailer对象。为了让容器正常工作，你先要教会它如何创建Mailer服务。这是通过配置来实现的，配置方式有YAML，XML或PHP:

PHP:// app/config/services.phpuse Symfony\Component\DependencyInjection\Definition; $container->setDefinition('app.mailer', new Definition(
    'AppBundle\Mailer',
    array('sendmail')));

XML:<!-- app/config/services.xml --><?xml version="1.0" encoding="UTF-8" ?><container xmlns="http://symfony.com/schema/dic/services"    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"    xsi:schemaLocation="http://symfony.com/schema/dic/services        http://symfony.com/schema/dic/services/services-1.0.xsd">     <services>
        <service id="app.mailer" class="AppBundle\Mailer">
            <argument>sendmail</argument>
        </service>
    </services></container>

YAML:# app/config/services.ymlservices:
    app.mailer:
        class:        AppBundle\Mailer
        arguments:    [sendmail]

class HelloController extends Controller{
    // ...     public function sendEmailAction()
    {
        // ...
        $mailer = $this->get('app.mailer');
        $mailer->send('ryan@foobar.net', ...);
    }}

PHP:// app/config/services.phpuse Symfony\Component\DependencyInjection\Definition; $container->setParameter('app.mailer.transport', 'sendmail'); $container->setDefinition('app.mailer', new Definition(
    'AppBundle\Mailer',
    array('%app.mailer.transport%')));

XML:<!-- app/config/services.xml --><?xml version="1.0" encoding="UTF-8" ?><container xmlns="http://symfony.com/schema/dic/services"    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"    xsi:schemaLocation="http://symfony.com/schema/dic/services        http://symfony.com/schema/dic/services/services-1.0.xsd">     <parameters>
        <parameter key="app.mailer.transport">sendmail</parameter>
    </parameters>     <services>
        <service id="app.mailer" class="AppBundle\Mailer">
            <argument>%app.mailer.transport%</argument>
        </service>
    </services></container>

YAML:# app/config/services.ymlparameters:
    app.mailer.transport:  sendmailservices:
    app.mailer:
        class:        AppBundle\Mailer
        arguments:    ['%app.mailer.transport%']

# app/config/parameters.ymlparameters:    # This will be parsed as string '@securepass'
    mailer_password: '@@securepass'

1

<argument type="string">http://symfony.com/?foo=%%s&bar=%%d</argument>

// src/Acme/HelloBundle/Newsletter/NewsletterManager.phpnamespace Acme\HelloBundle\Newsletter; use Acme\HelloBundle\Mailer; class NewsletterManager{
    protected $mailer;     public function __construct(Mailer $mailer)
    {
        $this->mailer = $mailer;
    }     // ...}

use Acme\HelloBundle\Newsletter\NewsletterManager; // ... public function sendNewsletterAction(){
    $mailer = $this->get('app.mailer');
    $newsletter = new NewsletterManager($mailer);
    // ...}

PHP:// app/config/services.phpuse Symfony\Component\DependencyInjection\Definition;use Symfony\Component\DependencyInjection\Reference; $container->setDefinition('app.mailer', ...); $container->setDefinition('app.newsletter_manager', new Definition(
    'AppBundle\Newsletter\NewsletterManager',
    array(new Reference('app.mailer'))));

XML:<!-- app/config/services.xml --><?xml version="1.0" encoding="UTF-8" ?><container xmlns="http://symfony.com/schema/dic/services"    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"    xsi:schemaLocation="http://symfony.com/schema/dic/services        http://symfony.com/schema/dic/services/services-1.0.xsd">     <services>
        <service id="app.mailer">
        <!-- ... -->
        </service>         <service id="app.newsletter_manager" class="AppBundle\Newsletter\NewsletterManager">
            <argument type="service" id="app.mailer"/>
        </service>
    </services></container>

YAML:# app/config/services.ymlservices:
    app.mailer:        # ...
    app.newsletter_manager:
        class:     AppBundle\Newsletter\NewsletterManager
        arguments: ['@app.mailer']

namespace AppBundle\Newsletter; use AppBundle\Mailer; class NewsletterManager{
    protected $mailer;     public function setMailer(Mailer $mailer)
    {
        $this->mailer = $mailer;
    }     // ...}

PHP:// app/config/services.phpuse Symfony\Component\DependencyInjection\Definition;use Symfony\Component\DependencyInjection\Reference; $container->setDefinition('app.mailer', ...); $container->setDefinition('app.newsletter_manager', new Definition(
    'AppBundle\Newsletter\NewsletterManager'))->addMethodCall('setMailer', array(
    new Reference('app.mailer'),));

XML:<!-- app/config/services.xml --><?xml version="1.0" encoding="UTF-8" ?><container xmlns="http://symfony.com/schema/dic/services"    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"    xsi:schemaLocation="http://symfony.com/schema/dic/services        http://symfony.com/schema/dic/services/services-1.0.xsd">     <services>
        <service id="app.mailer">
        <!-- ... -->
        </service>         <service id="app.newsletter_manager" class="AppBundle\Newsletter\NewsletterManager">
            <call method="setMailer">
                <argument type="service" id="app.mailer" />
            </call>
        </service>
    </services></container>

YAML:# app/config/services.ymlservices:
    app.mailer:        # ...
    app.newsletter_manager:
        class:     AppBundle\Newsletter\NewsletterManager
        calls:            - [setMailer, ['@app.mailer']]