За что отвечает функция headers

7

HTTP Headers для "чайников"

Являетесь вы программистом или нет, вы видели его повсюду в Интернете. На данный момент в адресной строке браузера отображается нечто, что начинается с «https: //». Даже ваш первый скрипт Hello World отправил HTTP-header без вашего понимания. В этой статье мы собираемся узнать об основах HTTP-заголовков и о том, как их можно использовать в наших веб-приложениях.

Что такое HTTP Headers?

HTTP значит «Hypertext Transfer Protocol» (Протокол передачи гипертекста). Всемирная паутина использует этот протокол. Он был создан в начале 1990-х годов. Почти всё, что вы видите в вашем браузере, передаётся на ваш компьютер через HTTP. Например, когда вы открыли страницу этой статьи, ваш браузер отправил более 40 HTTP-запросов и получил HTTP-ответы для каждого из них.

Заголовки HTTP являются основной частью этих HTTP-запросов и ответов, и они несут информацию о браузере клиента, запрошенной странице, сервере и многом другом.

Пример

Когда вы вводите URL-адрес в адресной строке, ваш браузер отправляет HTTP-запрос, и он может выглядеть так:

Первая строка — это «Request Line», которая содержит некоторую базовую информацию по запросу. Остальные — HTTP заголовки.

После этого запроса ваш браузер получает ответ HTTP, который может выглядеть так:

Первая строка — это «Строка состояния», за которой следуют «HTTP-заголовки», до пустой строки. После этого начинается «содержимое» (в данном случае — HTML вывод).

Когда вы смотрите на исходный код веб-страницы в своём браузере, вы видите только часть HTML, а не заголовки HTTP, хотя они фактически были переданы вместе.

Эти HTTP-запросы также отправляются и принимаются для других вещей, таких как изображения, CSS-файлы, файлы JavaScript и т. д. Именно поэтому я сказал ранее, что ваш браузер отправил не менее 40 или более HTTP-запросов, поскольку вы загрузили только эту страницу статьи.

Теперь давайте рассмотрим структуру более подробно.

Как увидеть HTTP Headers

Для анализа HTTP-заголовков я использую следующие расширения Firefox:

• getallheaders() получает запросы headers. Вы можете использовать массив $_SERVER.
• headers_list() получает отзывы headers.

Далее в этой статье мы увидим примеры кода в PHP.

Структура запроса HTTP

Первая строка HTTP-запроса называется линией запроса и состоит из трёх частей:

• «method» указывает, какой это запрос. Наиболее распространённые методы GET, POST и HEAD.
• «path» , как правило, является частью URL-адреса, который идёт после host (домена). Например, если запрос «https://net.tutsplus.com/tutorials/other/top-20-mysql-best-practices/» , часть path будет «/tutorials/other/top-20-mysql-best-practices/».
• Часть «protocol» содержит «HTTP» и версию, которая обычно 1.1 в современных браузерах.

Остальная часть запроса содержит HTTP headers как пары «Name: Value» в каждой строке. Они содержат различную информацию о HTTP-запросе и вашем браузере. Например, строка «User-Agent» предоставляет информацию о версии браузера и операционной системе, которую вы используете. «Accept-Encoding» сообщает серверу, может ли ваш браузер принимать сжатый output, например gzip.

Возможно, вы заметили, что данные cookie также передаются внутри HTTP-заголовка. И если бы ссылочный url, это было бы в header тоже.

Большинство этих заголовков являются необязательными. Этот HTTP-запрос мог быть таким же маленьким:

И вы всё равно получите правильный ответ от веб-сервера.

Методы запроса

Три наиболее часто используемых метода запроса: GET, POST и HEAD. Вы, вероятно, уже знакомы с первыми двумя, начиная с написания html-форм.

GET: получение документа

Это основной метод, используемый для извлечения html, изображений, JavaScript, CSS и т. д. С использованием этого метода запрошено большинство данных, загружаемых в ваш браузер.

Например, при загрузке статьи Nettuts +, самая первая строка HTTP-запроса выглядит так:

Как только html загрузится, браузер начнет отправлять GET-запрос изображений, который может выглядеть так:

Веб-формы можно настроить под метод GET. Вот пример.

Когда эта форма отправлена, HTTP-запрос начинается так:

Вы можете видеть, что каждый ввод формы был добавлен в строку запроса.

POST: отправка данных на сервер

Даже если вы можете отправлять данные на сервер с помощью GET и строки запроса, во многих случаях POST будет предпочтительнее. Отправка больших объёмов данных с помощью GET нецелесообразна и имеет ограничения.

Запросы POST чаще всего отправляются веб-формами. Давайте изменим предыдущий пример формы на метод POST.

Отправка этой формы создает HTTP-запрос следующим образом:

Здесь нужно отметить три важных момента:

• Путь в первой строке просто /foo.php, и больше нет строки запроса.
• Добавлены заголовки Content-Type и Content-Length, которые предоставляют информацию об отправляемых данных.
• Все данные теперь отправляются после заголовков, в том же формате, что и строка запроса.

Запросы POST метода также могут быть сделаны через AJAX, приложения, cURL и т. д. И все формы загрузки файлов необходимы для использования метода POST.

HEAD: получение информации заголовка

HEAD идентичен GET, за исключением того, что сервер не возвращает содержимое HTTP-ответа. Когда вы отправляете запрос HEAD, это означает, что вас интересуют только код ответа и HTTP headers, а не сам документ.

«Когда вы отправляете запрос HEAD, это означает, что вас интересуют только код ответа и HTTP headers, а не сам документ».

С помощью этого метода браузер может проверить, был ли документ изменён для целей caching. Он также может проверить, существует ли документ вообще.

Например, если у вас много ссылок на веб-сайте, вы можете периодически отправлять HEAD-запросы каждой из них, чтобы проверить наличие неработающих ссылок. Это будет намного быстрее, чем при использовании GET.

Структура ответа HTTP

После того, как браузер отправляет HTTP-запрос, сервер отвечает HTTP-ответом. Исключая контент, он выглядит так:

Первой порцией данных является протокол. Обычно это снова HTTP/1.x или HTTP/1.1 на современных серверах.

Следующая часть — это код состояния, за которым следует короткое сообщение. Код 200 означает, что наш запрос GET был успешным и сервер вернёт содержимое запрошенного документа сразу после headers.

Мы все видели «404» pages. Это число фактически приходит из части кода состояния HTTP-ответа. Если запрос GET будет создан для path, который сервер не может найти, он ответил бы 404, а не 200.

Остальная часть ответа содержит headers так же, как HTTP-запрос. Эти значения могут содержать информацию о софте сервера при последнем изменении страницы/файла, типе mime и прочее.

Опять же, большинство этих headers на самом деле являются необязательными.

Коды статуса HTTP

• 200 используются для успешных запросов.
• 300 для перенаправления.
• 400 используются, если возникла проблема с запросом.
• 500 используются, если возникла проблема с сервером.

200 OK

Как упоминалось ранее, этот код состояния отправляется в ответ на успешный запрос.

206 Partial Content

Если приложение запрашивает только диапазон запрошенного файла, возвращается код 206.

Это часто используется с менеджерами закачек, которые могут остановить и возобновить загрузку или разделить загрузку на части.

404 Not Found

Когда запрашиваемая страница или файл не найдена, сервер отправляет код ответа 404.

401 Unauthorized

Защищённые паролем веб-страницы отправляют этот код. Если вы не ввели логин правильно, вы можете увидеть следующее в вашем браузере.

Обратите внимание, что это относится только к страницам, защищённым паролем HTTP, которые вызывают запросы для входа следующим образом:

403 Forbidden

Если вам не разрешен доступ к странице, этот код может быть отправлен в ваш браузер. Это часто происходит, когда вы пытаетесь открыть URL-адрес для папки, в которой нет индексной страницы. Если параметры сервера не позволяют отображать содержимое папки, вы получите ошибку 403.

Например, на моем локальном сервере я создал папку изображений. Внутри этой папки я помещаю файл .htaccess с этой строкой: «Options -Indexes». Теперь, когда я пытаюсь открыть http://localhost/images/ — я вижу это:

Существуют другие способы блокировки доступа и 403 могут быть отправлены. Например, вы можете блокировать по IP-адресу с помощью некоторых директив htaccess.

302 (or 307) Moved Temporarily & 301 Moved Permanently

Эти два кода используются для перенаправления браузера. Например, когда вы используете службу сокращения URL, такую как bit.ly, именно так они перенаправляют людей, которые идут по ссылке.

302 и 301 обрабатываются браузером очень похоже, но они могут иметь различные значения для spiders поисковых систем. Например, если ваш сайт не готов для обслуживания, вы можете перенаправить его в другое место с помощью 302. Поисковая система продолжит проверку вашей страницы в будущем. Но если вы перенаправите с использованием 301, это сообщит spider, что ваш сайт переехал в это место навсегда. За более точной информацией: http://www.nettuts.com перейдите на https://net.tutsplus.com/ используя 301 код вместо 302.

