From e088ef3d4a7b6d99a5423b731026b508324ad79c Mon Sep 17 00:00:00 2001
From: Marian <42134098+IanDelMar@users.noreply.github.com>
Date: Mon, 7 Jul 2025 13:24:26 +0200
Subject: [PATCH 1/5] Fix handling of dynamic constants

---
 bootstrap.php  | 20 ++++++++------------
 extension.neon | 19 +++++++++++++++++--
 2 files changed, 25 insertions(+), 14 deletions(-)

diff --git a/bootstrap.php b/bootstrap.php
index 9831110..aedb7a3 100644
--- a/bootstrap.php
+++ b/bootstrap.php
@@ -5,16 +5,16 @@
 // phpcs:disable Generic.PHP.ForbiddenFunctions.Found
 
 // There are no core functions to read these constants.
-define('ABSPATH', './');
+define('ABSPATH', '/');
+define('WP_CONTENT_DIR', sprintf('%swp-content', ABSPATH));
+define('WP_PLUGIN_DIR', sprintf('%s/plugins', WP_CONTENT_DIR));
+define('WPMU_PLUGIN_DIR', sprintf('%s/mu-plugins', WP_CONTENT_DIR));
 define('WP_DEBUG', true);
-define('WP_DEBUG_LOG', true);
-define('WP_DEBUG_DISPLAY', true);
-define('WP_PLUGIN_DIR', './');
-define('WPMU_PLUGIN_DIR', './');
-define('EMPTY_TRASH_DAYS', 30 * 86400);
+define('WP_DEBUG_DISPLAY', false);
+define('EMPTY_TRASH_DAYS', 30);
 define('SCRIPT_DEBUG', false);
-define('WP_LANG_DIR', './');
-define('WP_CONTENT_DIR', './');
+define('WP_LANG_DIR', sprintf('%s/languages', WP_CONTENT_DIR));
+define('COOKIE_DOMAIN', '');
 
 // Constants for expressing human-readable intervals.
 define('MINUTE_IN_SECONDS', 60);
@@ -65,8 +65,4 @@
 define('EP_ALL', EP_PERMALINK | EP_ATTACHMENT | EP_ROOT | EP_COMMENTS | EP_SEARCH | EP_PAGES | EP_ALL_ARCHIVES);
 
 // Templating-related WordPress constants.
-// phpcs:ignore WordPress.WP.DiscouragedConstants.STYLESHEETPATHDeclarationFound
-define('STYLESHEETPATH', '/app/wp-content/themes/child/');
-// phpcs:ignore WordPress.WP.DiscouragedConstants.TEMPLATEPATHDeclarationFound
-define('TEMPLATEPATH', '/app/wp-content/themes/parent/');
 define('WP_DEFAULT_THEME', 'twentytwentythree');
diff --git a/extension.neon b/extension.neon
index 56205ee..fe87b88 100644
--- a/extension.neon
+++ b/extension.neon
@@ -38,14 +38,29 @@ parameters:
         - ../../php-stubs/wordpress-stubs/wordpress-stubs.php
         - bootstrap.php
     dynamicConstantNames:
+        # Debug constants
         - WP_DEBUG
         - WP_DEBUG_LOG
         - WP_DEBUG_DISPLAY
-        - EMPTY_TRASH_DAYS
-        - WP_CLI
+        # Directory constants
+        - ABSPATH
+        - WP_PLUGIN_DIR
+        - WP_LANG_DIR
+        - WP_CONTENT_DIR
+        - WPMU_PLUGIN_DIR
+        # Templating constants
+        - WP_DEFAULT_THEME
+        # Filesystem constants
+        - FS_CONNECT_TIMEOUT
+        - FS_TIMEOUT
+        - FS_CHMOD_DIR
+        - FS_CHMOD_FILE
+        # Other constants
         - COOKIE_DOMAIN
+        - EMPTY_TRASH_DAYS
         - SAVEQUERIES
         - SCRIPT_DEBUG
+        - WP_CLI
     earlyTerminatingFunctionCalls:
         - wp_send_json
         - wp_nonce_ays

