Kirjutasid töötava PHP koodi uusimal versioonil, lükkasid selle tootmisse ja said klientidelt vanalt hostingu pealt hulga veateateid. Tundub tuttav? Süntaks, mis sulle tundub „ilmselge", muutub PHP 7.0 peal fataalseks veaks. Kümmekonna aegunud versiooni lokaalseks paigaldamiseks, et iga koodijuppi kontrollida, kulub pool päeva, kui see üldse võimalik on.

Probleem on sügavam, kui paistab. Vanad PHP versioonid kaovad ametlikest repositooriumidest, ei kompileeru tänapäevastel Linuxi kernelitel ja lähevad laiendustega konflikti. WordPress jookseb endiselt serveritel, kus hostingu pakkuja on olnud liiga laisk, et PHP-d uuendada. Selle tulemusena läheb sinu plugin või teema sadade kasutajate jaoks katki lihtsalt sellepärast, et kasutasid tüübitud string argumenti või lühikest massiivi süntaksit.

Kuid on olemas tööriist, mis lahendab selle probleemi sekunditega: 3v4l.org, tasuta veebipõhine PHP koodi testija, mis töötab 300+ versioonil samaaegselt. Pole vaja paigaldamist ega virtuaalmasinaid. Selles juhendis näitan, kuidas enne väljalaset mitteühilduvusi tabada, ja demonstreerin reaalseid vigu, mille me ise tootmisse saatsime.

💡 Kiire ülevaade:

• Kleebi PHP koodijupp 3v4l.org lehele ja käivita see kõigil versioonidel alates PHP 4.3.0 kuni uusima 8.5-ni
• Vaata üle grupeeritud väljund: sait näitab, kus kood töötab, kus see veateateid viskab ja kus käitumine erineb
• Uuri kahte klassikalist mitteühilduvuse näidet, mis lõhuvad WordPressi pluginaid vanal hostingu peal, koos koodi ja linkidega reaalajas testidele
• Võrdle alternatiivseid kontrollimeetodeid: Dockeri konteinerid, PHPBrew, sisseehitatud PhpStormi inspektor, nende plussid ja miinused
• Vaata ingliskeelset videot, mis demonstreerib TemPHPest + 3v4l töövoogu otse VSCode'ist

Miks vanade PHP versioonide käsitsi paigaldamine on piinarikas

Kui sa haldad Linuxi serverit, oled kindlasti märganud: vanad, mittetoetatud PHP harud lihtsalt kaovad paketihalduritest. ppa:ondrej/php repositoorium, Ubuntu peamine PHP pakettide allikas, hoiatab paigaldamise ajal ausalt:

Pakutakse ainult toetatud Ubuntu väljalasete toetatud PHP versioone.

1. aasta juuni seisuga on ametlikult toetatud harud 8.2, 8.3, 8.4 ja 8.5. PHP 8.1 tugi lõppes 2025. aasta detsembris. PHP 7.4 on ammu ajalugu. Kuid jagatud hostingu ja aegunud VPS-ide peal kohtad endiselt PHP 7.0 või isegi 5.6. Koodi nende vastu lokaalselt kontrollida on omaette seiklus.

PHPBrew oli kunagi päästerõngas: see utiliit suutis kompileerida ükskõik millise PHP versiooni lähtekoodist ja nende vahel ühe käsuga lülituda. Kuid projekti pole alates 2020. aastast peaaegu üldse uuendatud ja PHP 5.6 kompileerimine Linuxi kernelil 6.x on parajaks nuputusülesandeks koos paikade ja ühilduvuslippudega. Dockeri konteinerid on lihtsamad, kuid nõuavad igale versioonile Dockerfile'i kirjutamist, tõmmiste allalaadimist ja söövad ikkagi gigabaite kettaruumi.

On olemas alternatiiv ja see töötab otse sinu brauseris.

3V4l.org: sinu veebipõhine testija 300+ PHP versioonile

