Konfigurazioa

Osumi Framework-en konfigurazioa src/Config/ barruko JSON fitxategien bidez kudeatzen da.

Konfigurazio-fitxategiak

Config.json: konfigurazio nagusia.
Config_{environment}.json: ingurunearen araberako aukerako gainidazketak.

Oinarrizko konfigurazio blokeak

Aplikazioaren konfigurazioa

{
	"name": "Nire aplikazioa",
	"lang": "eu",
	"use-session": true,
	"allow-cross-origin": true,
	"base_url": "https://example.com",
	"css_list": [],
	"js_list": [],
	"head_elements": []
}

Datu-basea (`db`)

{
	"db": {
		"driver": "mysql",
		"host": "localhost",
		"user": "root",
		"pass": "secret",
		"name": "my_database",
		"charset": "utf8mb4",
		"collate": "utf8mb4_unicode_ci"
	}
}

Logging-a (`log`)

{
	"log_level": "DEBUG",
	"log": {
		"name": "app_log",
		"max_file_size": 50,
		"max_num_files": 3
	}
}

Direktorio pertsonalizatuak (`dir`)

{
	"dir": {
		"uploads": "{{base}}public/uploads/",
		"exports": "{{ofw_export}}my_reports/"
	}
}

Konfigurazio gehigarria (`extra`)

{
	"extra": {
		"api_key": "12345-abcde",
		"items_per_page": 20
	}
}

Baliabideak eta `head` elementuak

css_list eta js_list arrayek public azpian ebazten diren izenak onartzen dituzte.

head_elements-ek item bat eta attributes objektu bat dituzten sarrerak onartzen ditu.

Konfigurazioa kodetik atzitzea

$apiKey = $this->getConfig()->getExtra('api_key');
$uploadPath = $this->getConfig()->getDir('uploads');
$dbName = $this->getConfig()->getDB('name');

Inguruneko gainidazketak

Balio bat Config.json-en eta hautatutako inguruneko fitxategian agertzen bada, inguruneko balioak nagusia gainidazten du.

Aplikazioaren bideak

OConfig-ek honako bide lehenetsi hauek definitzen ditu:

Giltza	Bidea	Deskribapena
`base`	`/`	Aplikazioaren oinarrizko bidea
`app`	`/src/`	Aplikazioaren kodea
`app_component`	`/src/Component/`	Osagai berrerabilgarriak
`app_config`	`/src/Config/`	Konfigurazio-fitxategiak
`app_dto`	`/src/DTO/`	DTO klaseak
`app_layout`	`/src/Layout/`	Layout osagaiak
`app_middleware`	`/src/Middleware/`	Middleware klaseak eta Middleware globalen konfigurazioa
`app_model`	`/src/Model/`	Datu-baseko modelo-fitxategiak
`app_routes`	`/src/Routes/`	Aplikazioaren ibilbideak
`app_service`	`/src/Service/`	Zerbitzu berrerabilgarriak
`app_task`	`/src/Task/`	Aplikazioaren CLI zereginak
`app_utils`	`/src/Utils/`	Erabilgarritasun-klaseak
`ofw`	`/ofw/`	Framework-ak sortutako fitxategiak
`ofw_cache`	`/ofw/cache/`	Cache fitxategiak
`ofw_export`	`/ofw/export/`	Esportatutako fitxategiak
`ofw_tmp`	`/ofw/tmp/`	Aldi baterako fitxategiak
`ofw_logs`	`/ofw/logs/`	Log fitxategiak
`ofw_base`	`/vendor/osumionline/framework/`	Framework-aren oinarrizko bidea
`ofw_vendor`	`/vendor/osumionline/framework/src/`	Framework-aren kodea
`ofw_assets`	`/vendor/osumionline/framework/src/Assets/`	Framework-aren baliabideak
`ofw_locale`	`/vendor/osumionline/framework/src/Assets/locale/`	Framework-aren hizkuntza-fitxategiak
`ofw_template`	`/vendor/osumionline/framework/src/Assets/template/`	Framework-aren txantiloiak
`ofw_task`	`/vendor/osumionline/framework/src/Task/`	Framework-aren CLI zereginak
`ofw_tools`	`/vendor/osumionline/framework/src/Tools/`	Framework-aren tresnak
`public`	`/public/`	Aplikazioaren document root-a

Praktika onak

Ez igo sekreturik biltegira.
Erabili ingurunearen araberako konfigurazioa beharrezkoa denean.
Balidatu getter generikoek itzulitako balioak haien mota garrantzitsua denean.
Mantendu JSON fitxategiak sintaktikoki zuzen.