PHP Master | Bina automasi dengan skrip komposer

3Berikutan pengenalan Alexander Cogneau kepada Pengurusan Ketergantungan dengan Komposer , anda kini tahu bahawa komposer adalah resolver untuk menguruskan kebergantungan projek luaran dan kekangan versi. Tetapi adakah itu semua? Dalam artikel ini, saya akan menunjukkan kepada anda bagaimana komposer juga boleh digunakan sebagai alat automasi membina asas.

Kunci Takeaways

• Komposer, selain menjadi resolver untuk menguruskan kebergantungan projek luaran dan kekangan versi, juga boleh digunakan sebagai alat automasi membina asas. Ia mendedahkan pra
• dan post
• Pasang/Kemas kini/Uninstall Hooks Acara Semasa Pelaksanaan yang boleh disiarkan untuk pelbagai tugas automatik.

Skrip Komposer

Mana -mana alat binaan automasi yang bernilai garamnya mesti memberikan keupayaan untuk skrip pelbagai tugas automatik - dari bangunan, pembungkusan, dan menjalankan suite ujian, untuk digunakan pada sistem pementasan dan pengeluaran. Sebagai contoh, Phing adalah berdasarkan ANT dan membenarkan anda menentukan tugas -tugas tersebut dalam fail membina XML. Komposer berbeza dalam hal ini kerana ia tidak membuat andaian tentang tugas -tugas ini, atau jika mereka akan dilakukan sama sekali. Apa yang dilakukan oleh komposer adalah mendedahkan cangkuk acara pra dan pasca/kemas kini/pemasangan/pemasangan semasa pelaksanaan yang boleh anda panggil semula menggunakan "skrip", dengan cara yang sama seperti Pyrus menyediakan keupayaan untuk menentukan arahan tersuai dalam pakej.xml melalui -Pilihan untuk memasang, menaik taraf, dan menyahpasang arahannya. Harta skrip ditakrifkan dalam objek JSON Root dari Composer.JSON Pakej Root anda fail. Anda boleh menentukan bilangan kaedah statik PHP (yang mesti autoloadable oleh mekanisme autoloader komposer), executable baris arahan, atau gabungan kedua-duanya. Mana-mana kod tersuai atau perintah khusus pakej yang ditakrifkan oleh skrip ini kemudian dipanggil semasa proses pelaksanaan komposer. Kaveat adalah bahawa hanya skrip yang ditakrifkan dalam komposer pakej akar.json dilaksanakan. Komposer tidak akan melaksanakan sebarang skrip yang dinyatakan dalam kebergantungan pakej akar. Peristiwa berikut dipecat semasa proses pelaksanaan komposer:

• pra-pemasangan-CMD-berlaku sebelum arahan pemasangan dilaksanakan
• post-install-cmd-berlaku selepas arahan pemasangan dilaksanakan
• pra-update-cmd-berlaku sebelum arahan kemas kini dilaksanakan
• post-update-cmd-berlaku selepas arahan kemas kini dilaksanakan
• Pra-Package-Install-berlaku sebelum pakej dipasang
• pasca pakej-pemasangan-berlaku selepas pakej dipasang
• pra-pakej-update-berlaku sebelum pakej dikemas kini
• pasca pakej-update-berlaku selepas pakej dikemas kini
• Pra-Package-Uninstall-berlaku sebelum pakej dipasang
• Post-Package-Uninstall-berlaku selepas pakej tidak dipasang

Ini cukup jelas, dan saya fikir anda akan bersetuju, kecantikan itu terletak pada kesederhanaannya. Tetapi untuk menggambarkan, inilah contoh komposer pakej akar:

<span>{
</span>    <span>"name": "MyProject",
</span>    <span>"description": "An example to demonstrate the use of Composer scripts",
</span>    <span>"version": "1.0.0",
</span>    <span>"require": {
</span>        <span>"php": ">=5.3",
</span>        <span>"ext-xsl": "*",
</span>        <span>"ext-imap": "*",
</span>        <span>"ext-gd": "*"
</span>      <span>},
</span>
    <span>"autoload": {
</span>        <span>"psr-0": {
</span>            <span>"MyProject": "src/"
</span>        <span>}
</span>    <span>},
</span>
    <span>"scripts": {
</span>        <span>"pre-install-cmd": "MyProject\Installer::preInstall",
</span>        <span>"post-install-cmd": [
</span>            <span>"MyProject\Installer::postInstall"
</span>        <span>],
</span>        <span>"post-package-install": [
</span>            <span>"MyProject\Installer::postPackageInstall",
</span>            <span>"phpunit -c /tests",
</span>            <span>"./bin/install.sh"
</span>        <span>]
</span>    <span>}
</span><span>}</span>

