HostForge upstream setup

2026-04-09 02:49:31 +08:00
parent b70c252e2c
commit 68a7ca8ca4
4 changed files with 250 additions and 0 deletions
--- a/wp-config-hostforge.php
+++ b/wp-config-hostforge.php
@@ -0,0 +1,151 @@
+<?php
+/**
+ * HostForge platform settings.
+ *
+ * IMPORTANT:
+ * This file should be managed by HostForge provisioning.
+ * Site-specific customizations should stay in wp-config.php
+ * or in a separate user-managed file if you want to support that later.
+ */
+
+/**
+ * Helper to fetch environment values safely.
+ *
+ * getenv() is preferred because $_ENV may not always be populated
+ * depending on PHP configuration.
+ *
+ * @param string $key
+ * @param mixed $default
+ * @return mixed
+ */
+if (!function_exists('hf_env')) {
+	function hf_env(string $key, $default = null)
+	{
+		$value = getenv($key);
+
+		if ($value !== false) {
+			return $value;
+		}
+
+		return $_ENV[$key] ?? $default;
+	}
+}
+
+/**
+ * Required database settings.
+ */
+define('DB_NAME', hf_env('DB_NAME', ''));
+define('DB_USER', hf_env('DB_USER', ''));
+define('DB_PASSWORD', hf_env('DB_PASSWORD', ''));
+define('DB_HOST', hf_env('DB_HOST', '127.0.0.1'));
+define('DB_CHARSET', hf_env('DB_CHARSET', 'utf8mb4'));
+define('DB_COLLATE', hf_env('DB_COLLATE', ''));
+
+/**
+ * Authentication keys and salts.
+ */
+define('AUTH_KEY', hf_env('AUTH_KEY', ''));
+define('SECURE_AUTH_KEY', hf_env('SECURE_AUTH_KEY', ''));
+define('LOGGED_IN_KEY', hf_env('LOGGED_IN_KEY', ''));
+define('NONCE_KEY', hf_env('NONCE_KEY', ''));
+define('AUTH_SALT', hf_env('AUTH_SALT', ''));
+define('SECURE_AUTH_SALT', hf_env('SECURE_AUTH_SALT', ''));
+define('LOGGED_IN_SALT', hf_env('LOGGED_IN_SALT', ''));
+define('NONCE_SALT', hf_env('NONCE_SALT', ''));
+
+/**
+ * HostForge metadata.
+ */
+define('HOSTFORGE_SITE_ID', hf_env('HOSTFORGE_SITE_ID', ''));
+define('HOSTFORGE_SITE_UUID', hf_env('HOSTFORGE_SITE_UUID', ''));
+define('HOSTFORGE_ENVIRONMENT', hf_env('HOSTFORGE_ENVIRONMENT', 'production'));
+define('HOSTFORGE_APP_TYPE', hf_env('HOSTFORGE_APP_TYPE', 'wordpress'));
+
+/**
+ * WordPress environment type.
+ *
+ * Maps HostForge environment to WP_ENVIRONMENT_TYPE.
+ */
+if (!defined('WP_ENVIRONMENT_TYPE')) {
+	switch (HOSTFORGE_ENVIRONMENT) {
+		case 'production':
+			define('WP_ENVIRONMENT_TYPE', 'production');
+			break;
+
+		case 'staging':
+			define('WP_ENVIRONMENT_TYPE', 'staging');
+			break;
+
+		default:
+			define('WP_ENVIRONMENT_TYPE', 'development');
+			break;
+	}
+}
+
+/**
+ * Debug settings.
+ */
+if (!defined('WP_DEBUG')) {
+	define('WP_DEBUG', HOSTFORGE_ENVIRONMENT !== 'production');
+}
+
+if (!defined('WP_DEBUG_LOG')) {
+	define('WP_DEBUG_LOG', HOSTFORGE_ENVIRONMENT !== 'production');
+}
+
+if (!defined('WP_DEBUG_DISPLAY')) {
+	define('WP_DEBUG_DISPLAY', false);
+}
+
+@ini_set('display_errors', '0');
+
+/**
+ * Detect scheme and set URLs dynamically.
+ *
+ * This is useful when the same codebase is used across temporary/staging domains.
+ */
+if (
+	!defined('WP_HOME') &&
+	!defined('WP_SITEURL') &&
+	isset($_SERVER['HTTP_HOST'])
+) {
+	$scheme = 'http';
+
+	if (
+		(!empty($_SERVER['HTTPS']) && $_SERVER['HTTPS'] !== 'off') ||
+		(isset($_SERVER['HTTP_X_FORWARDED_PROTO']) && $_SERVER['HTTP_X_FORWARDED_PROTO'] === 'https') ||
+		(isset($_SERVER['HTTP_X_FORWARDED_SSL']) && $_SERVER['HTTP_X_FORWARDED_SSL'] === 'on')
+	) {
+		$scheme = 'https';
+		$_SERVER['HTTPS'] = 'on';
+	}
+
+	define('WP_HOME', $scheme . '://' . $_SERVER['HTTP_HOST']);
+	define('WP_SITEURL', $scheme . '://' . $_SERVER['HTTP_HOST']);
+}
+
+/**
+ * Temporary directory.
+ */
+if (!defined('WP_TEMP_DIR')) {
+	define('WP_TEMP_DIR', sys_get_temp_dir());
+}
+
+/**
+ * Disable wp-cron if HostForge will run cron externally.
+ */
+if (!defined('DISABLE_WP_CRON')) {
+	define('DISABLE_WP_CRON', true);
+}
+
+/**
+ * Optional: disallow file modifications in non-development environments.
+ *
+ * This is useful if you want tighter control in staging/production.
+ */
+if (
+	!defined('DISALLOW_FILE_MODS') &&
+	in_array(HOSTFORGE_ENVIRONMENT, ['staging', 'production'], true)
+) {
+	define('DISALLOW_FILE_MODS', true);
+}