alphacore / core
AlphaCore PHP framework Engine
Requires
- php: ^8.5
- alphacore/exception: ^2.0.0
- alphacore/file: ^2.0.0
- alphacore/utils: ^2.0.0
- alphacore/value-object: ^2.0.0
- httpsoft/http-emitter: ^1.1.1
- laminas/laminas-diactoros: ^3.10.0
- middlewares/fast-route: ^2.1.0
- middlewares/request-handler: ^2.1.0
- oscarotero/middleland: ^1.0.3
- php-di/php-di: ^7.1.1
- psr/container: ^2.0.2
- psr/http-factory: ^1.1.0
- psr/http-message: ^2.0.0
- psr/http-server-handler: ^1.0.2
- psr/http-server-middleware: ^1.0.2
- psr/log: ^3.0.2
Requires (Dev)
- phpunit/phpunit: ^12.5.43
Suggests
None
Provides
None
Conflicts
None
Replaces
None
README
Framework PHP AlphaCore pour la création d'applications web.
Pré-requis
L'architecture minimale des dossiers et fichiers requise pour le fonctionnement de l'application est la suivante :
+-- app
+-- public
| +-- index.php
+-- settings
+-- app_settings.yml
Le dossier app est le dossier racine de l'application où les dossiers et fichiers de celle-ci sont stockés.
Le dossier app/public est le dossier où les fichiers publiquement accessibles doivent être stockés. Le paramètre document root
du vhost doit pointer vers ce dossier.
Le dossier app/settings est le dossier où les paramètres de l'application sont stockés. Il doit obligatoirement contenir un fichier
app_settings.yml contenant les paramètres de l'application.
Le projet AlphaCore template est un dépôt GitLab contenant l'architecture minimale requise au fonctionnement d'une application. Il peut être cloné pour servir de base au démarrage d'un nouveau projet.
Installation et utilisation
L'AlphaCore est conçu pour être utilisé comme dépendance du projet et installé par composer en ajoutant son noyau alphacore/core et autres composants
au fichier composer.json:
{
"require": {
"alphacore/core": "*"
}
}
Pour exécuter l'AlphaCore, le fichier index.php à la racine du dossier public du projet doit initialiser et exécuter l'Engine après avoir chargé
l'autoloader de composer :
require_once dirname(__DIR__).'/vendor/autoload.php';//Chargement de l'autoloader composer
//Initialisation de l'AlphaCore
try {
$alphacore = \AlphaCore\Engine::init();
}
catch(\AlphaCore\Exception\RuntimeException|\AlphaCore\Exception\InvalidArgumentException $e) {
http_response_code(500);
exit("AlphaCore initialisation error, ".$e->getStackMessage());
}
//Exécution de l'AlphaCore
$alphacore->run();
Recommandations
Configuration Apache
La configuration minimale recommandée d'un vhost apache est la suivante :
<VirtualHost *:80>
ServerAdmin admin@domain.tld
DocumentRoot "/var/www/public"
ServerName domain.tld
DirectoryIndex index.php
SetEnv ALPHACORE_ENVIRONMENT [prod|dev|test]
# Répertoire public du site
<Directory "/var/www/public">
AllowOverride None
Options FollowSymLinks
Require all granted
FallbackResource /index.php
</Directory>
</VirtualHost>
Auteur
- Merle Cédric, me@cmerle.dev
Licence
AlphaCore Core est un logiciel libre distribué sous les termes de la GNU Lesser General Public License, version 3 ou ultérieure (LGPL-3.0-or-later).
Vous êtes libre d'utiliser AlphaCore Core dans vos projets personnels et commerciaux, y compris dans des applications propriétaires, sous réserve du respect des conditions de la licence LGPL.
Toute modification ou redistribution du code source d'AlphaCore Core reste soumise aux conditions de la LGPL. Les modifications apportées au framework doivent notamment respecter les obligations de redistribution et de mise à disposition du code source prévues par cette licence.
Le texte intégral de la licence est disponible dans le fichier LICENSE.
Pour plus d'informations, consultez le site officiel de la GNU Lesser General Public License v3.0.