3v4l.org (leet-keeles „eval") on veebipõhine liivakast, mis käivitab sinu PHP koodi enam kui 300 interpretaatori versioonil samaaegselt. Muistsest PHP 4.3.0 kuni uusima 8.5-ni. Projekti looja kompileeris ja haldab iga olulist versiooni, mis on kogu keele ajaloo jooksul välja antud.

Mehaanika on geniaalselt lihtne: kleebi koodijupp vasakusse paneeli, vajuta eval() ja sekunditega saad tulemuste tabeli. Sait grupeerib versioonid väljundi järgi: rohelised read tähendavad, et kood jooksis identselt, kollased/punased, et käitumine erineb või tekkis viga. Sa näed kohe, millisest minimaalsest PHP versioonist alates muutub sinu süntaks vastuvõetavaks.

Mis on eriti väärtuslik: 3v4l.org näitab vea teksti iga probleemse versiooni kohta. Mitte abstraktset „mitteühilduv", vaid konkreetne Parse error: syntax error, unexpected '[' in ... koos reanumbri viitega. See säästab tunde silumist.

Iga test saab kordumatu URL-i, lingi saab lisada piletile, saata meeskonnajuhile või kasutada dokumentatsioonina: „Siin on tõestus, et match avaldised lähevad PHP 7.4 peal katki."

Näide 1: lühike massiivi süntaks, WordPressi jaoks miiniväli

Arendaja kirjutab JavaScriptis, lülitub PHP-le ja loob harjumusest massiivi:

1
$a = [];

Tundub kahjutu. Sinu lokaalses masinas PHP 8.4-ga see töötab. Testserveris PHP 8.2-ga töötab samuti. Lükkad tootmisse ja PHP 5.6-ga kliendid saavad valge ekraani.

Lühike massiivi süntaks [] ilmus alles PHP 5.4-s. Enne seda ainult array(). Ja kuigi PHP 5.4 tuli välja 2012. aastal, näitas WordPress.org statistika aastakümneid märkimisväärset osa installatsioone PHP versioonidel alla 5.4. Olukord on nüüd paranenud, kuid WordPressi pluginad peavad siiski ühilduvuse nüanssidega arvestama.

Käivita see koodijupp 3v4l.org-is ja saad lõpliku otsuse:

1
PHP 5.3.x and older: Parse error: syntax error, unexpected '['
2
PHP 5.4.x and newer: OK

Ei mingit oletamist, ei mingit iga konstruktsiooni käsiraamatust järele vaatamist. Säästetud aeg: 30 sekundit, mitte 15 minutit guugeldamist „milline PHP versioon toetab lühikest massiivisüntaksit".

Näide 2: tüübivihjed, kui kood vanal PHP-l hääletult katki läheb

Tüübideklaratsioonid muudavad PHP rangemaks ja etteaimatavamaks. Kuid tüübivihjete areng oli ebaühtlane ja see loob lõksu. Vaata seda koodi:

1
function handleException(Exception $e) {}
2
function greet(string $name) {}
3
function processItems(array $items) {}
4
 
5
handleException(new Exception('Test'));
6
greet("hello");
7
processItems([1, 2, 3]);

Paistab nagu kolm identset deklaratsiooni. Kuid 3v4l.org-is testimine toob päevavalgele üllatuse:

Skalaartüübid string, int ja bool tulid alles PHP 7.0-s, 12 aastat pärast klassitüüpe! Kui sinu plugin deklareerib minimaalseks PHP versiooniks 5.6 ja sa kasutasid function register(string $username), siis vanal hostimisel annab see krüptilise saatusliku vea:

1
Catchable fatal error: Argument 1 passed to greet() must be an instance of string,
2
string given in...

Veateade on segadusse ajav: „must be an instance of string, string given." Klient loeb seda kui mõttetut jama ja kirjutab vihase arvustuse. Põhjus on lihtne: PHP 5.6 ei mõista skalaartüübivihjeid ja püüab string-i tõlgendada klassi nimena.

3v4l.org-iga püüad sellised ühildumatuse probleemid kinni minutiga, mitte pärast tosinat veateadet.

Alternatiivid: IDE, Docker ja konsooliutiliidid

3v4l.org katab enamiku ühilduvuse kontrollimise stsenaariume, kuid mitte kõiki. Siin on, mis veel arsenalis on, koos plusside ja miinustega.

PhpStorm. JetBrainsi sisseehitatud inspektor tõstab esile süntaksi, mis ei ühildu valitud PHP versiooniga: määrad seadetes „PHP 7.4" ja redaktor joonib alla match(), tüübitud atribuudid, str_contains(). Kuid PhpStorm maksab raha (tellimus alates $99/aastas) ja kontroll on staatiline, tegelikku koodi käivitamist ei toimu. Inspektor ei näita array_key_last() käitumise erinevust versioonide vahel, samas kui 3v4l.org näitab.

Docker. Kõige paindlikum lähenemine: docker run -v $(pwd):/app php:5.6 php /app/test.php käivitab koodi täpses keskkonnas. Kuid 10 versiooni testimine nõuab 10 konteinerit, 10 erinevat tõmmist ja automatiseerimisskripti. Kiireks koodijupi kontrolliks on see ülepingutus.

Kohalik PHPBrew. Nagu eespool mainitud, on projekt külmutatud ja iidsete PHP versioonide ehitamine kaasaegsel kernelil nõuab parandustega tantsimist. Aastal 2026 on lihtsam avada 3v4l.org.

GitHub Actions / CI. PHP versioonide maatriks CI-s (näiteks strategy.matrix.php: ['7.4', '8.0', '8.1', '8.2', '8.3', '8.4', '8.5']) püüab probleemid kinni iga pushiga. See on raamatukogude puhul kohustuslik, kuid WordPressi pluginat kirjutavatele autoritele, kes kasutavad Sublime Texti või VSCode'i ilma CI-ta, jääb 3v4l.org kõige kättesaadavamaks ja kiireimaks tööriistaks.

Video: TemPHPest + 3v4l otse VSCode'ist

VSCode'i laiendus TemPHPest integreerib 3v4l.org-i redaktorisse: vali kood, vajuta kiirklahvi ja saad tulemused kõigil PHP versioonidel ilma brauserit avamata. Laienduse autor salvestas lühikese demonstratsiooni:

VSCode + TemPHPest + 3v4l.org kombinatsioon pakub peaaegu sujuvat kogemust: kirjuta koodi, kontrolli kohe ühilduvust, paranda vead. Töötab kiiremini kui redaktori ja brauseri vahel vahetamine.

⁉️🤔 Korduma kippuvad küsimused

Kas 3v4l.org on tasuta?

Jah, täiesti. Pole registreerimist, käivituskordade arvule piiranguid ega reklaame. Teenus on avatud lähtekoodiga ja töötab looja isiklikus serveris. Kui kasutad seda regulaarselt, saad autorit toetada GitHub Sponsorsi kaudu, mis aitab katta hostimise ja elektri kulud.

Millised PHP versioonid on 3v4l.org-is saadaval?

Kõik olulised väljalasked alates PHP 4.3.0-st (välja antud 2002. aastal) kuni uusima 8.5-ni (november 2025). Iga väiksem väljalase on tulemuste tabelis eraldi rida. Kokku on üle 300 versiooni. Kui vajalikku versiooni nimekirjas pole, lisab autor uued väljalasked kiiresti.

Kas testida saab terveid projekte või ainult koodijuppe?

3v4l.org on mõeldud isoleeritud koodifragmentide, funktsioonide, klasside ja üksikute algoritmide jaoks. Võid kleepida mitusada rida, kuid ilma require ja include'ita koos composer autoloadingu ja andmebaasiühendusteta. Projekti täielikuks integratsioonitestimiseks sobivad paremini Dockeri konteinerid või GitHub Actions koos PHP versioonide maatriksiga.

Kas tundliku koodi kleepimine kolmanda osapoole serverisse on ohutu?

Ei. 3v4l.org-is olev kood saab avaliku URL-i ja on tehniliselt otseviite kaudu juurdepääsetav. Ära kasuta teenust konfidentsiaalsete andmete, API-võtmete, paroolide ega äriloogika jaoks. Oma koodi puhul käivita lokaalne Dockeri konteiner: docker run -v $(pwd):/app php:7.4 php /app/private-code.php.

Mille poolest on 3v4l.org parem kui IDE-sisene kontroll?

Staatiline analüüs IDE-s (PhpStorm, PHPStan) kontrollib süntaksit ja tüüpe, kuid ei käivita koodi. 3v4l.org käivitab koodijupi tegelikult kõigi versioonide interpretaatoritega ja näitab tegelikku väljundit, erinevusi array_key_last(), json_encode() ja preg_match() käitumises versioonide lõikes. Lisaks ei nõua see IDE ostmist, töötab brauseris.

Mida valida PHP koodi ühilduvuse kontrollimiseks 2026. aastal

Teema- ja pistikprogrammide autori igapäevatööks on skeem selline. Kahtlust tekitav koodijupp läheb otse 3v4l.org-i. Tulemus tuleb 5 sekundiga, testi link lisatakse commit'ile. Projekt, kus ühilduvus tosina PHP versiooniga on oluline, saab maatriksi GitHub Actionsis: seadista üks kord ja iga push käivitab testid automaatselt. Kellegi teise koodi kiireks kontrolliks enne koodiülevaatust sobib TemPHPest VSCode'is (tasuta, integreeritud 3v4l.org-iga).

Peamine, mis võrreldes 2020. aastaga (kui selle materjali algversioon esmakordselt ilmus) on muutunud: PHP 5.6 on lõpuks enamikult hostingu platvormidelt lahkunud, miinimumribaks sai PHP 7.4 ning silmapiiril on PHP 8.5 koos uute võimaluste ja uute võimalike ühildumatustega. Kuid põhimõte jääb samaks: kontrolli ühilduvust enne väljalaset, maga rahulikult. 3v4l.org muudab selle kontrolli tühiseks.