Modulfrissítések

előző ◈ a következő

A modul frissítései egymás után szigorúan összhangban vannak a verzióval. Minden frissítés csak egy változást tartalmaz az előzőtől. Erősen ajánlott, hogy a frissítés minden kiadása többféle helyzetet emuláljon a teszteléshez. Például a kiadás előtt telepítsen frissítéseket a különböző verziók tiszta eloszlására és a munkahelyekre.

Modulfrissítési struktúra

A frissítési mappák fájljai:

  • /install/version.php - a fájl tartalmazza a frissítés verziószáma és a kiadás dátuma. Kötelező fájl.
  • leírás. * - tartalmazza a frissítés leírását, ahol * a rendszer nyelvének azonosítója. Például a modulfrissítés leírását orosz nyelven a description.ru fájl tartalmazza. angolul - description.en. Kötelező fájl.
    A leírásban megengedett a html címkék használata: ,,,
  • ,
      ,,

      ,

    • updater.php - a fájl a frissítés telepítésekor indul el. Ez a fájl az új verzió frissítésére szolgál. A fájl tetszőleges PHP kódot tartalmazhat, amely a webhely összefüggésében fut. Opcionális fájl.
    • version_control.txt - a modulok verziói közötti kommunikációra szolgál. A fájl hivatkozásokat tartalmaz azon modulok verzióihoz, amelyeken ez a frissítés függ. Például egy fájl iblock, 13.8.0 fájlt tartalmazhat. Ez azt jelenti, hogy ez a frissítés akkor lesz telepítve, ha a 13.8.0-nál alacsonyabb verziójú információs modulok telepítve vannak a rendszeren. Az Információs blokkok modul egyáltalán nincs telepítve. Opcionális fájl.

    Mielőtt a modult feltöltené a webhelyre, a modulfrissítő csomagot az archívumba kell csomagolni. Ehhez az alábbiak szerint járjon el:

    • Hozzon létre egy könyvtárat a frissítési verzió nevével. Például 0,0,2, 0,0,5 stb.
    • Másolja át a modulfrissítés fájlokat és könyvtárakat a létrehozott mappába.
    • Archiválja a mappát .zip vagy .tar.gz formátumban.

    Ennek eredményeképpen meg kell kapnia például a 0.0.2.zip, 0.0.5.zip fájlt. A frissítési mappának például a következő szerkezete lehet:

    Minden modul fájl, kivéve a updater.php fájlt. description.ru és más szolgáltatásfájlok automatikusan átmásolódnak a modul mappájába a frissítés során.

    Megjegyzés. A rendszermag automatikusan frissül. Minden más fájl (beleértve a modul komponenseit) - csak kifejezett utasításokkal. Ha magát a frissítésbe kell másolnia a fájlokat, akkor a következőket kell használni:

    Ebben az esetben a / install / classes mappa fájlokat. amelyek a frissítési mappában találhatók, átmásolódnak a /bitrix/modules/quintura.search/classes mappába.

    Ha szükségessé vált az új moduloktól való függőség megállapítása a későbbi frissítések kiadásakor, nem szabad megfeledkezni arról, hogy egy függőségi frissítés nem igényli a megadott modulok telepítését. Ebben az esetben két lehetőség közül választhat:

    1. A frissítés még mindig telepítve van, ellenőrizze a modulnak a modul működésében már meglévõ jelenlétét.
    2. Adjon hozzá egy frissítést a kívánt modul frissítési kódjához, és ennek hiányában adja ki a hibát a felhasználónak. A frissítés nem lesz telepítve, ha az üzenetsorozatot $ errorMessage értékre állítja be.

    Kapcsolódó cikkek

előző ◈ a következő