Démarrer
Trois façons d'utiliser OSD_Aurox™ : partir de la boilerplate Aurox Start, l'intégrer comme librairie via composer,
ou partir du dépôt aurox-dist, qui est aussi une application de démonstration fonctionnelle.
Prérequis : Apache2 + PHP ≥ 8.1, extensions pdo, curl, mbstring, gd, imagick.
Base de données : MySQL / MariaDB ou PostgreSQL.
Option 1 : la boilerplate Aurox Start (le plus rapide)
Aurox Start est une application de départ
prête à l'emploi : authentification (inscription, double authentification TOTP, mot de passe oublié), blog avec flux RSS,
espace membre et administration. Le framework y est déjà installé dans vendor/.
git clone https://github.com/osd84/aurox-start.git mon_site
cd mon_site
cp conf_example.php conf.php # base de données, appUrl, salt...
mysql -u root -p mon_site < migrations/2026-10-12-schema-mysql.sql
php scripts/create_admin.php admin@exemple.fr "Mon nom"
php -S 127.0.0.1:8000 -t public
PostgreSQL : les mêmes migrations existent en -pgsql.sql. Le README du dépôt détaille l'installation
et la page /guide.php de l'application explique son code.
Option 2 : comme librairie via Composer
composer require osd84/aurox
Puis copier à la racine du projet, depuis vendor/osd84/aurox/ : aurox.php (le bootstrap),
conf_example.php (à renommer en conf.php) et, comme point de départ,
app/, templates/ et public/.
Option 3 : partir du dépôt aurox-dist
1. Récupérer le code source :
git clone https://github.com/osd84/aurox-dist.git mon_site
ou télécharger le zip depuis GitHub (bouton Code → Download ZIP) et l'envoyer à la racine de votre hébergement.
2. Déclarer le dossier /public comme racine (webroot) de votre site dans Apache2. Tout le reste reste hors de la racine web.
<VirtualHost *:80>
ServerName mon_site.local
DocumentRoot /var/www/mon_site/public/
<Directory /var/www/mon_site/public/ >
AllowOverride All
Require all granted
</Directory>
</VirtualHost>
3. Copier conf_example.php en conf.php et le remplir selon votre environnement.
Chaque clé y est commentée.
4. Par défaut, OSD_Aurox™ force le HTTPS en production. Les lignes essentielles :
Configuration pour le développement
'devUrl' => 'http://monapp.local',
'prodUrl' => 'https://monapp.example',
'appUrl' => 'http://monapp.local',
'salt' => '...', // un sel unique et aléatoire, obligatoire
'disableHttpsRedirect' => true, // pas de redirection HTTPS en local
'debug' => true,
'dbActive' => false, // si pas besoin de base de données
Configuration pour la production
'devUrl' => 'http://monapp.local',
'prodUrl' => 'https://monapp.example',
'appUrl' => 'https://monapp.example',
'salt' => '...', // un sel unique et aléatoire, obligatoire
'disableHttpsRedirect' => false, // redirection HTTPS forcée
'debug' => false,
Si besoin, ajuster les permissions du dossier racine :
sudo chown -R www-data:www-data /var/www/mon_site
sudo find /var/www/mon_site -type d -exec chmod 755 {} \;
sudo find /var/www/mon_site -type f -exec chmod 644 {} \;
5. Ouvrir votre navigateur sur l'adresse de votre site.
À lire avant la mise en production
Le README du dépôt
liste les limites de sécurité à connaître : noms de colonnes en liste blanche dans BaseModel,
IP lue uniquement dans REMOTE_ADDR (configurer mod_remoteip derrière un proxy ou un CDN),
filtrage AbuseIP désactivé tant qu'aucune URL d'API n'est configurée.
💡 Envie de gagner du temps ?
Besoin d'un support PRO, de la documentation détaillée ou d'une maintenance continue ?
Nous composons votre projet sur mesure basé sur OSD_Aurox™ pour votre Logiciel sur mesure, Site, E-commerce, CRM, ERP :
✉️ Demandez un devis.