Hello World! Το πρώτο μας module

Όπως συνηθίζεται στον προγραμματισμό, ας ξεκινήσουμε με το Module Hello World!

Το Module μας, θα εμφανίζει σε μία ιστοσελίδα, το πρώτο μας μήνυμα: Hello World.

Χρειάζεται να δημιουργήσουμε:

1. Ένα αρχείο info με πληροφορίες για το Module μας, ώστε να το αναγνωρίζει το σύστημα.
2. Ένα αρχείο controller με τον απαραίτητο κώδικα PHP που θα εμφανίσει το μήνυμα στη σελίδα μας
3. Ένα αρχείο routing που θα πυροδοτεί την εκτέλεση του κώδικά μας.

Ας τα δούμε ένα ένα αναλυτικά:
 

1. Το αρχείο Info

Μέσα στο φάκελο modules του website, δημιουργούμε φάκελο με όνομα custom για τα modules που θα δημιουργήσουμε.

Μέσα στο φάκελο custom δημιουργούμε έναν νέο φάκελο με όνομα  hello_world, για τα αρχεία του Module και μέσα σε αυτόν, ένα αρχείο απλού κειμένου με όνομα: hello_world.info.yml 

Μέσα σε αυτό το αρχείο, χρησιμοποιώντας έναν code editor θα γράψουμε:

Αυτές οι πληροφορίες θα εμφανίζονται στη λίστα των Modules του site μας και είναι αρκετές, για να ενεργοποιήσουμε το Module ακόμα κι αν αυτή τη στιγμή δεν κάνει απολύτως τίποτα.

Δείτε πώς θα φαίνεται στο παράθυρο:

2. Το αρχείο Controller

Για να εμφανιστεί κάποιο περιεχόμενο στη σελίδα μας θα πρέπει να γράψουμε τον αντίστοιχο κώδικα σε PHP.

Για το σκοπό αυτό, μέσα στο φάκελο hello_world, δημιουργούμε έναν φάκελο src και μέσα σε αυτόν έναν φάκελο Controller.

Μέσα στον φάκελο Controller, δημιουργούμε ένα νέο αρχείο με όνομα HelloWorldController.php με το παρακάτω περιεχόμενο:

 

Ας δούμε αναλυτικά τον κώδικα αυτού του αρχείου.

• Στην αρχή δηλώνουμε το namespace ώστε να μην υπάρχει σύγχυση με ονόματα άλλων κλάσεων και συναρτήσεων.
• Στη συνέχεια δηλώνουμε ότι θα χρησιμοποιήσουμε την αφηρημένη κλάση ControllerBase. 
• Προγραμματίζουμε με αντικειμενοστραφή προγραμματισμό και δημιουργούμε την κλάση HelloWorldController, η οποία βασίζεται στην ControllerBase.
• Έχουμε μέσα στην κλάση μας μία πολύ απλή συνάρτηση, την helloWorld(), η οποία επιστρέφει το array με το μήνυμα Hello, World!

3. Το αρχείο routing

Όπως είπαμε στην αρχή αυτού του μαθήματος, το module μας θα εμφανίζει το μήνυμα "Hello World". Πού θα το εμφανίζει; Σε μια σελίδα του website.

• Θα πρέπει να δημιουργήσουμε και ένα αρχείο μέσα στον αρχικό φάκελο του module hello_world, με όνομα hello_world.routing.yml (module_name.routing.yml) και με περιεχόμενο όπως στην παρακάτω εικόνα:

Εδώ λοιπόν, στο αρχείο routing δίνουμε πληροφορίες για τη σελίδα που παράγει το module μας:

1. Θα βρίσκεται στο path /hello
2. Μόλις κάποιος επισκέπτεται αυτή τη σελίδα, πυροδοτείται η εκτέλεση του HelloWorldController με την κλάση helloWorld και εμφανίζεται το αποτέλεσμα του κώδικα. 
3. Ο τίτλος της σελίδας θα είναι Our first module
4. Θα έχει πρόσβαση σε αυτή τη σελίδα οποιοσδήποτε μπορεί να δει το απλό περιεχόμενο του website

 

  Κατεβάστε τα αρχεία του κώδικα