PHP

PHP е популярен скриптов език, разработен на C. Той е удобен и лесен за създаване на сайтове с динамично съдържание. Най-често се използва заедно с бази данни MySQL.

Следните версии на PHP са инсталирани на нашите сървъри: PHP 8.2 PHP 8.1 (по подразбиране) PHP 8.0 PHP 7.4 PHP 7.3 (остаряла) PHP 7.2 (остаряла) PHP 7.1 (остаряла) PHP 5.6 (остаряла) PHP 5.3 (остаряла) Поддържани PHP технологии Следните технологии за изпълнение на PHP скриптове се поддържат на нашите сървъри: CGICGI (Common Gateway Interface) позволява на сървъра да работи с външни за него програми, каквито са PHP скриптовете. В сравнение с FPM CGI е по-бавна технология и използва повече системни ресурси, но е възможно да се налага някои скриптове да се изпълняват чрез CGI от съображения за съвместимост. FPM с OPcache (препоръчана)FPM (FastCGI Process Manager) ползва FastCGI протокола. FPM поддържа работещи процеси за изпълнение на заявки, за да намали използването на ресурси на сървъра при стартирането на нови CGI процеси. Това води до по-бързо изпълнение на заявките. FPM работи в комбинация с OPcache - система за кеширане, която пази предварително компилиран байт код в сървърната памет. Това допълнително увеличава производителността и подобрява скоростта на зареждане. Версия и технология на PHP по подразбиране По подразбиране, всички нови акаунти се конфигурират да ползват най-новата PHP версия, която е налична на сървърите ни и се поддържа от повечето популярни приложения, заедно с FPM с OPcache. Всеки акаунт ползва версията и технологията, с които е бил конфигуриран в началото, освен ако не промените тези настройки ръчно. Ако акаунтът Ви е създаден, когато 7.3 е била най-новата версия на PHP и CGI е била технологията по подразбиране за изпълнение на PHP скриптове, той ще остане с тези настройки, докато не ги промените. Версията и технологията за нови поддомейни се управляват по същия начин - те ще бъдат настроени автоматично с най-новата версия на PHP и с FPM с OPcache. Промяна на версията/технологията на PHP Можете да смените версията и технологията за PHP поотделно за всеки поддомейн в акаунта си на страницата PHP настройки в Контролния панел. Ако искате да промените определени настройки на PHP, има повече информация как да направите това в статията PHP настройки. Версия на PHP за интерпретатора на командния ред По подразбиране, PHP на командния ред (php.cli) използва най-новата версия на PHP на сървъра към момента на отваряне на акаунта. В някои редки случаи е възможно акаунт да бъде конфигуриран с по-стара версия за php.cli заради остарели настройки. Можете да проверите или да промените версията за PHP на командния ред от раздела Избор на PHP CLI версия на страницата PHP настройки в Контролния панел. Списък с пътеките до изпълнимите файлове за всички версии на PHP, които се поддържат за акаунта Ви, има на страницата Информация за сървъра в Контролния панел. Можете да ползвате тези файлове, за да изпълнявате скриптове с конкретна версия на PHP чрез планирани задачи или чрез командния ред. Ако искате да изпълните скрипта ~/www/www/directory/file.php с PHP 7.2, например, можете да ползвате следната команда: /usr/local/bin/php72.cli ~/www/www/directory/file.php Смяна на PHP версията на PHP само за определена директория Информацията в този раздел се отнася само за поддомейни, които ползват CGI. Има повече информация за приоритетите на конфигурационните файлове на PHP в статията Конфигурационни файлове за PHP и техния приоритет. Важно: Ако искате да смените версията на PHP за целия поддомейн, можете да намерите повече информация за това в раздела Промяна на версията/технологията на PHP на тази статия. Можете да настроите определени директории да ползват дадена версия на PHP с CGI, като добавите директива в .htaccess файла в директорията (можете да го създадете, ако не съществува). Таблицата по-долу показва директивите, които трябва да ползвате за съответните версии на PHP: PHP версия .htaccess директива PHP 8.2   AddHandler application/x-httpd-php82 .php PHP 8.1   AddHandler application/x-httpd-php81 .php PHP 8.0   AddHandler application/x-httpd-php80 .php PHP 7.4   AddHandler application/x-httpd-php74 .php PHP 7.3   AddHandler application/x-httpd-php73 .php PHP 7.2   AddHandler application/x-httpd-php72 .php PHP 7.1   AddHandler application/x-httpd-php71 .php PHP 5.6   AddHandler application/x-httpd-php56 .php PHP 5.3   AddHandler application/x-httpd-php53 .php   Остарели PHP версии PHP 5.3, PHP 5.6, PHP 7.1, PHP 7.2 и PHP 7.3 не се поддържат от разработчиците на PHP и няма обновления за тях. Поради тази причина, тези версии на PHP може да бъдат премахнати от нашите сървъри по всяко време. Ако ползвате някоя от тези версии на PHP, Ви препоръчваме да ги смените с по-нова версия. Имайте предвид и че PHP 5.3 и PHP 5.6 на нашите сървърите може да не съдържат всички стандартни разширения за PHP от съображения за съвместимост. PHP 5.3 може да се ползва само със CGI за PHP технология. Не е възможно да се пусне FPM с OPcache за PHP 5.3 от съображения за сигурност и производителност.

