Résolution des problèmes de connexion MySQL à ownCloud 10
Découvrez si MySQL, PHP, les paramètres de socket ou les autorisations de base de données bloquent ownCloud 10, puis vérifiez une solution sûre.
Lorsque ownCloud 10 affiche l'erreur « Échec de la connexion à la base de données », vérifiez d'abord si MySQL est inaccessible, s'il refuse le compte ou si un pilote PHP est manquant. Contrôlez le service de base de données ainsi que l'hôte, le nom de la base de données et le nom d'utilisateur exacts enregistrés dans les fichiers d'ownCloud config/config.php. Testez ensuite ces identifiants depuis le serveur ownCloud avant de modifier les autorisations ou de recréer quoi que ce soit. Ce guide concerne ownCloud Server 10.16 avec MySQL ou MariaDB. Les intitulés des menus et les commandes des paquets peuvent varier selon le système d'exploitation et la méthode d'installation.
« Échec de la connexion à la base de données » est un message générique. L’erreur MySQL ou PHP plus spécifique, consignée dans les journaux d’ownCloud ou du serveur web, indique généralement la cause du problème. Une erreur de connexion telle que l’erreur MySQL 2002 ou 2003 signale généralement un service arrêté, un socket ou un port incorrect, un chemin réseau bloqué ou un serveur qui n’écoute pas à l’emplacement attendu par ownCloud. Un message « Accès refusé » signifie généralement que MySQL a bien reçu la connexion, mais n’a pas accepté le nom d’utilisateur, le mot de passe ou l’hôte client.
MySQL désigne le serveur de base de données ; MariaDB est une base de données compatible prise en charge par ownCloud. PDO MySQL est le pilote de base de données PHP qui permet à ownCloud de communiquer avec l'un ou l'autre. Action : notez le texte exact de l'erreur et son horodatage, puis comparez-les aux vérifications ci-dessous au lieu de considérer chaque échec de connexion comme un mot de passe incorrect.
config/config.phpavant toute modification et ne communiquez jamais le mot de passe de la base de données dans une demande d'assistance.Ne supprimez ni ne recréez la base de données lors d'une première étape de dépannage : les fichiers utilisateur et les métadonnées existants en dépendent. Action : effectuez une sauvegarde vérifiée du répertoire de données ownCloud et de la base de données avant toute modification de cette dernière.
sudo systemctl status mysql
sudo systemctl status mariadb
Il est possible qu'un nom de service soit absent de votre distribution. Si le service est arrêté, consultez son journal et le journal des erreurs de la base de données pour en déterminer la cause avant de le redémarrer. Action : résolvez les erreurs de démarrage, telles qu'un disque plein ou une configuration de base de données invalide, avant de tenter de résoudre les problèmes d'identifiants ownCloud.
localhostutilise souvent un socket Unix local, 127.0.0.1imposant ainsi le protocole TCP. Cela a une incidence lorsque la base de données est locale mais que PHP et MySQL utilisent des chemins de socket différents. Action : comparez le chemin de socket et le paramètre d'hôte avec la configuration réelle du serveur de base de données, ou testez délibérément le protocole TCP si c'est le chemin attendu.Testez la connexion au serveur ownCloud en utilisant le même nom d'utilisateur, le même hôte et le même nom de base de données que ceux utilisés par ownCloud :
mysql --protocol=TCP -h db.example.net -P 3306 -u oc_user -p owncloud
Saisissez le mot de passe à l'invite ; ne l'insérez pas directement dans la commande, car il pourrait être enregistré dans l'historique du shell. Pour une connexion socket locale, testez plutôt l'hôte et le mode socket correspondant à votre configuration. Une connexion réussie prouve que MySQL accepte ce chemin de connexion et ce compte, mais ne prouve pas que PHP dispose de son pilote ni qu'ownCloud utilise les mêmes paramètres. Action : si cette commande échoue, utilisez l'erreur MySQL pour choisir la prochaine vérification.
L'assistant d'installation d'ownCloud enregistre le type de base de données, son nom, le nom d'utilisateur, le mot de passe, l'hôte et le préfixe des tables dans un fichier config/config.php. Vérifiez attentivement ces valeurs sans copier le mot de passe dans les journaux ou le chat. Ce fichier dbhostpeut inclure un hôte et un port ; si la mention « hôte » apparaît localhost, vérifiez que le socket attendu est bien accessible au processus PHP.
Si le client en ligne de commande fonctionne mais qu'ownCloud ne fonctionne toujours pas, vérifiez que l'environnement d'exécution PHP utilisé par le serveur web est pdo_mysqlinstallé et activé. Une commande shell, telle que ` php -mphp apt`, ne renvoie que les informations concernant l'environnement d'exécution PHP en ligne de commande, qui peut différer d'Apache ou de PHP-FPM. Action : examinez la configuration PHP active du serveur web et redémarrez le service web/PHP concerné après avoir activé l'extension.
En cas d'erreur « Accès refusé », vérifiez que MySQL possède un compte correspondant à la fois au nom d'utilisateur et à l'hôte client vus par la base de données. MySQL considère les comptes tels que « nom_utilisateur » 'oc_user'@'localhost'et «'oc_user'@'10.0.0.5' hôte_client » comme distincts. Si l'application ownCloud est exécutée dans un conteneur, la base de données peut voir une adresse de conteneur ou de pont plutôt que « nom_utilisateurlocalhost ». Action : demandez à l'administrateur de la base de données d'examiner le compte correspondant et les autorisations ; n'accordez l'accès que depuis l'hôte ou le réseau ownCloud qui en a besoin.
Vérifiez que la base de données existe et que le compte ownCloud peut y accéder. Évitez d'accorder des privilèges globaux ou d'utiliser le compte root MySQL dans ownCloud. Les permissions requises peuvent varier selon qu'il s'agit d'une installation initiale ou d'une instance existante. Action : suivez les instructions de configuration de la base de données d'ownCloud pour cette étape et ne modifiez ni la propriété ni les permissions des bases de données non concernées.
Corrigez uniquement les paramètres identifiés par les tests : démarrez le service de base de données, utilisez un nom d’hôte et un port accessibles, corrigez une incompatibilité de socket, activez le pilote PHP, corrigez le mot de passe du compte ou ajustez les droits d’accès à la base de données spécifiques à l’hôte. Si vous effectuez des modifications config/config.php, veillez à conserver une syntaxe PHP valide et effectuez une sauvegarde au préalable. Ne modifiez pas le nom de la base de données, le préfixe des tables ni les identifiants sans les connaître.
Après la modification, rechargez ownCloud et vérifiez que la page se charge sans l'avertissement de connexion à la base de données. Consultez le journal ownCloud pour vérifier la réussite de la requête et assurez-vous que les utilisateurs peuvent parcourir les fichiers existants. Si MySQL signale « serveur indisponible » au lieu d'un refus de connexion, il s'agit d'un problème différent lié à une interruption de connexion, un délai d'attente dépassé ou une taille de paquet insuffisante ; la documentation ownCloud décrit les paramètres de délai d'attente et de taille de paquet MySQL pour ce cas. Action : suivez les instructions de dépannage de la base de données correspondante et ne modifiez les limites du serveur que si les journaux confirment ce diagnostic.
La documentation actuelle du serveur ownCloud 10.16 recommande l'assistant d'installation pour la configuration standard de la base de données et mentionne spécifiquement pdo_mysqlle chemin du socket MySQL comme point de contrôle. Les noms exacts des paquets, les versions de PHP et les noms des services dépendent de l'hôte. Action : terminez en répétant le test de connexion depuis le serveur ownCloud et en vérifiant que l'application peut lire ses données existantes.
Découvrez si MySQL, PHP, les paramètres de socket ou les autorisations de base de données bloquent ownCloud 10, puis vérifiez une solution sûre.
Rendez obligatoire l'expiration des liens publics dans ownCloud Classic, définissez une durée de vie maximale et vérifiez les partages existants qui pourraient nécessiter un nettoyage séparé.
Activez le protocole TOTP via Keycloak, inscrivez les utilisateurs en toute sécurité et comprenez quand les paramètres MFA au niveau du routage d'Infinite Scale s'appliquent.
Vérifiez si le problème provient d'une incompatibilité entre OC10 et 7.x ou d'un journal CSync endommagé, puis appliquez le correctif approprié sans supprimer les fichiers synchronisés.
Choisissez HTTP-01 ou DNS-01, configurez un proxy inverse ownCloud et vérifiez que Certbot renouvelle automatiquement les certificats HTTPS.
Configurez la connexion LDAP oCIS, alignez les recherches d'utilisateurs et de groupes et vérifiez les paramètres TLS et de schéma avant le déploiement.
Ajoutez un compartiment Amazon S3 à ownCloud 10, préparez les identifiants et les points de terminaison compatibles, et vérifiez l'accès sans confondre un montage avec le stockage principal.
Planifiez des sauvegardes MariaDB protégées pour ownCloud Server, gérez le mode maintenance en toute sécurité et vérifiez chaque sauvegarde avant de vous y fier.
Planifiez une migration d'ownCloud 10 vers oCIS avec l'application prise en charge, les commandes ordonnées, les contrôles d'identité et une liste claire des données qui nécessitent un traitement séparé.
Remplacez les logos ownCloud Classic 10 et personnalisez les couleurs de l'interface utilisateur Web grâce à une application de thème, tout en évitant les pièges liés à la mise à niveau et à la vérification d'intégrité.