Move the JPATH_PLATFORM constant to the compat plugin

[laoneo]

User description

joomla/joomla-cms#44638

---

PR Type

Documentation

---

Description

• Documented the removal of the deprecated JPATH_PLATFORM constant from Joomla core
• Added migration guide explaining how to replace JPATH_PLATFORM with _JEXEC in bootstrap files
• Updated backward compatibility documentation with code examples

---

Changes walkthrough 📝

	Relevant files
Documentation	removed-backward-incompatibility.md Document JPATH_PLATFORM constant deprecation and replacement migrations/54-60/removed-backward-incompatibility.md Added documentation about the removal of JPATH_PLATFORM constant Provided code example showing how to replace JPATH_PLATFORM with _JEXEC in bootstrap files +13/-0

---

💡 PR-Agent usage: Comment /help "your question" on any pull request to receive relevant information

[qodo-merge-pro]

Qodo Merge was enabled for this repository. To continue using it, please link your Git account with your Qodo account here.

PR Reviewer Guide 🔍

Here are some key observations to aid the review process:

⏱️ Estimated effort to review: 1 🔵⚪⚪⚪⚪

🧪 No relevant tests

🔒 No security concerns identified

⚡ Recommended focus areas for review Documentation Accuracy Verify that the migration guide accurately reflects all use cases where JPATH_PLATFORM was previously used and ensure the _JEXEC replacement is a complete solution for all scenarios Typo The word "bootsrapping" contains a typo and should be "bootstrapping"

[qodo-merge-pro]

Qodo Merge was enabled for this repository. To continue using it, please link your Git account with your Qodo account here.

PR Code Suggestions ✨

Explore these optional code suggestions:

Category	Suggestion	Score
Security	✅ Add security context about the importance of entry point validation in PHP files Suggestion Impact: The commit adds the suggested security context by explaining that JPATH_PLATFORM checks should be replaced with _JEXEC checks for security purposes code diff: - Description: The `JPATH_PLATFORM` is an old constant and should not be used if the Joomla core got correctly bootstrapped. Change your checks to `_JEXEC` Add a note explaining that the _JEXEC constant should be checked before any other code execution to prevent direct file access, as this is a critical security practice. migrations/54-60/removed-backward-incompatibility.md [77-78] // New: +// Check for direct file access - must be at the beginning of the file \defined('_JEXEC') or die; Apply this suggestion Suggestion importance[1-10]: 8 Why: The suggestion adds crucial security context about the purpose of the _JEXEC check, which is essential for preventing direct file access attacks. This is particularly important in a migration guide where developers need to understand security implications.	8