https://docs.whmcs.com/9-1/tags/database/Recent content in database onHugo -- gohugo.iohttps://docs.whmcs.com/9-1/installation-guide/system-requirements/Mon, 01 Jan 0001 00:00:00 +0000https://docs.whmcs.com/9-1/installation-guide/system-requirements/Lists minimum system requirements for self-hosted WHMCS installations, including supported operating system, Apache version and handlers, PHP 8.2/8.3 with required and recommended extensions and ionCube Loader versions, MySQL version and privileges, database collation, encrypted database connection variables, and recommended file and directory permissions.https://docs.whmcs.com/9-1/troubleshooting/troubleshoot-the-database/troubleshooting-the-database/Mon, 01 Jan 0001 00:00:00 +0000https://docs.whmcs.com/9-1/troubleshooting/troubleshoot-the-database/troubleshooting-the-database/Index page linking to general database and database backup troubleshooting articles for the MySQL database that WHMCS uses.https://docs.whmcs.com/9-1/troubleshooting/troubleshoot-the-database/argument-pdostatement-errors/Mon, 01 Jan 0001 00:00:00 +0000https://docs.whmcs.com/9-1/troubleshooting/troubleshoot-the-database/argument-pdostatement-errors/Documents “TypeError: Argument 1 passed… must be an instance of PDOStatement” errors during MySQL-intensive tasks, caused by heavy Module Log data or low wait_timeout/interactive_timeout MySQL settings, with fixes to disable Module Log and correct the MySQL configuration.https://docs.whmcs.com/9-1/troubleshooting/troubleshoot-the-database/base-table-or-view-not-found-errors/Mon, 01 Jan 0001 00:00:00 +0000https://docs.whmcs.com/9-1/troubleshooting/troubleshoot-the-database/base-table-or-view-not-found-errors/Covers “Base table or view not found” and “Unable to complete incremental updates” errors caused by a missing required table in the WHMCS database, with steps to recreate it from the corresponding schema.sql file.https://docs.whmcs.com/9-1/troubleshooting/troubleshoot-the-database/column-group-id-null-errors/Mon, 01 Jan 0001 00:00:00 +0000https://docs.whmcs.com/9-1/troubleshooting/troubleshoot-the-database/column-group-id-null-errors/Documents the “Column ‘group_id’ cannot be null” integrity constraint error caused by orphaned products not assigned to a valid product group, with fixes using the Orphaned Products Fixer script or a direct MySQL update.https://docs.whmcs.com/9-1/troubleshooting/troubleshoot-the-database/command-denied-errors/Mon, 01 Jan 0001 00:00:00 +0000https://docs.whmcs.com/9-1/troubleshooting/troubleshoot-the-database/command-denied-errors/Covers “Command denied to user” MySQL errors during updates caused by insufficient database user privileges, with the fix of granting the missing CREATE and INDEX privileges, for example via cPanel’s Privileged Users.https://docs.whmcs.com/9-1/troubleshooting/troubleshoot-the-database/could-not-connect-errors/Mon, 01 Jan 0001 00:00:00 +0000https://docs.whmcs.com/9-1/troubleshooting/troubleshoot-the-database/could-not-connect-errors/Documents the system cron’s “Could not connect to database” error caused by configuration.php misconfiguration or a missing PHP extension, with fixes to verify database settings, TLS certificate matching, and the required PDO, PDO MySQL, and MySQLi extensions.https://docs.whmcs.com/9-1/troubleshooting/troubleshoot-cron-issues/cron-system-queue-timeout/Mon, 01 Jan 0001 00:00:00 +0000https://docs.whmcs.com/9-1/troubleshooting/troubleshoot-cron-issues/cron-system-queue-timeout/Covers cron runs that stall on the Executing System Queue step due to database backup generation and zipping slowing as the database grows, and gives the fix of running system cleanup tasks and disabling FTP/SFTP and Daily Email Backups under Database Backups.https://docs.whmcs.com/9-1/system/database-and-storage/database-backups/Mon, 01 Jan 0001 00:00:00 +0000https://docs.whmcs.com/9-1/system/database-and-storage/database-backups/Compares the SFTP/FTP Backup, cPanel Backups (requiring a cPanel API token), and Daily Email Backups automated backup options at Configuration > System Settings > Database Backups, the manual php -q cron.php do –DatabaseBackup command, and the importance of backing up configuration.php separately for its encryption hash.https://docs.whmcs.com/9-1/system/database-and-storage/database-status/Mon, 01 Jan 0001 00:00:00 +0000https://docs.whmcs.com/9-1/system/database-and-storage/database-status/Covers the Optimise Tables button at Utilities > System > Database Status for reducing MySQL table overhead and the Download Database Backup button for manually downloading a database backup file.https://docs.whmcs.com/9-1/troubleshooting/general-troubleshooting/dataset-must-be-array-errors/Mon, 01 Jan 0001 00:00:00 +0000https://docs.whmcs.com/9-1/troubleshooting/general-troubleshooting/dataset-must-be-array-errors/Resolves the “InvalidArgumentException: Dataset must be an array” TableQuery.php error caused by an incorrect $mysql_charset value in configuration.php, with the fix of setting $mysql_charset = ‘utf8’ and removing any latin1 entry.https://docs.whmcs.com/9-1/troubleshooting/troubleshoot-domains/domain-management-oops-errors/Mon, 01 Jan 0001 00:00:00 +0000https://docs.whmcs.com/9-1/troubleshooting/troubleshoot-domains/domain-management-oops-errors/Fixes the Oops! WHMCS\Exception\InvalidDomain: The domain is invalid error shown when managing a domain, caused by an invalid character (such as a leading or trailing space) in the tbldomains.domain database field, by editing the record directly in the tbldomains table.https://docs.whmcs.com/9-1/troubleshooting/general-troubleshooting/down-for-maintenance-errors/Mon, 01 Jan 0001 00:00:00 +0000https://docs.whmcs.com/9-1/troubleshooting/general-troubleshooting/down-for-maintenance-errors/Troubleshoots the Down for Maintenance (Err2) error caused by a mismatch between database, WHMCS file, and PHP versions, with separate resolution steps for when the error appears during an in-progress update (browser install.php upgrade process) versus after an update that did not complete or apply correctly.https://docs.whmcs.com/9-1/troubleshooting/troubleshoot-the-database/duplicate-entry-errors/Mon, 01 Jan 0001 00:00:00 +0000https://docs.whmcs.com/9-1/troubleshooting/troubleshoot-the-database/duplicate-entry-errors/Covers “Duplicate entry ‘0’ for key ‘PRIMARY’” errors after copying or restoring a database, caused by missing primary key and auto_increment attributes from an incomplete table structure copy, with the recommendation to drop and restore the database again.https://docs.whmcs.com/9-1/troubleshooting/troubleshoot-installation/duplicate-tblconfiguration-errors/Mon, 01 Jan 0001 00:00:00 +0000https://docs.whmcs.com/9-1/troubleshooting/troubleshoot-installation/duplicate-tblconfiguration-errors/Explains the install.php step 4 “Oops!” error and the “1062 Duplicate entry for key tblconfiguration.PRIMARY” violation, caused by initiating installation twice simultaneously (for example, via monitoring tools accessing index.php), with steps to disable monitoring, restrict access, drop the database, and restart installation.https://docs.whmcs.com/9-1/troubleshooting/troubleshoot-the-database/field-default-value-errors/Mon, 01 Jan 0001 00:00:00 +0000https://docs.whmcs.com/9-1/troubleshooting/troubleshoot-the-database/field-default-value-errors/Documents the “Field xxx doesn’t have a default value” installation error caused by MySQL Strict Mode being enabled, with the fix of disabling Strict Mode.https://docs.whmcs.com/9-1/customization/models/Mon, 01 Jan 0001 00:00:00 +0000https://docs.whmcs.com/9-1/customization/models/Explains WHMCS’s Eloquent ORM-based model classes (such as WHMCS\User\Client mapping to tblclients) with PHP code examples for creating records with save(), retrieving records with find() and findOrFail(), querying with chained where() calls, accessing relational properties like domains and contacts, updating records, and deleting records and related objects with delete().https://docs.whmcs.com/9-1/troubleshooting/troubleshoot-the-database/mysql-server-gone-away-errors/Mon, 01 Jan 0001 00:00:00 +0000https://docs.whmcs.com/9-1/troubleshooting/troubleshoot-the-database/mysql-server-gone-away-errors/Documents “MySQL server has gone away” errors, often during upgrades, caused by the MySQL server closing the connection due to low timeout values, with the fix of increasing wait_timeout and max_allowed_packet and restoring pre-upgrade backups if needed.https://docs.whmcs.com/9-1/troubleshooting/troubleshoot-the-database/order-not-found-errors/Mon, 01 Jan 0001 00:00:00 +0000https://docs.whmcs.com/9-1/troubleshooting/troubleshoot-the-database/order-not-found-errors/Covers “Order Not Found…Exiting…” caused by WHMCS being unable to write to the database, typically due to MySQL Strict Mode, with the fix of disabling Strict Mode.https://docs.whmcs.com/9-1/troubleshooting/troubleshoot-the-database/pop3-general-error-3988-errors/Mon, 01 Jan 0001 00:00:00 +0000https://docs.whmcs.com/9-1/troubleshooting/troubleshoot-the-database/pop3-general-error-3988-errors/Documents the “General error: 3988 Conversion from collation” error in POP3 Connection Error emails, caused by a table character set mismatch, with the fix of running an ALTER TABLE command to convert the table’s collation.https://docs.whmcs.com/9-1/system/database-and-storage/storage-settings/Mon, 01 Jan 0001 00:00:00 +0000https://docs.whmcs.com/9-1/system/database-and-storage/storage-settings/Lists the eight file-type storage location selectors on the Settings tab (Client Files, Downloads, Email Attachments, Email Images, Email Template Attachments, Knowledgebase Images, Project Management Files, Ticket Attachments), the test/duplicate/edit/delete controls on the Configurations tab, and the recommended folder structure for each file type.https://docs.whmcs.com/9-1/system/system-cleanup/Mon, 01 Jan 0001 00:00:00 +0000https://docs.whmcs.com/9-1/system/system-cleanup/Details the Simple tab’s Empty Gateway Log, Empty Whois Lookup Log, Empty Ticket Mail Import Log, and Empty Template Cache actions, and the Advanced tab’s date-based Prune Client Activity Logs, Prune Saved Emails, and Prune Old Attachments options at Utilities > System > System Cleanup.https://docs.whmcs.com/9-1/troubleshooting/troubleshoot-the-database/unable-to-connect-errors/Mon, 01 Jan 0001 00:00:00 +0000https://docs.whmcs.com/9-1/troubleshooting/troubleshoot-the-database/unable-to-connect-errors/Documents “Critical Error - Unable to connect to the database” caused by incorrect configuration.php database settings, database user permissions, a missing pdo_mysql extension, or required encrypted connection settings, with fixes for each scenario.https://docs.whmcs.com/9-1/system/database-and-storage/database-and-storage-tutorials/disable-mysql-strict-mode/Mon, 01 Jan 0001 00:00:00 +0000https://docs.whmcs.com/9-1/system/database-and-storage/database-and-storage-tutorials/disable-mysql-strict-mode/Gives the steps to disable MySQL Strict Mode by editing the sql_mode setting in /etc/my.cnf and restarting the MySQL service, including the WHM path via Restart Services > SQL Server (MySQL).https://docs.whmcs.com/9-1/system/database-and-storage/database-and-storage-tutorials/encrypt-your-mysql-connection/Mon, 01 Jan 0001 00:00:00 +0000https://docs.whmcs.com/9-1/system/database-and-storage/database-and-storage-tutorials/encrypt-your-mysql-connection/Lists the db_tls_ca, db_tls_ca_path, db_tls_cert, db_tls_cipher, db_tls_key, and db_tls_verify_cert configuration.php settings needed to enable encrypted MySQL connections before, during (CLI -c/–config), or after installation.https://docs.whmcs.com/9-1/system/database-and-storage/database-and-storage-tutorials/migrate-local-storage/Mon, 01 Jan 0001 00:00:00 +0000https://docs.whmcs.com/9-1/system/database-and-storage/database-and-storage-tutorials/migrate-local-storage/Steps through adding a new local storage configuration and path under Storage Settings > Configuration, selecting it under the Settings tab, clicking Migrate to move files automatically, and canceling an in-progress migration with Revert Changes.https://docs.whmcs.com/9-1/system/database-and-storage/database-and-storage-tutorials/migrate-storage-locations/Mon, 01 Jan 0001 00:00:00 +0000https://docs.whmcs.com/9-1/system/database-and-storage/database-and-storage-tutorials/migrate-storage-locations/Explains that email attachments cannot migrate automatically, gives the Amazon S3 subdirectory naming convention (client_files, downloads, email_attachments, template_attachments, pm_files, ticket_attachments) for manual migrations, and links the File Not Found error troubleshooting page.https://docs.whmcs.com/9-1/system/database-and-storage/database-and-storage-tutorials/restore-the-whmcs-database/Mon, 01 Jan 0001 00:00:00 +0000https://docs.whmcs.com/9-1/system/database-and-storage/database-and-storage-tutorials/restore-the-whmcs-database/Walks through restoring a database backup via phpMyAdmin’s Drop-and-Import process, replacing WHMCS files from the full release download, restoring or recreating the configuration.php file, and the post-restoration checklist covering General Settings, Payment Gateways, Servers, and Domain Registrars.https://docs.whmcs.com/9-1/system/database-and-storage/database-and-storage-tutorials/set-up-amazon-s3-storage/Mon, 01 Jan 0001 00:00:00 +0000https://docs.whmcs.com/9-1/system/database-and-storage/database-and-storage-tutorials/set-up-amazon-s3-storage/Details entering the Access Key, Access Secret, Bucket, Region, and optional Endpoint URL under Storage Settings > Configurations to add an S3 provider, the required ListBucket/GetObject/PutObject/ReplicateObject/DeleteObject permissions, an example IAM policy JSON, and the Migrate versus Switch options for moving files to S3.https://docs.whmcs.com/9-1/system/database-and-storage/database-and-storage-tutorials/set-up-an-amazon-s3-bucket/Mon, 01 Jan 0001 00:00:00 +0000https://docs.whmcs.com/9-1/system/database-and-storage/database-and-storage-tutorials/set-up-an-amazon-s3-bucket/Walks through creating an S3 bucket in the AWS console, creating an IAM user and a custom policy granting ListBucket, GetObject, PutObject, ReplicateObject, and DeleteObject permissions scoped to the bucket ARN, and generating and storing the access key ID and secret for WHMCS.