FreeScoutin päivittäminen PHP 8.5:een (Ubuntu 26.04 -tarkistuslista)
Ennen kuin siirrät FreeScoutin PHP 8.5:een, varmista, että FreeScout ja jokainen käyttämäsi moduuli tukevat sitä, tarkista sitten PHP-laajennukset, käynnistä jonotyöntekijä uudelleen ja seuraa lokia merkinnän deprecated since 8.5 viestit. Ubuntu 26.04 asentaa oletuksena PHP 8.5:n, joten käyttöjärjestelmän päivitys on usein muutoksen laukaiseva tekijä.
Tämä on tärkeämpää FreeScoutille kuin useimmille PHP-sovelluksille, koska FreeScout käsittelee vanhentumisilmoituksia tietyllä tavalla.
Miksi PHP 8.5 voi rikkoa FreeScout-moduuleja
Jokainen PHP-julkaisu poistaa käytöstä joitakin vanhempia toimintoja. PHP 8.5 poistaa käytöstä useita toimintoja, jotka eivät ole tehneet mitään PHP 8.0:sta lähtien, mukaan lukien curl_close(), imagedestroy(), ja xml_parser_free(). Se myös poistaa käytöstä joitakin reunatapauksia, kuten null taulukon avaimena tai välittämällä chr() arvo, joka on 0–255:n ulkopuolella.
Useimmat PHP-sovellukset kirjaavat vanhentumisvaroituksen ja jatkavat. FreeScout muuttaa jokaisen vanhentumisilmoituksen virheeksi, joten yksikin jäljelle jäänyt kutsu pysäyttää pyynnön tai taustatyön, joka siihen törmäsi. Moduuli voi näyttää asennetulta ja terveeltä, vaikka jokainen sen muodostama yhteys epäonnistuu.
Jos näet nämä virheet päivityksen jälkeen, Korjaa "deprecated since 8.5" -virheet FreeScoutissa käy läpi vastuussa olevan moduulin löytämisen ja korjaamisen.
Ennen päivitystä
- Tarkista tuki: lue FreeScoutin julkaisutiedot ja järjestelmävaatimukset PHP 8.5:lle ja varmista, että jokaisella asennetulla moduulilla on PHP 8.5 -yhteensopiva julkaisu.
- Päivitä moduulit ensin: asenna nämä päivitykset, kun olet vielä nykyisessä PHP-versiossasi, jotta jokainen moduuli on valmis ennen siirtoa.
- Varmuuskopioi: ota kopio FreeScout-hakemistosta, tietokannasta ja PHP-kokoonpanotiedostoistasi.
- Testaa kopiolla: jos mahdollista, suorita päivitys ensin tukipalvelun staging-kopiossa.
Kun olet päivittänyt
Tarkista FreeScoutin käyttämä PHP-versio
Avaa Hallinnoi > Järjestelmä. Se näyttää verkkopalvelimesi käyttämän PHP-version ja luettelee FreeScoutin tarvitsemat PHP-laajennukset ja merkitsee puuttuvat.Yhdistä komentorivin PHP
Suoritaphp -vpalvelimella. Jonotyöntekijä jaschedule:runcron käyttää komentorivin PHP:tä, joka voi poiketa web-palvelimen versiosta. Molempien on käytettävä samaa versiota samoilla laajennuksilla.Asenna laajennukset ja asetukset uudelleen
Uusi PHP-versio tuo mukanaan omat laajennuspakettinsa japhp.initiedostot. Asenna laajennukset Hallinnoi > Järjestelmä merkitsee puuttuvaksi ja ota sitten uudelleen käyttöön mukautetut asetukset, kutenupload_max_filesizejapost_max_size.Osoita verkkopalvelin uuteen PHP:hen
Jos käytät PHP-FPM:ää, varmista, että verkkopalvelimesi käyttää PHP 8.5 FPM -sokkelia tai -palvelua, ja käynnistä sitten PHP-FPM ja verkkopalvelin uudelleen.Tyhjennä välimuistit ja käynnistä jonotyöntekijä uudelleen
Aja nämä FreeScout-hakemistostasi, jotta mikään prosessi ei jää ajamaan vanhaa koodia:terminalphp artisan freescout:clear-cache php artisan queue:restart
Mitä tarkistaa lokeista
Avaa Hallinnoi > Lokit > Sovelluslokit kun olet käyttänyt palvelupöytää jonkin aikaa. Hae:
is deprecated since 8.5, joka viittaa moduuliin tai tiedostoon, joka ei ole vielä PHP 8.5 -valmis.Providing a value not in-between 0 and 255 is deprecated, alkaenchr()kutsut.Using null as an array offset is deprecated.
Jokainen merkintä nimeää tiedoston. Polku kohdassa Modules/<Name> kertoo, mikä moduuli tarvitsee päivityksen.
Testaa ominaisuudet, jotka tekevät lähteviä yhteyksiä, koska ne epäonnistuvat ensin: sähköpostin nouto, tekoälytarjoajat, tietolähteet ja integraatiot, kuten Linear, Jira, Slack tai kauppaliittimet. Kun moduuli tarjoaa Testaa yhteys painiketta, käytä sitä.
Jos jokin menee rikki
Palauta FreeScout PHP 8.4:ään odottaessasi päivityksiä. PHP 8.4 ei käsittele näitä toimintoja vanhentuneina, joten sama koodi toimii siinä normaalisti. Vaihda sekä verkkopalvelin että komentorivin PHP ja käynnistä sitten PHP-FPM, verkkopalvelin ja jonotyöntekijä uudelleen.