Merge remote-tracking branch 'upstream/develop' into 4.8

# Conflicts:
#	user_guide_src/source/changelogs/index.rst

Author: michalsn

.ai/forum-announcement-instructions.md

@@ -0,0 +1,200 @@
+# Forum Announcement Instructions
+
+## Purpose
+These instructions guide the creation of forum announcements for new CodeIgniter4 releases using myBB formatting.
+
+## Process Overview
+
+### 1. Gather Information
+Read the following source files:
+- **CHANGELOG.md** - Main changelog with GitHub PR links
+- **user_guide_src/source/changelogs/v{VERSION}.rst** - Detailed RST changelog with comprehensive explanations
+
+### 2. Version Strategy
+For dual releases (e.g., maintenance + major):
+- **List the maintenance version first** (e.g., v4.6.5 before v4.7.0)
+- Clearly explain which version users should choose based on their PHP version
+- Provide separate links for each version
+
+### 3. Announcement Structure
+
+Use this **example** structure with myBB formatting:
+
+```
+[size=x-large][b]CodeIgniter {VERSION} & {VERSION} Released![/b][/size]
+
+Introduction paragraph(s) - mention maintenance release first, then major release
+
+Links to GitHub releases and changelogs
+
+[hr]
+
+[size=large][b]Which Version Should I Use?[/b][/size]
+- Guidance for users on which version to choose
+
+[hr]
+
+[size=large][b]What's in CodeIgniter {MAINTENANCE_VERSION}?[/b][/size]
+- Bug fixes section (if maintenance release)
+
+[hr]
+
+[size=large][b]Highlights & New Features ({MAJOR_VERSION})[/b][/size]
+- Top features
+
+[hr]
+
+[size=large][b]Notable Enhancements[/b][/size]
+- Bulleted list of improvements
+
+[hr]
+
+[size=large][b]Cache Improvements[/b][/size]
+- Cache-specific updates
+
+[hr]
+
+[size=large][b]Database & Model Updates[/b][/size]
+- Database-related changes
+
+[hr]
+
+[size=large][b]HTTP & Request Features[/b][/size]
+- HTTP/Request improvements
+
+[hr]
+
+[size=large][b]Security & Quality[/b][/size]
+- Security updates
+
+[hr]
+
+[size=large][b]Breaking Changes[/b][/size]
+- Detailed breaking changes with explanations
+- Include "Removed Deprecated Items" subsection
+
+[hr]
+
+[size=large][b]Other Notable Changes[/b][/size]
+- Other miscellaneous updates
+
+[hr]
+
+[size=large][b]Thanks to Our Contributors[/b][/size]
+- Acknowledge contributors
+
+[hr]
+
+Upgrade guide links
+Issue reporting link
+Closing message
+
+[hr]
+
+AI disclosure note
+```
+
+### 4. myBB Formatting Codes
+
+Use these myBB codes:
+- `[b]text[/b]` - Bold
+- `[i]text[/i]` - Italic
+- `[size=x-large]text[/size]` - Extra large text
+- `[size=large]text[/size]` - Large text
+- `[size=small]text[/size]` - Small text
+- `[url=URL]text[/url]` - Links
+- `[list]` - Unordered list
+- `[list=1]` - Ordered list
+- `[*]` - List item
+- `[hr]` - Horizontal rule
+- `` `code` `` - Inline code (use double backticks)
+
+### 4a. Emoticon Escaping
+
+myBB automatically converts emoticon patterns like `:s` (colon immediately followed by "s") into emoji. To prevent this in code blocks:
+
+**Replace all colons with HTML entity `:`**
+
+Examples:
+- `Entity::setAttributes()` → `Entity::setAttributes()`
+- `H:i:s` (time format) → `H:i:s`
+
+This prevents emoticon conversion while displaying properly as a colon character.
+
+### 5. Content Guidelines
+
+**Highlights Section:**
+- Emphasize PHP version requirements
+- Mark experimental features as [i]Experimental[/i]
+- List 3-5 most impactful features
+
+**Enhancements:**
+- Include specific config options and method names
+- Use `` `code` `` for class names, methods, and config values
+- Be specific about which handlers support which features
+
+**Breaking Changes:**
+- Provide detailed explanations, not just bullet points
+- Include the old behavior vs. new behavior
+- Mention exception type changes
+- List removed deprecated items separately
+- Reference specific methods and properties
+
+**Bug Fixes (for maintenance releases):**
+- Use ordered lists `[list=1]`
+- Provide clear before/after descriptions
+
+### 6. Key Points
+
+1. **Tone:** Professional yet friendly, engaging for community (no emojis - they don't render properly in myBB)
+2. **Accuracy:** Always cross-reference RST changelog for technical details
+3. **Clarity:** Explain breaking changes thoroughly
+4. **Contents:** Adjust sections based on the release content (e.g., skip "Cache Improvements" if no cache changes)
+5. **Brevity:** For single releases, omit the "Which Version Should I Use?" section
+6. **Links:** Include GitHub release links, changelogs, and upgrade guides
+7. **Attribution:** Thank contributors by username
+8. **Disclosure:** Add AI assistance disclosure at the end
+
+### 7. Version Priority
+
+For dual releases:
+- Mention maintenance version (e.g., 4.6.5) **before** major version (e.g., 4.7.0)
+- In "Which Version Should I Use?" section, list lower PHP version option first
+
+### 8. Final Disclosure
+
+Always include at the end:
+
+```
+[hr]
+
+[size=small][i]Note: This announcement was created with the assistance of GitHub Copilot (Claude Sonnet 4.5).[/i][/size]
+```
+
+Update the agent name as necessary.
+
+## Output File
+
+Save the announcement as: `v{VERSION}-announcement.txt` in the repository root
+
+## Example Workflow
+
+```bash
+# 1. Read changelogs
+Read: CHANGELOG.md
+Read: user_guide_src/source/changelogs/v4.7.0.rst
+Read: user_guide_src/source/changelogs/v4.6.5.rst (if maintenance release)
+
+# 2. Create announcement
+Create: v4.7.0-announcement.txt
+
+# 3. Structure content
+- Introduction with both versions
+- Version selection guidance
+- Maintenance release details first
+- Major release details
+- Breaking changes (comprehensive)
+- Contributors
+- Upgrade links
+- AI disclosure
+```

.gitattributes

@@ -8,6 +8,7 @@
 .gitignore     export-ignore
 
 # admin files
+.ai/               export-ignore
 .github/           export-ignore
 admin/             export-ignore
 contributing/      export-ignore

.gitignore

@@ -44,45 +44,45 @@ $RECYCLE.BIN/
 .env
 .vagrant
 Vagrantfile
-user_guide_src/venv/
+/user_guide_src/venv/
 .python-version
-user_guide_src/.python-version
+/user_guide_src/.python-version
 
 #-------------------------
 # Temporary Files
 #-------------------------
-writable/cache/*
-!writable/cache/index.html
+/writable/cache/*
+!/writable/cache/index.html
 
-writable/logs/*
-!writable/logs/index.html
+/writable/logs/*
+!/writable/logs/index.html
 
-writable/session/*
-!writable/session/index.html
+/writable/session/*
+!/writable/session/index.html
 
-writable/uploads/*
-!writable/uploads/index.html
+/writable/uploads/*
+!/writable/uploads/index.html
 
-writable/debugbar/*
-!writable/debugbar/index.html
+/writable/debugbar/*
+!/writable/debugbar/index.html
 
-writable/**/*.db
-writable/**/*.sqlite
+/writable/**/*.db
+/writable/**/*.sqlite
 
 php_errors.log
 
 #-------------------------
 # User Guide Temp Files
 #-------------------------
-user_guide_src/build/*
+/user_guide_src/build/*
 
 #-------------------------
 # Test Files
 #-------------------------
-tests/coverage*
+/tests/coverage*
 
 # Don't save phpunit under version control.
-phpunit
+/phpunit
 
 #-------------------------
 # Composer
@@ -105,14 +105,14 @@ _modules/*
 *.iml
 
 # Netbeans
-nbproject/
-build/
-nbbuild/
-dist/
-nbdist/
-nbactions.xml
-nb-configuration.xml
-.nb-gradle/
+/nbproject/
+/build/
+/nbbuild/
+/dist/
+/nbdist/
+/nbactions.xml
+/nb-configuration.xml
+/.nb-gradle/
 
 # Sublime Text
 *.tmlanguage.cache

.php-cs-fixer.tests.php

@@ -30,6 +30,7 @@
     ]);
 
 $overrides = [
+    'declare_strict_types'  => true,
     'phpdoc_to_return_type' => true,
     'void_return'           => true,
 ];

CHANGELOG.md

@@ -87,10 +87,10 @@
 * refactor: cleanup `ContentSecurityPolicy` by @paulbalandan in https://github.com/codeigniter4/CodeIgniter4/pull/9904
 * refactor: deprecate `CodeIgniter\HTTP\ContentSecurityPolicy::$nonces` since never used by @paulbalandan in https://github.com/codeigniter4/CodeIgniter4/pull/9905
 
-For the changelog of v4.6, see [CHANGELOG_4.6.md](./changelogs/CHANGELOG_4.6.md).
-For the changelog of v4.5, see [CHANGELOG_4.5.md](./changelogs/CHANGELOG_4.5.md).
-For the changelog of v4.4, see [CHANGELOG_4.5.md](./changelogs/CHANGELOG_4.4.md).
-For the changelog of v4.3, see [CHANGELOG_4.5.md](./changelogs/CHANGELOG_4.3.md).
-For the changelog of v4.2, see [CHANGELOG_4.5.md](./changelogs/CHANGELOG_4.2.md).
-For the changelog of v4.1, see [CHANGELOG_4.5.md](./changelogs/CHANGELOG_4.1.md).
-For the changelog of v4.0, see [CHANGELOG_4.5.md](./changelogs/CHANGELOG_4.0.md).
+For the changelog of v4.6, see [CHANGELOG_4.6.md](./changelogs/CHANGELOG_4.6.md).<br/>
+For the changelog of v4.5, see [CHANGELOG_4.5.md](./changelogs/CHANGELOG_4.5.md).<br/>
+For the changelog of v4.4, see [CHANGELOG_4.4.md](./changelogs/CHANGELOG_4.4.md).<br/>
+For the changelog of v4.3, see [CHANGELOG_4.3.md](./changelogs/CHANGELOG_4.3.md).<br/>
+For the changelog of v4.2, see [CHANGELOG_4.2.md](./changelogs/CHANGELOG_4.2.md).<br/>
+For the changelog of v4.1, see [CHANGELOG_4.1.md](./changelogs/CHANGELOG_4.1.md).<br/>
+For the changelog of v4.0, see [CHANGELOG_4.0.md](./changelogs/CHANGELOG_4.0.md).

admin/RELEASE.md

@@ -124,6 +124,10 @@ the existing content.
       * Set the date to format `Release Date: January 31, 2021`
     * Update **phpdoc.dist.xml** with the new `<title>CodeIgniter v4.x API</title>`
       and `<version number="4.x.x">`
+    * Update **admin/starter/builds**:
+      * Set `define('LATEST_RELEASE', '^4.x')`
+      * Set `define('NEXT_MINOR', '4.y-dev')`.
+      * If the major version changes, you need to manually change to `define('NEXT_MINOR', '5.0-dev')`.
     * Commit the changes with `Prep for 4.x.x release`
 * [ ] Create a new PR from `release-4.x.x` to `develop`:
   * Title: `Prep for 4.x.x release`