Bideratzea

Osumi Framework-en bideratzea ORoute klaseak kudeatzen du. Sarrerako HTTP eskaerak (URLak) ekintza gisa jokatzen duten osagai espezifikoetara mapatzen ditu.

Ibilbideak normalean src/Routes/ direktorioan dauden PHP fitxategietan definitzen dira. Karpeta honetan hainbat fitxategi sor ditzakezu zure ibilbideak logikoki antolatzeko (adibidez, fitxategi bat modulu bakoitzeko).

Erabiltzaile batek URL batera sartzen denean, ORoute-k bidea aurkitzen du, iragazkiak exekutatzen ditu, gero osagaia instantziatzen du eta run() deitzen du, erabiltzaileak definitutako DTO bat edo ORequest generiko bat pasatuz.

Ibilbideak definitzea

Ibilbide bat definitzeko, erabili ORoute-ren metodo estatikoak HTTP aditzei dagozkienak: get(), post(), put() edo delete().

Oinarrizko sintaxia

use Osumi\OsumiFramework\Routing\ORoute;
use Osumi\OsumiFramework\App\Module\Home\Index\IndexComponent;

ORoute::get('/', IndexComponent::class);

Ibilbidearen Parametroak

• URL (string): Erantzun beharreko bidea.
• Component (string): Exekutatzeko osagaiaren FQCN (Fully Qualified Class Name).
• Filters (array, aukerakoa): Osagaia baino lehen exekutatzeko iragazki klaseen zerrenda.
• Layout (string, aukerakoa): Ibilbide honetarako diseinu osagai espezifikoa.

Iragazkiak

Iragazkiak osagai nagusiaren aurretik exekutatutako klaseak dira. Normalean autentifikaziorako (tokenak egiaztatzeko), erregistroetarako edo eskaeren baliozkotzerako erabiltzen dira.

Dokumentuak: /docs/eu/concepts/filters.md

use Osumi\OsumiFramework\App\Filter\LoginFilter;
use Osumi\OsumiFramework\App\Module\User\Profile\ProfileComponent;

ORoute::post('/profile', ProfileComponent::class, [LoginFilter::class]);

Ibilbideak Taldekatzea

Osumi Framework-ek hiru modu eskaintzen ditu ezaugarri komunak dituzten ibilbideak taldekatzeko:

1. Aurrizkiak

Ibilbide anitzek URL hasiera bera partekatzen dutenean erabiltzen da (adibidez, API bat).

ORoute::prefix('/api', function() {
  ORoute::post('/login', LoginComponent::class);
  ORoute::post('/register', RegisterComponent::class);
});

2. Diseinuak

Ibilbide anitzek egitura bisual bera partekatzen dutenean erabiltzen da (goiburua, orri-oina, etab.).

ORoute::layout(MainLayoutComponent::class, function() {
  ORoute::get('/home', HomeComponent::class);
  ORoute::get('/contact', ContactComponent::class);
});

3. Taldeak (Aurrizkia + Diseinua)

Aurrizkia eta diseinuaren esleipena bloke bakarrean konbinatzen ditu.

ORoute::group('/admin', AdminLayoutComponent::class, function() {
  ORoute::get('/dashboard', DashboardComponent::class);
  ORoute::get('/settings', SettingsComponent::class);
});

Ikuspegi Estatikoak

Ekintza-osagai oso baten logikarik gabeko fitxategi estatiko bat edo txantiloi sinple bat zerbitzatu behar baduzu, erabili ORoute::view().

ORoute::view('/about-us', 'about-us.html');

Ibilbideetako parametroak

URLak parametroak izateko defini daitezke :izena sintaxia erabiliz.

ORoute::get('/user/:id', UserComponent::class);
ORoute::get('/location/:name', LocationComponent::class);

Osagaiaren run(ORequest $req) metodoak parametro horretara sar daiteke getParamInt('id') edo getParamString('name') bezalako metodoak erabiliz.

ORoute metodoen laburpena

Praktika onak

• Antolatu fitxategiaren arabera: Sortu fitxategi desberdinak src/Routes/-en zure aplikazioaren modulu edo funtzio-eremu bakoitzerako.
• Erabili iragazkiak: Mantendu zure osagaiak garbi autentifikazio eta balidazio logika iragazkietara deskargatuz.
• Klase konstanteak: Erabili beti ::class notazioa osagai eta iragazkietarako IDE autoosatze eta analisi estatikotik etekina ateratzeko.