Safely manage PHP constants (defines) through the WordPress admin or WP-CLI with full CRUD functionality and comprehensive viewing capabilities.

ramon fincken

Define Constants

GUI in backend to define constants without any programming knowledge. Every file in your theme has access to your constant.

cartpauj

<p>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!</p>
<h4>Key Features</h4>
<ul>
<li><strong>Complete Constant Management</strong>: Create, read, update, and delete PHP constants from the WordPress admin</li>
<li><strong>Dual View System</strong>: “My Constants” for your custom constants and “All Constants” to view every constant in your WordPress installation</li>
<li><strong>Native WordPress UI</strong>: Built using WP_List_Table with sorting, searching, and bulk actions</li>
<li><strong>Multiple Data Types</strong>: Support for String, Integer, Float, Boolean, and NULL constant types with strict validation</li>
<li><strong>Real-time Validation</strong>: Form fields validate values against selected type with immediate feedback</li>
<li><strong>Active/Inactive States</strong>: Toggle constants on/off without deleting them</li>
<li><strong>Conflict Detection</strong>: Visual indicators show when constants are already defined elsewhere (predefined)</li>
<li><strong>Screen Options</strong>: Customize table views with adjustable items per page and column visibility controls</li>
<li><strong>Early Loading Option</strong>: Optional must-use plugin creation for loading constants before other plugins</li>
<li><strong>Load Order Awareness</strong>: Constants loaded during plugins_loaded action (priority 1) for broad compatibility</li>
<li><strong>Comprehensive Help</strong>: Built-in help system with detailed documentation and best practices</li>
<li><strong>Administrator Only</strong>: Secure access restricted to users with manage_options capability</li>
<li><strong>Database Storage</strong>: Constants stored safely in a custom database table with full audit trail</li>
<li><strong>Import/Export</strong>: Backup and migrate constants using CSV files with detailed error reporting</li>
<li><strong>WP-CLI Integration</strong>: Manage constants, import/export CSV, and toggle early loading from the terminal via <code>wp phpcm ...</code> — ideal for automation, CI/CD, and multi-site provisioning</li>
</ul>
<h4>Understanding Predefined Constants</h4>
<p>The plugin intelligently detects when constants are already defined by WordPress core, other plugins, or your theme:<br />
* <strong>Not Predefined</strong>: Your constant is unique and will work normally<br />
* <strong>Predefined</strong>: The constant exists elsewhere – your definition is saved but won’t override the existing value due to PHP’s constant rules</p>
<h4>Use Cases</h4>
<ul>
<li>Manage environment-specific configuration</li>
<li>Toggle debug constants without file editing</li>
<li>Store API keys and configuration values securely</li>
<li>Create fallback constants for different environments</li>
<li>Document constant purposes with built-in descriptions</li>
<li>Audit all constants in your WordPress installation</li>
<li>Backup constants to CSV files for migration between sites</li>
<li>Import constants in bulk from properly formatted CSV files</li>
<li>Automate site setup and deployment pipelines with WP-CLI (<code>wp phpcm add MY_KEY ...</code>)</li>
</ul>
<h4>WP-CLI Commands</h4>
<p>When WP-CLI is available, the plugin registers a <code>phpcm</code> command suite that mirrors the admin UI:</p>
<ul>
<li><code>wp phpcm list [--active] [--inactive] [--type=<type>] [--search=<term>] [--format=<format>]</code> — list managed constants</li>
<li><code>wp phpcm get <name></code> — show a single constant (supports <code>--field=<field></code>)</li>
<li><code>wp phpcm add <name> [<value>] [--type=<type>] [--description=<text>] [--inactive] [--porcelain]</code> — create a constant (value can be <code>-</code> to read from stdin)</li>
<li><code>wp phpcm update <name> [--value=<value>] [--type=<type>] [--description=<text>] [--active|--inactive]</code> — update fields</li>
<li><code>wp phpcm delete <name>... [--yes]</code> — delete one or more by name</li>
<li><code>wp phpcm activate|deactivate|toggle <name>...</code> — flip active state</li>
<li><code>wp phpcm defined <name></code> — report whether the constant is currently defined and by whom (this plugin, early-load, or elsewhere like wp-config.php)</li>
<li><code>wp phpcm all-defines [--user-defined] [--search=<term>]</code> — inspect every PHP constant present in the process</li>
<li><code>wp phpcm status</code> — plugin health summary (table, row counts, early-loading state)</li>
<li><code>wp phpcm import <file|-> [--overwrite]</code> — import CSV (file path or stdin)</li>
<li><code>wp phpcm export [<file>] [--active] [--inactive] [--type=<type>]</code> — write CSV to a file or stdout</li>
<li><code>wp phpcm early-loading enable|disable|status</code> — manage the must-use plugin that loads constants before all other plugins</li>
</ul>
<p>Run <code>wp help phpcm <subcommand></code> for detailed usage, flags, and examples.</p>
<h3>Developer Information</h3>
<h4>Database Schema</h4>
<p>The plugin creates a custom table <code>{prefix}phpcm_constants</code> with the following structure:<br />
* <code>id</code> – Primary key (auto-increment)<br />
* <code>name</code> – Constant name (unique, varchar 191)<br />
* <code>value</code> – Constant value (longtext)<br />
* <code>type</code> – Data type (enum: string, integer, float, boolean, null)<br />
* <code>is_active</code> – Whether the constant is loaded (tinyint)<br />
* <code>description</code> – Optional description (text)<br />
* <code>created_at</code> – Creation timestamp (datetime)<br />
* <code>updated_at</code> – Last update timestamp (datetime)</p>
<h4>WordPress Hooks Used</h4>
<ul>
<li><code>plugins_loaded</code> (priority 1) – Early constant loading for maximum compatibility</li>
<li><code>admin_menu</code> – Menu registration</li>
<li><code>admin_post_*</code> – Form submission handling</li>
<li><code>wp_ajax_*</code> – AJAX operations</li>
<li><code>WP_CLI::add_command('phpcm', ...)</code> – Registers the CLI command when WP-CLI is available</li>
</ul>
<h4>Load Order & Compatibility</h4>
<p>Constants are defined during <code>plugins_loaded</code> with priority 1, ensuring they are available to:<br />
* All theme functions and templates<br />
* Other plugins (unless using higher priority)<br />
* WordPress core hooks like <code>init</code>, <code>wp_loaded</code>, etc.</p>
<h4>Security Implementation</h4>
<ul>
<li>Capability requirement: <code>manage_options</code> (administrators only)</li>
<li>Nonce verification on all form submissions and AJAX requests</li>
<li>SQL injection prevention with prepared statements</li>
<li>Input sanitization using WordPress core functions</li>
<li>Output escaping for all displayed data</li>
</ul>
<h4>Code Standards</h4>
<p>This plugin follows WordPress coding standards and best practices:<br />
* PSR-4 autoloading structure<br />
* WordPress database abstraction layer<br />
* Internationalization ready<br />
* WP_List_Table implementation<br />
* Standard WordPress admin UI patterns</p>


PHP Constants Manager


Our dev team juggles a ton of constants for switching environment variables during testing, and this tool has been a game changer. Being able to export and share sets of constants across the team is a huge plus. Toggling them on and off within the plugin is super straightforward. And the early loading feature is perfect for getting constants changed before any other plugins are loaded.


Alternatives to PHP Constants Manager

Top alternatives