Démarrer

Deux façons d'utiliser OSD_Aurox™ : partir du dépôt, qui est aussi une application de démonstration fonctionnelle, ou l'intégrer comme librairie via composer.
Prérequis : Apache2 + PHP ≥ 8.1, extensions pdo, curl, mbstring, gd, imagick. Base de données : MySQL / MariaDB ou PostgreSQL.

Option 1 : partir du dépôt

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.

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

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