Подробна документация за PHP може да бъде намерена на следния адрес: http://www.php.net/manual

Можете да настроите сървъра да изпълнява PHP код във вашите страници с разширение .html и .htm чрез .htaccess файл. Ако няма такъв файл в директорията, в която искате да направите промяната, можете да го създадете лесно чрез секция Файлов Мениджър на Контролния панел. Добавете следния ред във файла:AddHandler application/x-httpd-php .html .htmАко желаете да използвате PHP версия различна от стандартната за сървъра, можете да намерите информация тук: Поддържани версии на PHPНапример, за да използвате PHP 5.6, добавете следния ред:AddHandler application/x-httpd-php56 .html .htm

Най-често срещаната причина за това съобщение за грешка са неправилни права на вашите PHP файлове.Моля, проверете дали вашите скриптове не са с права за достъп 666 или 777. Също така проверете дали директорията, в която се намират скриптовете не е с такива права. На нашите сървъри не е необходимо да задавате права за писане за всички (world-writable). Права 666 и 777 са несигурни, тъй като позволяват на всеки потребител на сървъра да променя тези файлове.

Можете да променяте PHP настройките на Вашия акаунт чрез php.ini или .user.ini файлове. Съветваме Ви да използвате .user.ini файлове, тъй като те работят рекурсивно за разлика от php.ini файловете, но имайте предвид, че определени PHP настройки могат да се променят само с php.ini файлове (напр. модулите ionCube и ImageMagick). Повече информация за конфигурационните файлове за PHP, техните основни разлики и техният приоритет е налична в статията Конфигурационни файлове и техния приоритет. Можете да създавате/качвате PHP конфигурационни файлове във Вашия акаунт ръчно чрез страницата Файлове в хостинг Контролния панел. Промяна на PHP настройките за поддомейн За да промените PHP настройките за даден поддомейн, натиснете бутона Промени до него в страницата PHP настройки в хостинг Контролния панел. Ще бъдете пренасочени към страница за управление на PHP настройки с интуитивен интерфейс, където можете да променяте различни PHP настройки и модули. Можете да използвате бутона Редактирай до php.ini файла на поддомейна в страницата за управление на PHP настройки, за да го редактирате в текстов режим чрез страницата Файлове в хостинг Контролния панел. Ако предпочитате да редактирате php.ini файловете директно в текстов режим, можете да използвате страницата Файлове на хостинг Контролния панел. Важно: Ако не използвате страницата PHP настройки в хостинг Контролния панел за промяна на PHP настройките на поддомейн, който използва FPM технологията, трябва ръчно да презаредите основния FPM процес, като отидете в раздел PHP настройки в хостинг Контролния панел, натиснете бутона Промени до конкретния поддомейн и натиснете бутона Презареди основния FPM процес. Промяна на PHP настройките за папка Ако желаете да приложите различни PHP настройки само за дадена папка, можете да създадете php.ini или .user.ini файл в нея чрез страницата Файлове в хостинг Контролния панел. Съветваме Ви да добавите директивите описани в раздел Съдържание на php.ini файлове от статията ни Конфигурационни файлове за PHP и техния приоритет от съображения за съвместимост. Промяна на PHP настройките за файл Можете да промените стойностите на PHP настройки за даден файл чрез PHP функцията ini_set(). Тя Ви позволява да използвате PHP настройки по Ваш избор, вместо PHP настройките от php.ini или .user.ini конфигурационни файлове, за дадения файл. Промяна на PHP настройките в глобалния php.ini файл на Вашия акаунт За да промените PHP настройките в глобалния php.ini файл на Вашия хостинг акаунт, отидете на страницата PHP настройки в хостинг Контролния панел и използвайте бутона Редактирай в раздел Редактиране на глобалния php.ini файл. Ако Вашият хостинг акаунт няма глобален php.ini файл, ще видите бутон Създай на мястото на бутона Редактирай, който ще Ви позволи да създадете глобален php.ini файл за Вашия акаунт.

