Dépannage de WordPress Playground

Cette page couvre les erreurs du site Playground lui-même, des Playgrounds enregistrés, du stockage du navigateur et du démarrage de WordPress. Pour les erreurs propres aux Blueprints, consultez Dépanner et déboguer les Blueprints.

Playground semble cassé

Essayez d’abord ceci :

• Utilisez le bouton de rechargement dans la barre d’outils de Playground au lieu d’actualiser l’onglet du navigateur. L’actualisation du navigateur redémarre toute l’application Playground.
• Ouvrez la même URL dans une fenêtre privée pour écarter un état de site enregistré ou de stockage du navigateur.
• Désactivez les extensions du navigateur qui bloquent JavaScript, WebAssembly, le stockage, les workers ou les requêtes réseau.
• Consultez les erreurs de Console et de Network dans les outils de développement du navigateur.
• Si l’URL inclut ?site-slug=..., essayez de supprimer ce paramètre de requête pour démarrer un nouveau Playground non enregistré.

Un site propre indique que l’extension MySQL est manquante

Vous pouvez voir une page d’erreur WordPress comme celle-ci :

Your PHP installation appears to be missing the MySQL extension which is required by WordPress.

Dans Playground, cela signifie généralement que WordPress n’a pas chargé l’intégration SQLite qui permet à WordPress de fonctionner sans MySQL. Playground exécute WordPress dans WebAssembly et utilise SQLite au lieu d’un serveur MySQL.

Essayez ces étapes :

• Démarrez un nouveau Playground non enregistré sur https://playground.wordpress.net/ pour confirmer que le site public peut démarrer.
• Si l’URL inclut un site enregistré, supprimez ?site-slug=... et chargez un nouveau site temporaire.
• Si cela s’est produit après l’importation d’un ZIP, confirmez que l’importation n’incluait pas de wp-content/db.php personnalisé qui remplace la configuration SQLite de Playground.
• Si cela s’est produit dans la CLI, n’utilisez pas --skip-sqlite-setup sauf si vous fournissez votre propre intégration de base de données.
• Si cela s’est produit avec un Blueprint, consultez la page de dépannage des Blueprints.

Si vous écrivez un Blueprint et devez ajouter l’extension d’intégration SQLite, plugins se place au premier niveau :

{
	"preferredVersions": {
		"php": "8.3",
		"wp": "latest"
	},
	"plugins": ["sqlite-database-integration"],
	"steps": [
		{
			"step": "login",
			"username": "admin"
		}
	]
}

Error connecting to the SQLite database

Cela signifie que Playground a chargé l’intégration SQLite, mais que WordPress n’a toujours pas pu se connecter à la base de données.

Causes courantes :

• Le stockage navigateur d’un Playground enregistré est périmé ou incomplet.
• Un ZIP de site importé contient un fichier de base de données ou un drop-in de base de données incompatible.
• Il manque à un répertoire local monté des fichiers dont WordPress a besoin.
• Le stockage du navigateur a été effacé, évincé ou bloqué.

Récupération recommandée :

1. Démarrez un nouveau Playground non enregistré sans site-slug.
2. Si le nouveau site fonctionne, le problème est lié au site enregistré ou à l’archive importée.
3. Exportez tous les fichiers accessibles du site enregistré cassé avec le File Browser ou une copie de répertoire local, si disponible.
4. Réimportez le site dans un nouveau Playground, ou reconstruisez-le à partir de son Blueprint.

NotAllowedError

NotAllowedError signifie généralement que le navigateur a bloqué une opération qui nécessite une autorisation de l’utilisateur ou un contexte de navigateur pris en charge. Dans Playground, cela concerne souvent les sites enregistrés ou l’accès à un répertoire local.

Vous pouvez voir ce message exact :

The request is not allowed by the user agent or the platform in the current context.

Essayez :

• Ouvrez Playground dans un onglet de navigateur normal de premier niveau, pas dans une iframe restreinte.
• Rouvrez le site depuis le panneau Saved Playgrounds de Playground.
• Si le site a été enregistré dans un répertoire local, importez ou enregistrez de nouveau le répertoire.
• Confirmez que le navigateur prend en charge l’API de fichier ou de stockage utilisée. Chrome et Edge offrent généralement la prise en charge la plus large des répertoires locaux.
• Vérifiez si le mode de navigation privée, une politique d’entreprise ou les réglages du navigateur bloquent l’accès au stockage.

NoModificationAllowedError

NoModificationAllowedError signifie que le navigateur ou le système de fichiers a refusé une écriture. Cela peut arriver lorsqu’un répertoire local enregistré est devenu en lecture seule, que l’autorisation a été perdue ou que le stockage du navigateur est indisponible.

Vous pouvez voir ce message exact :

An attempt was made to write to a file or directory which could not be modified due to the state of the underlying filesystem.

Essayez :

• Enregistrez une copie dans un autre répertoire local.
• Vérifiez que le dossier cible existe encore et qu’il est accessible en écriture.
• Évitez les dossiers protégés par le système ou les dossiers synchronisés qui verrouillent temporairement les fichiers.
• Démarrez un nouveau Playground non enregistré si vous avez seulement besoin d’un site de test temporaire.
• Utilisez Playground CLI pour un développement local qui nécessite une persistance fiable du système de fichiers.

Le Playground enregistré ne peut pas se recharger

Les Playgrounds enregistrés sont stockés dans le stockage du navigateur ou dans un répertoire local que vous avez sélectionné. Ils ne sont pas hébergés sur un serveur distant.

Si un Playground enregistré ne peut pas se recharger :

• Confirmez que vous utilisez le même navigateur et le même profil de navigateur que lors de son enregistrement.
• Vérifiez si les données du navigateur ont été effacées ou si le stockage a été désactivé.
• Si le site a été enregistré dans un répertoire local, confirmez que le répertoire existe toujours et n’a pas été déplacé.
• Si l’URL inclut ?site-slug=..., supprimez-le pour démarrer un nouveau site non enregistré.
• Recréez le site enregistré depuis son Blueprint d’origine ou son ZIP d’importation si le stockage a été perdu.

Stockage du navigateur et persistance

Un Playground non enregistré est temporaire. Une actualisation du navigateur, la fermeture d’un onglet, le nettoyage du stockage ou un changement de profil de navigateur peut supprimer son état.

Utilisez le bouton Save avant d’effectuer un travail important. Pour un développement local plus long, préférez Playground CLI, qui conserve les fichiers du site sur le disque.

Le bouton de rechargement dans la barre d’outils de Playground recharge WordPress tout en conservant l’environnement d’exécution actuel de Playground. Le bouton d’actualisation du navigateur recharge toute l’application et peut perdre les modifications non enregistrées.

Quand repartir de zéro

Démarrez un nouveau Playground non enregistré lorsque :

• Vous voulez seulement tester si le site public Playground fonctionne.
• L’URL pointe vers un site-slug enregistré qui ne se charge plus.
• Vous cherchez à savoir si une erreur vient de Playground lui-même ou d’une extension, d’un thème, d’un Blueprint ou d’un site importé.
• Le stockage du navigateur ou l’accès au répertoire local semble cassé.

Utilisez cette URL pour un site propre :

https://playground.wordpress.net/

Signaler un problème Playground

Si le problème se reproduit sur un nouveau Playground non enregistré, veuillez ouvrir une issue et inclure :

• L’URL complète de Playground.
• Le navigateur et le système d’exploitation.
• Si vous avez utilisé un site enregistré, un ZIP importé, un Blueprint, un répertoire local ou la CLI.
• Le nom et le message d’erreur exacts.
• Les détails de Console et de Network des outils de développement du navigateur.