500 Internal Server Error

Этот код обычно отображается при сбое веб-скрипта. Большинство скриптов CGI не выводят ошибки непосредственно в браузер, в отличие от PHP. Если есть фатальные ошибки, они просто отправят код статуса 500. И тогда программист должен искать в журналах ошибок сервера, чтобы найти сообщения об ошибках.

Complete List

Вы можете найти полный список кодов состояния HTTP с их пояснениями here.

Заголовки HTTP в запросах HTTP

Теперь мы рассмотрим некоторые из наиболее распространенных HTTP headers , найденных в HTTP requests.

Почти все эти заголовки можно найти в массиве $ _SERVER в PHP. Вы также можете использовать функцию getallheaders() для извлечения всех заголовков одновременно.

HTTP-запрос отправляется на определенные IP-адреса. Но так как большинство серверов способны размещать несколько сайтов под одним IP, они должны знать, какое доменное имя ищет браузер.

Это в основном имя host, включая домен и поддомен.

В PHP его можно найти, как $_SERVER[‘HTTP_HOST’] или $_SERVER[‘SERVER_NAME’].

User-Agent

Этот заголовок может содержать несколько частей информации, таких как:

• Имя и версия браузера.
• Название и версия операционной системы.
• Язык по умолчанию.

Именно так веб-сайты могут собирать определённую общую информацию о своих системах surfers. Например, они могут определить, использует ли surfer мобильный браузер и перенаправляет их на мобильную версию своего веб-сайта, который лучше работает с низким разрешением.

В PHP может быть выражен так: $_SERVER[‘HTTP_USER_AGENT’].

Accept-Language

Этот заголовок отображает настройки языка по умолчанию. Если сайт имеет разные языковые версии, он может перенаправить нового surfer на основе этих данных.

Он может содержать несколько языков, разделённых запятыми. Первый — это предпочтительный язык, и каждый из перечисленных языков может иметь значение «q», которое представляет собой оценку предпочтения пользователя для языка (min. 0 max. 1).

В PHP его можно найти так: $ _SERVER [«HTTP_ACCEPT_LANGUAGE»].

Accept-Encoding

Большинство современных браузеров поддерживают gzip и отправляют это в header. Затем веб-сервер может отправить выходной HTML-код в сжатом формате. Это позволяет уменьшить размер до 80% для экономии пропускной способности и времени.

В PHP его можно найти так: $ _SERVER [«HTTP_ACCEPT_ENCODING»]. Однако, когда вы используете функцию обратного вызова ob_gzhandler(), она будет проверять значение автоматически, поэтому вам это не нужно.

If-Modified-Since

Если веб-документ уже сохранен в кеше в браузере и вы посещаете его снова, ваш браузер может проверить, был ли документ обновлён, отправив следующее:

Если он не изменялся с этой даты, сервер отправляет код ответа «304 Not Modified», а содержимое — нет, и браузер загружает содержимое из cache.

В PHP его можно найти так: $ _SERVER [‘HTTP_IF_MODIFIED_SINCE’].

Существует также HTTP-заголовок Etag, который можно использовать для проверки текущего кэша. Мы поговорим об этом в ближайшее время.

Cookie

Как следует из названия, это отправляет файлы cookie, хранящиеся в вашем браузере для этого домена.

Это пары name=value, разделённые точками с запятой. Cookies могут также содержать id сеанса.

В PHP отдельные cookie-файлы могут быть доступны с помощью массива $ _COOKIE. Вы можете напрямую обращаться к переменным сеанса, используя массив $ _SESSION, и если вам нужен id сеанса, вы можете использовать функцию session_id () вместо cookie.

Referer

Как следует из названия, этот HTTP header содержит ссылочный url.

Например, если я зашел на домашнюю страницу Nettuts + и нажал ссылку на статью, этот header будет отправлен в мой браузер:

В PHP его можно найти как $ _SERVER [‘HTTP_REFERER’].

Возможно, вы заметили, что слово «referrer» написано с ошибкой, как «referer». К сожалению, он превратился в официальную спецификацию HTTP подобным образом и застрял.

Authorization

Когда веб-страница запрашивает авторизацию, браузер открывает окно входа в систему. Когда вы вводите имя пользователя и пароль в этом окне, браузер отправляет другой HTTP-запрос, но на этот раз он содержит этот header

Данные внутри header имеют кодировку base64. Например, base64_decode (‘bXl1c2VyOm15cGFzcw ==’) возвратит ‘myuser: mypass’

В PHP эти значения можно найти как $ _SERVER [‘PHP_AUTH_USER’] и $ _SERVER [‘PHP_AUTH_PW’].

Подробнее об этом будет, когда мы поговорим о заголовке WWW-Authenticate.

Заголовки HTTP в ответах HTTP

Теперь мы рассмотрим некоторые из наиболее распространенных HTTP headers, найденных в HTTP-ответах.

В PHP вы можете установить заголовки ответа, используя функцию header(). PHP уже отправляет определённые заголовки автоматически, для загрузки содержимого и настройки файлов cookie и прочее. Вы можете увидеть headers, которые отправляются или будут отправляться с помощью функции headers_list (). Вы можете проверить, были ли уже отправлены заголовки с помощью функции headers_sent().

Cache-Control

Определение из w3.org: «Поле заголовка Cache-Control используется для указания директив, которые ДОЛЖНЫ выполняться всеми механизмами кэширования по цепочке запросов/ответов». Эти «механизмы кэширования» включают шлюзы и прокси, которые может использовать ваш интернет-провайдер.

«public» означает, что ответ может быть кэширован кем угодно. «max-age» указывает, сколько секунд действителен кеш. Разрешение кэширования вашего сайта может снизить нагрузку на сервер и пропускную способность, а также увеличить время загрузки в браузере.

Кэширование также может быть предотвращено с помощью директивы «no-cache».

Подробности смотрите в w3.org.

Content-Type

Этот header указывает «mime-type» документа. Затем браузер определяет, как интерпретировать содержимое на основании этого. Например, страница html (или PHP-скрипт с выходом html) может возвращать это:

«text» — это тип, а «html» — подтип документа. Заголовок также может содержать больше информации, такой как charset.

Для gif-изображения это может быть отправлено.

Браузер может использовать внешнее приложение или расширение браузера на основе mime-type. Например, это приведет к загрузке Adobe Reader:

При загрузке напрямую Apache обычно может обнаружить mime-тип документа и отправить соответствующий header. Кроме того, большинство браузеров имеют некоторую степень отказоустойчивости и автоопределение типов mime, если заголовки указаны неверно или отсутствуют.

Вы можете найти список общих типов mime here.

В PHP вы можете использовать функцию finfo_file() для определения mime-типа файла.

Content-Disposition

Этот header указывает браузеру открыть окно загрузки файла, вместо того, чтобы пытаться проанализировать содержимое. Пример:

Это заставит браузер сделать это:

Обратите внимание, что соответствующий заголовок Content-Type также должен быть отправлен вместе с этим:

Content-Length

Когда контент будет передаваться браузеру, сервер может указать его размер (в байтах), используя этот header.

Это особенно полезно при загрузке файлов. Именно так браузер может определить ход загрузки.

Например, вот сценарий-макет, который я написал, имитирует медленную загрузку.

Теперь я собираюсь закомментировать заголовок Content-Length

Теперь результат такой:

Браузер может только сказать, сколько байтов было загружено, но он не знает общую сумму. И индикатор выполнения не показывает прогресс.

Это еще один header, который используется для кеширования. Это выглядит так:

Веб-сервер может отправлять этот header с каждым документом, который он обслуживает. Значение может быть основано на последней изменённой дате, размере файла или даже контрольной сумме файла. Браузер затем сохраняет это значение, так как он кэширует документ. В следующий раз, когда браузер запрашивает тот же файл, он отправляет это в HTTP-запросе:

Если значение Etag документа совпадает с этим, сервер будет отправлять код 304 вместо 200, и никакого содержимого. Браузер будет загружать содержимое из своего кеша.

Last-Modified

Как следует из названия, этот header указывает дату последнего изменения документа в формате GMT:

Это предлагает браузеру другой способ для cache документа. Браузер может отправить это в HTTP-запросе:

Мы уже говорили об этом ранее в разделе «If-Modified-Since».

Location

Этот заголовок используется для перенаправления. Если код ответа 301 или 302, сервер также должен отправить этот header. Например, когда вы перейдете на страницу http://www.nettuts.com, ваш браузер получит следующее:

В PHP вы можете перенаправить surfer так:

По умолчанию, это отправит 302 код ответа. Если вы хотите вместо 301 отправить:

Set-Cookie

