laravel web tinker

Artisan Tinker di browser Anda

Perintah tinker Artisan adalah cara terbaik untuk mengutak-atik aplikasi Anda di terminal. Sayangnya menjalankan beberapa baris kode, melakukan pengeditan, dan menyalin/menempelkan kode dapat mengganggu. Bukankah menyenangkan mengutak-atik browser?

Paket ini akan menambahkan rute ke aplikasi Anda di mana Anda dapat mengotak-atik sesuka hati Anda.

Jika cahaya menyakiti mata Anda, ada mode gelap juga.

Dukung kami

Kami menginvestasikan banyak sumber daya untuk menciptakan paket sumber terbuka terbaik di kelasnya. Anda dapat mendukung kami dengan membeli salah satu produk berbayar kami.

Kami sangat menghargai Anda mengirimi kami kartu pos dari kota asal Anda, yang menyebutkan paket kami mana yang Anda gunakan. Anda akan menemukan alamat kami di halaman kontak kami. Kami mempublikasikan semua kartu pos yang diterima di dinding kartu pos virtual kami.

Sebuah kata bijak

Paket ini dapat menjalankan kode arbitrer. Kecuali Anda tahu apa yang Anda lakukan, Anda tidak boleh menginstal atau menggunakan ini di lingkungan produksi, atau lingkungan apa pun tempat Anda menangani data dunia nyata.

Instalasi

Anda dapat menginstal paket melalui composer:

composer require spatie/laravel-web-tinker --dev

Selanjutnya, Anda harus mempublikasikan aset dari paket ini dengan menjalankan perintah ini.

php artisan web-tinker:install

Secara opsional, Anda dapat mempublikasikan file konfigurasi paket.

php artisan vendor:publish --provider= " SpatieWebTinkerWebTinkerServiceProvider " --tag= " config "

Ini adalah konten yang akan dipublikasikan ke config/web-tinker.php

 return [

    /*
     * The web tinker page will be available on this path.
     */
    ' path ' => ' /tinker ' ,

    /*
     * Possible values are 'auto', 'light' and 'dark'.
     */
    ' theme ' => ' auto ' ,

    /*
     * By default this package will only run in local development.
     * Do not change this, unless you know what your are doing.
     */
    ' enabled ' => env ( ' APP_ENV ' ) === ' local ' ,

   /*
    * This class can modify the output returned by Tinker. You can replace this with
    * any class that implements SpatieWebTinkerOutputModifiersOutputModifier.
    */
    ' output_modifier ' =>  Spatie  WebTinker  OutputModifiers PrefixDateTime::class,

    /*
    * These middleware will be assigned to every WebTinker route, giving you the chance
    * to add your own middlewares to this list or change any of the existing middleware.
    */
    ' middleware ' => [
        Illuminate  Cookie  Middleware EncryptCookies::class,
        Illuminate  Session  Middleware StartSession::class,
        Spatie  WebTinker  Http  Middleware Authorize::class,
    ],

    /*
     * If you want to fine-tune PsySH configuration specify
     * configuration file name, relative to the root of your
     * application directory.
     */
    ' config_file ' => env ( ' PSYSH_CONFIG ' , null ),
];

Penggunaan

Secara default paket ini hanya akan berjalan di lingkungan lokal.

Kunjungi /tinker di lingkungan lokal aplikasi Anda untuk melihat halaman tinker.

Otorisasi

Jika Anda ingin menjalankan ini di lingkungan lain (kami tidak menyarankan ini), ada dua langkah yang harus Anda lakukan.

1. Anda harus mendaftarkan kemampuan viewWebTinker . Tempat yang baik untuk melakukan ini adalah di AuthServiceProvider yang dikirimkan bersama Laravel.

 public function boot ()
{
    $ this -> registerPolicies ();

    Gate:: define ( ' viewWebTinker ' , function ( $ user = null ) {
        // return true if access to web tinker is allowed
    });
}

2. Anda harus menyetel variabel enabled di file konfigurasi web-tinker ke true .

Memodifikasi keluaran

Anda dapat memodifikasi keluaran tinker dengan menentukan pengubah keluaran di kunci output_modifier dari file konfigurasi web-tinker . Pengubah keluaran adalah kelas apa pun yang mengimplementasikan SpatieWebTinkerOutputModifiersOutputModifier .

Seperti inilah tampilan antarmukanya.

 namespace Spatie  WebTinker  OutputModifiers ;

interface OutputModifier
{
    public function modify ( string $ output = '' ): string ;
}

Instalasi default paket ini akan menggunakan pengubah keluaran PrefixDataTime yang mengawali keluaran dari Tinker dengan waktu tanggal saat ini.

Pengujian

composer test 

log perubahan

Silakan lihat CHANGELOG untuk informasi lebih lanjut tentang apa yang berubah baru-baru ini.

Berkontribusi

Silakan lihat KONTRIBUSI untuk rinciannya.

Keamanan

Jika Anda menemukan bug terkait keamanan, silakan kirim email ke [email protected] alih-alih menggunakan pelacak masalah.

Kredit

• Freek Van der Herten
• Semua Kontributor

Paket ini terinspirasi dan menggunakan kode dari paket nova-tinker-tool oleh Marcel Pociot.

Lisensi

Lisensi MIT (MIT). Silakan lihat File Lisensi untuk informasi lebih lanjut.