Saya telah menentukan beberapa skrip untuk peristiwa pra-pemasangan-CMD, pasca pemasangan-CMD, dan pasca pakej. Seperti yang anda lihat, kami boleh menentukan apa-apa gabungan kaedah PHP statik dan executable baris arahan. Dalam kes acara pasca pakej, ia juga melaksanakan beberapa ujian unit dan skrip pemasangan tersuai. Inilah contoh skrip contoh kami:

<span><span><?php
</span></span><span><span>namespace MyProject;
</span></span><span><span>use ComposerScriptEvent;
</span></span><span>
</span><span><span>class Installer
</span></span><span><span>{
</span></span><span>    <span>public static function preInstall(Event $event) {
</span></span><span>        <span>// provides access to the current ComposerIOConsoleIO
</span></span><span>        <span>// stream for terminal input/output
</span></span><span>        <span>$io = $event->getIO();
</span></span><span>        <span>if ($io->askConfirmation("Are you sure you want to proceed? ", false)) {
</span></span><span>            <span>// ok, continue on to composer install
</span></span><span>            <span>return true;
</span></span><span>        <span>}
</span></span><span>        <span>// exit composer and terminate installation process
</span></span><span>        <span>exit;
</span></span><span>    <span>}
</span></span><span>
</span><span>    <span>public static function postInstall(Event $event) {
</span></span><span>        <span>// provides access to the current Composer instance
</span></span><span>        <span>$composer = $event->getComposer();
</span></span><span>        <span>// run any post install tasks here
</span></span><span>    <span>}
</span></span><span>
</span><span>    <span>public static function postPackageInstall(Event $event) {
</span></span><span>        <span>$installedPackage = $event->getComposer()->getPackage();
</span></span><span>        <span>// any tasks to run after the package is installed?
</span></span><span>    <span>}
</span></span><span><span>}</span></span>

Apabila setiap peristiwa ini dipecat, pengendali acara dalaman komposer meluluskan objek komposerscriptEvent sebagai hujah pertama (dan hanya) kepada setiap panggilan balik. Acara itu objek mendedahkan getter berikut untuk objek komposer lain untuk panggilan balik anda:

• getComposer () - Mengembalikan contoh semasa komposerkomposer
• getName () - Mengembalikan nama acara yang dipecat
• getio () - Mengembalikan aliran input/output semasa yang melaksanakan ComposerioioInterface untuk membaca/menulis ke konsol

Anda boleh merujuk kepada dokumentasi API Komposer untuk setiap tandatangan kaedah dan untuk kaedah lain yang setiap objek ini mendedahkan - khususnya, contoh komposer dan antara muka IO. Walaupun pelaksanaan yang seolah -olah ini mungkin tidak muncul sebagai "kuat" sebagai definisi phing, kesederhanaannya memungkiri fleksibiliti yang luar biasa. Ia memanfaatkan pelaburan pengetahuan anda yang sedia ada di PHP, dan dengan sedikit kreativiti dan imaginasi anda boleh menggunakan resolver ketergantungan komposer dan skrip PHP asli untuk mewujudkan beberapa tugas membina dan mengambil yang agak kompleks. Anda juga boleh mengintegrasikannya ke Jenkins untuk integrasi berterusan.

Ringkasan

Dalam artikel ini, saya telah memperkenalkan contoh asas bagaimana skrip komposer boleh digunakan untuk melakukan pembentukan automasi. Tugas -tugas ini boleh menjadi mudah atau kompleks seperti yang anda perlukan, kerana mereka memanfaatkan pelaburan pengetahuan anda yang sedia ada di PHP. Dan diharapkan, artikel ini akan memberi inspirasi kepada anda untuk menggunakan komposer untuk lebih daripada sekadar pengurusan ketergantungan. Untuk maklumat lanjut mengenai cara menggunakan skrip komposer, lihat getcomposer.org/doc/articles/scripts.md. imej melalui Fotolia

Soalan Lazim (Soalan Lazim) Mengenai Membina Automasi dengan Skrip Komposer