Когда веб-сайт хочет установить или обновить файл cookie в вашем браузере, он будет использовать этот header.

Каждый файл cookie отправляется как отдельный header. Обратите внимание, что файлы cookie, установленные с помощью JavaScript, не проходят через HTTP headers.

В PHP вы можете установить cookie-файлы, используя функцию setcookie(), а PHP отправляет соответствующие HTTP headers.

Что приводит к отправке этого заголовка:

Если дата истечения срока действия не указана, cookie удаляется, когда окно браузера закрыто.

WWW-Authenticate

Сайт может отправить этот header для аутентификации пользователя через HTTP. Когда браузер увидит этот header, он откроет диалоговое окно входа в систему.

Что будет выглядеть так:

В руководстве PHP есть section, в котором приведены образцы кода, как это сделать в PHP.

Content-Encoding

Этот header обычно устанавливается, когда возвращаемое содержимое сжимается.

В PHP, если вы используете функцию обратного вызова ob_gzhandler(), она будет автоматически установлена.

Заключение

Спасибо за прочтение. Надеюсь, эта статья послужит хорошей отправной точкой для изучения HTTP Headers. Пожалуйста, оставьте свои комментарии и вопросы ниже, и я постараюсь дать как можно больше ответов.

header

header() используется для отправки HTTP -заголовка. В » спецификации HTTP/1.1 есть подробное описание HTTP -заголовков.

Помните, что функцию header() можно вызывать только если клиенту ещё не передавались данные. То есть она должна идти первой в выводе, перед её вызовом не должно быть никаких HTML-тегов, пустых строк и т.п. Довольно часто возникает ошибка, когда при чтении кода файловыми функциями, вроде include или require , в этом коде попадаются пробелы или пустые строки, которые выводятся до вызова header() . Те же проблемы могут возникать и при использовании PHP/HTML в одном файле.

Список параметров

Существует два специальных заголовка. Один из них начинается с " HTTP/ " (регистр не важен) и используется для отправки кода состояния HTTP. Например, если веб-сервер Apache сконфигурирован таким образом, чтобы запросы к несуществующим файлам обрабатывались средствами PHP-скрипта (используя директиву ErrorDocument ), вы наверняка захотите убедиться, что скрипт генерирует правильный код состояния.

Другим специальным видом заголовков является "Location:". В этом случае функция не только отправляет этот заголовок браузеру, но также возвращает ему код состояния REDIRECT (302), если ранее не был установлен код 201 или 3xx .