Ако желаете да виждате грешките върнати от PHP интерпретатора, можете да включите записването на PHP грешки (PHP error logging), като промените PHP настройките за Вашия акаунт. Повече информация относно промяната на PHP настройки може да откриете в статията ни Промяна на PHP настройките за Вашия акаунт. За да включите записването PHP грешки, добавете следните директиви в PHP конфигурационен файл (php.ini) във Вашия хостинг акаунт: error_reporting = E_ALL | E_STRICT log_errors = Ondisplay_errors = Offerror_log = /home/USERNAME/private/php-errors.log Заменете USERNAME с реалното потребителско име на Вашия хостинг акаунт (можете да намерите своето потребителско име в горния ляв ъгъл на Вашия хостинг Контролен панел). Горните настройки са препоръчителни и можете да ги променяте по Ваше усмотрение. Директивата error_reporting определя кои грешки да бъдат записвани. Константата E_ALL включва всички PHP грешки и предупреждения, а константата E_STRICT задава на PHP интерпретатора да показва предложения за промяна в PHP кода, така че той да е съвместим с бъдещи версии на PHP. Можете да разгледате списък с всички error_reporting настройки тук:https://php.net/manual/en/errorfunc.constants.php Редът log_errors = On включва записването на PHP грешките в лог файл на сървъра. Ако тази опция е със стойност Off, няма да се  записват никакви PHP грешки в лог файл на сървъра. Редът display_errors = Off изключва показването на грешки в браузъра. Ако зададете тази опция да е On, тогава PHP грешките ще се показват в браузъра при изпълнение на PHP скрипта. Редът error_log = /home/USERNAME/private/php-errors.log задава на PHP интерпретатора да записва грешките във файл във Вашата директория "Private" на сървъра. Не забравяйте да промените USERNAME с потребителското име на Вашия хостинг акаунт. Ако желаете, можете да зададете друга папка или файл, където да се записват грешките от PHP интерпретатора.

