PHP 伪协议 php:// 用法详解与官方手册解析

PHP I/O Akışları: Kapsamlı Bir Kıla vuz

PHP, geliştiricilere dosya sistemleri ve ağ bağlantılarıyla çalışmanın ötesinde, çeşitli girdi/çıktı kaynaklarıyla etkileşim kurmak için güçlü bir araç seti sunar. Bu araçlar, PHP'nin kendi standart giriş/çıkış akışlarından, bellek tabanlı geçici depolamaya kadar uzanır. Hadi, bu "php://" protokolleri altındaki akışları birlikte inceleyelim.

php://stdin, php://stdout ve php://stderr

Bu üçlü, PHP sürecinin doğrudan standart girdi (stdin), çıktı (stdout) ve hata (stderr) akışlarına erişim sağlar. Aslında bu akışlar, mevcut dosya tanıtıcılarının birer kopyasına referans verir. Bu nedenle, örneğin `php://stdin`'i açıp kapatmanız, yalnızca o kopyayı etkiler; gerçek STDIN akışı aynı kalır. Burada küçük bir not düşmekte fayda var: PHP 5.2.1 ve öncesi sürümlerde bu da vranışta tutarsızlıklar olabiliyordu. Pratikte, bu sarmalayıcıları manuel olarak açmak yerine, doğrudan `STDIN`, `STDOUT` ve `STDERR` sabitlerini kullanmanız daha temiz ve önerilen bir yoldur. Erişim türlerine gelince: `php://stdin` salt okunurken, `php://stdout` ve `php://stderr` salt yazılır durumdadır.

php://input

`php://input`, HTTP isteğinin gövdesindeki ham veriyi okumanıza olanak tanıyan salt okunur bir akıştır. POST isteklerinde, `$HTTP_RAW_POST_DATA` küresel değişkenine kıyasla önemli a vantajlar sunar. Neden mi? Çünkü `php://input`'un da vranışı `php.ini` dosyasındaki özel yönergelere bağlı değildir. Ayrıca, `always_populate_raw_post_data` yönergesini etkinleştirmeye kıyasla daha az bellek tüketen bir seçenektir. Ancak dikkat: Bu akış, `enctype="multipart/form-data"` ile gönderilen form verileri için kullanılamaz.

php://output

`php://output`, çıktı tamponlaması mekanizmasına doğrudan yazma yapmanızı sağlayan salt yazılır bir akıştır. Bu, özellikle çıktıyı özelleştirilmiş bir şekilde işlemek veya doğrudan tampona müdahale etmek istediğiniz senaryolarda kullanışlıdır.

php://fd

`php://fd` protokolü, size açık olan belirli bir dosya tanıtıcısına doğrudan erişim hakkı verir. Sözdizimi oldukça basittir: Örneğin, `php://fd/3` ifadesi, dosya tanıtıcı numarası 3'ü ifade eder.

php://memory ve php://temp

Bu ikili, geçici verileri dosya benzeri bir arayüzle depolamak için tasarlanmış okuma-yazma akışlarıdır. Peki aralarındaki fark ne? Temel fark, depolama stratejilerinde yatar. `php://memory` akışı, verilerini her zaman ve tamamen bellekte tutar. `php://temp` ise daha esnek bir yaklaşım sergiler: Bellekte depolanan veri miktarı önceden tanımlanmış bir sınıra (öntanımlı olarak 2 MB) ulaşana kadar bellekte çalışır; bu sınır aşıldığında ise otomatik olarak sunucuda geçici bir dosya oluşturup kullanmaya başlar. Bu sınırı, `php://temp/maxmemory:NN` şeklinde bir yol belirterek özelleştirebilirsiniz; burada `NN`, geçici dosyaya düşmeden önce kullanılacak maksimum bellek miktarını bayt cinsinden belirtir.

php://filter

`php://filter`, belki de en güçlü ve benzersiz akış türüdür. Bir "meta sarmalayıcı" olarak tasarlanmıştır ve asıl amacı, bir akış açılırken üzerine anında süzgeçler (filters) uygulamaktır. Bu ne işe yarar? Diyelim ki `file_get_contents()` veya `fopen()` gibi, akışın içeriğini okumadan önce süzgeç uygulama şansınız olmayan fonksiyonlarla çalışıyorsunuz. İşte `php://filter` tam da burada devreye girerek, akış kaynağının yolunun bir parçası olarak süzgeç zincirleri tanımlamanıza izin verir. Tek bir yolda, boru (`|`) karakteriyle ayırarak birden fazla süzgeci zincirleme şekilde belirtebilirsiniz. Kullanım detayları için resmi dokümanlardaki örnekler oldukça aydınlatıcıdır.

php://filter Seçenekleri

Seçenek: resource=
Bu seçenek zorunludur. Hangi akışın süzüleceğini belirtir.

Seçenek: read=
Bu seçenek isteğe bağlıdır. Okuma işlemi için uygulanacak bir veya daha fazla süzgeci belirtir. Süzgeçler boru (`|`) karakteri ile ayrılır.

Seçenek: write=
Bu seçenek isteğe bağlıdır. Yazma işlemi için uygulanacak bir veya daha fazla süzgeci belirtir. Süzgeçler boru (`|`) karakteri ile ayrılır.

Önemli bir not: Eğer `read=` veya `write=` ön ekleri olmadan, doğrudan bir süzgeç listesi belirtirseniz, bu liste uygun olduğu durumlarda hem okuma hem de yazma zincirlerine aynı anda uygulanır.