From 96deab847d420ae3a35121eb3b027a3e02c1f492 Mon Sep 17 00:00:00 2001
From: Marian <42134098+IanDelMar@users.noreply.github.com>
Date: Mon, 7 Jul 2025 15:31:29 +0200
Subject: [PATCH 2/5] Remove SAVEQUERIES from dynamicConstantNames

---
 extension.neon | 1 -
 1 file changed, 1 deletion(-)

diff --git a/extension.neon b/extension.neon
index fe87b88..7d5f751 100644
--- a/extension.neon
+++ b/extension.neon
@@ -58,7 +58,6 @@ parameters:
         # Other constants
         - COOKIE_DOMAIN
         - EMPTY_TRASH_DAYS
-        - SAVEQUERIES
         - SCRIPT_DEBUG
         - WP_CLI
     earlyTerminatingFunctionCalls:

From c7aec98f2b94c82e9f159b088b0e379ea612ba6c Mon Sep 17 00:00:00 2001
From: Marian <42134098+IanDelMar@users.noreply.github.com>
Date: Mon, 7 Jul 2025 20:31:15 +0200
Subject: [PATCH 3/5] Revert "Remove SAVEQUERIES from dynamicConstantNames"

This reverts commit 96deab847d420ae3a35121eb3b027a3e02c1f492. It is handled separately in #287.
---
 extension.neon | 1 +
 1 file changed, 1 insertion(+)

diff --git a/extension.neon b/extension.neon
index 7d5f751..fe87b88 100644
--- a/extension.neon
+++ b/extension.neon
@@ -58,6 +58,7 @@ parameters:
         # Other constants
         - COOKIE_DOMAIN
         - EMPTY_TRASH_DAYS
+        - SAVEQUERIES
         - SCRIPT_DEBUG
         - WP_CLI
     earlyTerminatingFunctionCalls:

From 0d3fcf98506bfdda358137646928af4bebc2593a Mon Sep 17 00:00:00 2001
From: Marian <42134098+IanDelMar@users.noreply.github.com>
Date: Mon, 7 Jul 2025 21:51:58 +0200
Subject: [PATCH 4/5] Readd WP_DEBUG_LOG to bootstrap.php

---
 bootstrap.php | 1 +
 1 file changed, 1 insertion(+)

diff --git a/bootstrap.php b/bootstrap.php
index aedb7a3..8970f8f 100644
--- a/bootstrap.php
+++ b/bootstrap.php
@@ -10,6 +10,7 @@
 define('WP_PLUGIN_DIR', sprintf('%s/plugins', WP_CONTENT_DIR));
 define('WPMU_PLUGIN_DIR', sprintf('%s/mu-plugins', WP_CONTENT_DIR));
 define('WP_DEBUG', true);
+define('WP_DEBUG_LOG', true);
 define('WP_DEBUG_DISPLAY', false);
 define('EMPTY_TRASH_DAYS', 30);
 define('SCRIPT_DEBUG', false);

From dbbd2064bd3741ad617efd5b9da364882cd01344 Mon Sep 17 00:00:00 2001
From: Marian <42134098+IanDelMar@users.noreply.github.com>
Date: Tue, 8 Jul 2025 03:07:20 +0200
Subject: [PATCH 5/5] Add tests for dynamic constants

---
 phpcs.xml.dist                           |   2 +
 phpstan.neon.dist                        |   1 +
 tests/DynamicConstantTypeTest.php        |  30 ++++++
 tests/data/dynamic-constants.php         | 128 +++++++++++++++++++++++
 tests/phpstan-data/dynamic-constants.php | 112 ++++++++++++++++++++
 5 files changed, 273 insertions(+)
 create mode 100644 tests/DynamicConstantTypeTest.php
 create mode 100644 tests/data/dynamic-constants.php
 create mode 100644 tests/phpstan-data/dynamic-constants.php

