Метод $.ajax() поддерживает следующие параметры:
- "xml" - возвращает XML документ, который может быть обработан с помощью jQuery.
- "html" - возвращает HTML как обычный текст, теги будут обработаны и выполнены после вставки в объектную модель документа (DOM ).
- "script" - расценивает ответ как JavaScript и возвращает его как обычный текст. Отключает кэширование с помощью добавления параметра к строке запроса _= , даже если парамета cache имеет значение true . Это превратит метод POST в GET для кроссдоменных запросов.
- "json" - расценивает ответ как JSON и возвращает объект JavaScript . Кроссдоменные "json" запросы преобразуются в "jsonp" , если в параметрах запроса не указано jsonp : false . Данные JSON парсятся в строгом порядке и должны соответствовать общепринятому формату , любой некорректный JSON отвергается и выдается ошибка. С версии jQuery 1.9, пустой ответ не принимается, сервер должен вернуть в качестве ответа NULL , или {} .
- "jsonp" - загружает данные в формате JSON , используя при этом формат загрузки JSONP . Добавляет дополнительный параметр "?callback=? " в конец URL адреса для указания имени функции обработчика. Отключает кэширование путем добавления параметра _= к URL адресу,даже если парамета cache имеет значение true .
- "text" - обычная текстовая строка.
- несколько значений - значения разделяются пробелом. Начиная с версии 1.5, jQuery может преобразовать тип данных, который получен в Content-Type заголовка, в тип данных, который вам требуется. Например, если вы хотите, чтобы текстовый ответ был расценен как XML, используйте "text XML" для этого типа данных. Вы также можете сделать JSONP запрос, получить его в виде текста и интерпретировать его в формате XML : "jsonp text XML" . Следующая строка позволит сделать тоже самое: "jsonp XML" , jQuery будет пытаться конвертировать из JSONP в XML , после неудачной попытки попытается преобразовать JSONP в текст, а затем из текста уже в XML .
Тип: Function (jqXHR jqXHR , String textStatus , String errorThrown ).
Функция обратного вызова, которая вызывается если AJAX запрос не был выполнен. Функция получает три аргумента:- jqXHR - объект jqXHR (в jQuery 1.4.х, объект XMLHttpRequest ).
- textStatus - строка, описывающую тип ошибки, которая произошла. Возможные значения (кроме null ) не "timeout" , "error" , "abort" и "parsererror" .
- errorThrown - дополнительный объект исключения, если произошло. При возникновении ошибки HTTP аргумент получает текстовую часть состояния, например, "Not Found" , или "Internal Server Error" .
global (по умолчанию: true ).
Тип: Boolean .
Логический параметр, который определяет допускается ли вызвать глобальные обработчики событий AJAX для этого запроса. Значением по умолчанию является true . Если Вам необходимо предотвратить вызов глобальных обработчиков событий, таких как.ajaxStart() , или.ajaxStop() , то используйте значение false .headers (по умолчанию: { } ).
Тип: PlainObject .
Объект, который содержит пары ключ/значение дополнительных заголовков запроса, предназначенные для отправки вместе с запросом с использованием объекта XMLHttpRequest . Обращаю Ваше внимание, что заголовок X-Requested-With: XMLHttpRequest добавляется всегда, но значение XMLHttpRequest по умоланию допускается изменить с использованием этого параметра. Значения headers также могут быть переопределены параметром beforeSend . Добавлен в версии jQuery 1.5.ifModified (по умолчанию: false ).
Тип: Boolean .
По умолчанию значение false , игнорирует поля заголовка HTTP запроса, а при значении true AJAX запрос переводится в статус успешно (success ), только в том случае, если ответ от сервера изменился с момента последнего запроса. Проверка производится путем проверки поля заголовка Last-Modified . Начиная с версии jQuery 1.4 , помимо заголовка Last-Modified производится проверка и "etag" (entity tag ) - это закрытый идентификатор, присвоенный веб-сервером на определенную версию ресурса, найденного на URL. Если содержание ресурса для этого адреса меняется на новое, назначается и новый etag.isLocal (по умолчанию: зависит от текущего местоположения).
Тип: Boolean .
Используйте значение true для определения текущего окружения как "локального" (например, file:///url), даже если jQuery не распознает его таким по умоланию. Следующие протоколы в настоящее время признаются как локальные: file , *-extension и widget . Если Вам необходимо изменить параметр isLocal , то рекомендуется сделать это один раз при помощи функции $.ajaxSetup() . Добавлен в версии jQuery 1.5.1.Тип: Boolean , или String .
Переопределяет имя функции обратного вызова в JSONP запросе. Это значение будет использоваться вместо "callback " ("http://domain.ru/test.php?callback=?" ) в составе части строки запроса в URL адресе. Например, значение { jsonp : "onLoad "} передастся на сервер в виде следующей строки запроса "http://domain/test.php?onLoad=?" .
Начиная с версии jQuery 1.5 при установке значения параметра jsonp в значение false предотвращает добавление строки "?callback " к URL адресу, или попытки использовать "=? " для преобразования ответа. В этом случае Вы дополнительно должны указать значение параметра jsonpCallback , например: { jsonp : false , jsonpCallback : "callbackName " } По соображениям безопасности, если Вы не доверяете цели ваших AJAX запросов, то рекомендуется установить значение параметра jsonp в значение false .jsonpCallback .
Тип: String , или Function .
Задает имя функции обратного вызова для JSONP запроса. Это значение будет использоваться вместо случайного имени, которое автоматически генерируется и присваивается библиотекой jQuery. Рекомендуется, чтобы jQuery самостоятелно генерировало уникальное имя, это позволит легче управлять запросами и обрабатывать возможные ошибки. В некоторых случаях установка собственного имени функции позволит улучшить браузерное кеширование GET запросов.
Начиная с версии jQuery 1.5, вы можете в качестве значения параметра jsonpCallback указать функцию. В этом случае, в значение параметра jsonpCallback должно быть установлено возвращаемое значение этой функцией.method (по умолчанию: "GET" ).
Тип: String .
Метод HTTP , используемый для запроса (например, "POST" , "GET" , "PUT" ). Добавлен в версии jQuery 1.9.0.mimeType .
Тип: String .
MIME тип, который переопределяет MIME тип, указанынй в объекте XHR по умолчанию. Добавлен в версии jQuery 1.5.1.password .
Тип: String .
Пароль, который будет использован с XMLHttpRequest в ответе на запрос проверки подлинности доступа HTTP .processData (по умолчанию: true ).
Тип: Boolean .
По умолчанию данные, передаваемые в параметр data в качестве объекта будут обработаны и преобразованы в строку запроса, подходящую для типа данных по умолчанию "application/x-www-form-urlencoded" . Если Вам необходимо отправить DOMDocument , или другие не обработанные данные, то установите значение этого параметра в false .scriptCharset .
Тип: String .
Устанавливает атрибут charset (кодировка символов) на HTML тег , используемый в запросе. Используется, когда кодировка на странице отличается от кодировки удаленного скрипта. Обратите внимание, что параметр scriptCharset применяется только в кроссдоменных запросах с параметром type со значением "GET" (по умолчанию) и параметром dataType со значением "jsonp" , или "script" .statusCode (по умолчанию: { } ).
Тип: PlainObject .
Объект числовых кодов HTTP и функции, которые будут вызываться, когда код ответа сервера имеет соотвествующее значение (определенный код HTTP ). Например, следующая функция будет вызвана, если от сервера получен код ответа 404 , или "Not found" (стандартный код ответа HTTP о том, что клиент был в состоянии общаться с сервером, но сервер не может найти данные согласно запросу.): $.ajax({ statusCode : { 404: function (){ // выполнить функцию если код ответа HTTP 404 alert("страница не найдена "); } , 403: function (){ // выполнить функцию если код ответа HTTP 403 alert("доступ запрещен "); } } } );success .
Тип: Function (Anything data , String textStatus , jqXHR jqXHR ).
Функция обратного вызова, которая вызывается если AJAX запрос выполнится успешно. Функции передаются три аргумента:- data - данные возвращенные с сервера. Данные форматируюся в соответствии с параметрами dataType , или dataFilter , если они указаны
- textStatus - строка описывающая статус запроса.
- jqXHR - объект jqXHR (до версии jQuery 1.4.x объект XMLHttpRequest ).
timeout .
Тип: Number .
Устанавливает в миллисекундах таймаут для запроса. Значение 0 означает, что таймаут не установлен. Обращаю Ваше внимание, что этот параметр переопределяет значение таймаута, установленного с помощью функции $.ajaxSetup() . Таймаут ожидания начинается в момент вызова метода $.ajax() .traditional .
Тип: Boolean .
Если вы планируете использовать традиционные параметры сериализации (подходит для использования в строке URL запроса или запроса AJAX ), то установите значение этого параметра в true .type (по умолчанию: "GET" ).
Тип: String .
Псевдоним (алиас) для параметра method . Вы должны использовать type , если вы используете версии jQuery до 1.9.0 .url (по умолчанию: текущая страница ).
Тип: String .
Строка, содержащая URL адрес, на который отправляется запрос.username .
Тип: String .
Имя пользователя, которое будет использовано с XMLHttpRequest в ответе на запрос проверки подлинности доступа HTTP .xhr (по умолчанию: ActiveXObject , когда доступен (Internet Explorer ), в других случаях XMLHttpRequest .
Тип: Function() .
Обратный вызов для создания объекта XMLHttpRequest . С помощью этого параметра Вы можете переопределить объект XMLHttpRequest , чтобы обеспечить свою собственную реализацию.xhrFields .
Тип: PlainObject .
Объект, содержащий пары имя_поля: значение_поля, которые будут установлены на объект XHR . Например, вы можете определить, должны ли создаваться кроссдоменные запросы с использованием таких идентификационных данных как cookie , авторизационные заголовки или TLS сертификаты: $.ajax({ url : "cross_domain_url ", // адрес, на который будет отправлен запрос xhrFields : { withCredentials: true // поддерживается в jQuery 1.5.1 + } } );
accepts (по умолчанию: зависит от dataType ).
Тип: PlainObject
.
Набор пар ключ/значение, которые отправляется в Accept
заголовка запроса. Этот заголовок сообщает серверу, какой ответ запрос будет принимать в ответ. Обратите внимание, что значение параметра, указанного в dataType
(тип данных, которые мы ожидаем от сервера) сопоставляется с указанным в параметре. Кроме того, для корректной обработки ответа от сервера необходимо в параметре converters
указать функцию, которая возвращает преобразованное значение ответа. Например:
$.ajax({
accepts
: {
mycustomtype: "application/x-some-custom-type
"
}
,
// указываем как обрабатывать ответ
converters
: {
"text mycustomtype
": function
(result
) {
// возвращаем преобразованное значение ответа
return
newresult;
}
}
,
// Ожидаемый тип данных ("mycustomtype")
dataType
: "mycustomtype
"
}
);
async (по умолчанию: true ).
Тип: Boolean
.
По умолчанию, все запросы отправляются асинхронно, если вам необходимо организовать синхронные запросы, то установите этот параметр в false
. Обратите внимание, что кроссдоменные запросы и элемент, параметр dataType
которого имеет значение "jsonp"
не поддерживают запросы в синхронном режиме. Учтите, что используя синхронные запросы вы можете временно заблокировать браузер отключив какие-либо действия пока запрос будет активен.
Функция обратного вызова, которая будет вызвана перед осуществлением AJAX запроса. Функция позволяет изменить объект jqXHR (в jQuery 1.4.х объект XMLHTTPRequest ) до его отправки. Объект jqXHR это надстройка расширяющая объект XMLHttpRequest , объект содержит множество свойств и методов, которые позволяет получить более полную информацию об ответе сервера, а так же объект содержит Promise методы. Если функция beforeSend возвращает false , то AJAX запрос будет отменен. Начиная с версии jQuery 1.5 функция beforeSend будет вызываться независимо от типа запроса.
cache (по умолчанию: true , для dataType "script" и "jsonp" false ).
Тип: Boolean
.
Если задано значение false
, то это заставит запрашиваемые страницы не кэшироваться браузером. Обратите внимание, что значение false
будет правильно работать только с HEAD
и GET
запросами.
complete .
Тип: Function
(jqXHR
jqXHR
, String
textStatus
).
Функция, которая вызывается, когда запрос заканчивается (функция выполняется после AJAX событий "success"
или "error"
). В функцию передаются два параметра: jqXHR
(в jQuery 1.4.х объект XMLHTTPRequest
) и строка соответствующая статусу запроса ("success"
, "notmodified"
, "nocontent"
, "error"
, "timeout"
, "abort"
, или "parsererror"
). Начиная с версии jQuery 1.5 параметр complete
может принимать массив из функций, которые будут вызываться по очереди.
contents .
Тип: PlainObject
.
Объект состоящий из пар строка/регулярное выражение, определяющих, как jQuery будет обрабатывать (парсить) ответ в зависимости от типа содержимого. Добавлен в версии jQuery 1.5.
contentType (по умолчанию: "application/x-www-form-urlencoded; charset=UTF-8" ).
Тип: Boolean
, или String
.
Определяет тип содержимого, которое указывается в запросе при передаче данных на сервер. С версии с jQuery 1.6 допускается указать значение false
, в этом случае jQuery не передает в заголовке поле Content-Type
совсем.
context .
Тип: PlainObject
.
При выполнении AJAX функций обратного вызова контекстом их выполнения является объект window
. Параметр context
позволяет настроить контекст исполнения функции таким образом, что $(this
) будет ссылаться на определенный DOM
элемент, или объект. Например:
$.ajax({
url
: "test.html
",
context
: $(".myClass
"), // новый контекст исполнения функции
success
: function
(){
// если запрос успешен вызываем функцию
$(this
).html("Всё ок
"); // добавлем текстовое содержимое в элемент с классом.myClass
}
}
);
converters
Значения по умолчанию:
{
"* text
": window.String, // любой тип в текст
"text html
": true
, // текст в html
"text json
": jQuery.parseJSON, // текст в JSON
"text xml
": jQuery.parseXML // текст в XML
}
Тип: PlainObject
.
Объект, содержащий тип данных для конвертации и способ его преобразования. Значение каждого преобразователя является функцией, которая возвращает преобразованное значение ответа. Добавлен в версии jQuery 1.5.
crossDomain (по умолчанию: false для запросов внутри того же домена, true для кроссдоменных запросов).
Тип: Boolean
.
Если вы хотите сделать кроссдоменный запрос находясь на том же домене (например jsonp-запрос), то установите этот параметр в true
. Это позволит, к примеру, сделать перенаправление запроса на другой домен с вашего сервера. Добавлен в версии jQuery 1.5.
Тип: PlainObject
, или String
, или Array
.
Данные, которые будут отправлены на сервер. Если они не является строкой, то преобразуются в строку запроса. Для GET
запросов строка будет добавлена к URL. Для того, чтобы предотвратить автоматическую обработку вы можете воспользоваться параметром processData
со значением false
. Если данные передаются в составе объекта, то он должен состоять из пар ключ/значение. Если значение является массивом, то jQuery сериализует несколько значений с одним и тем же ключом (в зависимости от значения параметра traditional
, который позволяет задействовать традиционный тип сериализации основанный на методе $.param).
dataFilter .
Тип: Function
(String
data
, String
type
) => Anything
.
Функция вызывается после успешного выполнения AJAX запроса и позволяет обработать "сырые" данные, полученные из ответа сервера. Возврат данных должен происходить сразу после их обработки. Функция принимает два аргумента: data
- данные полученные от сервера в виде строки и type
- тип этих данных (значение параметра dataType
).
dataType (по умолчанию: xml , json , script , или html ).
Тип: String
.
Определяет тип данных, который вы ожидаете получить от сервера. Если тип данных не указан, то jQuery будет пытаться определить его на основе типа MIME из ответа (XML
тип MIME
приведет к получению XML , с версии jQuery 1.4 json
будет давать объект JavaScript
, script
будет выполнять скрипт, а все остальное будет возвращено в виде строки).
Основные типы (результат передается в качестве первого аргумента в функцию обратного вызова success ):
«Чем для Вас является успех в жизни???»
Прошу Вас, задумайтесь, остановитесь на минутку.
Хорошо, а теперь разрешите мне помочь Вам. О том, что не является успехом , я писал в предыдущей рассылке. Эти понятия откинем сразу же.
Успех – это душевная гармония.
Успех – это быть счастливым.
Успех – это реализация самого себя и раскрытие своего потенциала.
Успех – это наполненность в жизни.
Успех – это заниматься любимым делом, которое Вас зажигает и Вы можете делать это круглосуточно.
Успех – это отдавать себя для других и делать этот мир лучше, а других людей счастливее
.
Успех неразрывно связан с состоянием души. Наша душа пришла в этот мир, чтоб получить удовольствие и реализовать себя, а мы (наш разум, наше тело, наше сознание) должны поддержать ее в этом. Когда наша душа творит и реализовывает себя мы чувствуем себя счастливыми. Когда мы чувствуем и видим, что творение нашей души и то, что мы делаем приносит огромную пользу другим людям, мы чувсвтуем блаженство. Вот это и называется успех. Успех – это наполненность жизни.
Любая реализация талантов души возможна только благодаря другим людям . Душа творит не для себя. Она творит для других – чтоб помочь им и сделать жизнь других наполненной и передать им частичку своего счастья. Счастливый человек передает другим частичку своего счастья, несчастный человек передает другим свое несчастье . Избегайте несчастливых людей!
Если вдруг в момент изчезнут все люди, реализация себя станет невозможной – какой смысл в том, чтоб писать книги, ведь их никто не прочитает, какой смысл создавать новые модели одежды, ведь их никто не будет носить, в чем смысл строить новые дома, в которых никто не будет жить?
Очевидно, что в этом нет смысла.
Тут проявляется двойная природа успеха: душа творит и реализовывает себя, а также помогает другим людям стать счастливее
.
Самое точное определение успеха, которое я бы мог дать звучало бы так:
успех – это реализация своих подлинных талантов, которые делают наш мир лучше, более совершенным, а людей счастливее.
Хочу, чтоб Вы глубоко осознали, что люди, которые живут только для себя и собирают богатства только для себя, несчастны . Они собирают эти богатства с целью заполнить ту душевную пустоту, которая образовалась в результате бессмысленной жизни . Но эту пустоту можно заполнить только любовью, принося ценность другим людям. Душа счастлива, когда она отдает себя без избытка на то, чтоб делать этот мир лучше. А какой смысл во всех тех богатствах, которые собрал человек, когда он уйдет из жизни, ведь мы не долговечны. Душа приходит, чтоб создать ценность, реализовать себя и затем возвращается «домой». Если она не создает эту ценность, а занимается чем-то другим, она чувствует себя плохо. Она чувствует, что пришла в этот мир и не делает того, чего хочет. И причиной тому наш разум – он ослеплен «успехом» в общем понимание этого слова . Он гонится за иллюзорным, а когда достигает этого, если вообще достигает, он понимает бессмысленность достигнутого.
А что такое успех в общем понимание?
- богатство (деньги, материальные вещи)
- слава, власть, популярность
- статус
Но посмотрите это все исходит от эго. Человек хочет почувствовать свою значимость, но он не понимает, что богатства, слава, статус – это иллюзия. Они похожи на морскую воду, которую сколько не пей, никогда не удовлетворишь жажду. Потому люди всю жизнь и гонятся за ними. Они думают, вот заработаю столько денег и буду счастлив, вот выйду на уровень дохода в $100,000 в год и тогда буду счастлив, вот когда я выйду на сцену и буду петь я буду счастлива, вот выйду замуж, вот буду иметь детей... Вы можете это проверить, но я со 100% уверенностью утверждаю, что Вы не будете счастливы. Более того ваш уровень счастья станет еще меньше. Вы отдаляетесь от своего призвания, и понимая это душа становится еще более несчастной. Чем больше богатства, славы, статуса Вы получаете, тем больший контроль над жизнью берет разум и тем дальше отодвигается роль души. Но истинное счастье исходит от души !!!
Успех – это гармония между душой и разумом. Роль разума состоит в том, чтоб помочь душе самореализоваться. Мы неправильно ставим приоритеты. Недолговечное тело и материальные вещи мы ставим на первое место, а бессмертную душу и неисчерпаемые богатсва мы ставим на последнее. В Библии сказано: «собирайте богатсва на небе, а не Земле». Наше тело – это транспортное средство для души . Душа связана с Высшим Разумом и только она способна понять, что нужно для этого мира. Вселенная способствует людям, которые идут своим путем . Свой путь наименее энергозатратный, а в нашем мире все течет путем наименьшего сопротивления. Я всегда говорю, что успех – это нормальное течение событий. Неудача – это отклонение от нормы. Если сейчас Вы не настолько удачны, как вы этого хотите – значит Вы занимаетесь не тем, для чего предназначены. Душа и разум находятся в разладе. И чем больше этот разлад, тем более несчастен человек.
Но Вы не подумайте, что я говорю, что человеку не нужно материальное. Очень даже нужно. И вот почему: когда у человека нет денег, он вынужден идти на работу и заниматься какой-то "глупостью". Человек тратит 10 часов в сутки для того, чтоб заработать деньги, но делая это он не реализовывает себя. Шеф - вот тот человек, который за счет Вас реализовывает себя. (я говорю, как происходит в большинстве случаев. Большинство людей ненавидят свою работу, но работают потому что нужны деньги, чтоб выжить).
Материальные вещи создают комфорт для души. Материальные вещи обустраивают этот мир для души. Душе намного приятнее творить шедевры в местах, которые ее вдохновляют. Намного лучше рисовать картину в доме на берегу моря, чем на "помойной яме". Душе нужен покой и уют, чтоб творить. Но какой может быть покой, если в семье не хватает денег и каждый день муж и жена ругаются по этому поводу.
Душе для того, чтоб выразить себя нужно время. Только по прошествию некоторого времени созданная душой ценность может продаваться и продаваться в сотни, а то и тысячи раз дороже, чем человек получает на работе. Но чтоб создать такую ценность нужно время. Лично мне потребовалось 5 месяцев, чтоб выйти на какой-нибудь мизерный доход. Через 8 месяцев мой сайт начал приносить доход, на который бедная семья уже смогла бы прожить. И только через 17 месяцев мой сайт стал приносить доход, который уже заменит доходы с очень высокооплачиваемой работы.
Потребовалось 17 месяцев, чтоб заменить работу. Но теперь я свободен! Я занимаюсь любимым делом и это только начало. Для моих мечтаний нет ограничений - а значит и для меня нет ограничений. Когда Вы занимаетесь своим делом, Ваш доход ограничен только вашим воображением и только. Кто на работе зарабатывает $1,000,000 в год? Да, может есть единици. Но занимаясь своим делом даже это не придел.
Материальное важно, но только для того, чтоб удовлетворять потребности жить.
Скажу честно: не получая дохода, тяжелее творить и создавать шедевры . Разум постоянно говорит: «то, что ты делаешь это хорошо, но за что мы будем жить?». И этот вопрос постоянно и сильно отвлекает от творчества. Он отбирает наше счастье. Для того, чтоб выключить этот диалог любимое занятие должно приносить деньги. Конечно, разум потом начинает задавать другие вопросы, но чем больше денег приносит любимое дело, тем менее больными и отвлекающими стают эти вопросы.
Часто люди работают на работе, зарабатывают деньги, но еще имеют хобби. Что такое хобби?
Хобби – это занятие для души, которое не приносит дохода. Но почему хобби не превратить в работу? Самые счастливые люди – это те, у которых хобби является работой
. Они нон-стоп занимаются любимым делом.
Все, о чем я говорю, о работе, о деньгах я хочу до Вас донести две важные мысли:
1) Душа и разум должны быть в гармонии
2) Нематериальное всегда должно стоять на первом месте
Фокус должен быть только на нематериальном! Материальное придасться, как следствие
.
Вот правильные жизненные приоритеты:
счастье -> здоровье -> богатство
А многие люди живут по схеме
богатство->здоровье->счастье
А что еще хуже, есть люди, которые живут по схеме
богатство->богатство->богатство
Не удивительно, что они не счастны. Эти люди имеют миллионы, но у них нет друзей, у них проблемы в семье. У них проблемы в отношениях с людьми. Потому что они думают, что все люди, которые их окружают, с ними только из-за их денег и только. Я не знаю, как Вы, но я бы не хотел такого счастья. Когда же приоритеты в жизни расставлены верно богатство возникает, как следствие. Нет смысла сосредотачиваться на нем. Высокий уровень счастья и здоровья неизбежно ведет к высокому уровню доходов .
Материальные вещи и наши богатства могут служить только, как дополнение к нашему счастью. Они не могут служить фундаментом. То, что является фундаментом, мы уже с Вами обсудили выше.
). Облако предназначено для того, чтобы запускать различные PHP-скрипты по расписанию или через API. Как правило, эти скрипты обрабатывают очереди, и нагрузка «размазывается» приблизительно по 100 серверам. Ранее мы акцентировали внимание на том, как реализована управляющая логика, которая отвечает за равномерное распределение нагрузки по такому количеству серверов и генерацию заданий по расписанию. Но, помимо этого, нам потребовалось написать демон, который был бы способен запускать наши PHP-скрипты в CLI и следить за статусом их исполнения.
Изначально он был написан на Си, как и все остальные демоны в нашей компании. Однако мы столкнулись с тем, что существенная часть процессорного времени (около 10%) тратилась, по сути, впустую: это запуск интерпретатора и загрузка «ядра» нашего фреймворка. Поэтому, чтобы иметь возможность инициализировать интерпретатор и наш фреймворк только один раз, было принято решение переписать демон на PHP. Мы назвали его Phprock
syd (по аналогии с Phproxyd - PHP Proxy Daemon, демоном на Си, который у нас был до этого). Он принимает запросы на запуск отдельных классов и делает fork() на каждый запрос, а также умеет сообщать о статусе исполнения каждого из запусков. Такая архитектура во многом похожа на модель веб-сервера Apache, когда вся инициализация делается один раз в «мастере» и «дети» занимаются уже именно обработкой запроса. В качестве дополнительной «плюшки» мы получаем возможность включить opcode cache в CLI, который будет правильно работать, поскольку все дети наследуют ту же область общей памяти, что и мастер-процесс. Чтобы уменьшить задержки при обработке запроса на запуск, можно делать fork() заранее (prefork-модель), но в нашем случае задержки на fork() составляют около 1 мс, что нас вполне устраивает.
Однако, поскольку мы обновляем код весьма часто, этот демон также приходится часто перезапускать, иначе код, который загружен в него, может устареть. Так как каждый рестарт сопровождался бы массой ошибок вида connection reset by peer
, включая отказы в обслуживании конечных пользователей (демон полезен не только для облака, но и для части нашего сайта), мы решили поискать способы сделать рестарт демона без потери уже установленных соединений. Существует одна популярная техника, с помощью которой делается graceful reload
для демонов: делается fork-exec и при этом потомку передается дескриптор от listen-сокета. Таким образом, новые соединения принимаются уже новой версией демона, а старые «дорабатывают» с использованием старой версии.
В этой статье мы рассмотрим усложненный вариант graceful reload : старые подключения будут продолжать обрабатываться новой версией демона, что важно в нашем случае, поскольку иначе он будет запускать старый код.
Теория Давайте для начала подумаем: возможно ли то, что мы хотим получить? И если да, то как этого достичь?Поскольку демон работает под Linux, который является POSIX-совместимым, нам доступны следующие возможности:
Для начала мы внесем пару небольших патчей в код PHP, чтобы добавить возможность получить fd у потока (stream) и сделать так, чтобы fopen(php://fd/) не приводил к открытию копии дескриптора (второе изменение несовместимо с текущим поведением PHP, поэтому вместо него можно добавить новый «адрес», к примеру, php://fdraw/):
Код патча
diff --git a/ext/standard/php_fopen_wrapper.c b/ext/standard/php_fopen_wrapper.c
index f8d7bda..fee964c 100644
--- a/ext/standard/php_fopen_wrapper.c
+++ b/ext/standard/php_fopen_wrapper.c
@@ -24,6 +24,7 @@
#if HAVE_UNISTD_H
#include
#endif
+#include
#include "php.h"
#include "php_globals.h"
@@ -296,11 +297,11 @@ php_stream * php_stream_url_wrap_php(php_stream_wrapper *wrapper, char *path, ch
"The file descriptors must be non-negative numbers smaller than %d", dtablesize);
return NULL;
}
-
- fd = dup(fildes_ori);
- if (fd == -1) {
+
+ fd = fildes_ori;
+ if (fcntl(fildes_ori, F_GETFD) == -1) {
php_stream_wrapper_log_error(wrapper, options TSRMLS_CC,
- "Error duping file descriptor %ld; possibly it doesn"t exist: "
+ "File descriptor %ld invalid: "
"[%d]: %s", fildes_ori, errno, strerror(errno));
return NULL;
}
diff --git a/ext/standard/streamsfuncs.c b/ext/standard/streamsfuncs.c
index 0610ecf..14fd3b0 100644
--- a/ext/standard/streamsfuncs.c
+++ b/ext/standard/streamsfuncs.c
@@ -24,6 +24,7 @@
#include "ext/standard/flock_compat.h"
#include "ext/standard/file.h"
#include "ext/standard/php_filestat.h"
+#include "ext/standard/php_fopen_wrappers.h"
#include "php_open_temporary_file.h"
#include "ext/standard/basic_functions.h"
#include "php_ini.h"
@@ -484,6 +485,7 @@ PHP_FUNCTION(stream_get_meta_data)
zval *arg1;
php_stream *stream;
zval *newval;
+ int tmp_fd;
if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "r", &arg1) == FAILURE) {
return;
@@ -502,6 +504,9 @@ PHP_FUNCTION(stream_get_meta_data)
add_assoc_string(return_value, "wrapper_type", (char *)stream->wrapper->wops->label, 1);
}
add_assoc_string(return_value, "stream_type", (char *)stream->ops->label, 1);
+ if (SUCCESS == php_stream_cast(stream, PHP_STREAM_AS_FD_FOR_SELECT | PHP_STREAM_CAST_INTERNAL, (void*)&tmp_fd, 1) && tmp_fd != -1) {
+ add_assoc_long(return_value, "fd", tmp_fd);
+ }
add_assoc_string(return_value, "mode", stream->mode, 1);
Мы добавили поле fd в результат, возвращаемый функцией stream_get_meta_data(), если оно имеет смысл (например, для zlib-потоков поле fd не будет присутствовать). Также мы заменили вызов dup() от переданного файлового дескриптора на простую его проверку. К сожалению, этот код не будет работать без модификаций под Windows, поскольку вызов fcntl() - это POSIX-specific, так что полный патч должен содержать в себе дополнительные ветки кода под другие ОС.Демон без возможности перезапуска Для начала напишем небольшой сервер, который сможет принимать запросы в формате JSON и отдавать какой-нибудь ответ. К примеру, он будет отдавать количество элементов в массиве, который пришел в запросе.
Демон прослушивает порт 31337. Результат работы должен быть примерно следующим:
Мы будем использовать stream_socket_server() для того, чтобы начать слушать порт, и stream_select() для того, чтобы определить, какие дескрипторы готовы к чтению/записи.
Код простейшей реализации (Simple.php)
