Les premiers pas
Remarque : Dans ce tutoriel, nous utiliserons le dossier phpdev comme dossier où réside votre installation de PHPDevShell. Modifiez-le pour qu'il corresponde au nom de votre dossier actuel.
Démarrer avec un nouveau cadre d'application est toujours à la fois une tâche passionnante et intimidante. Vous pouvez penser que ce que vous avez devant vous est intéressant, mais comment pouvez-vous commencer avec les bases et travailler avec lui dans sa forme la plus simple ?
Pour suivre ce tutoriel, vous aurez besoin de :
- une installation fonctionnelle de PHPDevShell (nous supposons qu'elle est accessible à l'adresse http://localhost/phpdev/)
- un compte administrateur (une inscription sur cette installation vous permettant de gérer les plugiciels)
- un éditeur de texte ou un IDE pour coder (il est recommandez d'utiliser NetBeans gratuit ou Eclipse gratuit),
- vous devez également avoir accès pour créer des dossiers et télécharger des fichiers sur votre installation.
Choisissons maintenant un nom pour votre plugiciel. Dans PHPDevShell, chaque script appartient à un plugiciel. Cela vous permet de rester cohérent au sein d'une structure et d'avoir un site entier dans un seul dossier de plugiciel. Supposons que vous nommiez votre plugiciel "tutorial" (tout en minuscules). Créez un dossier avec ce nom dans le dossier "plugins".
Une application "Hello World" (Bonjour le monde)
Bien sûr, votre premier script sera le classique mais sophistiqué Hello World, en utilisant uniquement du code que vous connaissez.
Créez un dossier "phpdev/plugins/tutorial/" et placez votre nouveau script (appelons-le first.php pour l'instant) "first.php" à l'intérieur. Ouvrez votre script first.php avec votre éditeur PHP préféré et commencez à écrire du code, faisons le bonjour le monde promis :
- <?php
- /* Entête de «Hello world» */
- echo "<h1>Hello, world!</h1>";
-
- /* Mais ne vous sentez pas limité. Vous avez accès à absolument toutes les fonctions PHP standard, même les requêtes :Mais ne vous sentez pas limité. Vous avez accès à absolument toutes les fonctions PHP standard, même les requêtes : */
- $qeury = mysql_query('SELECT * FROM pds_core_users WHERE user_id = 1');
-
- /* Ou utilisez des requêtes d'objet si les modèles ne doivent pas être utilisés. */
- $qeury = $db->newQuery('SELECT * FROM pds_core_users WHERE user_id = 1');
-
- /* Vous pouvez créer du HTML ici. */
- $html = "<p>Some HTML</p>";
- echo $html;
- ?>
Ajout d'un menu pour ouvrir votre script dans votre navigateur
La manière la plus courante d'exécuter un script est de créer un élément de menu. La création d'un menu dans PHPDevShell fait apparaître un élément dans le tableau de bord qui, une fois cliqué, exécutera votre script. Allez dans System Management -> Menu Admin -> New Menu -> Fill the fields comme :
| Nom | Description |
|---|---|
| Plugin Item | Plugiciel standard (laissez le reste de la colonne de gauche vide). |
| Name | Le nom d'affichage visible par l'utilisateur ; essayons «Hello, World !» (notez que ce nom peut être différent en fonction de la langue de l'utilisateur) |
| Alias | Un nom alternatif, qui peut être utilisé à partir du code pour faire référence au menu quelle que soit la langue de l'utilisateur ; essayons «hello-world». |
| Plugin Name/Folder | Le nom du dossier dans lequel réside notre script ; nous avons choisi «tutorial» plus tôt. |
| URL or path | Cela indiquera au moteur où trouver exactement notre fichier de script ; c'est «first.php» |
Laissez les autres valeurs par défaut et cliquez sur «Save». Cliquez ensuite sur «Dashboard» dans le menu supérieur : notre nouvel élément de menu «Hello, World !» devrait apparaître.
Première exécution
Maintenant, nous sommes prêts ! Cliquez sur l'icône de menu «Hello, World !» et vous devriez voir votre joli message d'accueil. En gros, n'importe quel script PHP peut être exécuté de cette façon ; nous appelons cela le «mode hérité» car c'est ainsi que les scripts ont été écrits avant la version 3.0.
Mais tout le monde peut voir mon script
Vous voulez donc protéger rapidement votre secret Hello World avec un peu de magie en utilisant le contrôle d'accès ? Ce n'est pas un problème, ajoutez simplement cette ligne en haut de votre script :
- /* Empêchez les gens de voir mon menu hautement secret. */
- (is_object($this->security)) ? $this->security->securityIni() : exit('Accès refusé!');
N'oubliez pas maintenant de donner à votre élément de menu les autorisations appropriées en allant dans System Management->Policy Admin->Access Control.
Exemple de plugin
Le PHPDevShell est fourni avec un exemple de plugiciel appelé ExamplePlugin, assurez-vous d'y jeter un oeil afin de démarrer le plus rapidement possible avec des techniques de codage plus avancées.