1.0.7

PHP Route v1.0.7 Release

Release Date: December 6, 2024

🎉 What's New

Major Features

1️⃣ Multiple Middleware Format Support

Three ways to define middleware - choose what works best for you:

// Closure
Route::get('/path', $handler, [
    function($req, $res) { return true; }
]);
// Static class

Route::get('/path', $handler, ['AuthMiddleware@check']);
// Instance

Route::get('/path', $handler, [new RateLimitMiddleware(100), 'check']);

2️⃣ Middleware Attribute Persistence

Middleware can now set attributes that are accessible in route handlers:

// Middleware sets attribute
$req->withAttribute('user_id', 123);
// Handler accesses it

$userId = $req->getAttribute('user_id'); // 123

3️⃣ Fixed Optional Route Parameters

Optional parameters {?paramName} now work correctly:

Route::get('/post/{?slug}', function($req, $res) {
    $slug = $req->getAttribute('slug') ?? 'default';
    $res->json(['slug' => $slug]);
});
// All these work now:

// GET /post          → slug = null

// GET /post/hello    → slug = "hello"

// GET /post/2        → slug = "2"  ✅ FIXED!

4️⃣ Middleware Control Flow

Middleware now supports proper return value control:

function($req, $res) {
    if (!$req->getHeaderLine('Authorization')) {
        $res->json(['error' => 'Unauthorized'], 401);
        return false;  // Stop request
    }
    return true;  // Continue
}

---

🔧 Technical Improvements

Request Class

• Direct attribute modification (no more cloning)
• Custom attribute storage for faster access
• Merged attribute access from all sources

Route Class

• Improved regex generation for optional parameters
• Better middleware execution pipeline
• Proper attribute persistence across chain
• Query string removal in URI normalization

---

📊 Regex Pattern Examples

Optional parameters now generate correct regex:

{?slug}              → #^/post(?:/(?P<slug>[^/]+))?/?$#
{?page:\d+}          → #^/page(?:/(?P<page>\d+))?/?$#
{id}/posts/{?tag}    → #^/user/(?P<id>[^/]+)/posts(?:/(?P<tag>[^/]+))?/?$#

---

✨ Example: Complete Feature Showcase

<?php
class AuthMiddleware {
    public static function check(Request $req, Response $res) {
        $token = $req->getHeaderLine('Authorization');
        if (empty($token)) {
            $res->json(['error' => 'Unauthorized'], 401);
            return false;
        }
    // Set user attributes
    $req-&gt;withAttribute('user_id', 123);
    $req-&gt;withAttribute('user_role', 'admin');
    return true;
}

}
// Route with optional parameter and middleware

Route::get('/user/{?filter}', function($req, $res) {

$userId = $req->getAttribute('user_id');    // From middleware

$filter = $req->getAttribute('filter');     // From URL
$res-&gt;json([
    'user_id' =&gt; $userId,
    'filter' =&gt; $filter ?? 'none'
]);

}, ['AuthMiddleware@check']);
// URLs that now work:

// GET /user              → user_id=123, filter=null ✅

// GET /user/active       → user_id=123, filter="active" ✅

---

✅ What's Fixed

Issue	Before	After
Optional params	❌ 404 error	✅ Works correctly
Middleware attributes	❌ Lost between middleware	✅ Persist to handler
Middleware formats	❌ Closures only	✅ 3 format types
Middleware control	⚠️ Limited	✅ Full control (true/false)

---

📈 Backward Compatibility

✅ 100% Backward Compatible

• No breaking changes
• All v1.0.6 code works as-is
• Just add new features where needed

---

📚 Documentation

New guides added:

• Optional parameters complete guide
• Request attributes explanation
• Middleware attribute usage examples
• Route regex pattern testing utility
• Troubleshooting section

---

🐛 Bug Fixes

1. Optional parameters returning 404 - FIXED
2. Middleware attributes not persisting - FIXED
3. Query string interference - FIXED
4. Multiple trailing slash handling - FIXED

---

🚀 Installation & Upgrade

Fresh Install

composer require refkinscallv/php-route

Upgrade from v1.0.6

composer update refkinscallv/php-route

No code changes required - just works!

---

📖 Learn More

• Full Documentation
• Optional Parameters Guide
• Middleware Guide
• Request Attributes

---

🤝 Feedback

Found issues? Have suggestions?

• 🐛 Report Bugs
• 💡 Request Features
• ⭐ Star us on GitHub

---

📋 Release Checklist

• ✅ Features implemented and tested
• ✅ Documentation updated
• ✅ Examples provided
• ✅ Backward compatibility verified
• ✅ No breaking changes

---

Thank you for using PHP Route! Happy routing! 🎉

For detailed changelog, see CHANGELOG.md

# PHP Route v1.0.7 Release

Release Date: December 6, 2024

🎉 What's New

Major Features

1️⃣ Multiple Middleware Format Support

