PHP 4.3.0 sürümünden beri, Komut Satırı Arayüzü anlamına gelen CLI isimli yeni bir SAPI türünü (Sunucu Uygulaması Yazılım Arayüzü) desteklemektedir. Adından da anlaşıldığı gibi, bu SAPI türünün ana odağı PHP ile kabuk (veya masaüstü) uygulamaları geliştirmektir. CLI SAPI'nin bu bölümde anlatılan diğer SAPI'lerden az bir farkı vardır. Söylemek gerekir ki, her ne kadar CLI ve CGI birçok aynı davranışı paylaşsa da farklı SAPI'lerdir.
CLI SAPI ilk kez PHP 4.2.0 ile dağıtıldı, fakat hala deneyseldi ve ./configure çalıştırılırken açıkça --enable-cli ile etkinleştirilmesi gerekiyordu. PHP 4.3.0'dan beri CLI SAPI deneysel değil ve --enable-cli öntanımlı olarak bulunmaktadır. Etkinliğini kaldırmak için --disable-cli kullanabilirsiniz.
PHP 4.3.0'dan beri, CLI/CGI çalıştırılabilirinin adı, yeri ve mevcudiyeti PHP'nin sisteminize nasıl kurulduğuna bağlı olarak değişecektir. make çalıştırıldığında öntanımlı olarak, hem CGI hem de CLI derlenir ve PHP kaynak ağacında sapi/cgi/php-cgi ve sapi/cli/php dizinlerine ayrı yerleştirilirler. Her ikisinin de adının php olduğunu farkedeceksiniz. make install çalıştırıldığında ne yaşanacağı yapılandırma satırınıza bağlıdır. Eğer yapılandırma sırasında apxs gibi bir SAPI modülü seçildiyse, veya --disable-cgi seçeneği kullanıldıysa, make install sırasında CLI {PREFIX}/bin/php dizinine kopyalanır, aksi takdirde buraya CGI yerleştirilir. Örneğin, --with--apxs yapılandırma satırınızda ise make install sırasında CLI {PREFIX}/bin/php dizinine kopyalanır. Eğer CGI kurulumunu etkisiz kılmak isterseniz, make install'dan sonra make install-cli kullanın. Ya da yapılandırma satırınızda --disable-cgi belirtebilirsiniz.
Bilginize: --enable-cli ve --enable-cgi öntanımlı olarak etkinleştirildiği için, yapılandırma satırınızda sadece --enable-cli olması CLI'nin make install sırasında {PREFIX}/bin/php dizinine kopyalanacağı anlamına gelmez.
PHP 4.2.0 ve PHP 4.2.3 arasındaki Windows paketlerinde CLI php-cli.exe olarak, CGI da aynı dizinde php.exe olarak dağıtılmıştır. PHP 4.3.0'la başlayarak Windows paketlerinde CLI, cli adlı farklı bir dizinde php.exe olarak dağıtılmıştır, böylece cli/php.exe olmuştur. PHP 5'le başlayarak, CLI ana dizinde php.exe adıyla dağıtılmıştır. CGI sürümü php-cgi.exe olarak dağıtılmaktadır.
PHP 5'den beri, php-win.exe isimli yeni bir dosya dağıtılmaktadır. Bu CLI sürümü ile aynıdır, fakat php-win herhangi çıktı vermez, bu nedenle konsol desteklemez (ekranda "dos penceresi" görünmez). Bu yaklaşım php-gtk ile benzerlik gösterir. --enable-cli-win32 ile yapılandırılması gerekir.
Bilginize: Bende hangi SAPI var?
Kabuktan, php -v yazımı php CGI mı CLI mi olduğunu söyler. Ayrıca php_sapi_name() işlevine ve PHP_SAPI sabitine bakınız.
Bilginize: PHP 4.3.2'de bir Unix kılavuz (man) sayfası eklendi. Bunu kabuk ortamınıza man php yazarak görüntüleyebilirsiniz.
CLI SAPI'nin diğer SAPI'lerden dikkate değer farklılıkları:
CGI SAPI'den farklı olarak, çıktıya hiçbir başlık yazılmaz.
CGI SAPI HTTP başlıklarını önlemek için bir yol sunsa da, CLI SAPI'de onları etkinleştirecek eşdeğer bir seçenek yoktur.
CLI öntanımlı olarak sessiz kipte başlar, -q ve --no-header seçenekleri eski CGI betiklerinin kullanımına uyumluluk için tutulmaktadır.
Çalışma dizinini betiğinki ile aynı yapmaz. (-C ve --no-chdir seçenekleri uyumluluk için tutulmaktadır)
Düz metin hata iletileri (HTML biçimlendirmesi yok).
Kabuk ortamında birşey ifade etmedikleri için CLI SAPI tarafından geçersiz kılınan bazı php.ini yönergeleri vardır:
Yönerge | CLI SAPI öntanımlı değeri | Yorum |
---|---|---|
html_errors | FALSE | Hata iletileri HTML etiketleri ile karıştırılmışken, kabukta bunları okumak oldukça zor olacağı için bu yönerge öntanımlı olarak FALSE değerlidir. |
implicit_flush | TRUE | print(), echo() ve arkadaşlarından gelen çıktıların önbellekte tutulmadan hemen çıktıya yazılması istenir. Eğer standart çıktıyı ertelemek veya işlemek isterseniz çıktı önbellekleme kullanabilirsiniz. |
max_execution_time | 0 (sınırsız) | Kabuk ortamlarında PHP kullanımının sonsuz olasılığı olduğu için, azami işletim süresi sınırsız olarak belirtilmiştir. HTML üretmek için yazılan uygulamalar genellikle çok çabuk işletilse de, kabuk uygulamaları daha fazla işletim zamanı harcama eğilimindedirler. |
register_argc_argv | TRUE |
Bu ayar TRUE olduğu için CLI SAPIdeki argc (uygulamaya aktarılan değiştirge sayısı) ve argv (gerçek değiştirgeler dizisi) değerlerine her zaman erişebilirsiniz. PHP 4.3.0'dan beri, CLI SAPI kullanırken $argc ve $argv PHP değişkenleri uygun değerlerle doldurulur ve kaydedilir. Bu sürümden önce, bu değişkenlerin yaratılışı register_globals PHP yönergesi değerinin on olmasını gerektiren CGI ve modül sürümlerindeki gibi davranırdı. Sürüme ve register_globals ayarına bakmaksızın $_SERVER veya $HTTP_SERVER_VARS üzerinden kullanabilirsiniz. Örnek: $_SERVER['argv'] |
Bilginize: Bu yönergeler php.ini yapılandırma dosyasından başka bir değerle ilklendirilemezler. Bu bir sınırlamadır çünkü bu öntanımlı değerler bütün yapılandırma dosyaları çözümlendikten sonra uygulanırlar. Fakat, çalışma anında bunların değerleri değişirilebilir (bu yönergeler için birşey ifade etmez, örn. register_argc_argv).
Kabuk ortamında kolay çalışmak için aşağıdaki sabitler tanımlanmıştır:
Sabit | Açıklama |
---|---|
STDIN |
stdin'e açılmış bir akımdır. Aşağıdaki örnek akımı açıp geleni kaydeder:
<?php Eğer stdin'den tek satır okumak istenirse şu kullanılabilir:
<?php
|
STDOUT | stdout'a açılmış bir akımdır. Aşağıdaki örnek akımı açıp gideni kaydeder:
<?php
|
STDERR |
stderr'e açılmış bir akımdır. Aşağıdaki örnek akımı açıp çıktıyı kaydeder:
<?php
|
Yukarıda verilene göre, örneğin stderr için bir akım açmanız gerekmez, ancak akım kaynağı yerine sabit kullanabilirsiniz:
php -r 'fwrite(STDERR, "stderr\n");'
Betik sonlandığında PHP özdevinimli olarak akımları kapattığı için sizin ayrıca kapatmanız gerekmez.
Bilginize: Bu sabitler, PHP betiğinin stdin'den okunması halinde mevcut değildir.
CLI SAPI geçerli dizini betiğin işletildiği dizine değiştirmez!
CGI SAPI farkını gösteren örnek:
<?php
// deneme.php isimli basit deneme uygulamamız
echo getcwd(), "\n";
?>
CGI sürümününü kullanınca, çıktı şöyle olur:
$ pwd /tmp $ php -q bir_dizin/deneme.php /tmp/bir_dizin
Bu açıkça gösteriyor ki PHP geçerli dizinini betiğin çalıştığı dizine değiştiriyor.
CLI SAPI kullanımı sonucu:
$ pwd /tmp $ php -f bir_dizin/deneme.php /tmp
Bu, PHP'de kabuk araçları yazarken daha fazla esneklik imkanı verir.
Bilginize: CGI SAPI bu CLI SAPI davranışını komut satırından çalışırken -C seçeneği ile destekler.
PHP çalıştırılabiliri tarafından desteklenen komut satırı seçenekleri listesi istenirse PHP -h seçeneği ile çalıştırılarak sorgulanabilir:
Kullanım: php [seçenekler] [-f] <dosya> [--] [değiştirgeler...] php [seçenekler] -r <kod> [--] [değiştirgeler...] php [seçenekler] [-B <başlangıç_kodu>] -R <kod> [-E <bitiş_kodu>] [--] [değiştirgeler...] php [seçenekler] [-B <başlangıç_kodu>] -F <dosya> [-E <bitiş_kodu>] [--] [değiştirgeler...] php [seçenekler] -- [değiştirgeler...] php [seçenekler] -a -a Etkileşimli çalışır -c <yol>|<dosya> php.ini dosyası bu dizinde aranır -n Hiçbir php.ini dosyası kullanılmayacak -d foo[=bar] 'bar' değerli bir foo INI girdisi tanımlar -e Hata ayıklayıcı/profilci için genişletilmiş bilgi üretir -f <dosya> <dosya>'yı çözümler ve çalıştırır -h Bu yardım iletisini gösterir -i PHP bilgisi -l Sadece söz dizimi denetimi (lint) -m Modül olarak derlenenleri gösterir -r <kod> PHP <kod>unu <?..?> betik etiketleri olmadan çalıştırır -B <başlangıç_kodu> PHP <başlangıç_kodu>nu girdi satırlarından önce çalıştırır -R <kod> PHP <kod>unu her girdi satırı için çalıştırır -F <dosya> Her girdi satırı için <dosya>yı çözümler ve çalıştırır -E <bitiş_kodu> PHP <bitiş_kodu>nu bütün girdi satırlarını işledikten sonra çalıştırır -H Harici araçlardan aktarılan bütün değiştirgeleri gizler -s Kaynağı renklendirilmiş söz dizimi ile gösterir -v Sürüm bilgilerini gösterir -w Kaynağı boşluklar ve yorumlardan arındırılmış olarak gösterir -z <dosya> <dosya> Zend eklentisini yükler değiştirgeler... Betiğe aktarılan değiştirgeler. Eğer betik stdin'den okunuyorsa veya ilk değiştirge - ile başlıyorsa -- değiştirgeler kullanın --ini Yapılandırma dosyası isimlerini gösterir --rf <isim> <isim> işlevi hakkında bilgi gösterir --rc <isim> <isim> sınıfı hakkında bilgi gösterir --re <isim> <isim> eklentisi hakkında bilgi gösterir --ri <isim> <isim> eklentisi için yapılandırmayı gösterir
CLI SAPI çalıştırmak istediğiniz PHP kodunu getirmek için üç farklı yola sahiptir:
PHP'ye belli bir dosyayı çalıştırmasını söyleyerek.
php ornek_betik.php php -f ornek_betik.php
Her iki yolla da (-f seçeneğini olsun olmasın) ornek_betik.php dosyası çalıştırılır. Çalıştırmak için herhangi bir dosyayı seçebilirsiniz - PHP betikleriniz .php uzantısı ile bitmek zorunda değildir, istediğiniz herhangi bir isim ve uzantıya sahip olabilirler.
Bilginize: Eğer betiklerinize değiştirgeler aktarmanız gerekirse -f seçeneğini kullandığınızda ilk değiştirge olarak -- aktarmanız gerekir.
Doğrudan komut satırında işletmek üzere PHP kodunu aktararak.
php -r 'print_r(get_defined_constants());'
Kabuk değişken değişimi ve tırnak kullanımı için özel bir çaba sarfetmek gerekir.
Bilginize: Örneği dikkatle okuyunuz, hiçbir başlangıç veya bitiş etiketi yok! -r seçeneği bunlara ihtiyaç duymaz. Bunların kullanımı çözümleme hatasına yol açar.
Çalıştırılacak PHP kodunu standart girdiden (stdin) yollamak suretiyle.
Bu, PHP kodunu devingen olarak oluşturma ve bunu çalıştırma yeteneği sağlar. Örneğin:
$ bir_uygulama | bir_suzgec | php | sort -u > nihai_sonuc.txt
Kodu çalıştırmak için bu üç yol birlikte kullanılamaz.
Her kabuk uygulamasındaki gibi, PHP çalıştırılabiliri bir takım değiştirgeler alabildiği gibi PHP betiğiniz de değiştirgeler alabilir. Betiğinize aktarabileceğiniz değiştirge sayısı PHP tarafından sınırlandırılmamıştır (kabukta aktarılabilecek karakter sayısı sınırlıdır; genellikle bu sınıra ulaşmazsınız). Betiğinize aktarılan değiştirgeler $argv küresel dizisinde bulunur. Sıfır indisi her zaman betik adını içerir (PHP kodu standart girdiden veya -r komut satırı seçeneğiyle çalıştıysa betik adı - olur). İkinci kayıtlı küresel değişken $argc'dir ve $argv dizisindeki eleman sayısını içerir (betiğe aktarılan değiştirge sayısını değil).
Betiğinize aktarmak istediğiniz değiştirgeler - karakteriyle başlamadığı sürece, özel bir şeye dikkat etmeniz gerekmez. Betiğinize - ile başlayan bir değiştirge aktarımı sorun yaratır çünkü PHP bunu kendisinin işlemesi gerektiğini düşünecektir. Bunu önlemek için, değiştirge listesi ayracı olan -- kullanın, bunu izleyen her değiştirge ellenmeden betiğinize aktarılır.
# Bu verilen kodu çalıştırmaz fakat PHP kullanımını gösterir $ php -r 'var_dump($argv);' -h Usage: php [options] [-f] <file> [args...] [...] # Bu '-h' değiştirgesini betiğinize aktarır ve # PHP'nin değiştirgeyi görmesini önler $ php -r 'var_dump($argv);' -- -h array(2) { [0]=> string(1) "-" [1]=> string(2) "-h" }
Kabuk betikleri için PHP farklı bir yoldan kullanılabilir. İlk satırı #!/usr/bin/php ile başlayan bir betik yazabilirsiniz. Bunu takip eden satırlara başlangıç ve bitiş etiketlerine sahip normal PHP kodunuzu yerleştirebilirsiniz. Dosyanın çalıştırma izinlerini ayarladığınızda (örn. chmod +x deneme) betiğiniz normal bir kabuk veya perl betiği gibi işletilir.
Örnek 1 - PHP betiğini kabuk betiği olarak çalıştırmak
#!/usr/bin/php
<?php
var_dump($argv);
?>
Geçerli dizindeki bu dosyanın isminin deneme olduğunu varsayarsak, aşağıdakini yapabiliriz:
$ chmod +x deneme $ ./deneme -h -- foo array(4) { [0]=> string(6) "./deneme" [1]=> string(2) "-h" [2]=> string(2) "--" [3]=> string(3) "foo" }
Gördüğünüz gibi, bu durumda betiğinize - ile başlayan değiştirge aktarırken hiçbir şeye dikkat etmeniz gerekmez.
Uzun seçenekler PHP 4.3.3'den beri mevcuttur.
Seçenek | Uzun Seçenek | Açıklama |
---|---|---|
-a | --interactive |
PHP'yi etkileşimli çalıştırır. Eğer PHP'yi Readline eklentisi ile derlerseniz (Windows'ta yoktur), tamamlama özelliği olan (örneğin bir değişken adını yazmaya başlayıp TAB tuşuna basınca PHP adı tamamlar), ok tuşlarıyla erişebileceğiniz bir komut satırı geçmişi olan güzel bir kabuğunuz olur. Komut satırı geçmişi ~/.php_history dosyasında saklanır.
|
-c | --php-ini |
Bu seçenek php.ini dosyasının aranacağı dizini veya özel bir INI dosyasını (adı php.ini olmak zorunda değildir) belirtebilir. Örneğin: $ php -c /ozel/dizin/ ornek_betik.php $ php -c /ozel/dizin/ozel-dosya.ini ornek_betik.php Eğer bu seçeneği belirtmezseniz, dosya öntanımlı dizinlerde aranır. |
-n | --no-php-ini |
php.iniyi görmezden gel. Bu seçenek PHP 4.3.0'dan beri vardır. |
-d | --define |
Bu seçenek php.inide izin verilen yapılandırma yönergelerinden herhangi birine özel değer atamanıza imkan verir. Söz dizimi: -d ayar_yönergesi[=değer] Örnekler (satırlar okunabilirlik açısından kaydırılmıştır): # Değer kısmını atlamak yapılandırma yönergesini "1" yapar $ php -d max_execution_time -r '$foo = ini_get("max_execution_time"); var_dump($foo);' string(1) "1" # Boş değer aktarınca yapılandırma yönergesinine "" atanır php -d max_execution_time= -r '$foo = ini_get("max_execution_time"); var_dump($foo);' string(0) "" # Yapılandırma yönergesine '=' karakterinden sonra aktarılan değer atanır $ php -d max_execution_time=20 -r '$foo = ini_get("max_execution_time"); var_dump($foo);' string(2) "20" $ php -d max_execution_time=herhangi_bir_sey -r '$foo = ini_get("max_execution_time"); var_dump($foo);' string(15) "herhangi_bir_sey" |
-e | --profile-info |
Hata ayıklayıcı/profilci için kullanılmak üzere genişletilmiş bilgi kipini etkinleştirir. |
-f | --file |
-f seçeneğiyle verilen dosya adını çözümler ve çalıştırır. Bu seçenek isteğe bağlıdır; verilmese de olur. Sadece çalıştırılacak dosya adını belirtmek yeterlidir.
|
-h ve -? | --help ve --usage | Bu seçenekle, komut satırı seçenekleri tek satırlık açıklamalarıyla listelenir. |
-i | --info | Bu komut satırı seçeneği phpinfo() işlevini çağırır ve sonuçları yazdırır. Eğer PHP doğru çalışmıyorsa, php -i komutunu kullanmanız ve bilgi tablolarından önce herhangi bir hata iletisi yazdırılmış mı bakmanız tavsiye edilir. CGI kipini kullanırken çıktının HTML biçiminde olacağına ve bu nedenle çok büyük olacağına dikkat ediniz. |
-l | --syntax-check |
Bu seçenek verilen PHP kodunun sadece söz dizimini denetlemek için uygun bir yol sağlar. Başarı halinde, No syntax errors detected in <filename> metni standart çıktıya yazılır ve kabuk dönüş kodu 0 olur. Başarısızlık halinde, iç çözümleyici hatasına ilaveten Errors parsing <filename> metni standart çıktıya yazılır ve kabuk dönüş kodu -1 olur. Bu seçenek ölümcül hataları bulamaz (tanımlanmamış işlevler gibi). Eğer ölümcül hataları da denetlemek isterseniz -f seçeneğini kullanın.
|
-m | --modules |
Bu seçeneğin kullanımı ile PHP yerleşik (ve yüklü) PHP ve Zend modüllerini listeler: $ php -m [PHP Modules] xml tokenizer standard session posix pcre overload mysql mbstring ctype [Zend Modules] |
-r | --run |
Bu seçenek PHP'nin komut satırından çalıştırılmasına izin verir. PHP başlangıç ve bitiş etiketleri (<?php ve ?>) gerekmez ve eğer bulunurlarsa çözümleme hatasına neden olurlar.
|
-B | --process-begin |
Standart girdi işlenmeden çalıştırılacak PHP kodudur. PHP 5'de eklenmiştir. |
-R | --process-code |
Her girdi satırı için işletilecek PHP kodudur. PHP 5'de eklenmiştir. Bu kipte iki özel değişken bulunur: $argn ve $argi. $argn PHP'nin o anda işlediği satırı içerirken, $argi satır numarasını içerir. |
-F | --process-file |
Her girdi satırı için işletilecek PHP dosyasıdır. PHP 5'de eklenmiştir. |
-E | --process-end |
Girdi işlendikten sonra işletilecek PHP kodudur. PHP 5'de eklenmiştir. Örnek 2 - Bir projedeki satır sayısını saymak için -B, -R ve -E seçeneklerinin kullanımı $ find projem | php -B '$l=0;' -R '$l += count(@file($argn));' -E 'echo "Toplam Satır Sayısı: $l\n";' Toplam Satır Sayısı: 37328 |
-s | --syntax-highlight ve --syntax-highlighting |
Renklendirilmiş söz dizimi ile kaynak gösterimi. Bu seçenek dosyayı çözümlemek için içsel yöntemleri kullanır ve renklendirilmiş bir HTML sürümü üreterek standart çıktıya yazar. Bütün yaptığı HTML başlıkları olmadan <code> [...] </code> HTML etiketlerinden oluşan bir blok üretmektir.
|
-v | --version |
PHP, PHP SAPI ve Zend sürümlerini standart çıktıya yazar. Örneğin: $ php -v PHP 5.3.0alpha3-dev (cli) (built: Nov 13 2008 18:20:00) Copyright (c) 1997-2008 The PHP Group Zend Engine v2.3.0, Copyright (c) 1998-2008 Zend Technologies |
-w | --strip |
Kaynağı boşluklar ve yorumlardan arındırılmış olarak gösterir.
|
-z | --zend-extension |
Zend eklentisini yükler. Eğer sadece dosya ismi verilirse, PHP bu eklentiyi sisteminizde geçerli öntanımlı kütüphane yolundan yüklemeye çalışır (Linux sistemlerde genellikle /etc/ld.so.conf dosyasında belirtilir). Dosya adı tam yol bilgisi ile aktarılırsa sistem kütüphanesi arama yolu kullanılmaz. Bir dizin bilgisiyle göreceli bir dosya ismi kullanımı PHP'ye sadece geçerli dizine göreceli eklentinin yüklenmesini söyler. |
--ini |
Yapılandırma dosya isimlerini ve taranan dizinleri gösterir. PHP 5.2.3'den beri mevcuttur. Örnek 3 --ini örneği $ php --ini Configuration File (php.ini) Path: /usr/dev/php/5.2/lib Loaded Configuration File: /usr/dev/php/5.2/lib/php.ini Scan for additional .ini files in: (none) Additional .ini files parsed: (none)
|
|
--rf | --rfunction |
Verilen işlev veya sınıf yöntemi hakkında bilgi gösterir (örneğin, değiştirge adlarını ve sayısını). PHP 5.1.2'den beri vardır. Bu seçenek sadece PHP Reflection desteği ile derlendiyse mevcuttur.
Örnek 4 - Temel --rf kullanımı $ php --rf var_dump Function [ <internal> public function var_dump ] { - Parameters [2] { Parameter #0 [ <required> $var ] Parameter #1 [ <optional> $... ] } }
|
--rc | --rclass |
Verilen sınıf hakkında bilgi gösterir (sabitler, özellikler ve yöntemler listesi). PHP 5.1.2'den beri vardır. Bu seçenek sadece PHP Reflection desteği ile derlendiyse mevcuttur.
Örnek 5 --rc örneği $ php --rc Directory Class [ <internal:standard> class Directory ] { - Constants [0] { } - Static properties [0] { } - Static methods [0] { } - Properties [0] { } - Methods [3] { Method [ <internal> public method close ] { } Method [ <internal> public method rewind ] { } Method [ <internal> public method read ] { } } }
|
--re | --rextension |
Verilen eklenti hakkında bilgi gösterir (php.ini seçenekleri, tanımlı işlevler, sabitler ve sınıflar listesi). PHP 5.1.2'den beri vardır. Bu seçenek sadece PHP Reflection desteği ile derlendiyse mevcuttur.
Örnek 6 --re örneği $ php --re json Extension [ <persistent> extension #19 json version 1.2.1 ] { - Functions { Function [ <internal> function json_encode ] { } Function [ <internal> function json_decode ] { } } }
|
--ri | --rextinfo |
Verilen eklenti için yapılandırma bilgisini gösterir (phpinfo() ile aynı bilgiyi döndürür). PHP 5.2.2'den beri vardır. Çekirdek yapılandırma bilgisi "main" eklenti adı kullanılarak bulunabilir.
Örnek 7 --ri örneği $ php --ri date date date/time support => enabled "Olson" Timezone Database Version => 2008.9 Timezone Database => internal Default timezone => Europe/Helsinki Directive => Local Value => Master Value date.timezone => no value => no value date.default_latitude => 31.7667 => 31.7667 date.default_longitude => 35.2333 => 35.2333 date.sunset_zenith => 90.583333 => 90.583333 date.sunrise_zenith => 90.583333 => 90.583333
|
PHP çalıştırılabiliri HTTP sunucusundan tamamen bağımsız olarak PHP betikleri çalıştırmak için kullanılabilir. Eğer Unix sistemi üzerindeyseniz, PHP betiğinizin başına özel bir satır eklemeli ve dosyanızı çalıştırılabilir yapmalısınız; böylece sistem betiğinizi hangi programın çalıştıracağını bilir. Windows üzerinde .php dosyalarına çift tıklama seçeneği ile php.exe ilişkilendirebilir veya betiği PHP üzerinden çalıştıracak bir yığın dosyası yapabilirsiniz. Unix'de çalışması için betiğe eklenen ilk satır Windows'da sorun çıkarmaz, böylece platformdan bağımsız programlar yazabilirsiniz. Örnek basit bir komut satırı PHP programı aşağıdaki gibi olabilir.
Örnek 8 - Komut satırından çalıştırılması planlanan betik (betik.php)
#!/usr/bin/php
<?php
if ($argc != 2 || in_array($argv[1], array('--help', '-help', '-h', '-?'))) {
?>
Bu tek seçenekli bir komut satırı PHP betiğidir.
Kullanımı:
<?php echo $argv[0]; ?> <secenek>
<secenek> yazdırmak istediğiniz bir kelime olabilir.
--help, -help, -h,
veya -? seçenekleriyle, bu yardımı alabilirsiniz.
<?php
} else {
echo $argv[1];
}
?>
Yukarıdaki betikte, bu dosyanın PHP tarafından çalıştırılması gerektiğini belirten özel bir ilk satır kullandık. Burada CLI sürümü ile çalışıyoruz, böylece HTTP başlık çıktıları olmayacak. PHP ile komut satırı uygulamaları yazarken kullanabileceğiniz iki değişken vardır: $argc ve $argv. Birincisi değiştirge sayısından bir fazlasıdır (çalışan betiğin adı). İkincisi değiştirgeleri içeren bir dizidir, sıfır numarayla başlar ve ilk elemanında betik adını içerir ($argv[0]).
Yukarıdaki programda birden farklı sayıda değiştirge olup olmadığını kontrol ettik. Ayrıca eğer değiştirge --help, -help, -h veya -? ise yardım iletisini yazdırdık ve betik adını devingen olarak yazdırdık. Eğer bazı başka değiştirgeler aldıysak yazdırdık.
Eğer yukarıdaki betiği Unix üzerinde çalıştırmak isterseniz betiği çalıştırılabilir yapmalı ve betik.php echothis veya betik.php -h ile çağırmalısınız. Windows'da bu iş için bir yığın dosyası yapabilirsiniz:
Örnek 9 - Bir komut satırı PHP betiği çalıştırmak için yığın dosyası (betik.bat)
@echo OFF "C:\php\php.exe" script.php %*
Yukarıdaki programı betik.php olarak adlandırdığınız ve C:\php\php.exe içinde CLI'nin php.exe olduğu varsayılarak bu yığın dosyası sizin eklediğiniz seçeneklerle çalışacaktır: betik.bat echothis veya betik.bat -h.
PHP'deki komut satırı uygulamalarını iyileştirmek için kullanabileceğiniz işlevlerle ilgili bilgi için Readline eklentisinin belgesine bakınız.
Windows üzerindeyseniz PHP, Command Line PHP on Microsoft Windows bölümünde açıklandığı gibi .php uzantısına veya C:\php\php.exe çalıştırılabilirinin belirtilmesine gerek kalmadan çalıştırılmak üzere yapılandırılabilir.