Telepítési lépések, külső könyvtárak, migrációk és környezet

A telepítő lépései, az alapséma és a migrációk szabályai, a külső könyvtárak helye és telepítési módjai, a frissítéskezelő, a nyelvi fájlok és a rendszer-ellenőrzés mérései.

A telepítés a bővítmény szerkesztő oldalának „Rendszer-ellenőrzés és telepítés” fülén fut, külön AJAX-lépésekként, idempotensen: check → composer → schema → migrate → defaults → register → finish. A telepítés gomb csak piros hiba nélkül aktív.

Lépések

Alapséma: install/schema/baseline.sql (csak CREATE TABLE IF NOT EXISTS), majd a migrációk.
A defaults lépés generálja a cron-titkot, ha hiányzik, és beírja a cron-sorokat.
Külső könyvtárak, ha a webes telepítés nem futhat (pl. tiltott exec): cPanel fájlkezelővel a libraries.zip kibontása a storage mappába, majd „Könyvtárak telepítése”; terminálon Composer nélkül php install/composer/install.php <storage> --from=<csomag vagy vendor mappa> (az átmeneti mappa hiba esetén is törlődik); Composerrel php install/composer/install.php <storage> [--composer=<út>] — a Composert a PATH-on, a /opt/cpanel/composer/bin/composer helyen és ~/composer.phar-ként is megtalálja.
A cron futtatása: percenként php cron.php a keretrendszer gyökeréből (ajánlott), vagy a worker URL a masterdata/cronqueue.run végponttal és a cron-titokkal (a titok listában, naplóban nem jelenik meg).

Külső könyvtárak

Composer-csomagok (install/composer/composer.json, PHP ≥ 8.0, platform 8.0.30), a keretrendszer közös vendor-mappájában, csomag-jegyzékkel; a frissített gyári csomagok stage-mappából kerülnek a helyükre. A Rendszer-ellenőrzés csomag-sora kiírja a verziót és a helyet.

Csomag	Verzió	Mire
`tecnickcom/tcpdf`	^6.7	PDF-generálás (a 6.9+ elavulási jelzését a PDF-alap csak a TCPDF fájljaiból nyeli el)
`setasign/fpdi`, `setasign/fpdf`	^2.6, ^1.8	PDF-oldalak importja (vízjel, összefűzés)
`smalot/pdfparser`	^2.11	PDF-szövegkinyerés
`google/apiclient`	^2.15	Drive-tárhely, konverzió (csak Drive szolgáltatás)
`guzzlehttp/guzzle`, `psr7`, `promises`, `psr/http-message`	^7.15.2, ^2.13.2, ^2.6, ^1.1	HTTP; a gyári csomagokat azonos főverzión belül biztonsági okból frissíti
`qualityunit/tnef-decoder`	^1.0	levél-mellékletek (opcionális)

Migrációk és frissítés

Globális SemVer (install.json, jelenleg 1.1.0). Új migráció csak install/migrations/<verzió>/ alá, fejléccel (@id, @requires, @skip-if, @post, @reversible), előtag-helyőrzős táblanévvel, expand-only (tilos DROP, RENAME, szűkítés, WHERE nélküli UPDATE).
A futtató MySQL 5.7-en is hordozhatóvá bontja a feltételes DDL-t, kivétel-módban fut, és naplóz (migration tábla: verzió, köteg, időpontok, időtartam, hiba, SHA-256 checksum, fajta, visszafordíthatóság). Alkalmazott migráció fájlja nem módosítható.
Frissítéskezelő: aláírt csomag (Ed25519); előkészítés (engedély, letöltés, aláírás és hash, staging, előellenőrzés, mentés) és aktiválás (karbantartás, delta-mentés, migráció a staging-kódból, atomi kódcsere, könyvtár-szinkron, egészség-ellenőrzés; hibánál automatikus kód-visszaállítás). Független helyreállító eszköz (CLI; web csak engedélyezett ablakban).

Nyelvek

Minden felirat nyelvi kulcsból, három nyelvi mappában (en-gb, hu-hu, de-de). A magyar nyelvi csomag a bővítmény saját fordításait a csomag-másolat után újra ráolvasztja. Dokumentum-nyelv: a sablon nyelve; a címzettek levelei a személy értesítési nyelvén; az adatszoba nyelvváltása oldal-újratöltés nélkül.

Környezet

Terület	Követelmény
PHP	≥ 8.0.0 (ajánlott ≥ 8.2), 64 bit ajánlott; keretrendszer 4.0.2.x
Kötelező kiterjesztések	mysqli, curl, mbstring, zip, dom, simplexml, libxml, openssl, sodium, gd, zlib, iconv, json, ctype
Ajánlott, opcionális	fileinfo, OPcache, soap; imap, exif, imagick, intl
ini	`memory_limit` ≥ 128M (javasolt 512M), `max_execution_time` ≥ 120 (javasolt 300), `upload_max_filesize` ≥ 32M (javasolt 64M), `post_max_size` ≥ upload, `max_input_vars` ≥ 3000 (javasolt 5000), `file_uploads` = On
Adatbázis	MariaDB ≥ 10.2.7 vagy MySQL ≥ 5.7.8; jogok: CREATE, ALTER, INDEX, DROP, CREATE TEMPORARY TABLES; `GET_LOCK()`; utf8mb4
Írható könyvtárak	storage, logs, cache, upload, image (kötelező); extension (ajánlott)
Opcionális programok	ghostscript, pdftotext, qpdf, tesseract (+hun), imagemagick, composer

Kapcsolódó témák: telepítés frissítés háttérfeladat

Konzultáció kérése Vissza a főoldalra