PHP скриптовете на Вашия акаунт ползват часовата зона на сървъра, която зависи от местоположението на техническия център. Вижте статията Часова зона на сървъра за повече информация. Ако желаете да смените часовата зона за Вашите PHP скриптове или приложения, трябва да промените стойността на PHP директивата date.timezone. За да направите това за домейн/поддомейн, използвайте раздел PHP Настройки на Вашия Контролен панел и последвайте тези стъпки: Натиснете бутона Промени до домейна/поддомейна. Изберете желаната от Вас часова зона от падащото меню до директивата date.timezone от раздел Директиви. Ако не виждате директивата date.timezone, натиснете бутона Покажи допълнителните директиви, с които ще се покажат всички директиви, които можете да променяте през интерфейса за управление на PHP настройки. Натиснете бутона Запази. Часовата зона може да бъде променена и чрез ръчното добавяне на следния код в PHP конфигурационен файл: date.timezone = "chasova_zona" Заменете chasova_zona с часовата зона, която бихте желали да използвате. Списък с часовите зони, поддържани в актуалната версия на PHP, можете да намерите на адрес http://php.net/timezones. Повече информация за промяната на PHP настройки е налична в статията ни Промяна на PHP настройките за Вашия акаунт. Промяна на часовата зона за PHP 5.3 PHP 5.3 е остаряла версия и не се поддържа от разработчиците на PHP, затова съветваме всички клиенти да преустановят изполването на тази версия. Ако искате да промените часовата зона за скриптове, използващи PHP 5.3, освен промяната на стойността на директивата date.timezone (описана по-горе), трябва да добавите и следния ред в .htaccess файл: SetEnv TZ Този .htaccess файл трябва да бъде в папката с Вашите PHP скриптове или в папка от по-горно ниво, тъй като тези файлове работят рекурсивно. Промяна на часовата зона за MySQL сесии Имайте предвид, че промяната на часовата зона за Вашите PHP скриптове, няма да се приложи за часовата зона на MySQL сървъра. Ако използвате вградените функции за работа с дати на MySQL, връщаните от тях стойности ще зависят от часовата зона на MySQL сървъра, така че е необходимо да извършвате часови корекции чрез Вашите скриптове. Може да намерите повече информация по темата в нашата статия Промяна на часовата зона на MySQL сесии.

Можете да ползвате локални .user.ini и php.ini конфигурационни файлове, за да променяте различни настройки за PHP интерпретатора. Тези файлове могат лесно да бъдат създавани чрез страницата Файлове в Контролния панел. Когато се създава нов поддомейн на страницата Поддомейни в Контролния панел, автоматично ще се създаде и php.ini файл в главната директория на поддомейна. Файлът php.ini за главния Ви домейн (поддомейна "www") се създава при активирането на нов акаунт. Имайте предвид, че на някои акаунти тези php.ini файлове може да не съществуват заради стари настройки. Конфигурационни файлове за PHP Основни разлики между .user.ini и php.ini файлове В .user.ini файловете можете да ползвате само директиви, които са маркирани с PHP_INI_PERDIR и PHP_INI_USER режими за промяна (можете да намерите списък с тези режими за промяна тук), а php.ini файловете могат да се използват за променяне на всички директиви, които се поддържат на нашите сървъри. .user.ini файловете работят рекурсивно (за всички поддиректории), за разлика от php.ini файловете, които не работят рекурсивно (техните настройки са валидни единствено за директорията, в която се намира php.ini файлът). Стойностите за директиви, които не са дефинирани в .user.ini файлове, ще бъдат взети от php.ini файла с най-висок приоритет според таблицата с приоритети. Това не е така за php.ini файловете - при тях стойностите за всички директиви, които не са описани в php.ini файла, се задават по подразбиране. За директории, в които се ползва FPM технологията за PHP, всички промени по .user.ini файловете ще имат ефект веднага, докато за php.ini файловете може да се наложи да презаредите главния FPM процес, за да се активират новите php.ini настройки. Има повече информация за презареждането на главния FPM процес в статията PHP настройки. Глобален php.ini файл Глобалният php.ini файл за акаунта Ви се намира в главната директория на акаунта (/home/USERNAME/php.ini). Настройките в този php.ini файл се прилагат глобално за всички PHP скриптове, освен ако не са променени от локален php.ini или .user.ini файл. Съдържание на php.ini файловете Всички автоматично генерирани php.ini файлове на нашите сървъри съдържат следните редове: post_max_size = 60Mmemory_limit = 3000Mupload_max_filesize = 60Mmax_execution_time = 120expose_php = Offsession.save_path = /tmperror_reporting = E_ALL & ~E_STRICT & ~E_NOTICE & ~E_DEPRECATEDdate.timezone = ${TZ} Важно: Ако искате да ползвате локални php.ini файлове, Ви препоръчваме да добавите тези редове във всеки от тях от съображения за съвместимост. Разбира се, можете да промените стойностите на тези директиви, ако решите. Например ако не искате скриптовете Ви да ползват часовата зона на физическото местоположение на сървъра, можете да смените стойността по подразбиране ${TZ} на директивата date.timezone. Възстановяване на началните настройки в глобален или главен php.ini файл за поддомейн Можете да възстановите настройките в глобалния php.ini за акаунта или за главните php.ini файлове в поддомейните си чрез бутона Възстанови на страницата PHP настройки в Контролния панел. Приоритет на конфигурационните файлове на PHP PHP интерпретатор (CGI и FPM технологии) Приоритетът на конфигурационните файлове за PHP е както следва (от най-висок към най-нисък): Конфигурационен файл\Технология   CGI   PHP-FPM .user.ini файл в директорията на скрипта   ✓   ✓ php.ini файл в директорията на скрипта   ✓   × главен php.ini файл за поддомейна   ×   ✓ глобален php.ini за хостинг акаунта   ✓   ✓ сървърен php.ini файл   ✓   ✓ настройки на PHP по подразбиране   ✓   ✓ Важно: Стойностите за директивите, които не са дефинирани в .user.ini файлове, ще бъдат взети от php.ini файла с най-висок приоритет от таблицата по-горе. За разлика от .user.ini файловете, стойностите за директивите, които не са дефинирани в php.ini файл, ще бъдат зададени от PHP инсталацията на сървъра. PHP на командния ред Конфигурационните файлове за PHP интерпретатора, изпълнен от командния ред (php.cli), имат следния приоритет: php-cli.ini файл в директорията на скрипта php.ini файл в директорията на скрипта глобален php.ini за акаунта сървърен php.ini файл настройки на PHP по подразбиране

