Artisan'da mevcut olan komutlara ilaveten, uygulamanız ile çalışacak olan kendi özel komutlarınızı inşa edebilirsiniz. Bu özel komutlarınızı app/commands dizininde depolayabilirsiniz. Komutlarınızı kendi istediğiniz başka bir dizinde de depolayabilirsiniz. Bunun için, bu komutlarınızın composer.json ayarlarınız bazında "autoload" edilebiliyor olması gerekmektedir.
Yeni bir komut oluşturmak için, command:make Artisan komutunu kullanabilirsiniz. Bu komut, başlamanızda size yardımcı olmak için yeni bir komut taslağı oluşturacaktır.
Yeni bir Komut Sınıfının Oluşturulması
php artisan command:make FalancaKomut
Ön tanımlı olarak, oluşturulan komutlar app/commands dizininde depolanırlar. Fakat, siz başka bir dizin veya bir 'namespace' de belirleyebilirsiniz.
php artisan command:make FalancaKomut --path="app/classes" --namespace="Siniflar"
Komut oluşturulduktan sonra, komutu list ekranında görüntülerken kullanılacak olan, sınıf ismi name ve tanımı description özellikleri doldurulmalıdır.
Komut çalıştırıldığında fire (ateşle) yöntemi çağırılmaktadır. Bu yönteme, istenecek herhangi bir komut mantığı yerleştirebilinir.
Komutunuzun alacağı argüman veya seçenekleri tanımlayabileceğiniz yerler getArguments ve getOptions metodlarıdır. Bu metodların her ikisi de birer komut dizisi verirler. Bu komut dizileri, bir 'dizi seçenekleri listesi' ile tarif edilirler.
Argümanları arguments belirlerlerken, dizi tanımı değerleri şunları belirler: (ismi, modu, tanımı, ön değeri)
array($name, $mode, $description, $defaultValue)
Modu argümanı mode şunlardan herhangi biri olabilir: InputArgument::REQUIRED (mecburi) veya InputArgument::OPTIONAL (isteğe bağlı).
Seçenekleri options belirlerken, dizi tanımı değerleri şunları belirler: (ismi, kısayolu, modu, tanımı, ön değeri)
array($name, $shortcut, $mode, $description, $defaultValue)
Seçenekler için, modu argümanı mode şunlardan biri olabilir: InputOption::VALUE_REQUIRED (Girdi Seçeneği: mecburi), InputOption::VALUE_OPTIONAL (isteğe bağlı), InputOption::VALUE_IS_ARRAY (dizi), InputOption::VALUE_NONE (yok).
VALUE_IS_ARRAY (Girdi Seçeneği: dizi) modu, komut çağırılırken, anahtarın birden çok kez kullanılabilir oldugunu belirtir:
php artisan falan --option=filan --option=fesmekan
VALUE_NONE (Girdi Seçeneği: yok) modu, seçeneğin sadece bir "anahtar" olarak kullanıldığını belirtir.
php artisan falan --option
Komutunuz çalışırken, uygulamanızın kabul edeceği argüman ve seçenek değerlerine ulaşabilmeniz gerekecektir. Bunu yapabilmek için argüman argument ve seçenek option yöntemlerini kullanabilirsiniz:
Bir Komut Argüman Değerinin Çağırılması
$value = $this->argument('ismi');
Tüm Argümanların Birden Çağırılması
$arguments = $this->argument();
Bir Komut Seçeneği Değerinin Çağırılması
$value = $this->option('ismi');
Tüm Seçeneklerin Birden Çağırılması
$options = $this->option();
Çıktının konsola gönderilmesi için, info (bilgi), comment (not), question (soru) ve error (hata) yöntemlerini kullanabilirsiniz. Bu yöntemlerin her biri, kendi amaçlarına uygun olan ANSI renklerini kullanacaktır.
Konsola Bilgi Gönderilmesi
$this->info('Bunu ekranda göster');
Konsola Bir Hata Mesajı Gönderilmesi
$this->error('Bir hata oluştu!');
Kullanıcıdan bir girdi talep etmek için, ask (sor) ve confirm (onayla) yöntemlerini kullanabilirsiniz.
Kullanıcıya Girdi Bilgisinin Soruluşu
$name = $this->ask('İsminiz nedir?');
Kullanıcıya Gizli Şifre Bilgisinin Soruluşu
$password = $this->secret('Lütfen şifrenizi giriniz!');
Kullanıcıya Onayının Soruluşu
if ($this->confirm('Devam etmek istiyor musunuz? [evet|hayır]'))
{
//
}
İsterseniz confirm (onayla) yöntemine, true (evet) ve false (hayır) seçeneklerinden birini varsayılan ön değer olarak belirleyebilirsiniz :
$this->confirm($soru, true);
Komutunuzun inşa edilmesi tamamlandığında, kullanılmaya hazır olabilmesi için, Artisan'da kayıt ettirmeniz gerekir. Bu, genelde app/start/artisan.php dosyası içerisinde yapılır. Bu dosya içerisinde, kayıt ettirmek için Artisan::add (Artisan::ekle) yöntemini kullanabilirsiniz.
Bir Artisan Komutunun Kayıt Ettirilişi
Artisan::add(new FalancaKomut);
Eğer komutunuz IoC container uygulamasında kayıtlı ise, Artisan'da da kullanılabilir olması için Artisan::resolve yöntemini kullanabilirsiniz.
IoC Container'da Olan Bir Komutun Kayıt Ettirilişi
Artisan::resolve('binding.ismi');
Bazı durumlarda, komtunuzun içerisinden diğer başka bir komutu çağırmak isteyebilirsiniz. Bunu, call (çağır) yöntemini kullanarak yapabilirsiniz:
Başka Bir Komutun Çağırılışı
$this->call('command.ismi', array('argument' => 'falan', '--option' => 'filan'));