Ga naar inhoud

De PHP-versie wijzigen

Elke SuperSpace-site draait op een specifieke PHP-versie. Je kunt een site wanneer je maar wilt overschakelen naar een andere beschikbare PHP-versie vanuit het dashboard — bijvoorbeeld om naar een nieuwere release te gaan voor betere prestaties en beveiliging, of om op een oudere release te blijven terwijl je de compatibiliteit van plugins en thema's test.

SuperSpace past de wijziging op de achtergrond toe en houdt deze bij als een taak op de site, dus het gebeurt niet meteen. Deze handleiding loopt door het doorvoeren van de wijziging en wat je kunt verwachten.

Voordat je begint

  • Toegang tot de site in je SuperSpace-dashboard.
  • Een idee van welke PHP-versie je WordPress-thema en -plugins ondersteunen. Grote versiesprongen (bijvoorbeeld van PHP 7.x naar PHP 8.x) kunnen oudere plugins kapot maken, dus controleer eerst de compatibiliteit.
  • Idealiter een recente back-up van de site, voor het geval je na het testen wilt terugzetten.

Stappen

  1. Open de site. Open in de linkerzijbalk Mijn sites en selecteer de site die je wilt wijzigen.

  2. Ga naar de instellingen van de site. Klik in de linkerzijbalk van de site op Instellingen.

  3. Kies de nieuwe PHP-versie. Zoek op de pagina Instellingen het veld PHP Version. Dit is een dropdown met de PHP-versies die beschikbaar zijn voor je site. Kies de versie die je wilt.

  4. Pas de wijziging toe. Klik op Bijwerken.

Nadat je het hebt ingediend, bevestigt SuperSpace dat de wijziging van de PHP-versie is ingediend. De wijziging draait op de achtergrond en wordt bijgehouden als een taak op de site. Zodra deze klaar is, wordt de PHP-versie van de site bijgewerkt en verschijnt de nieuwe waarde in de kaart PHP VERSION op de overzichtspagina van de site.1

Als je de versie kiest waarop de site al draait, meldt SuperSpace dat er geen wijziging in de PHP-versie is in plaats van iets opnieuw uit te voeren.

De wijziging wordt op de achtergrond toegepast

Het wisselen van PHP-versie verandert de runtime waarop je site draait. SuperSpace past dit op de achtergrond toe nadat je het hebt ingediend, dus geef de nieuwe versie even de tijd om door te werken en controleer je site opnieuw zodra de taak is voltooid.

Test de compatibiliteit voordat je productie wijzigt

Een nieuwere PHP-versie kan ervoor zorgen dat oudere plugins of thema's niet meer werken, en een downgrade kan code kapot maken die afhankelijk is van nieuwere taalfuncties. Controleer of je plugins en thema de doelversie ondersteunen voordat je een live site wijzigt, en houd een recente back-up aan zodat je kunt herstellen als er iets misgaat.

Tip

De wijziging is niet permanent — als een versie problemen veroorzaakt, herhaal je deze stappen om terug te schakelen naar een versie waarvan je weet dat die werkt.

Het resultaat controleren

De wijziging van de PHP-versie is asynchroon. Nadat je het hebt ingediend, houdt SuperSpace het bij als een taak die door deze statussen beweegt:

  • In behandeling — de wijziging staat in de wachtrij (PHP Version Change is pending).
  • Bezig — de wijziging wordt toegepast (PHP Version Change is in progress).
  • Geslaagd — de wijziging is voltooid (PHP Version was successfully changed).
  • Mislukt — de wijziging is niet voltooid (Failed to change php version).

Je kunt de live waarde op elk moment bevestigen via de kaart PHP VERSION op de overzichtspagina van de site.

De PHP-versie uitlezen via de API

Er is geen API-aanroep om de PHP-versie te wijzigen zonder het dashboard — de wijziging wordt vanuit het dashboard gemaakt. Je kunt echter wel de huidige PHP-versie van een site uitlezen via de API. Het detail-endpoint van de site retourneert een alleen-lezen veld php_version:

curl -H "Authorization: Bearer $SUPERSPACE_TOKEN" -H "X-Auth-Account: $ACCOUNT_ID" \
  https://control.superspace.nl/api/sites/$SITE_ID

Het antwoord bevat php_version (een string zoals 8.2) naast de overige details van de site. Zie Sites voor de volledige vorm van het antwoord.

Volgende stappen

  • Test de belangrijkste pagina's en beheeromgeving van je site opnieuw nadat de wijziging is voltooid.
  • Bekijk wat je verder op een site kunt configureren — zie het platformoverzicht.
  • Als een plugin kapotgaat, herstel dan vanaf een back-up en schakel terug naar een PHP-versie waarvan je weet dat die goed werkt.

  1. De lijst met selecteerbare versies weerspiegelt de PHP-versies die momenteel beschikbaar zijn voor je site; de versie die als actief is gemarkeerd, is de versie waarop de site draait. ↩