diff --git a/phpcs.xml.dist b/phpcs.xml.dist
index 3eef46a..4c951c7 100644
--- a/phpcs.xml.dist
+++ b/phpcs.xml.dist
@@ -5,6 +5,7 @@
     <file>tests/</file>
 
     <exclude-pattern>tests/data/*</exclude-pattern>
+    <exclude-pattern>tests/phpstan-data/*</exclude-pattern>
     <exclude-pattern>tests/functions.php</exclude-pattern>
     <exclude-pattern>tests/WP_UnitTestCase_Base.php</exclude-pattern>
 
@@ -19,6 +20,7 @@
     <rule ref="NeutronStandard.Functions.TypeHint.UnusedReturnType">
         <exclude-pattern>tests/AssertMethodTypeSpecifyingExtensionTest.php</exclude-pattern>
         <exclude-pattern>tests/DynamicReturnTypeExtensionTest.php</exclude-pattern>
+        <exclude-pattern>tests/DynamicConstantTypeTest.php</exclude-pattern>
     </rule>
 
     <!-- Allow string concatenation in tests -->
diff --git a/phpstan.neon.dist b/phpstan.neon.dist
index fd23039..ef3b54b 100644
--- a/phpstan.neon.dist
+++ b/phpstan.neon.dist
@@ -1,6 +1,7 @@
 includes:
     - vendor/phpstan/phpstan/conf/bleedingEdge.neon
     - vendor/phpstan/phpstan-strict-rules/rules.neon
+    - vendor/szepeviktor/phpstan-wordpress/extension.neon
 parameters:
     level: 9
     scanFiles:
diff --git a/tests/DynamicConstantTypeTest.php b/tests/DynamicConstantTypeTest.php
new file mode 100644
index 0000000..b42e57e
--- /dev/null
+++ b/tests/DynamicConstantTypeTest.php
@@ -0,0 +1,30 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SzepeViktor\PHPStan\WordPress\Tests;
+
+class DynamicConstantTypeTest extends \PHPStan\Testing\TypeInferenceTestCase
+{
+    /**
+     * @return iterable<mixed>
+     */
+    public function dataFileAsserts(): iterable
+    {
+        yield from self::gatherAssertTypes(__DIR__ . '/data/dynamic-constants.php');
+    }
+
+    /**
+     * @dataProvider dataFileAsserts
+     * @param array<string> ...$args
+     */
+    public function testFileAsserts(string $assertType, string $file, ...$args): void
+    {
+        $this->assertFileAsserts($assertType, $file, ...$args);
+    }
+
+    public static function getAdditionalConfigFiles(): array
+    {
+        return [dirname(__DIR__) . '/vendor/szepeviktor/phpstan-wordpress/extension.neon'];
+    }
+}
diff --git a/tests/data/dynamic-constants.php b/tests/data/dynamic-constants.php
new file mode 100644
index 0000000..70bb2aa
--- /dev/null
+++ b/tests/data/dynamic-constants.php
@@ -0,0 +1,128 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SzepeViktor\PHPStan\WordPress\Tests;
+
+use const ABSPATH;
+use const WP_CONTENT_DIR;
+use const WP_LANG_DIR;
+use const WPMU_PLUGIN_DIR;
+use const WP_PLUGIN_DIR;
+use const WP_DEBUG;
+use const WP_DEBUG_DISPLAY;
+use const EMPTY_TRASH_DAYS;
+use const SCRIPT_DEBUG;
+use const COOKIE_DOMAIN;
+use const WP_DEFAULT_THEME;
+use const MINUTE_IN_SECONDS;
+use const HOUR_IN_SECONDS;
+use const DAY_IN_SECONDS;
+use const WEEK_IN_SECONDS;
+use const MONTH_IN_SECONDS;
+use const YEAR_IN_SECONDS;
+use const KB_IN_BYTES;
+use const MB_IN_BYTES;
+use const GB_IN_BYTES;
+use const TB_IN_BYTES;
+use const PB_IN_BYTES;
+use const EB_IN_BYTES;
+use const OBJECT;
+use const OBJECT_K;
+use const ARRAY_A;
+use const ARRAY_N;
+use const EP_NONE;
+use const EP_PERMALINK;
+use const EP_ATTACHMENT;
+use const EP_DATE;
+use const EP_YEAR;
+use const EP_MONTH;
+use const EP_DAY;
+use const EP_ROOT;
+use const EP_COMMENTS;
+use const EP_SEARCH;
+use const EP_CATEGORIES;
+use const EP_TAGS;
+use const EP_AUTHORS;
+use const EP_PAGES;
+use const EP_ALL_ARCHIVES;
+use const EP_ALL;
+use const FS_CONNECT_TIMEOUT;
+use const FS_TIMEOUT;
+use const FS_CHMOD_DIR;
+use const FS_CHMOD_FILE;
+
+use function PHPStan\Testing\assertType;
+
+/*
+ * Unconditional constants resolve to constant values and are
+ * - defined in bootstrap.php
+ * - NOT part of the dynamicConstantNames list in extension.neon.
+ */
+
+assertType('60', MINUTE_IN_SECONDS);
+assertType('3600', HOUR_IN_SECONDS);
+assertType('86400', DAY_IN_SECONDS);
+assertType('604800', WEEK_IN_SECONDS);
+assertType('2592000', MONTH_IN_SECONDS);
+assertType('31536000', YEAR_IN_SECONDS);
+
+assertType('1024', KB_IN_BYTES);
+assertType('1048576', MB_IN_BYTES);
+assertType('1073741824', GB_IN_BYTES);
+
+if (PHP_INT_SIZE === 8) {
+    // 64bit
+    assertType('1099511627776', TB_IN_BYTES);
+    assertType('1125899906842624', PB_IN_BYTES);
+    assertType('1152921504606846976', EB_IN_BYTES);
+    // ZB_IN_BYTES and YB_IN_BYTES will be converted to floats.
+}
+
+assertType("'OBJECT'", OBJECT);
+assertType("'OBJECT_K'", OBJECT_K);
+assertType("'ARRAY_A'", ARRAY_A);
+assertType("'ARRAY_N'", ARRAY_N);
+
+assertType('0', EP_NONE);
+assertType('1', EP_PERMALINK);
+assertType('2', EP_ATTACHMENT);
+assertType('4', EP_DATE);
+assertType('8', EP_YEAR);
+assertType('16', EP_MONTH);
+assertType('32', EP_DAY);
+assertType('64', EP_ROOT);
+assertType('128', EP_COMMENTS);
+assertType('256', EP_SEARCH);
+assertType('512', EP_CATEGORIES);
+assertType('1024', EP_TAGS);
+assertType('2048', EP_AUTHORS);
+assertType('4096', EP_PAGES);
+assertType('3644', EP_ALL_ARCHIVES);
+assertType('8191', EP_ALL);
+
+/*
+ * Conditional constants resolve to non constant types and are
+ * - defined in bootstrap.php
+ * - part of the dynamicConstantNames list in extension.neon.
+ */
+
+assertType('bool', WP_DEBUG);
+// assertType('bool|string', WP_DEBUG_LOG); // PHPStan does not yet support more than one type for constants
+assertType('bool', WP_DEBUG_DISPLAY);
+
+assertType('string', ABSPATH);
+assertType('string', WP_CONTENT_DIR);
+assertType('string', WP_PLUGIN_DIR);
+assertType('string', WPMU_PLUGIN_DIR);
+assertType('string', WP_LANG_DIR);
+
+assertType('int', FS_CONNECT_TIMEOUT);
+assertType('int', FS_TIMEOUT);
+assertType('int', FS_CHMOD_DIR);
+assertType('int', FS_CHMOD_FILE);
+
+assertType('string', COOKIE_DOMAIN);
+assertType('int', EMPTY_TRASH_DAYS);
+assertType('bool', SCRIPT_DEBUG);
+assertType('string', WP_DEFAULT_THEME);
diff --git a/tests/phpstan-data/dynamic-constants.php b/tests/phpstan-data/dynamic-constants.php
new file mode 100644
index 0000000..e44e694
--- /dev/null
+++ b/tests/phpstan-data/dynamic-constants.php
@@ -0,0 +1,112 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SzepeViktor\PHPStan\WordPress\Tests;
+
+// These should not be reported as errors by PHPStan's ConstantRule
+use const ABSPATH;
+use const WP_CONTENT_DIR;
+use const WP_LANG_DIR;
+use const WPMU_PLUGIN_DIR;
+use const WP_PLUGIN_DIR;
+use const WP_DEBUG;
+use const WP_DEBUG_LOG;
+use const WP_DEBUG_DISPLAY;
+use const EMPTY_TRASH_DAYS;
+use const SCRIPT_DEBUG;
+use const COOKIE_DOMAIN;
+use const WP_DEFAULT_THEME;
+use const MINUTE_IN_SECONDS;
+use const HOUR_IN_SECONDS;
+use const DAY_IN_SECONDS;
+use const WEEK_IN_SECONDS;
+use const MONTH_IN_SECONDS;
+use const YEAR_IN_SECONDS;
+use const KB_IN_BYTES;
+use const MB_IN_BYTES;
+use const GB_IN_BYTES;
+use const TB_IN_BYTES;
+use const PB_IN_BYTES;
+use const EB_IN_BYTES;
+use const OBJECT;
+use const OBJECT_K;
+use const ARRAY_A;
+use const ARRAY_N;
+use const EP_NONE;
+use const EP_PERMALINK;
+use const EP_ATTACHMENT;
+use const EP_DATE;
+use const EP_YEAR;
+use const EP_MONTH;
+use const EP_DAY;
+use const EP_ROOT;
+use const EP_COMMENTS;
+use const EP_SEARCH;
+use const EP_CATEGORIES;
+use const EP_TAGS;
+use const EP_AUTHORS;
+use const EP_PAGES;
+use const EP_ALL_ARCHIVES;
+use const EP_ALL;
+use const FS_CONNECT_TIMEOUT;
+use const FS_TIMEOUT;
+use const FS_CHMOD_DIR;
+use const FS_CHMOD_FILE;
+
+// These should not be reported as errors by PHPStan's ConstantRule and RequireFileExistsRule
+require_once ABSPATH . 'file.php';
+require_once WP_PLUGIN_DIR . '/file.php';
+require_once WP_CONTENT_DIR . '/file.php';
+require_once WP_LANG_DIR . '/file.php';
+require_once WPMU_PLUGIN_DIR . '/file.php';
+
+// These should not be reported as errors by PHPStan's ConstantRule
+$testVariable = ABSPATH;
+$testVariable = WP_CONTENT_DIR;
+$testVariable = WP_LANG_DIR;
+$testVariable = WPMU_PLUGIN_DIR;
+$testVariable = WP_PLUGIN_DIR;
+$testVariable = WP_DEBUG_LOG;
+$testVariable = WP_DEBUG;
+$testVariable = WP_DEBUG_DISPLAY;
+$testVariable = WP_DEFAULT_THEME;
+$testVariable = EMPTY_TRASH_DAYS;
+$testVariable = SCRIPT_DEBUG;
+$testVariable = COOKIE_DOMAIN;
+$testVariable = MINUTE_IN_SECONDS;
+$testVariable = HOUR_IN_SECONDS;
+$testVariable = DAY_IN_SECONDS;
+$testVariable = WEEK_IN_SECONDS;
+$testVariable = MONTH_IN_SECONDS;
+$testVariable = YEAR_IN_SECONDS;
+$testVariable = KB_IN_BYTES;
+$testVariable = MB_IN_BYTES;
+$testVariable = GB_IN_BYTES;
+$testVariable = TB_IN_BYTES;
+$testVariable = PB_IN_BYTES;
+$testVariable = EB_IN_BYTES;
+$testVariable = OBJECT;
+$testVariable = OBJECT_K;
+$testVariable = ARRAY_A;
+$testVariable = ARRAY_N;
+$testVariable = EP_NONE;
+$testVariable = EP_PERMALINK;
+$testVariable = EP_ATTACHMENT;
+$testVariable = EP_DATE;
+$testVariable = EP_YEAR;
+$testVariable = EP_MONTH;
+$testVariable = EP_DAY;
+$testVariable = EP_ROOT;
+$testVariable = EP_COMMENTS;
+$testVariable = EP_SEARCH;
+$testVariable = EP_CATEGORIES;
+$testVariable = EP_TAGS;
+$testVariable = EP_AUTHORS;
+$testVariable = EP_PAGES;
+$testVariable = EP_ALL_ARCHIVES;
+$testVariable = EP_ALL;
+$testVariable = FS_CONNECT_TIMEOUT;
+$testVariable = FS_TIMEOUT;
+$testVariable = FS_CHMOD_DIR;
+$testVariable = FS_CHMOD_FILE;