Bagaimana Membuat Pakej Laravel (Pakej) Pembangunan?

Langkah -langkah untuk membuat pakej di Laravel termasuk: 1) Memahami kelebihan pakej, seperti modulariti dan penggunaan semula; 2) mengikuti penamaan Laravel dan spesifikasi struktur; 3) mewujudkan pembekal perkhidmatan menggunakan perintah artisan; 4) menerbitkan fail konfigurasi dengan betul; 5) Menguruskan kawalan versi dan penerbitan kepada Packagist; 6) melakukan ujian yang ketat; 7) menulis dokumentasi terperinci; 8) Memastikan keserasian dengan versi Laravel yang berbeza.

Mewujudkan pakej dalam pembangunan Laravel adalah cara yang kuat untuk memperluaskan fungsi kerangka. Mari kita menyelam bagaimana untuk meneruskan proses ini dan berkongsi beberapa pengalaman dan pandangan saya sendiri.

Untuk membangunkan pakej Laravel, anda perlu memahami kelebihan yang boleh dibawa ke projek anda. Pakej membolehkan anda memodulasi fungsi yang biasa digunakan, menjadikannya mudah digunakan semula dalam projek yang berbeza. Lebih penting lagi, pakej boleh diterbitkan kepada Packagist, yang membolehkan pemaju di seluruh dunia menggunakan kod anda, yang bukan sahaja meningkatkan penglihatan anda, tetapi juga menyumbang kepada masyarakat.

Apabila saya memulakan pakej Laravel pertama saya, saya menyedari bahawa struktur dan penamaan konvensyen pakej sangat penting. Struktur direktori pakej perlu jelas dan mengikuti spesifikasi penamaan Laravel supaya pemaju lain dapat memahami dan menggunakan pakej anda dengan mudah. Sebagai contoh, pembekal perkhidmatan harus diletakkan di direktori src dan perlu dikonfigurasi dengan betul dalam fail composer.json .

 // composer.json
{
    "Nama": "nama-nama anda/nama-pakej-nama",
    "Autoload": {
        "PSR-4": {
            "YourVendOrName \\ yourpackagename \\": "src/"
        }
    },
    "tambahan": {
        "Laravel": {
            "Penyedia": [
                "YourVendOrName \\ yourpackagename \\ yourpackagenameserviceProvider"
            ]
        }
    }
}

Semasa pembangunan, saya mendapati ia sangat berguna untuk menggunakan arahan artisan Laravel untuk mewujudkan struktur asas. Sebagai contoh, php artisan make:provider YourPackageNameServiceProvider dengan cepat dapat menghasilkan kelas penyedia perkhidmatan. Pembekal perkhidmatan adalah teras pakej, yang bertanggungjawab untuk mendaftarkan pelbagai komponen pakej, seperti arahan, fail konfigurasi, dll.

 // src/yourpackagenameserviceProvider.php
ruang nama yourvendorName \ yourpackagename;

Gunakan Illuminate \ Support \ ServiceProvider;

Kelas YourPackagenameserviceProvider Extends ServiceProvider
{
    Boot Fungsi Awam ()
    {
        jika ($ this-> app-> runninginconsole ()) {
            $ this-> menerbitkan ([
                __Dir __. '/../config/config.php' => config_path ('package-name.php'),
            ], 'nama-pakej-nama-config');
        }
    }

    Daftar Fungsi Awam ()
    {
        $ this-> MergeConFigFrom (
            __Dir __. '/../config/config.php', 'nama-pakej anda'
        );
    }
}

Masalah biasa yang saya ada semasa pembangunan adalah bagaimana untuk menerbitkan fail konfigurasi dengan betul. Melalui kaedah publishes dalam kaedah boot , anda boleh menerbitkan fail konfigurasi dalam pakej ke direktori config projek, supaya pengguna dapat menyesuaikan konfigurasi seperti yang diperlukan.

 // config/config.php
Kembali [
    'opsyen' => 'default_value',
];

Satu lagi perkara utama ialah cara mengendalikan versi dan pelepasan pakej. Saya cadangkan menggunakan Git untuk menguruskan pakej anda dan mengemas kini nombor versi dalam composer.json setiap kali versi baru dikeluarkan. Penerbitan kepada Packagist sangat mudah, hanya buat pakej baru pada Packagist dan pautan ke repositori Git anda.

Semasa proses pembangunan, saya mendapati bahawa ujian sangat penting. Laravel menyediakan alat ujian yang kuat yang boleh anda gunakan phpunit untuk menulis dan menjalankan ujian. Pastikan pakej anda berfungsi dengan baik di semua persekitaran, bukan sahaja meningkatkan kualiti pakej, tetapi juga meningkatkan keyakinan pengguna.

 // ujian/yourpackenametest.php
ruang nama yourvendorname \ yourpackagename \ tests;

Gunakan YourVendOrName \ yourpackagename \ yourpackagename;
Gunakan orkestra \ testbench \ testcase;

Kelas YourPackAgenameTest Extends TestCase
{
    Fungsi yang dilindungi getPackageProviders ($ App)
    {
        kembali [yourpackagenameserviceProvider :: class];
    }

    /** @test*/
    fungsi awam it_does_something ()
    {
        // logik ujian anda di sini
    }
}

Dalam aplikasi praktikal, saya mendapati bahawa dokumentasi pakej adalah kunci kejayaan. Fail ReadMe terperinci dapat membantu pengguna dengan cepat memulakan dengan pakej anda. Ingatlah untuk menerangkan dalam ReadMe bagaimana untuk memasang, mengkonfigurasi dan menggunakan pakej anda dan berikan jawapan kepada beberapa soalan yang sering ditanya.

Akhirnya, saya ingin berkongsi lubang yang saya telah melangkah: Apabila membangunkan pakej, mudah untuk mengabaikan isu keserasian antara pakej dan versi Laravel. Pastikan pakej anda berfungsi dengan baik pada versi Laravel yang berlainan, atau secara jelas mengisytiharkan skop versi Laravel yang disokong di composer.json .

Singkatnya, membangunkan pakej Laravel bukan sahaja meningkatkan kemahiran pengaturcaraan anda, tetapi juga menyumbang kepada masyarakat. Melalui reka bentuk struktur yang munasabah, dokumentasi terperinci dan ujian yang ketat, anda boleh membuat pakej berkualiti tinggi untuk membantu lebih banyak pemaju menyelesaikan masalah.

Atas ialah kandungan terperinci Bagaimana Membuat Pakej Laravel (Pakej) Pembangunan?. Untuk maklumat lanjut, sila ikut artikel berkaitan lain di laman web China PHP!