<?php
header ( «Location: http://www.example.com/» ); /* Перенаправление браузера */

/* Убедиться, что код ниже не выполнится после перенаправления .*/
exit;
?>

Необязательный параметр replace определяет, надо ли заменять предыдущий аналогичный заголовок или заголовок того же типа. По умолчанию заголовок будет заменён, но если передать false , можно задать несколько однотипных заголовков. Например:

Принудительно задаёт код ответа HTTP. Следует учитывать, что это будет работать, только если строка header не является пустой.

Возвращаемые значения

Функция не возвращает значения после выполнения.

Ошибки

Если не удалось запланировать отправку заголовка, header() выдаёт ошибку уровня E_WARNING .

Примеры

Пример #1 Диалог загрузки

Если нужно предупредить пользователя о необходимости сохранить пересылаемые данные, такие как сгенерированный PDF-файл, можно воспользоваться заголовком » Content-Disposition, который подставляет рекомендуемое имя файла и заставляет браузер показать диалог загрузки.

<?php
// Будем передавать PDF
header ( ‘Content-Type: application/pdf’ );

// Он будет называться downloaded.pdf
header ( ‘Content-Disposition: attachment; filename=»downloaded.pdf»‘ );

// Исходный PDF-файл original.pdf
readfile ( ‘original.pdf’ );
?>

Пример #2 Директивы для работы с кешем

PHP-скрипты часто генерируют динамический контент, который не должен кешироваться клиентским браузером или какими-либо промежуточными обработчиками, вроде прокси-серверов. Можно принудительно отключить кеширование на многих прокси-серверах и браузерах, передав заголовки:

Замечание:

В некоторых случаях ваши страницы не будут кешироваться браузером, даже если вы не передавали этих заголовков. В браузерах есть определённые настройки, с помощью которых пользователь может изменять обычный ход кеширования, отключать его. Вы должны переопределять любые настройки, которые могут повлиять на кеширование скрипта, отправляя приведённые выше заголовки.

Кроме того, для случаев когда используются сессии, можно задать настройки конфигурации session_cache_limiter() и session.cache_limiter . Эти настройки можно использовать для автоматической генерации заголовков управляющих кешированием.

Примечания

Замечание:

Доступ к заголовкам и их вывод будет осуществляться только в случае, если в используемом вами SAPI есть их поддержка.

Замечание:

Чтобы обойти эту проблему, можно буферизовать вывод скрипта. В этом случае все выводимые данные будут буферизоваться на сервере, пока не будет дана явная команда на пересылку данных. Управлять буферизацией можно вручную функциями ob_start() и ob_end_flush() , либо задав директиву output_buffering в конфигурационном файле php.ini , или же настроив соответствующим образом конфигурацию сервера.

Замечание:

Строка заголовка состояния HTTP всегда будет отсылаться клиенту первой, вне зависимости от того был соответствующий вызов функции header() первым или нет. Это состояние можно перезаписать, вызывая header() с новой строкой состояния в любое время, когда можно отправлять HTTP-заголовки.

Замечание:

Спецификация HTTP/1.1 требует указывать абсолютный URI в качестве аргумента » Location:, включающий схему, имя хоста и абсолютный путь, хотя некоторые клиенты способны принимать и относительные URI. Абсолютный URI можно построить самостоятельно с помощью $_SERVER[‘HTTP_HOST’] , $_SERVER[‘PHP_SELF’] и dirname() :

Замечание:

Идентификатор сессии не будет передаваться вместе с заголовком Location, даже если включена настройка session.use_trans_sid. Его нужно передавать вручную, используя константу SID .

Смотрите также

• headers_sent() — Проверяет, были ли отправлены заголовки
• setcookie() — Отправляет cookie
• http_response_code() — Получает или устанавливает код ответа HTTP
• header_remove() — Удаляет ранее установленные заголовки
• headers_list() — Возвращает список переданных заголовков (или готовых к отправке)
• Раздел документации HTTP-аутентификации

User Contributed Notes 32 notes

I strongly recommend, that you use

header($_SERVER[«SERVER_PROTOCOL»].» 404 Not Found»);

header(«HTTP/1.1 404 Not Found»);

I had big troubles with an Apache/2.0.59 (Unix) answering in HTTP/1.0 while I (accidentially) added a «HTTP/1.1 200 Ok» — Header.

Most of the pages were displayed correct, but on some of them apache added weird content to it:

A 4-digits HexCode on top of the page (before any output of my php script), seems to be some kind of checksum, because it changes from page to page and browser to browser. (same code for same page and browser)

«0» at the bottom of the page (after the complete output of my php script)

It took me quite a while to find out about the wrong protocol in the HTTP-header.

Several times this one is asked on the net but an answer could not be found in the docs on php.net .

If you want to redirect an user and tell him he will be redirected, e. g. «You will be redirected in about 5 secs. If not, click here.» you cannot use header( ‘Location: . ‘ ) as you can’t sent any output before the headers are sent.

So, either you have to use the HTML meta refresh thingy or you use the following:

<?php
header ( «refresh:5;url=wherever.php» );
echo ‘You\’ll be redirected in about 5 secs. If not, click <a href=»wherever.php»>here</a>.’ ;
?>

Hth someone

A quick way to make redirects permanent or temporary is to make use of the $http_response_code parameter in header().

<?php
// 301 Moved Permanently
header ( «Location: /foo.php» , TRUE , 301 );

// 302 Found
header ( «Location: /foo.php» , TRUE , 302 );
header ( «Location: /foo.php» );

// 303 See Other
header ( «Location: /foo.php» , TRUE , 303 );

// 307 Temporary Redirect
header ( «Location: /foo.php» , TRUE , 307 );
?>

The HTTP status code changes the way browsers and robots handle redirects, so if you are using header(Location:) it’s a good idea to set the status code at the same time. Browsers typically re-request a 307 page every time, cache a 302 page for the session, and cache a 301 page for longer, or even indefinitely. Search engines typically transfer «page rank» to the new location for 301 redirects, but not for 302, 303 or 307. If the status code is not specified, header(‘Location:’) defaults to 302.

When using PHP to output an image, it won’t be cached by the client so if you don’t want them to download the image each time they reload the page, you will need to emulate part of the HTTP protocol.

// Test image.
$fn = ‘/test/foo.png’ ;

// Getting headers sent by the client.
$headers = apache_request_headers ();

// Checking if the client is validating his cache and if it is current.
if (isset( $headers [ ‘If-Modified-Since’ ]) && ( strtotime ( $headers [ ‘If-Modified-Since’ ]) == filemtime ( $fn ))) <
// Client’s cache IS current, so we just respond ‘304 Not Modified’.
header ( ‘Last-Modified: ‘ . gmdate ( ‘D, d M Y H:i:s’ , filemtime ( $fn )). ‘ GMT’ , true , 304 );
> else <
// Image not cached or cache outdated, we respond ‘200 OK’ and output the image.
header ( ‘Last-Modified: ‘ . gmdate ( ‘D, d M Y H:i:s’ , filemtime ( $fn )). ‘ GMT’ , true , 200 );
header ( ‘Content-Length: ‘ . filesize ( $fn ));
header ( ‘Content-Type: image/png’ );
print file_get_contents ( $fn );
>

?>

That way foo.png will be properly cached by the client and you’ll save bandwith. 🙂

If using the ‘header’ function for the downloading of files, especially if you’re passing the filename as a variable, remember to surround the filename with double quotes, otherwise you’ll have problems in Firefox as soon as there’s a space in the filename.

So instead of typing:

<?php
header ( «Content-Disposition: attachment; filename keyword»>. basename ( $filename ));
?>

you should type:

<?php
header ( «Content-Disposition: attachment; filename=\»» . basename ( $filename ) . «\»» );
?>

If you don’t do this then when the user clicks on the link for a file named «Example file with spaces.txt», then Firefox’s Save As dialog box will give it the name «Example», and it will have no extension.

See the page called «Filenames_with_spaces_are_truncated_upon_download» at
http://kb.mozillazine.org/ for more information. (Sorry, the site won’t let me post such a long link. )

// Response codes behaviors when using
header ( ‘Location: /target.php’ , true , $code ) to forward user to another page :

$code = 301 ;
// Use when the old page has been «permanently moved and any future requests should be sent to the target page instead. PageRank may be transferred.»

$code = 302 ; (default)
// «Temporary redirect so page is only cached if indicated by a Cache-Control or Expires header field.»

$code = 303 ;
// «This method exists primarily to allow the output of a POST-activated script to redirect the user agent to a selected resource. The new URI is not a substitute reference for the originally requested resource and is not cached.»

$code = 307 ;
// Beware that when used after a form is submitted using POST, it would carry over the posted values to the next page, such if target.php contains a form processing script, it will process the submitted info again!

// In other words, use 301 if permanent, 302 if temporary, and 303 if a results page from a submitted form.
// Maybe use 307 if a form processing script has moved.

According to the RFC 6226 (https://tools.ietf.org/html/rfc6266), the only way to send Content-Disposition Header with encoding is:

Content-Disposition: attachment;
filename*= UTF-8»%e2%82%ac%20rates

for backward compatibility, what should be sent is:

Content-Disposition: attachment;
filename=»EURO rates»;
filename*=utf-8»%e2%82%ac%20rates

As a result, we should use

<?php
$filename = ‘中文文件名.exe’ ; // a filename in Chinese characters

$contentDispositionField = ‘Content-Disposition: attachment; ‘
. sprintf ( ‘filename=»%s»; ‘ , rawurlencode ( $filename ))
. sprintf ( «filename*=utf-8»%s» , rawurlencode ( $filename ));

header ( ‘Content-Type: application/octet-stream’ );

readfile ( ‘file_to_download.exe’ );
?>

I have tested the code in IE6-10, firefox and Chrome.

You can use HTTP’s etags and last modified dates to ensure that you’re not sending the browser data it already has cached.

<?php
$last_modified_time = filemtime ( $file );
$etag = md5_file ( $file );

header ( «Last-Modified: » . gmdate ( «D, d M Y H:i:s» , $last_modified_time ). » GMT» );
header ( «Etag: $etag » );

if (@ strtotime ( $_SERVER [ ‘HTTP_IF_MODIFIED_SINCE’ ]) == $last_modified_time ||
trim ( $_SERVER [ ‘HTTP_IF_NONE_MATCH’ ]) == $etag ) <
header ( «HTTP/1.1 304 Not Modified» );
exit;
>
?>

It seems the note saying the URI must be absolute is obsolete. Found on https://en.wikipedia.org/wiki/HTTP_location

«An obsolete version of the HTTP 1.1 specifications (IETF RFC 2616) required a complete absolute URI for redirection.[2] The IETF HTTP working group found that the most popular web browsers tolerate the passing of a relative URL[3] and, consequently, the updated HTTP 1.1 specifications (IETF RFC 7231) relaxed the original constraint, allowing the use of relative URLs in Location headers.»

Be aware that sending binary files to the user-agent (browser) over an encrypted connection (SSL/TLS) will fail in IE (Internet Explorer) versions 5, 6, 7, and 8 if any of the following headers is included:

Workaround: do not send those headers.

Also, be aware that IE versions 5, 6, 7, and 8 double-compress already-compressed files and do not reverse the process correctly, so ZIP files and similar are corrupted on download.

Workaround: disable compression (beyond text/html) for these particular versions of IE, e.g., using Apache’s «BrowserMatch» directive. The following example disables compression in all versions of IE:

BrowserMatch «.*MSIE.*» gzip-only-text/html

Just to inform you all, do not get confused between Content-Transfer-Encoding and Content-Encoding

Content-Transfer-Encoding specifies the encoding used to transfer the data within the HTTP protocol, like raw binary or base64. (binary is more compact than base64. base64 having 33% overhead).
Eg Use:- header(‘Content-Transfer-Encoding: binary’);

Content-Encoding is used to apply things like gzip compression to the content/data.
Eg Use:- header(‘Content-Encoding: gzip’);

Note that ‘session_start’ may overwrite your custom cache headers.
To remedy this you need to call:

. after you set your custom cache headers. It will tell the PHP session code to not do any cache header changes of its own.

It is important to note that headers are actually sent when the first byte is output to the browser. If you are replacing headers in your scripts, this means that the placement of echo/print statements and output buffers may actually impact which headers are sent. In the case of redirects, if you forget to terminate your script after sending the header, adding a buffer or sending a character may change which page your users are sent to.

This redirects to 2.html since the second header replaces the first.

<?php
header ( «location: 1.html» );
header ( «location: 2.html» ); //replaces 1.html
?>

This redirects to 1.html since the header is sent as soon as the echo happens. You also won’t see any «headers already sent» errors because the browser follows the redirect before it can display the error.

<?php
header ( «location: 1.html» );
echo «send data» ;
header ( «location: 2.html» ); //1.html already sent
?>

Wrapping the previous example in an output buffer actually changes the behavior of the script! This is because headers aren’t sent until the output buffer is flushed.

<?php
ob_start ();
header ( «location: 1.html» );
echo «send data» ;
header ( «location: 2.html» ); //replaces 1.html
ob_end_flush (); //now the headers are sent
?>

A call to session_write_close() before the statement

<?php
header ( «Location: URL» );
exit();
?>

is recommended if you want to be sure the session is updated before proceeding to the redirection.

We encountered a situation where the script accessed by the redirection wasn’t loading the session correctly because the precedent script hadn’t the time to update it (we used a database handler).

Please note that there is no error checking for the header command, either in PHP, browsers, or Web Developer Tools.

If you use something like «header(‘text/javascript’);» to set the MIME type for PHP response text (such as for echoed or Included data), you will get an undiagnosed failure.

The proper MIME-setting function is «header(‘Content-type: text/javascript’);».

For large files (100+ MBs), I found that it is essential to flush the file content ASAP, otherwise the download dialog doesn’t show until a long time or never.

<?php
header ( «Content-Disposition: attachment; filename keyword»>. urlencode ( $file ));
header ( «Content-Type: application/force-download» );
header ( «Content-Type: application/octet-stream» );
header ( «Content-Type: application/download» );
header ( «Content-Description: File Transfer» );
header ( «Content-Length: » . filesize ( $file ));
flush (); // this doesn’t really matter.

$fp = fopen ( $file , «r» );
while (! feof ( $fp ))
<
echo fread ( $fp , 65536 );
flush (); // this is essential for large downloads
>
fclose ( $fp );
?>

<?php
/* This will give an error. Note the output
* above, which is before the header() call */
header ( ‘Location: http://www.example.com/’ );
exit;
?>

this example is pretty good BUT in time you use «exit» the parser will still work to decide what’s happening next the «exit» ‘s action should do (’cause if you check the manual exit works in others situations too).
SO MY POINT IS : you should use :
<?php

?>
‘CAUSE all die function does is to stop the script ,there is no other place for interpretation and the scope you choose to break the action of your script is quickly DONE.

there are many situations with others examples and the right choose for small parts of your scrips that make differences when you write your php framework at well!

Thanks Rasmus Lerdorf and his team to wrap off parts of unusual php functionality ,php 7 roolez.

I made a script that generates an optimized image for use on web pages using a 404 script to resize and reduce original images, but on some servers it was generating the image but then not using it due to some kind of cache somewhere of the 404 status. I managed to get it to work with the following and although I don’t quite understand it, I hope my posting here does help others with similar issues:

header_remove();
header(«Cache-Control: no-store, no-cache, must-revalidate, max-age=0»);
header(«Cache-Control: post-check=0, pre-check=0», false);
header(«Pragma: no-cache»);
// . and then try redirecting
// 201 = The request has been fulfilled, resulting in the creation of a new resource however it’s still not loading
// 302 «moved temporarily» does seems to load it!
header(«location:$dst», FALSE, 302); // redirect to the file now we have it

If you want to remove a header and keep it from being sent as part of the header response, just provide nothing as the header value after the header name. For example.

PHP, by default, always returns the following header:

Which your entire header response will look like

HTTP/1.1 200 OK
Server: Apache/2.2.11 (Unix)
X-Powered-By: PHP/5.2.8
Date: Fri, 16 Oct 2009 23:05:07 GMT
Content-Type: text/html; charset=UTF-8
Connection: close

If you call the header name with no value like so.

?>

Your headers now look like this:

HTTP/1.1 200 OK
Server: Apache/2.2.11 (Unix)
X-Powered-By: PHP/5.2.8
Date: Fri, 16 Oct 2009 23:05:07 GMT
Connection: close

Saving php file in ANSI no isuess but when saving the file in UTF-8 format for various reasons remember to save the file without any BOM ( byte-order mark) support.
Otherwise you will face problem of headers not being properly sent
eg.
<?php header ( «Set-Cookie: name=user» ); ?>

Would give something like this :-

Warning: Cannot modify header information — headers already sent by (output started at C:\www\info.php:1) in C:\www\info.php on line 1

After lots of research and testing, I’d like to share my findings about my problems with Internet Explorer and file downloads.

Take a look at this code, which replicates the normal download of a Javascript:

<?php
if( strstr ( $_SERVER [ «HTTP_USER_AGENT» ], «MSIE» )== false ) <
header ( «Content-type: text/javascript» );
header ( «Content-Disposition: inline; filename=\»download.js\»» );
header ( «Content-Length: » . filesize ( «my-file.js» ));
> else <
header ( «Content-type: application/force-download» );
header ( «Content-Disposition: attachment; filename=\»download.js\»» );
header ( «Content-Length: » . filesize ( «my-file.js» ));
>
header ( «Expires: Fri, 01 Jan 2010 05:00:00 GMT» );
if( strstr ( $_SERVER [ «HTTP_USER_AGENT» ], «MSIE» )== false ) <
header ( «Cache-Control: no-cache» );
header ( «Pragma: no-cache» );
>
include( «my-file.js» );
?>

Now let me explain:

I start out by checking for IE, then if not IE, I set Content-type (case-sensitive) to JS and set Content-Disposition (every header is case-sensitive from now on) to inline, because most browsers outside of IE like to display JS inline. (User may change settings). The Content-Length header is required by some browsers to activate download box. Then, if it is IE, the «application/force-download» Content-type is sometimes required to show the download box. Use this if you don’t want your PDF to display in the browser (in IE). I use it here to make sure the box opens. Anyway, I set the Content-Disposition to attachment because I already know that the box will appear. Then I have the Content-Length again.

Now, here’s my big point. I have the Cache-Control and Pragma headers sent only if not IE. THESE HEADERS WILL PREVENT DOWNLOAD ON IE. Only use the Expires header, after all, it will require the file to be downloaded again the next time. This is not a bug! IE stores downloads in the Temporary Internet Files folder until the download is complete. I know this because once I downloaded a huge file to My Documents, but the Download Dialog box put it in the Temp folder and moved it at the end. Just think about it. If IE requires the file to be downloaded to the Temp folder, setting the Cache-Control and Pragma headers will cause an error!

I hope this saves someone some time!

I just want to add, becuase I see here lots of wrong formated headers.

1. All used headers have first letters uppercase, so you MUST follow this. For example:

Location, not location
Content-Type, not content-type, nor CONTENT-TYPE

2. Then there MUST be colon and space, like

good: header(«Content-Type: text/plain»);
wrong: header(«Content-Type:text/plain»);

3. Location header MUST be absolute uri with scheme, domain, port, path, etc.

4. Relative URIs are NOT allowed

wrong: Location: /something.php?a=1
wrong: Location: ?a=1

It will make proxy server and http clients happier.

My files are in a compressed state (bz2). When the user clicks the link, I want them to get the uncompressed version of the file.

After decompressing the file, I ran into the problem, that the download dialog would always pop up, even when I told the dialog to ‘Always perform this operation with this file type’.

As I found out, the problem was in the header directive ‘Content-Disposition’, namely the ‘attachment’ directive.

If you want your browser to simulate a plain link to a file, either change ‘attachment’ to ‘inline’ or omit it alltogether and you’ll be fine.

This took me a while to figure out and I hope it will help someone else out there, who runs into the same problem.

If you haven’t used, HTTP Response 204 can be very convenient. 204 tells the server to immediately termiante this request. This is helpful if you want a javascript (or similar) client-side function to execute a server-side function without refreshing or changing the current webpage. Great for updating database, setting global variables, etc.

header(«status: 204»); (or the other call)
header(«HTTP/1.0 204 No Response»);

This is the Headers to force a browser to use fresh content (no caching) in HTTP/1.0 and HTTP/1.1:

<?PHP
header ( ‘Expires: Sat, 26 Jul 1997 05:00:00 GMT’ );
header ( ‘Last-Modified: ‘ . gmdate ( ‘D, d M Y H:i:s’ ) . ‘ GMT’ );
header ( ‘Cache-Control: no-store, no-cache, must-revalidate’ );
header ( ‘Cache-Control: post-check=0, pre-check=0’ , false );
header ( ‘Pragma: no-cache’ );

The encoding of a file is discovered by the Content-Type, either in the HTML meta tag or as part of the HTTP header. Thus, the server and browser does not need — nor expect — a Unicode file to begin with a BOM mark. BOMs can confuse *nix systems too. More info at http://unicode.org/faq/utf_bom.html#bom1

On another note: Safari can display CMYK images (at least the OS X version, because it uses the services of QuickTime)

DO NOT PUT space between location and the colon that comes after that ,
// DO NOT USE THIS :
header(«Location : #whatever»); // -> will not work !

// INSTEAD USE THIS ->
header(«Location: #wahtever»); // -> will work forever !

// Beware that adding a space between the keyword «Location» and the colon causes an Internal Sever Error

//This line causes the error
7
header(‘Location : index.php&controller=produit&action=index’);

// While It must be written without the space
header(‘Location: index.php&controller=produit&action=index’);

Setting the «Location: » header has another undocumented side-effect!

It will also disregard any expressly set «Content-Type: » and forces:

«Content-Type: text/html; charset=UTF-8»

The HTTP RFCs don’t call for such a drastic action. They simply state that a redirect content SHOULD include a link to the destination page (in which case ANY HTML compatible content type would do). But PHP even overrides a perfectly standards-compliant
«Content-Type: application/xhtml+xml»!

Функция header

HTTP заголовки это специальная информация, которая присоединяется к документу, то есть, к тому файлу, который запрашивается браузером с сервера. Когда мы вбиваем в адресную строку какой-нибудь адрес то, соответственно, запрашиваем на сервере по этому адресу какой-нибудь документ. Эта информация(документ) видна у нас на экране. Но кроме видимой части есть еще и невидимая — те самые HTTP заголовки, которые отправляются сервером браузеру и они нужны для того, чтобы браузер корректно отобразил страницу. То есть, заголовки подсказывают браузеру как показать страницу или как отдать страницу.

Для браузера firefox: кнопка F12 -> сеть -> кликнуть «статус» и обновить страницу :

Среди прочего в заголовках отправляется информация о кодировке страницы, как давно модифицировалась страница, информация о том, что это за страница (html-страница, обычный текстовый документ; или, вместо того чтобы показать страницу, отдать ее на скачивание)

Установление кодировки

Один, из наиболее часто используемых вариантов функции header , это использование функции для установления кодировки.

В файле index.php в папке с нашим уроком запишем: привет, мир! и посмотрим в браузере, что получили. Мы можем получить крабозябры . Это происходит по тому, что браузер будет открывать документ в той кодировке, которую сервер отправил в заголовках по умолчанию. Если кодировка нашего документа не совпадает с кодировкой сервера — получим крабозябры.

Кодировка для всех частей нашего приложения должна быть единой .

Рекомендуется всегда использовать кодировку utf-8 — как универсальную кодировку.

Использование метатэга <meta charset=»UTF-8″> — не всегда помогает, потому что сервер может отправлять по умолчанию свою кодировку в заголовках и в этом случае она будет иметь больший приоритет, чем метатэг charset .

В этом случае мы должны переопределить кодировку сервера с помощью функции header . (php.net)

Функция header позволяет указать нужную нам кодировку.

Файл index.php

<?php
header ( ‘Content-Type: text/html; charset=utf-8’ );
?>

<!doctype html>
<html Lang= «en» >
<html>
<head>
<meta charset = «UTF-8» >
<title> Document </title>
</head>
<body>
<p> привет мир! </p>
</body>
</html>
выведет:
привет мир!

где:
text/html — тип документа;
charset=utf-8 — нужная нам кодировка.

Если посмотрим заголовки в «разработка/инструменты разработчика/сеть» (в firefox ), то увидим, что они дополнились кодировкой charset=»UTF-8″ , то есть, мы указали браузеру (отправили заголовки), что нужно использовать именно данную кодировку. При этом она имеет приоритет над метатэгом charset .

Еще один способ установления кодировки по умолчанию — это использовать специальный файл .htaccess . Данный файл является файлом настройки сервера Apache .

Создадим даннный файл в нашей папке.

Установим кодировку для сервера по умолчанию с помощью специальной директивы AddDefaultCharset .

Данная директива заставляет сервер отправлять в заголовках кодировку, указанную в качестве значения данной дериктивы.

Файл .htaccess:

AddDefaultCharset utf -8

Организация редиректа

Функцию header часто используют для редиректа .

Создадим новый файл — inc.php и выведем в нем строку: «привет из подключаемого файла» .

Файл inc.php

<?php
echo ‘Привет из подключаемого файла’ ;
?>

В индексном файле используем функцию header для редиректа. Его можно сделать двумя командами:
— командой ‘ Location ‘
— командой ‘ refresh ‘

Файл index.php

<?php
header ( ‘Content-Type: text/html; charset=utf-8’ );
header ( ‘Location: inc.php’ ); // где inc.php — относительный путь к файлу
?>

<!doctype html>
<html Lang= «en» >
<html>
<head>
<meta charset = «UTF-8» >
<title> Document </title>
</head>
<body>
<p> привет мир! </p>
</body>
</html>
после обновления страницы выведет:
— привет из подключаемого файла

При работе с редиректом нужно помнить что редирект происходит не сразу. Когда отрабатывает
данная команда ( header(‘Location: inc.php’); ), выполнение файла продолжается дальше.
Чтобы сделать безусловный редирект и не выполнять дальнейший код нужно воспользоватся
одной из двух команд — функция die (пер.- умри) и функция exit (пер.- выйти).
Эти команды почти всегда рекомендуется использовать после редиректа.

Чтобы убедиться, что у нас код после команды редиректа выполняется, используем редирект
с задержкой: header(‘refresh: 5, url’) , где
5 — время задержки в секундах,
url=inc.php — адрес, на который должен быть перенаправлен пользователь (если внешний адрес,
то используем — http, если внутренний, то используем — относительный путь к файлу ).
Запускаем файл index.php:

<?php
header ( ‘Content-Type: text/html; charset=utf-8’ );

header( ‘Location: inc.php’ );
// — где inc.php — относительный путь к файлу

header ( ‘refresh: 5, url=inc.php’ );
// — адрес, на который должен быть перенаправлен пользователь

<!doctype html>
<html Lang= «en» >
<html>
<head>
<meta charset = «UTF-8» >
<title> Document </title>
</head>
<body>
<p> привет мир! </p>
</body>
</html>
выведет:
— привет мир!
через 5 секунд выведет:
— привет из подключаемого файла

— после загрузки документа весь код у нас выполнился — выводится: привет мир!
После пятисекундной задержки нас перенаправляет на другой файл ( inc.php ) — выводится: привет из подключаемого файла .
Чтобы код не выполнялся используем любую из функций: либо exit , либо die .

<?php
header ( ‘Content-Type: text/html; charset=utf-8’ );
header( ‘Location: inc.php’ );
// — где inc.php — относительный путь к файлу

header ( ‘refresh: 5, url=inc.php’ );
exit ;
// die;
?>

<!doctype html>
<html Lang= «en» >
<html>
<head>
<meta charset = «UTF-8» >
<title> Document </title>
</head>
<body>
<p> привет мир! </p>
</body>
</html>
выведет:
— пустую страницу
через 5 секунд выведет:
— привет из подключаемого файла

— после загрузки документа код у нас не выполняется — видим пустую страницу.
После пятисекундной задержки перенаправляемся на другой файл — выводится: привет из подключаемого файла .

Проблемы вывода

Функция header отправляет заголовки в браузер. Они помогают коректно отобразить страницу. Эти заголовки должны бать отправленны раньше перед самим контентом страницы, поскольку браузер должен проанализировать заголовки и, в соответствии с ними, показать нашу страницу. Поэтому заголовки должны быть всегда отправленны до вывода , при этом заголовки могут отправлятся только один раз .
Если мы инициализируем вывод в браузер, то заголовки автоматически будут отправленны. Это значит, что если перед функцией header есть какой-то вывод в браузер, то она просто не отработает.

1. В этом легко убедиться, если в индексном файле поставим какой нибудь вывод, например, перенос строки перед функцией header :

— будет выведена ошибка:

— не удается изменить информацию заголовка — заголовки уже отправленны .

Выводом считается любой символ , который показывается в браузере, например, даже пробел.

2. С проблемой вывода можно столкнуться при подключении какого нибудь файла.

Например, мы подключаем файл inc.php, и в нем есть какая-то переменная — $test = ‘TEST’ .

В индексном файле мы хотим использовать данную переменную: <?= $test ?> .

Файл index.php

<?php
require_once ‘inc.php’ ;
header ( ‘Content-Type: text/html; charset=utf-8’ );
?>
<!doctype html>
<html Lang= «en» >
<html>
<head>
<!— <meta charset=»UTF-8″> —>
<title> Урок 1 </title>
</head>
<body>
<?= $test ?> <!— используем переменную из подключаемого файла —>
<p> привет мир! </p>
</body>
</html>

Файл inc.php

— в результате выполнения выведется: TEST привет мир! — заголовки успешно отправляются.

Однако, если в файле inc.php мы организуем вывод, например выведем на экран переменную $test :

<?php
echo $test = ‘TEST’ ;

— то получим известную нам ошибку. Фактически, содержимое подключаемого файла inc.php, вставляется вместо строки require_once ‘inc.php’ .

3. Также с этой проблемой можно столкнуться, если в подключаемом файле после закрывающего тэга ?> есть переносы строк, пробелы . Для того, чтобы случайно не получить эту проблему надо в подключаемых файлах, где нет вывода, нет html-кода не использовать закрывающий тэг ?>.

4. Еще один вариант данной проблемы — это использование кодировки просто utf-8 , вместо кодировки utf-8 без BOM . BOM — это маркер, в котором зашифрована информация о том, что за кодировка используется. В данном случае этот маркер и есть вывод в браузер.

Изменение статуса страницы. Отправление другого кода ответа сервера браузеру

Если пользователь обратился по адресу которого нет на сервере, то мы должны изменить статус, то есть перенаправить его на страницу 404 . Что бы эта страница не включалась в индекс, нам нужно отправить соответствующий статус страницы, соответствующий код ответа — 404 .

Все коды ответов (список кодов состояния HTTP): wikipedia.org

Отправление кода ответа 404 Not Found :

Представим, что наш файл index.php — это несуществующая страница — страница 404 и мы должны отправить соответствующий код: header(‘HTTP/1.0 404 Not Found’);

<?php
require_once ‘inc.php’ ;
header ( ‘Content-Type: text/html; charset=utf-8’ );
header ( ‘HTTP/1.0 404 Not Found’ ); // отправление кода ответа 404 Not Found

// header(‘Location: inc.php’);
// header(‘refresh: 5, url=inc.php’);
// exit;
// die;
?>
<!doctype html>
<html Lang= «en» >
<html>
<head>
<!— <meta charset=»UTF-8″> —>
<title> Урок 1 </title>
</head>
<body>
<?= $test ?> <!— используем переменную из подключаемого файла —>
<p> привет мир! </p>
</body>
</html>

Обновляем страницу и получаем нужный нам ответ:

— теперь поисковый робот, увидев статус страницы, поймет, что такой страницы нет на нашем сервере и со временем выкинет это страницу из индекса, если она была уже в него включена.

Как отдать нужное содержимое. Как поменять тип документа

Создадим файл text.txt и запишем в него: ПРИВЕТ, МИР.

файл text.txt:

— мы хотим отдать на скачивание этот текстовый файл. Делаем это следующим образом:

1)— переопределяем тип нашего документа — text/html меняем на text/plain (текстовые данные): header(‘Content-Type: text/plain; charset=utf-8’);

Список всех типов документов (список MIME-типов ) здесь: wikipedia.org

Когда мы используем text/plain то мы говорим браузеру, что это обычный текстовый документ, где мы не предусматриваем каких-то html-тэгов, и соответственно браузер не будет обрабатавать эти самые html-тэги.

файл index.php

<?php
require_once ‘inc.php’ ;

// меняем тип документа
header ( ‘Content-Type: text/plain; charset=utf-8’ );
?>
<!doctype html>
<html Lang= «en» >
<html>
<head>
<!— <meta charset=»UTF-8″> —>
<title> Урок 1 </title>
</head>
<body>
<? = $test ?> <!— используем переменную из подключаемого файла —>
<p> привет мир! </p>
</body>
</html>

Обновляем страницу и увидим:

— страница в браузере —

2) — отдаем документ на скачивание — header(‘Content-Disposition: attachment; filename=»downloaded.txt»‘);

— Content-Disposition: attachment — указывает на то, что файл необходимо отдать на скачивание

— filename=»downloaded.txt» — указывает, как файл будет назван после сохранения

Файл index.php:

<?php
require_once ‘inc.php’ ;

// меняем тип документа
header ( ‘Content-Type: text/plain; charset=utf-8’ );

// отдаем документ на скачивание
header ( ‘Content-Disposition: attachment; filename=»downloaded.txt»‘ );
?>
.
.
.

После обновления страницы появится окно, предлагающее открыть или сохранить файл по именем downloaded.txt:

3) — читаем файл — readfile(‘text.txt’);

Файл index.php:

<?php
require_once ‘inc.php’ ;

// меняем тип документа
header ( ‘Content-Type: text/plain; charset=utf-8’ );

// отдаем документ на скачивание
header ( ‘Content-Disposition: attachment; filename=»downloaded.txt»‘ );

После обновления страницы и нажатии «ОК» в появившемся окне, получаем:

Файл downloaded.txt:

Чтобы отсечь html-код, необходимо завершить выполнение нашего скрипта, для этого воспользуемся функцией dia или exit .

Файл index.php:

<?php
// header (‘Content-Type: text/html; charset=utf-8’ );

// переопределяем тип нашего документа
header ( ‘Content-Type: text/plain; charset=utf-8’ );

// отдаем документ на скачивание
header ( ‘Content-Disposition: attachment; filename=»downloaded.txt»‘ );

// читаем файл
readfile ( ‘text.txt’ );

die ; // завершаем выполнение нашего скрипта
?>
.
.
.

И тогда получим в файле downloaded.txt:

— этот способ используется часто для организации платного скачивания на сайте.

Name already in use

intensive-php-guide / guide / http_forms.md

• Go to file T
• Go to line L
• Copy path
• Copy permalink

• Open with Desktop
• View raw
• Copy raw contents Copy raw contents

Copy raw contents

Copy raw contents

Как работает WWW (всемирная паутина, веб) в двух словах:

• браузер пользователя (клиент) отсылает на сервер запрос с адресом сайта (URL)
• сервер получает этот запрос и отдает клиенту требуемый тому контент

Иными словами, весь современный веб построен на модели клиент-серверного взаимодействия. И чтобы весь этот процесс оказался возможным, необходим универсальный язык-протокол, который будет понимать и сервер, и браузер. Такой протокол есть, а называется он просто — HTTP.

Как работает HTTP и зачем нам это знать

Программировать на PHP можно и без знания протокола HTTP, но есть ряд ситуаций, когда для решения определенных задач знание о том, как функционирует сервер, становится просто необходимым. Ведь PHP — это в первую очередь серверный язык программирования.

Протокол HTTP очень прост и состоит, по сути, из двух частей:

• заголовков запроса/ответа
• тела запроса/ответа

Всегда вначале идет список заголовков, затем пустая строка, а затем (если есть) тело запроса/ответа.

И клиент и сервер могут посылать друг другу заголовки и тело, но только в случае с клиентом доступные заголовки будут одни, а с сервером — другие. Рассмотрим пошагово как будет выглядеть работа по протоколу HTTP в случае, когда пользователь хочет загрузить главную страницу социальной сети «Вконтакте».

1.Браузер пользователя устанавливает соединение с сервером vk.com и отправляет следующий запрос:

2.Сервер принимает запрос и отправляет ответ:

3.Браузер принимает ответ и показывает готовую страничку

Больше всего нам интересен самый первый шаг, где браузер инициирует запрос к серверу vk.com
Рассмотрим подробнее что тут происходит: Самая первая строка этого запроса определяет несколько важных параметров, а именно:

• метод, которым будет запрошен контент
• адрес страницы
• версию протокола

GET — это метод (глагол), который мы применяем для доступа к указанной странице.
GET является самым часто используемым методом, потому что он говорит серверу о том, что клиент всего лишь хочет прочитать указанный документ. Но помимо GET есть и другие методы, а один из них рассмотрим уже в следующем разделе.

После метода идет указание на адрес страницы — URI (универсальный идентификатор ресурса). В нашем случае мы запрашиваем главную страницу сайта, поэтому используется просто слеш — / .
Последним в этой строке идет версия протокола и почти всегда это будет HTTP/1.1

После строки с указанием основных параметров всегда следует перечисление заголовков, которые передают серверу дополнительную, полезную информацию: название и версия браузера, язык, кодировка, параметры кэширования и т.д.
Среди всех этих заголовков, которые передаются при каждом запросе, есть один обязательный и самый важный — это заголовок Host . Именно он определяет адрес домена, который запрашивает браузер клиента.

Сервер, в свою очередь, получив запрос, ищет у себя сайт с доменом из заголовка Host , а также указанную страницу.
Если запрошенный сайт и страница найдены, клиенту отправляется ответ:
HTTP/1.1 200 OK
Такой ответ означает, что все хорошо, документ найден и будет отправлен клиенту. Если говорить более обобщенно, стартовая строка ответа имеет следующую структуру:
HTTP/Версия Код состояния Пояснение

Больше всего здесь интересен именно код состояния, он же код ответа сервера.
В этом примере код ответа — 200, что означает: сервер работает, документ найден и будет передан клиенту. Но не всегда все идет гладко.
Например, запрошенный документ может отсутствовать или сервер будет перегружен, в таком случае клиент не получит контент, а код ответа будет отличным от 200.

• 404 — если сервер доступен, но запрошенный документ не найден
• 503 — если сервер не может обрабатывать запросы по техническим причинам

Спецификация HTTP 1.1 определяет 40 различных кодов HTTP.

После стартовой строки следуют заголовки, а затем тело ответа.

Работа с заголовками в PHP

В PHP есть все возможности для взаимодействия с протоколом HTTP:

• получение тела запроса
• получение заголовков запроса
• добавление/изменение заголовков ответа
• управление телом ответа

Разберём все по порядку.

Получение тела запроса

Тело запроса — это информация, которую передал браузер при запросе страницы.
Но тело запроса присутствует только если браузер запросил страницу методом POST .
Дело в том, что POST — это метод, специально предназначенный для отправки данных на сайт. Чаще всего метод POST браузер задействует, когда отправляет форму. Значит содержимое самой формы и будет телом запроса.

В PHP-сценарии все данные отправленной формы будут доступны в специальном массиве $_POST . Более подробно об этом написано в следующей главе, посвященной формам.

Получение заголовков запроса

Напомним еще раз, что заголовки запроса — это метаинформация, отправленная браузером при запросе нашего сценария.
PHP автоматически извлекает такие заголовки и помещает их в специальный массив — $_SERVER .
Стоит отметить, что в этом массиве помимо заголовков есть и другая информация. Значения заголовков запроса находятся под ключами, что начинаются с HTTP_ . Подробно всё содержимое этого массива описано в официальной документации.

Пример как получить предыдущую страницу, с которой перешел пользователь:

Добавление/изменение заголовков ответа

В PHP сценарии можно управлять всеми заголовками ответа, которые попадут к пользователю вместе с контентом страницы. Это возможно, потому что PHP работает на стороне веб-сервера и имеет с ним очень тесную интеграцию.
Вот примеры сценариев, когда пригодится управление заголовками ответа:

• кэширование
• переадресация пользователя
• установка cookies
• отправка файлов
• передача дополнительной информации браузеру

Как видно, заголовки ответа нужны для выполнения множества важных задач.
Чтобы отправить или поменять абсолютно любой заголовок в PHP есть ровно одна функция: header() .
Эта функция принимает имя и значение заголовка и добавляет его в список из всех заголовков, которые уйдут в браузер пользователю после окончания работы сценария.
Например, таким способом выполняется перенаправление пользователя на другую страницу:

За переадресацию отвечает заголовок с именем Location , а через двоеточие ему задали значение — адрес страницы для перехода.

Важное замечание по использованию заголовков
Есть одно ограничение: заголовки нельзя отправлять, если пользователю уже отправили любой контент. Т.е., если показать что то на экране через, скажем, функцию print() , то после этого заголовки поменять уже не полуится.

Управление телом ответа

Как менять тело ответа ты уже знаешь, потому что всё что PHP выводит на экран и есть содержимое ответа. Иными словами, вызовы функций print , echo или показ текста через шорт-теги: всё это является телом ответа, которое попадает в браузер пользователю.

Мы привыкли, что на нашем сайте каждый PHP-сценарий отвечает за одну страницу. Посетитель сайта вбивает в адресную строку путь, который состоит из имени домена и имени php-сценария. Например, так: http://weather-diary.ru/day.php .
Но как быть, если одна страница должна показывать разную информацию?

На нашем сайте дневника наблюдений за погодой мы сделали отдельную страницу, чтобы показывать на ней информацию о погоде за один конкретный день из истории. Т.е. страница одна, но показывает разные данные, в зависимости от выбранного дня.
Также пользователи хотят добавить в закладки адреса страниц, с нужными им днями. Получается, что имея только один сценарий сделать страницу, способную показывать дневник погоды за любой день невозможно? Вовсе нет!

Из чего состоит URI

URI — это уникальный идентификатор ресурса. Ресурс в нашем случае — это полный путь до страницы сайта. И вот как может выглядеть ресурс для показа погоды за конкретный день:
http://weather-diary.ru/day.php?date=2017-10-15

Разберем из чего состоит этот URI.
Во-первых, здесь есть имя домена: weather-diary.ru .
Затем идёт имя сценария: day.php
А вот всё что идёт после — это параметры запроса.

Параметры запроса — это как-бы дополнительные аттрибуты адреса страницы. Они отделяются от имени страницы знаком запроса. В примере выше параметр запроса только один: date=2017-10-30.
Имя этого параметра: date , значение: 2017-10-15 .
Параметров запроса может быть несколько, тогда они разделяются знаком амперсанда: ?date=2017-10-15&tscale=celsius

В примере выше указывается два аргумента: дата и единица измерения температуры.

Параметры запроса как внешние переменные

Хорошо, теперь в адресе страницы используются параметры запроса, но какая нам от этого польза? А удобство соостоит в том, что если имя страницы вызывает к исполнению соответствующий php-сценарий, то параметры запроса становятся специальными внешними переменными в этом сценарии. Т.е. если в адресе присутствуют такие параметры, то их легко получить внутри кода сценария и выполнить нужные действия. Например, показать информацию погоду за конкретный день и в выбранных единицах измерения.

Получение параметров запроса

Если есть внешние переменные, то как их прочитать?
Все параметры запроса находятся в специальном, ассоциативном массиве $_GET , а значит сценарий, вызванный с таким адресом: day.php?date=2017-10-15&tscale=celsius будет иметь в этом массиве два значения с ключами date и scale соответственно.
Пример как сформировать запрос на получение данных за выбранный день:

В примере выше в первой строчке мы получаем значение параметра date , а если он отсутствует, то используем текущую дату в качестве выбранного дня.
Никогда не полагайтесь на существование параметра в массиве $_GET и делайте проверку либо функцией isset() , либо как в этом примере.

Формирование URI с параметрами запроса

Иногда нужно совершить обратную операцию: сформировать адрес страницы, включив туда нужные параметры запроса из массива.
Скажем, на странице погодного дневника надо поставить ссылку на следующий и предыдущий день. Нужно также сохранить выбранную единицу измерений. Т.е. необходимо сохранить текущие параметры запроса, поменять значение одного из них (день), и сформировать новую ссылку.
Вот как это можно сделать:

Здесь мы использовали две функции:

• basename(__FILE__) — получает имя текущего сценария
• http_build_query() — преобразует ассоциативный массив в строку запроса

Формы — это часть языка HTML. Формы нужны для передачи любых данных от клиента на сервер. Чаще всего формы используются для регистрации пользователей, заполнения анкет, оформления заказа в интернет магазине и т.д.
Отправлять можно как простую текстовую информацию, так и целые файлы.
Большую часть времени программирования на PHP вы будете так или иначе работать с формами и данными из них.

HTML описывает как выглядит форма: из каких полей и других элементов она состоит, но без принимающей стороны, т.е. сервера, который принимает эти данные и обрабатывает их нужным образом, создавать формы нет никакого смысла.

PHP содержит множество удобных средств для работы с формами, что позволяет очень просто решать типичные задачи, которые часто возникают в веб-программировании:

• регистрация и аутентификация пользователя
• отправка комментариев на форумах и соц. сетях
• оформление заказов

Практически любой современный сайт содержит как минимум несколько разных форм.

Рассмотрим один типичный пример — форма обратной связи. Чтобы дать посетителю сайта возможность связаться с его авторами, как правило используются формы обратной связи, где человек указывает как минимум свое имя, email для обратной связи и сам текст своего сообщения.
Такая форма может выглядеть в HTML следующим образом:

Это очень простая форма, состоящая из трех полей и одной кнопки отправки.

Почти весь приведенный код описывает внешний вид и содержание формы, но следует обратить внимание на два атрибута тега <form> , которые нужны для указания на способ обработки данных:

• method — этот атрибут используется для определения метода HTTP, который будет использован для передачи данных на сервер. Вы уже знакомы с HTTP методом GET , предписывающим серверу просто вернуть определенный документ.
  Метод POST наоборот сообщает о намерении передать на сервер некоторую информацию, что, впрочем, не отменяет последующее получение контента.
• action — содержит адрес PHP скрипта, который должен обработать эту форму

После нажатия кнопки «отправить» браузер выполняет POST запрос, который содержит введенные данные, на адрес, указанный в атрибуте action .

После отправки формы управление передается php скрипту, который должен получить переданные данные, выполнить с ними какие-либо действия (например, сохранить в базе данных) и показать результат.
Результатом может быть простое сообщение «ваши данные успешно отправлены».

Поэтому в первую очередь требуется научиться в сценарии получать данные из формы.
К счастью, в PHP это очень просто — все данные из формы находятся в глобальном ассоциативном массиве $_POST .
Этот массив всегда будет неявно присутствовать в сценарии, если он был загружен по методу POST .
Каждое поле из формы будет находиться в массиве, где ключом будет значение атрибута name , а значением содержимое поля.
Например, чтобы из формы всю информацию на экран, можно написать такой сценарий:

Функция isset служит для определения существует ли переданная ей переменная. Так мы проверяем, что сценарий загружен методом POST , т.е. была отправлена форма.

Как правило, после обработки формы в PHP, сценарий должен переадресовать пользователя на другую страницу, потому что если форма была отправлена через метод POST , то при обновлении страницы пользователем данные будут отправлены еще раз, а это в большинстве случаев нежелательное поведение.

Помимо текстовой информации, существует возможность отправлять на сервер файлы любых типов.
Пример формы для загрузки файла:

Тут есть два важных отличия от первого примера:

• добавился новый атрибут enctype который всегда должен иметь значение multipart/form-data . Если его не будет, то файл просто не отправится.
• сам файл загружается при помощи поля с типом «file»

В PHP загруженный файл будет доступен в другом специальном массиве — $_FILES .

PHP автоматически сохраняет загруженный файл во временную директорию на сервере. Но хранить там файлы нельзя, потому что эта директория очищается, а кроме того на такой файл нельзя дать ссылку на сайте. Решение здесь только одно — переместить загруженный файл в другую папку. Перемещение файла всегда выполняют сразу после загрузки.

Для начала надо убедиться, что в рабочей директории проекта существует папка для хранения файлов. Пусть она называется uploads .

Перемещение загруженного файла

Ты прекрасно знаешь, что для перемещения файла нужно знать где он находится сейчас и место на диске, куда он будет переноситься.
С текущим адресом всё крайне просто — он уже находится в массиве $_FILES . Новый адрес файла, в свою очередь, состоит из пути к папке и имени файла. Т.к. папка uploads находится там же, где и текущий сценарий, получить путь к ней можно так: dirname(__FILE__) .

Вот как выглядит перемещение файла в новую папку:

Функция move_uploaded_file() выполняет два действия:

1. Проверяет, что файл действительно загружен через форму
2. Перемещает загруженный файл по новому адресу

Валидация формы — это проверка содержимого её полей. Задача такой проверки — убедиться, что необходимые поля заполнены, а значения в них соответствуют ожидаемому формату.
Так, например, при регистрации пользователя на сайте он должен заполнить поля с адресом электронной почты и придумать себе пароль. Оба поля обязательны к заполнению, но значение из поля email также должно быть корректным email адресом.
Помимо текстовых значений формы валидировать можно и загружаемые файлы на их формат и размер.

Общий подход к валидации

При выполнения валидации любой формы порядок действий будет всегда одним: