PHP Constants Manager provides a secure and user-friendly interface for managing PHP constants in WordPress. No more editing wp-config.php or theme files to add or modify constants!

Key Features

Complete Constant Management: Create, read, update, and delete PHP constants from the WordPress admin
Dual View System: “My Constants” for your custom constants and “All Constants” to view every constant in your WordPress installation
Native WordPress UI: Built using WP_List_Table with sorting, searching, and bulk actions
Multiple Data Types: Support for String, Integer, Float, Boolean, and NULL constant types with strict validation
Real-time Validation: Form fields validate values against selected type with immediate feedback
Active/Inactive States: Toggle constants on/off without deleting them
Conflict Detection: Visual indicators show when constants are already defined elsewhere (predefined)
Screen Options: Customize table views with adjustable items per page and column visibility controls
Early Loading Option: Optional must-use plugin creation for loading constants before other plugins
Load Order Awareness: Constants loaded during plugins_loaded action (priority 1) for broad compatibility
Comprehensive Help: Built-in help system with detailed documentation and best practices
Administrator Only: Secure access restricted to users with manage_options capability
Database Storage: Constants stored safely in a custom database table with full audit trail
Import/Export: Backup and migrate constants using CSV files with detailed error reporting
WP-CLI Integration: Manage constants, import/export CSV, and toggle early loading from the terminal via wp phpcm ... — ideal for automation, CI/CD, and multi-site provisioning

Understanding Predefined Constants

The plugin intelligently detects when constants are already defined by WordPress core, other plugins, or your theme:
* Not Predefined: Your constant is unique and will work normally
* Predefined: The constant exists elsewhere – your definition is saved but won’t override the existing value due to PHP’s constant rules

Use Cases

Manage environment-specific configuration
Toggle debug constants without file editing
Store API keys and configuration values securely
Create fallback constants for different environments
Document constant purposes with built-in descriptions
Audit all constants in your WordPress installation
Backup constants to CSV files for migration between sites
Import constants in bulk from properly formatted CSV files
Automate site setup and deployment pipelines with WP-CLI (wp phpcm add MY_KEY ...)

WP-CLI Commands

When WP-CLI is available, the plugin registers a phpcm command suite that mirrors the admin UI:

wp phpcm list [--active] [--inactive] [--type=] [--search=] [--format=] — list managed constants
wp phpcm get — show a single constant (supports --field=)
wp phpcm add [] [--type=] [--description=] [--inactive] [--porcelain] — create a constant (value can be - to read from stdin)
wp phpcm update [--value=] [--type=] [--description=] [--active|--inactive] — update fields
wp phpcm delete ... [--yes] — delete one or more by name
wp phpcm activate|deactivate|toggle ... — flip active state
wp phpcm defined — report whether the constant is currently defined and by whom (this plugin, early-load, or elsewhere like wp-config.php)
wp phpcm all-defines [--user-defined] [--search=] — inspect every PHP constant present in the process
wp phpcm status — plugin health summary (table, row counts, early-loading state)
wp phpcm import [--overwrite] — import CSV (file path or stdin)
wp phpcm export [] [--active] [--inactive] [--type=] — write CSV to a file or stdout
wp phpcm early-loading enable|disable|status — manage the must-use plugin that loads constants before all other plugins

Run wp help phpcm for detailed usage, flags, and examples.

Developer Information

Database Schema

The plugin creates a custom table {prefix}phpcm_constants with the following structure:
* id – Primary key (auto-increment)
* name – Constant name (unique, varchar 191)
* value – Constant value (longtext)
* type – Data type (enum: string, integer, float, boolean, null)
* is_active – Whether the constant is loaded (tinyint)
* description – Optional description (text)
* created_at – Creation timestamp (datetime)
* updated_at – Last update timestamp (datetime)

WordPress Hooks Used

plugins_loaded (priority 1) – Early constant loading for maximum compatibility
admin_menu – Menu registration
admin_post_* – Form submission handling
wp_ajax_* – AJAX operations
WP_CLI::add_command('phpcm', ...) – Registers the CLI command when WP-CLI is available

Load Order & Compatibility

Constants are defined during plugins_loaded with priority 1, ensuring they are available to:
* All theme functions and templates
* Other plugins (unless using higher priority)
* WordPress core hooks like init, wp_loaded, etc.

Security Implementation

Capability requirement: manage_options (administrators only)
Nonce verification on all form submissions and AJAX requests
SQL injection prevention with prepared statements
Input sanitization using WordPress core functions
Output escaping for all displayed data

Code Standards

This plugin follows WordPress coding standards and best practices:
* PSR-4 autoloading structure
* WordPress database abstraction layer
* Internationalization ready
* WP_List_Table implementation
* Standard WordPress admin UI patterns

PHP Constants Manager