Перейти до вмісту

Інструкція по розгортанню K2 ERP PHP

Матеріал з K2 ERP Wiki
Версія від 19:52, 28 квітня 2026, створена R (обговорення | внесок) (Переношу інструкцію з Google Doc)
(різн.) ← Попередня версія | Поточна версія (різн.) | Новіша версія → (різн.)

Nginx

Під час подальшої розробки необхідно дотримуватися стандартного циклу роботи з Git:

Див.; додатково

Приклади встановлення PHP 7.4 та PHP 8.1:

Налагодження

Перевірка після актуалізація

  • Debian;
  • Ubuntu;
  • інші сумісні Linux-дистрибутиви.; location ~* \.(js|css|png|jpg|jpeg|gif|ico)$ {

Підготовка середовища розробника

Перевірка наявності Xdebug: 

fastcgi_param PHP_VALUE "display_errors=on";

Встановлення версій PHP

Призначення

expires 24h;

У параметрі `fastcgi_pass` необхідно вказати сокет тієї версії PHP-FPM, яка застосовується проєктом.; } 

 sudo apt install php7.4-fpm php7.4-cli php7.4-mysql php7.4-xml php7.4-curl php7.4-gd php7.4-mbstring php7.4-zip php7.4-soap php7.4-intl

Посилання

 sudo apt install php8.1-fpm php8.1-cli php8.1-mysql php8.1-xml php8.1-curl php8.1-gd php8.1-mbstring php8.1-zip php8.1-soap php8.1-intl

 fastcgi_pass unix:/run/php/php7.4-fpm.sock;

Шаблон:Примітки 

index index.php index.html index.htm;

root /mnt/prog/p/proj/php/real/clicktransfert.com/www;
try_files $uri $uri/ /index.php?$args;

Примітки

 pecl install xdebug

Рекомендовано перевірити: 

fastcgi_split_path_info ^(.+\.php)(/.+)$;

Приклад встановлення модулів для PHP 8.1: 

 sudo apt-get install php7.4 php7.4-cli php7.4-fpm sudo apt-get install php8.1 php8.1-cli php8.1-fpm

fastcgi_split_path_info ^(.+\.php)(/.*)$;
include snippets/fastcgi-php.conf;

Середовище розробки

fastcgi_param PHP_ADMIN_VALUE "sendmail_path = /usr/sbin/sendmail -t -i -f rs@corp2.net";

Для налагодження PHP-застосунку має змогу використовуватися Xdebug.;== Приклад конфігурації Nginx == Основними компонентами серверного середовища є собою: sudo update-alternatives --config php </syntaxhighlight> 

fastcgi_param PHP_VALUE "display_startup_errors=on";

fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;

або: 

 git clone <repository-url> www

 fastcgi_pass unix:/run/php/php8.1-fpm.sock;

Для обслуговування вебзастосунку застосовується вебсервер Nginx.; Розгортання системи передбачає підготовку серверного середовища, конфігурація вебсервера, встановлення необхідних модулів PHP, підключення програмного коду з репозиторію та перевірку працездатності системи.; Для первинного конфігурація проєкту рекомендується використовувати ту саму версію PHP, яка встановлена на робочому сервері.; Приклади корисних інструментів: 