Можете да управлявате и да прегледате конфигурацията на PHP за поддомейните си на страницата "PHP настройки" в Контролния панел. Там има и диагностична информация, която се отнася само до PHP-FPM. Когато щракнете на бутона "Промени" до някой от поддомейните, ще видите страница с настройките на PHP за конкретния поддомейн. Ако избраната PHP технология е FPM с OPcache, можете да щракнете върху бутона "Статус", за да видите допълнителен списък с диагностична информация за производителността и натовареността на сайта Ви. Следва списък с диагностичните показатели, които можете да видите, наред със значението на всеки от тях: Accepted conn Броят на заявките, които са приети и обработени. Active processes Броят на активните PHP-FPM процеси, които приемат заявки. Idle processes Броят на процесите, които са свободни. Listen queue Тази стойност показва броя на заявките, които изчакват изпълнение. Listen queue len Това е броят на чакащите изпълнение заявки. Max active processes Това е най-големият брой активни процеси, които са били стартирани, откакто работи главният PHP-FPM процес. Max children reached Показва колко пъти е достиган лимитът за брой PHP-FPM процеси, които обработват заявки. Max listen queue Показва най-големият брой заявки в опашката, откакто е стартиран главният PHP-FPM процес. Pool Това е общият идентификатор на FPM процесите. Обикновено е името на поддомейна. Process manager Типът стратегия за управление на процесите, избрана за сайта Ви. На нашите сървъри тази стойност е "ondemand". Slow requests Броят заявки, които са отнели повече време за обработка от определен максимален срок за изпълнение. Start since Показва броят на секундите, в които е работил главният PHP-FPM процес. Start time Показва кога е стартиран PHP-FPM процесът. Total processes Броят на всички PHP-FPM процеси, които работят в момента. Най-важните показатели, на които трябва да обърнете внимание, са "Max children reached" и "Listen queue". Max children reached Тази стойност ще се увеличава винаги, когато главният PHP-FPM процес достигне максималния брой процеси, които може да стартира за изпълнение на заявки. Ако тази стойност не е нула, това означава, че в даден момент е имало повече заявки към сайта Ви, отколкото хостинг услугата Ви е могла да изпълни лесно и заявките са започнали да се трупат на опашка за изпълнение. Това може да направи сайта Ви по-бавен от обикновено и може да е индикация за други проблеми. Listen queue Тази стойност показва броя на заявките, които чакат да бъдат изпълнени. Ако в опашката има заявки, това може да означава, че сайтът Ви е претоварен или има друг проблем, който забавя изпълнението на заявките. Детайли за работещите процеси Можете и да прегледате състоянието на работещите FPM процеси. Това се прави на командния ред с командата php-fpm-status. С нея можете да видите какви заявки обработва сайтът Ви в момента. За целта трябва да влезете в акаунта си през SSH и да изпълните следната команда: php-fpm-status www.example.com Трябва да заместите "www.example.com" с името на сайта си. Ето примерен резултат от командата: Expires: Thu, 01 Jan 1970 00:00:00 GMT Cache-Control: no-cache, no-store, must-revalidate, max-age=0 Content-Type: text/plain pool: www.example.com process manager: ondemand start time: 25/Apr/2021:01:37:49 +0800 start since: 1695502 accepted conn: 66673 listen queue: 0 max listen queue: 0 listen queue len: 0 idle processes: 1 active processes: 2 total processes: 3 max active processes: 20 max children reached: 2 slow requests: 0 ************************ pid: 22441 state: Running start time: 17/May/2021:04:14:52 -0400 start since: 871 requests: 127 request duration: 685 request method: GET request URI: /fpm-status-ShOC0gaIVoh0eiH1eEGNahVEK?full content length: 0 user: - script: - last request cpu: 0.00 last request memory: 0 ************************ pid: 22442 state: Idle start time: 17/May/2021:04:14:52 -0400 start since: 871 requests: 127 request duration: 64918 request method: POST request URI: /index.php content length: 36 user: - script: /home/example/www/www/index.php last request cpu: 2.62 last request memory: 2097152 Първата част от резултата показва същата информация като "Статус" раздела, описан по-горе. След нея има информация за всеки активен FPM процес. Детайлите са както следва: pid Това е идентификационният номер на процеса в операционната система на сървъра. state Състояние на процеса. Най-вероятно има един или повече процеси в "Idle" състояние, които изчакват нови заявки. start time Кога е стартиран процесът. start since Показва колко секунди е работил процесът досега. requests Броят заявки, обработени от този процес. request duration Колко време е отнело на процеса (в микросекунди) да обработи последната заявка. request method HTTP методът на последната обработена заявка. request URI URI на заявката. Имайте предвид, че в зависимост от конфигурацията на сайта Ви, стойността тук може да се различава от тази, подадена на сървъра при заявката. content length Колко байта е заявката. user Не се ползва на нашите сървъри. script Пътека на файловата система до изпълнявания PHP файл. last request cpu Колко процесорно време (секунди) е отнело на сървъра да обработи заявката. last request memory Количеството памет (байтове), което е използвано от сървъра, за да обработи заявката. Най-важните показатели са "request duration", "last request cpu" и "last request memory". Request duration Показва колко време е отнело на PHP FPM процеса да обработи последната заявка. Времето тук се измерва в микросекунди, така че 5 000 000 означава 5 секунди. Last request CPU Показва колко секунди процесорно време е отнело на сървъра да обработи последната заявка. Този показател е важен, защото може да Ви покаже дали някой скрипт претоварва акаунта Ви. По-ниски стойности са по-добри и за натоварването, и за производителността на сайта. Last request memory Показва количеството памет, заделено за PHP FPM процеса по време на последната обработена заявка. Въпреки че ограничението на сървърите ни е доста високо, трябва да имате предвид, че ако паметта свърши, сайтът Ви може да спре да работи. Ако тази стойност често е висока, това може да означава, че има проблеми с употребата на ресурси от страна на PHP приложенията Ви.