Three ways to define middleware - choose what works best for you:

// Closure
Route::get('/path', $handler, [
    function($req, $res) { return true; }
]);

// Static class
Route::get('/path', $handler, ['AuthMiddleware@check']);

// Instance
Route::get('/path', $handler, [new RateLimitMiddleware(100), 'check']);

2️⃣ Middleware Attribute Persistence

Middleware can now set attributes that are accessible in route handlers:

// Middleware sets attribute
$req->withAttribute('user_id', 123);

// Handler accesses it
$userId = $req->getAttribute('user_id'); // 123

3️⃣ Fixed Optional Route Parameters

Optional parameters {?paramName} now work correctly:

Route::get('/post/{?slug}', function($req, $res) {
    $slug = $req->getAttribute('slug') ?? 'default';
    $res->json(['slug' => $slug]);
});

// All these work now:
// GET /post          → slug = null
// GET /post/hello    → slug = "hello"
// GET /post/2        → slug = "2"  ✅ FIXED!

4️⃣ Middleware Control Flow

Middleware now supports proper return value control:

function($req, $res) {
    if (!$req->getHeaderLine('Authorization')) {
        $res->json(['error' => 'Unauthorized'], 401);
        return false;  // Stop request
    }
    return true;  // Continue
}

---

🔧 Technical Improvements

Request Class

• Direct attribute modification (no more cloning)
• Custom attribute storage for faster access
• Merged attribute access from all sources

Route Class

• Improved regex generation for optional parameters
• Better middleware execution pipeline
• Proper attribute persistence across chain
• Query string removal in URI normalization

---

📊 Regex Pattern Examples

Optional parameters now generate correct regex:

{?slug}              → #^/post(?:/(?P<slug>[^/]+))?/?$#
{?page:\d+}          → #^/page(?:/(?P<page>\d+))?/?$#
{id}/posts/{?tag}    → #^/user/(?P<id>[^/]+)/posts(?:/(?P<tag>[^/]+))?/?$#

---

✨ Example: Complete Feature Showcase

<?php
class AuthMiddleware {
    public static function check(Request $req, Response $res) {
        $token = $req->getHeaderLine('Authorization');
        if (empty($token)) {
            $res->json(['error' => 'Unauthorized'], 401);
            return false;
        }
        
        // Set user attributes
        $req->withAttribute('user_id', 123);
        $req->withAttribute('user_role', 'admin');
        return true;
    }
}

// Route with optional parameter and middleware
Route::get('/user/{?filter}', function($req, $res) {
    $userId = $req->getAttribute('user_id');    // From middleware
    $filter = $req->getAttribute('filter');     // From URL
    
    $res->json([
        'user_id' => $userId,
        'filter' => $filter ?? 'none'
    ]);
}, ['AuthMiddleware@check']);

// URLs that now work:
// GET /user              → user_id=123, filter=null ✅
// GET /user/active       → user_id=123, filter="active" ✅

---

✅ What's Fixed

Issue	Before	After
Optional params	❌ 404 error	✅ Works correctly
Middleware attributes	❌ Lost between middleware	✅ Persist to handler
Middleware formats	❌ Closures only	✅ 3 format types
Middleware control	⚠️ Limited	✅ Full control (true/false)

---

📈 Backward Compatibility

✅ 100% Backward Compatible

• No breaking changes
• All v1.0.6 code works as-is
• Just add new features where needed

---

📚 Documentation

New guides added:

• Optional parameters complete guide
• Request attributes explanation
• Middleware attribute usage examples
• Route regex pattern testing utility
• Troubleshooting section

---

🐛 Bug Fixes

1. Optional parameters returning 404 - FIXED
2. Middleware attributes not persisting - FIXED
3. Query string interference - FIXED
4. Multiple trailing slash handling - FIXED

---

🚀 Installation & Upgrade

Fresh Install

composer require refkinscallv/php-route

Upgrade from v1.0.6

composer update refkinscallv/php-route

No code changes required - just works!

---

📖 Learn More

• [Full Documentation](https://github.com/refkinscallv/php-route)
• [Optional Parameters Guide](https://github.com/refkinscallv/php-route#optional-parameters)
• [Middleware Guide](https://github.com/refkinscallv/php-route#middleware-system)
• [Request Attributes](https://github.com/refkinscallv/php-route#request-attributes)

---

🤝 Feedback

Found issues? Have suggestions?

• 🐛 [Report Bugs](https://github.com/refkinscallv/php-route/issues)
• 💡 [Request Features](https://github.com/refkinscallv/php-route/discussions)
• ⭐ [Star us on GitHub](https://github.com/refkinscallv/php-route)

---

📋 Release Checklist

• ✅ Features implemented and tested
• ✅ Documentation updated
• ✅ Examples provided
• ✅ Backward compatibility verified
• ✅ No breaking changes

---

Thank you for using PHP Route! Happy routing! 🎉