PHP Dilinde Akış Bağlamı Seçenekleri ve Bağımsız Değişkenleri ile Gelişmiş Kontrol

PHP geliştiricileri için harici kaynaklarla etkileşim, genellikle dosya sisteminden veri okuma, ağ istekleri yapma veya özel protokollere erişim gibi işlemleri içerir. Bu tür işlemlerin davranışını detaylı bir şekilde kontrol etmek, özellikle ağ isteklerinde zaman aşımı, kimlik doğrulama, vekil sunucu ayarları gibi özelleştirmeler yapmak kritik öneme sahiptir. PHP'nin bağlam (context) mekanizması, bu etkileşimleri yapılandırmak için güçlü ve esnek bir yol sunar. Bağlamlar, bir akış (stream) işlemi sırasında kullanılacak protokole özgü seçenekleri ve kullanıcı tanımlı bağımsız değişkenleri (parameters) bir araya getiren bir kapsayıcı görevi görür. Bu makale, PHP'de bağlam seçeneklerinin ve bağımsız değişkenlerinin nasıl tanımlandığını ve kullanıldığını detaylı bir şekilde inceleyecektir.

Sözdizimi

PHP'de bir bağlam oluşturmak ve yapılandırmak için başlıca iki fonksiyon kullanılır: stream_context_create() ve stream_context_set_option(). Bağımsız değişkenleri (parameters) ayarlamak için ise stream_context_set_params() fonksiyonu mevcuttur.

Bağlam Oluşturma:

$context = stream_context_create(
    array $options = [],
    array $params = []
);

Seçenek Ayarlama:

bool stream_context_set_option(
    resource $context,
    string $wrapper,
    string $option,
    mixed $value
);

// Alternatif olarak, stream_context_create() sırasında da ayarlanabilir:
// $context = stream_context_create([
//     'wrapper' => [
//         'option' => 'value'
//     ]
// ]);

Bağımsız Değişken Ayarlama:

bool stream_context_set_params(
    resource $context,
    array $params
);

Detaylı Açıklama

PHP'deki akış bağlamları, belirli bir akış işlemi sırasında davranışını değiştirmek için kullanılan anahtar-değer çiftlerinden oluşan koleksiyonlardır.

Bağlam Oluşturma ve Seçenekler

stream_context_create() fonksiyonu, yeni bir akış bağlamı kaynağı (resource) döndürür. Bu fonksiyon, isteğe bağlı olarak iki dizi parametresi alır:

• $options: Bu dizi, çeşitli akış sarmalayıcıları (wrapper) için protokole özgü seçenekleri içerir. Yapısı ['wrapper_adı' => ['seçenek_adı' => 'değer']] şeklindedir.

• $params: Bu dizi, bağlam için kullanıcı tanımlı bağımsız değişkenleri içerir. Genellikle bir bağlamın yaşam döngüsü boyunca bir akışa özel veri veya geri çağırma fonksiyonları (callback functions) eklemek için kullanılır.

Seçenekler (Options):

Seçenekler, belirli bir sarmalayıcının (wrapper) davranışını özelleştirmek için kullanılır. Örneğin, http:// sarmalayıcısı için zaman aşımı (timeout), kullanıcı aracısı (user agent) veya HTTP başlıkları gibi ayarlar yapılabilir. Her sarmalayıcının desteklediği seçenekler farklıdır. Yaygın olarak kullanılan bazı sarmalayıcılar ve seçenek kategorileri şunlardır:

• http / https: method, header, user_agent, timeout, proxy, follow_location, content vb.

• ftp: overwrite, resume_pos, timeout vb.

• file: throw_exceptions (PHP 8.0+)

• ssl: verify_peer, cafile, local_cert, passphrase vb.

stream_context_set_option() fonksiyonu, mevcut bir bağlama tek bir seçenek eklemek veya değiştirmek için kullanılır. Parametreleri şunlardır:

• $context: Seçeneğin ekleneceği veya değiştirileceği bağlam kaynağı.

• $wrapper: Seçeneğin ait olduğu akış sarmalayıcısının adı (örneğin, 'http' veya 'ssl').

• $option: Ayarlanacak seçeneğin adı (örneğin, 'timeout' veya 'method').

• $value: Seçeneğin değeri.

Bağımsız Değişkenler (Parameters)