docs: atualizar documentação para refletir a sintaxe de roteamento suportada e corrigir exemplos de uso

Author: CAFernandes

README.md

@@ -110,6 +110,53 @@ $app->get('/posts/:year<\d{4}>/:month<\d{2}>/:slug<slug>', function($req, $res)
 $app->run();
 ```
 
+### 🛣️ Sintaxes de Roteamento Suportadas
+
+O PivotPHP suporta múltiplas sintaxes para definir handlers de rota:
+
+```php
+// ✅ Closure/Função Anônima (Recomendado)
+$app->get('/users', function($req, $res) {
+    return $res->json(['users' => []]);
+});
+
+// ✅ Array Callable com classe
+$app->get('/users', [UserController::class, 'index']);
+
+// ✅ Função nomeada
+function getUsersHandler($req, $res) {
+    return $res->json(['users' => []]);
+}
+$app->get('/users', 'getUsersHandler');
+
+// ❌ NÃO suportado - String no formato Controller@method
+// $app->get('/users', 'UserController@index'); // ERRO!
+```
+
+**Exemplo com Controller:**
+
+```php
+<?php
+
+class UserController 
+{
+    public function index($req, $res) 
+    {
+        return $res->json(['users' => User::all()]);
+    }
+    
+    public function show($req, $res) 
+    {
+        $id = $req->param('id');
+        return $res->json(['user' => User::find($id)]);
+    }
+}
+
+// Registrar rotas com array callable
+$app->get('/users', [UserController::class, 'index']);
+$app->get('/users/:id', [UserController::class, 'show']);
+```
+
 ### 🔄 Suporte PSR-7 Híbrido
 
 O PivotPHP oferece **compatibilidade híbrida** com PSR-7, mantendo a facilidade da API Express.js enquanto implementa completamente as interfaces PSR-7:

docs/releases/FRAMEWORK_OVERVIEW_v1.0.0.md

@@ -103,19 +103,19 @@ $app->run();
 
 ```php
 // Basic routing
-$app->get('/users', 'UserController@index');
-$app->post('/users', 'UserController@create');
-$app->put('/users/{id}', 'UserController@update');
-$app->delete('/users/{id}', 'UserController@delete');
+$app->get('/users', [UserController::class, 'index']);
+$app->post('/users', [UserController::class, 'create']);
+$app->put('/users/{id}', [UserController::class, 'update']);
+$app->delete('/users/{id}', [UserController::class, 'delete']);
 
 // Route groups
 $app->group('/api/v1', function ($group) {
-    $group->get('/users', 'UserController@index');
-    $group->post('/users', 'UserController@create');
+    $group->get('/users', [UserController::class, 'index']);
+    $group->post('/users', [UserController::class, 'create']);
 });
 
 // Middleware on routes
-$app->get('/admin', 'AdminController@dashboard')
+$app->get('/admin', [AdminController::class, 'dashboard'])
     ->middleware(AuthMiddleware::class);
 ```
 
@@ -127,7 +127,7 @@ $app->use(new CorsMiddleware());
 $app->use(new SecurityHeadersMiddleware());
 
 // Route-specific middleware
-$app->post('/login', 'AuthController@login')
+$app->post('/login', [AuthController::class, 'login'])
     ->middleware(CsrfMiddleware::class);
 
 // Custom middleware

docs/releases/FRAMEWORK_OVERVIEW_v1.0.1.md

@@ -177,19 +177,19 @@ $app->get('/posts/:category<alpha>/:slug<slug>', handler);
 
 ```php
 // Basic routing
-$app->get('/users', 'UserController@index');
-$app->post('/users', 'UserController@create');
-$app->put('/users/:id', 'UserController@update');
-$app->delete('/users/:id', 'UserController@delete');
+$app->get('/users', [UserController::class, 'index']);
+$app->post('/users', [UserController::class, 'create']);
+$app->put('/users/:id', [UserController::class, 'update']);
+$app->delete('/users/:id', [UserController::class, 'delete']);
 
 // Route groups
 $app->group('/api/v1', function ($group) {
-    $group->get('/users', 'UserController@index');
-    $group->post('/users', 'UserController@create');
+    $group->get('/users', [UserController::class, 'index']);
+    $group->post('/users', [UserController::class, 'create']);
 });
 
 // Middleware on routes
-$app->get('/admin', 'AdminController@dashboard')
+$app->get('/admin', [AdminController::class, 'dashboard'])
     ->middleware(AuthMiddleware::class);
 ```
 
@@ -201,7 +201,7 @@ $app->use(new CorsMiddleware());
 $app->use(new SecurityHeadersMiddleware());
 
 // Route-specific middleware
-$app->post('/login', 'AuthController@login')
+$app->post('/login', [AuthController::class, 'login'])
     ->middleware(CsrfMiddleware::class);
 
 // Custom middleware

docs/technical/authentication/usage_native.md

@@ -427,7 +427,7 @@ $app->group('/admin', function() use ($app) {
         'requiredRole' => 'admin'
     ]));
 
-    $app->get('/users', 'AdminController@getUsers');
+    $app->get('/users', [AdminController::class, 'getUsers']);
 });
 
 // API Key para integrações externas
@@ -437,7 +437,7 @@ $app->group('/api/v1', function() use ($app) {
         'apiKeyCallback' => 'validateApiKey'
     ]));
 
-    $app->get('/data', 'ApiController@getData');
+    $app->get('/data', [ApiController::class, 'getData']);
 });
 
 // Multi-método para rotas gerais
@@ -448,7 +448,7 @@ $app->group('/api', function() use ($app) {
         'bearerAuthCallback' => 'validateBearerToken'
     ]));
 
-    $app->get('/profile', 'UserController@getProfile');
+    $app->get('/profile', [UserController::class, 'getProfile']);
 });
 ```
 

docs/technical/extesions/README.md

@@ -144,7 +144,7 @@ class MyExtensionProvider extends ServiceProvider
     {
         // Registrar rotas da extensão
         $this->app->group('/extension', function() {
-            $this->app->get('/status', 'MyExtension\\StatusController@index');
+            $this->app->get('/status', [MyExtension\StatusController::class, 'index']);
         });
     }
 
@@ -262,9 +262,9 @@ class PaymentExtensionProvider extends ServiceProvider
     {
         $this->app->group('/payments', function() {
             // Rotas de API de pagamento
-            $this->app->post('/process', 'PaymentController@process');
-            $this->app->post('/webhook', 'PaymentController@webhook');
-            $this->app->get('/status/{id}', 'PaymentController@status');
+            $this->app->post('/process', [PaymentController::class, 'process']);
+            $this->app->post('/webhook', [PaymentController::class, 'webhook']);
+            $this->app->get('/status/{id}', [PaymentController::class, 'status']);
         });
     }
 

docs/technical/middleware/README.md

@@ -336,7 +336,7 @@ $app->group('/api/v1', function() use ($app) {
         $app->use(new RateLimitMiddleware(['maxRequests' => 100]));
         $app->use(new AuditMiddleware()); // Log de auditoria
 
-        $app->get('/users', 'AdminController@getUsers');
+        $app->get('/users', [AdminController::class, 'getUsers']);
     });
 });
 ```