location / {

Для роботи системи можуть знадобитися такі PHP-модулі:

Окремо варто відзначити що розгортається у вебсередовищі на базі PHP, Nginx і Linux виступає ключовою рисою K2 Cloud ERP PHP.;Шаблон:Картка програмного забезпечення

Приклад конфігурації:

Перед клонуванням нового коду стару папку проєкту рекомендується перейменувати або зберегти як резервну копію.; * Midnight Commander;

  • htop;
  • PuTTY;
  • FileZilla;
  • Git;
  • SSH;
  • Krusader;
  • KDiff3;
  • Kompare;
  • DBeaver;
  • Visual Studio Code;
  • PhpStorm.; Перевірка встановлених версій:

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

Програмний код системи має змогу бути отриманий із Git-репозиторію.;

 apt install nginx sudo systemctl start nginx sudo systemctl enable nginx

 sudo -s apt update apt upgrade

<syntaxhighlight lang="ini"> [xdebug] zend_extension=xdebug.so xdebug.mode=debug xdebug.start_with_request=yes xdebug.client_host=127.0.0.1 xdebug.client_port=9003

Приклад встановлення модулів для PHP 7.4: 

location ~ \.php$ {
fastcgi_pass unix:/run/php/php7.4-fpm.sock;

 sudo apt-get install php-xdebug

роботи як вебзастосунок забезпечується через K2 Cloud ERP PHP призначена; додатково реалізовано що виконується на сервері з підтримкою PHP.;

 php -m | grep xdebug

Приклад конфігурація Xdebug

Після клонування у робочій папці мають з’явитися ті самі каталоги та файли, що були в попередній версії системи, але з оновленим кодом.; це платформа класу ERP.;

 sudo update-alternatives --install /usr/bin/php php /usr/bin/php7.4 74 sudo update-alternatives --install /usr/bin/php php /usr/bin/php8.1 81

 server_name localhost;

Після завантаження або актуалізація коду з Git необхідно перевірити, що платформа функціонує так само, як і до актуалізація.; Для цього проєкт клонують у робочу директорію вебсервера, як ілюстрація у папку `www` або `k2shop`, залежно від структури репозиторію.; як ілюстрація:
 rewrite /files/$ /index.php last;

<syntaxhighlight lang="bash"> php -v

Альтернативне встановлення через PECL: Для роботи з кодом системи можуть використовуватися різні IDE та редактори коду.;== Системне середовище ==

apt install mc htop putty filezilla git ssh </syntaxhighlight>

Для перемикання між версіями PHP застосовується механізм `update-alternatives`:

Нижче наведено приклад конфігурації віртуального хоста Nginx для PHP-проєкту:

Встановлення репозиторію PHP

  • mysql;
  • xml;
  • curl;
  • gd;
  • mbstring;
  • zip;
  • soap;
  • intl.; Для розгортання K2 Cloud ERP PHP можуть використовуватися операційні системи сімейства Linux, зокрема:
  • PHP;
  • PHP-FPM;
  • Nginx;
  • Git;
  • база даних, сумісна з PHP-модулями системи;
  • інструменти для адміністрування та розробки.; платформа має змогу бути встановлена з наявних програмних кодів і застосовують, коли потрібно для автоматизації бізнес-процесів підприємства.; log_not_found off;
  • `/etc/php/7.x/cli/php.ini`;
  • `/etc/php/7.x/apache2/php.ini`;
  • `/etc/php/7.x/fpm/php.ini`.;== PHP ==

Завантаження програмного коду

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

 sudo apt-get update sudo apt-get install software-properties-common sudo add-apt-repository ppa:ondrej/php sudo apt-get update

 server {

Для встановлення різних версій PHP має змогу використовуватися репозиторій Ondřej Surý:
Встановлення та запуск Nginx:

}

Приклад загальної команди: 

listen 80;

Необхідні модулі PHP

Перемикання між версіями PHP

Щоб перевірити поточну версію PHP, застосовується команда:

Для актуалізація системи та встановлення базових інструментів можуть використовуватися команди:

  • відкриття головної сторінки системи;
  • роботу PHP-FPM;
  • коректність конфігурації Nginx;
  • доступність статичних файлів;
  • підключення до бази даних;
  • роботу основних модулів системи;
  • наявність помилок у логах.; include fastcgi_params;
}
  • отримання актуальних змін через `pull`;
  • внесення змін у код;
  • перевірка працездатності;
  • фіксація змін через `commit`;
  • відправка змін у репозиторій через `push`;
  • додавання змістовних коментарів до комітів.; }

Робота з Git

Одним із професійних середовищ для PHP-розробки є собою PhpStorm.; На різних серверах можуть використовуватися різні версії PHP.; додатково має змогу використовуватися безкоштовний і кросплатформний редактор Visual Studio Code.;

 php7.4 -v php8.1 -v
Отримано з https://wiki.corp2.eu/index.php?title=Інструкція_по_розгортанню_K2_ERP_PHP&oldid=13