OSD_Aurox™ framework PHP brutaliste
open source · MIT

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.

Envoi sur l'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.

Configuration

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.

Site prêt

À 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.