Apakah fungsi utama komposer dalam pembangunan PHP? Ia membolehkan anda mengisytiharkan perpustakaan projek anda bergantung pada, dan ia akan mengurus (memasang/mengemas kini) untuk anda. Komposer bukan pengurus pakej dalam erti kata yang sama seperti Yum atau Apt. Ya, ia berkaitan dengan "pakej" atau perpustakaan, tetapi ia menguruskannya secara per-projek, memasangnya dalam direktori (mis., Vendor) di dalam projek anda.

Bagaimana saya boleh mengautomasikan tugas menggunakan skrip komposer?

Skrip komposer adalah cara untuk mengautomasikan tugas dalam pembangunan PHP. Mereka ditakrifkan dalam fail komposer.json dan boleh dijalankan dari baris arahan menggunakan arahan 'komposer run-skrip'. Skrip boleh digunakan untuk mengautomasikan tugas seperti ujian, bangunan, dan penempatan. Mereka juga boleh digunakan untuk menjalankan kod PHP tersuai.

Bolehkah saya menggunakan skrip komposer untuk ujian?

Ya, skrip komposer boleh digunakan untuk ujian. Anda boleh menentukan skrip dalam fail komposer.json anda yang menjalankan ujian anda. Sebagai contoh, anda boleh menentukan skrip yang dipanggil 'ujian' yang menjalankan phpunit. Kemudian, anda boleh menjalankan ujian anda dari baris arahan menggunakan arahan 'komposer run-script' perintah.

Bagaimana saya boleh menggunakan skrip komposer untuk penempatan? Dengan menentukan skrip dalam fail komposer.json anda yang melakukan langkah -langkah yang diperlukan untuk menggunakan aplikasi anda. Ini termasuk tugas -tugas seperti menyusun aset, mengoptimumkan kod, dan memuat naik fail ke pelayan. Sebaik sahaja skrip ditakrifkan, anda boleh menjalankannya dari baris arahan menggunakan perintah 'komposer run-skrip'.

Bolehkah skrip komposer menjalankan kod php tersuai? kod php tersuai. Anda boleh menentukan skrip dalam fail komposer.json anda yang menjalankan fail PHP. Fail PHP boleh mengandungi sebarang kod yang anda mahukan. Apabila anda menjalankan skrip menggunakan arahan 'komposer run-skrip', kod php akan dilaksanakan. Fail .json. Setiap skrip ditakrifkan sebagai pasangan nilai utama, dengan kunci sebagai nama skrip dan nilai menjadi arahan untuk dijalankan. Anda boleh menambah, mengubah suai, atau mengeluarkan skrip dengan mengedit fail komposer.json.

Bolehkah saya menggunakan skrip komposer untuk mengautomasikan proses membina? . Dengan menentukan skrip dalam fail komposer.json anda, anda boleh mengautomasikan tugas seperti menyusun kod, minifikasi aset, dan menghasilkan dokumentasi. Skrip ini kemudiannya boleh dijalankan dari baris arahan menggunakan perintah 'komposer run-skrip'.

Apakah faedah menggunakan skrip komposer untuk automasi? proses pembangunan anda lebih cekap. Dengan mengautomasikan tugas berulang, anda boleh menjimatkan masa dan mengurangkan risiko kesilapan. Skrip komposer juga membuat proses binaan anda lebih konsisten, kerana tugas yang sama dilakukan dengan cara yang sama setiap masa. boleh digunakan bersama dengan alat lain. Sebagai contoh, anda boleh menggunakan skrip komposer untuk menjalankan tugas Gulp, atau untuk menjalankan suite ujian phpunit. Ini membolehkan anda memanfaatkan keupayaan alat lain semasa masih mendapat manfaat daripada automasi yang disediakan oleh skrip komposer.

Bagaimana saya boleh mengetahui lebih lanjut mengenai menggunakan skrip komposer untuk automasi? Dokumentasi komposer rasmi adalah tempat yang bagus untuk bermula. Terdapat juga banyak tutorial dan catatan blog yang tersedia dalam talian yang menyediakan contoh dan amalan terbaik untuk menggunakan skrip komposer.

Atas ialah kandungan terperinci PHP Master | Bina automasi dengan skrip komposer. Untuk maklumat lanjut, sila ikut artikel berkaitan lain di laman web China PHP!