<?xml version="1.0" encoding="utf-8"?>

<refentry xml:id="context.http" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" annotations="verify_info:false" role="stream_context_option">

<refnamediv>

<refname>HTTP bağlamı seçenekleri</refname>

<refpurpose>HTTP bağlamı seçeneklerinin listesi</refpurpose>

</refnamediv>

<refsect1 role="description">

&reftitle.description;

<para>

<literal>http://</literal> ve <literal>https://</literal> aktarımları için

bağlam seçenekleri.

</para>

</refsect1>

<refsect1 role="options"><!-- {{{ -->

&reftitle.options;

<para>

<variablelist>

<varlistentry xml:id="context.http.method">

<term>

<parameter>method</parameter>

<type>string</type>

</term>

<listitem>

<para>

Uzak sunucu tarafından desteklenen <constant>GET</constant>,

<constant>POST</constant> veya başka bir HTTP yöntemi.

</para>

<para>

<constant>GET</constant> öntanımlıdır.

</para>

</listitem>

</varlistentry>

<varlistentry xml:id="context.http.header">

<term>

<parameter>header</parameter>

<type>array</type> veya <type>string</type>

</term>

<listitem>

<para>

İstek sırasında gönderilecek ek başlıklar. Bu seçenekte belirtilen

değerler, ardından gelen <literal>Location:</literal>

yönlendirmelerinde bile, diğer değerleri geçersiz kılar

(<literal>User-agent:</literal>, <literal>Host:</literal>,

<literal>Authentication:</literal> gibi). Bu bakımdan,

<parameter>follow_location</parameter> etkinken

<literal>Host:</literal> başlığının atanması önerilmez.

</para>

</listitem>

</varlistentry>

<varlistentry xml:id="context.http.user-agent">

<term>

<parameter>user_agent</parameter>

<type>string</type>

</term>

<listitem>

<para>

<literal>User-Agent:</literal> başlığı ile gönderilecek değer. Bu değer

sadece, tarayıcı <literal>header</literal> seçeneği ile

belirtilmemişse kullanılır.

</para>

<para>

Öntanımlı olarak, &php.ini; dosyasındaki <link

linkend="ini.user-agent">user_agent</link> değeri kullanılır.

</para>

</listitem>

</varlistentry>

<varlistentry xml:id="context.http.content">

<term>

<parameter>content</parameter>

<type>string</type>

</term>

<listitem>

<para>

Başlıklardan sonra gönderilecek ek veri. Normalde POST veya PUT

istekleriyle kullanılır.

</para>

</listitem>

</varlistentry>

<varlistentry xml:id="context.http.proxy">

<term>

<parameter>proxy</parameter>

<type>string</type>

</term>

<listitem>

<para>

Vekil sunucunun adresini belirten URI

(<literal>tcp://vekil.example.com:5100</literal> gibi).

</para>

</listitem>

</varlistentry>

<varlistentry xml:id="context.http.request-fulluri">

<term>

<parameter>request_fulluri</parameter>

<type>bool</type>

</term>

<listitem>

<para>

&true; atanırsa, istek oluşturulurken URI'nin tamamı kullanılır

(<literal>GET http://example.com/dizin/yolu/dosya.html

HTTP/1.0</literal> gibi). Bu standart dışı bir istek biçimi olsa da

bazı vekil sunucular bunun böyle olmasını gerektirirler.

</para>

<para>

&false; öntanımlıdır.

</para>

</listitem>

</varlistentry>

<varlistentry xml:id="context.http.follow-location">

<term>

<parameter>follow_location</parameter>

<type>int</type>

</term>

<listitem>

<para>

<literal>Location</literal> başlık yönlendirmelerini izler.

İptal etmek için <literal>0</literal> atayın.

</para>

<para>

<literal>1</literal> öntanımlıdır.

</para>

</listitem>

</varlistentry>

<varlistentry xml:id="context.http.max-redirects">

<term>

<parameter>max_redirects</parameter>

<type>int</type>

</term>

<listitem>

<para>

İzlenecek yönlendirmelerin azami sayısı. <literal>1</literal> veya

daha az bir değer belirtilmesi hiçbir yönlendirmenin izlenmeyeceği

anlamına gelir.

</para>

<para>

<literal>20</literal> öntanımlıdır.

</para>

</listitem>

</varlistentry>

<varlistentry xml:id="context.http.protocol-version">

<term>

<parameter>protocol_version</parameter>

<type>float</type>

</term>

<listitem>

<para>

HTTP protokolünün sürümü.

</para>

<para>

PHP 8.0.0 itibariyle <literal>1.1</literal> öntanımlıdır, evvelce

<literal>1.0</literal> sürümü öntanımlıydı.

</para>

</listitem>

</varlistentry>

<varlistentry xml:id="context.http.timeout">

<term>

<parameter>timeout</parameter>

<type>float</type>

</term>

<listitem>

<para>

Bir <type>float</type> değer olarak saniye cinsinden okuma zaman aşımı.

(<literal>10.5</literal> gibi).

</para>

<para>

Öntanımlı olarak, &php.ini; dosyasındaki <link

linkend="ini.default-socket-timeout">default_socket_timeout</link>

yönergesinin değeri kullanılır.

</para>

</listitem>

</varlistentry>

<varlistentry xml:id="context.http.ignore-errors">

<term>

<parameter>ignore_errors</parameter>

<type>bool</type>

</term>

<listitem>

<para>

Başarısızlık durumu kodlarında bile içerik alınır.

</para>

<para>

&false; öntanımlıdır.

</para>

</listitem>

</varlistentry>

</variablelist>

</para>

</refsect1><!-- }}} -->

<refsect1 role="examples"><!-- {{{ -->

&reftitle.examples;

<para>

<example xml:id="context.http.example-post"><!-- {{{ -->

<title>- Bir sayfayı çekip veriyi POST ile göndermek</title>

<programlisting role="php">

</programlisting>

</example><!-- }}} -->

</para>

<para>

<example xml:id="context.http.example-fetch-ignore-redirect"><!-- {{{ -->

<title>- Başlıklar ve içerik alınırken yönlendirmeleri yoksaymak </title>

<programlisting role="php">

</programlisting>

</example><!-- }}} -->

</para>

</refsect1><!-- }}} -->

<refsect1 role="notes">

&reftitle.notes;

<note>

<title>Temel soket akımı bağlamı seçenekleri</title>

<simpara>

Ek bağlamsal seçenekler <link linkend="transports.inet">temel

aktarım</link> tarafından desteklenebilir. <literal>http://</literal>

akımları için <literal>tcp://</literal> aktarımının bağlamsal

seçeneklerine atıf yapılır. <literal>https://</literal> akımları için ise

<literal>ssl://</literal> aktarımının bağlamsal seçeneklerine atıf

yapılır.

</simpara>

</note>

<note>

<title>HTTP durum satırı</title>

<simpara>

Bu akım sarmalayıcı bir yönlendirmeyi izlerken

<function>stream_get_meta_data</function> tarafından döndürülen

<literal>wrapper_data</literal>, gerçekte <literal>0</literal> indisinde

içerik verisine uygulanan HTTP durum satırını içermeyebilir.

</simpara>

<screen>

</screen>

<simpara>

İlk istek <literal>301</literal> (kalıcı yönlendirme) ile döndü, dolayısıyla

akım sarmalayıcı otomatik olarak yönlendirmeyi izleyip bir

<literal>200</literal> yanıtı aldı (indis = <literal>4</literal>).

</simpara>

</note>

</refsect1>

<refsect1 role="seealso">

&reftitle.seealso;

<para>

<simplelist>

<member><xref linkend="wrappers.http" /></member>

<member><xref linkend="context.socket" /></member>

<member><xref linkend="context.ssl" /></member>

</simplelist>

</para>

</refsect1>

</refentry>