Juste ดาวน์โหลด - Juste แหล่งดาวน์โหลดแหล่งที่มา

Juste

หมวดหมู่อื่นๆ

v2.0.2 stable

ดาวน์โหลด

ผู้ถือ

Juste เป็นแกนหลักของ Project Bravo กรอบ PHP MVC ส่วนตัวของฉันมันช่วยให้มั่นใจได้ถึงความเข้าใจของโมเดลคอนโทรลเลอร์เอ็นจิ้นเทมเพลตพื้นฐาน นอกจากนี้ยังจัดการการกำหนดเส้นทาง, Middlewares, ฐานข้อมูลและโดยเฉพาะอย่างยิ่ง Mini Mini Mini Mini ที่ดีสุด ๆ ของฉันโดยไม่ลืมการส่งอีเมลอย่างง่ายดาย

เอกสาร:

เอกสารสำหรับ Bravo กำลังเตรียมและจะพร้อมใช้งานในไม่ช้า คอยติดตามการอัปเดต!

วิธีใช้:

หากต้องการดูตัวอย่างของการใช้ Bravo คุณสามารถอ้างถึงโครงการ Bravo มันทำหน้าที่เป็นโครงการสาธิตและจะมีเอกสารอย่างเป็นทางการในไม่ช้า

การติดตั้ง

ในการติดตั้ง Juste คุณสามารถทำตามขั้นตอนเหล่านี้:

ต้องการแพ็คเกจโดยใช้นักแต่งเพลงโดยเรียกใช้คำสั่งต่อไปนี้:
```
composer require blakvghost/juste
```
เมื่อติดตั้งแพ็คเกจแล้วคุณสามารถเริ่มรวม Juste เข้ากับโครงการ PHP ของคุณได้

ความต้องการ

PHP 8.0 หรือสูงกว่า

โปรดทราบว่า Juste ต้องการแพ็คเกจต่อไปนี้เป็นแบบอ้างอิง: symfony/dotenv (version 6.2 or higher) และ symfony/mailer (version 6.2 or higher) การพึ่งพาเหล่านี้จะถูกติดตั้งโดยอัตโนมัติเมื่อคุณติดตั้ง Juste โดยใช้นักแต่งเพลง

คุณสมบัติ

โมเดล: กำหนดโมเดลข้อมูลของคุณและโต้ตอบกับฐานข้อมูลโดยใช้ Mini ORM ของ Juste
คอนโทรลเลอร์: ใช้ตรรกะของแอปพลิเคชันและจัดการคำขอผู้ใช้
การกำหนดเส้นทาง: กำหนดเส้นทางและแมปกับการกระทำของคอนโทรลเลอร์ที่เฉพาะเจาะจง
Middlewares: ใช้ตรรกะที่กำหนดเองกับคำขอขาเข้าและแก้ไขคำขอหรือการตอบกลับ
ฐานข้อมูล: ดำเนินการฐานข้อมูลได้อย่างง่ายดายโดยใช้ ORM ของ Juste
เทมเพลตเอ็นจิ้น: ใช้เครื่องมือเทมเพลตพื้นฐานที่จัดทำโดย Juste สำหรับการแสดงผล
การส่งอีเมล: ลดความซับซ้อนของกระบวนการส่งอีเมลภายในใบสมัครของคุณ

ฟังก์ชั่นยูทิลิตี้

Juste มีฟังก์ชั่นยูทิลิตี้บางอย่างที่คุณสามารถใช้ในแอปพลิเคชันของคุณ:

ซุปเปอร์

ซุ้ม Common รวมถึงฟังก์ชั่นยูทิลิตี้ต่างๆ:

posts() : ส่งคืนอาร์เรย์ด้วยเนื้อหาทั้งหมดของตัวแปร $ _post ทั่วโลกหลบหนีด้วย htmlentities ()
server(string $key) : ส่งคืนค่าของคีย์ที่กำหนดจากอาร์เรย์ $ _Server Global
input(string $key, string $default = '') : ส่งคืนค่าของคีย์ที่กำหนดจากตัวแปร Global $ _POST หรือ $ _GET โดยมีตัวเลือกเพื่อระบุค่าเริ่มต้นหากคีย์ไม่ได้ตั้งค่า
file(string $key) : ส่งคืนไฟล์ที่อัปโหลดด้วยคีย์ที่กำหนดจากตัวแปร $ _files Global หรือเปลี่ยนเส้นทางกลับไปยังหน้าก่อนหน้าด้วยข้อความแสดงข้อผิดพลาดหากไม่มีการอัปโหลดไฟล์
redirectTo(string $path = '') : เปลี่ยนเส้นทางผู้ใช้ไปยังเส้นทางที่กำหนดโดยใช้ฟังก์ชันส่วนหัว ()
redirecTo(string $path = '') : เปลี่ยนเส้นทางผู้ใช้ไปยังเส้นทางที่กำหนดโดยใช้ฟังก์ชันส่วนหัว () (พิมพ์ผิดในรหัสแก้ไขเป็น redirectTO)
sanitize_post(string $key, bool $strict = true) : ส่งคืนค่า sanitized ของคีย์ที่กำหนดจากตัวแปร Global $ _post พร้อมตัวเลือกเพื่อตรวจสอบว่าคีย์มีอยู่และไม่ว่างเปล่า
back() : เปลี่ยนเส้นทางผู้ใช้กลับไปที่หน้าก่อนหน้า
with(string $message, $key = 'error') : ตั้งค่าข้อความในเซสชันด้วยคีย์ที่กำหนด (การเริ่มต้นเป็น 'ข้อผิดพลาด')
json(array $data) : ส่งคืนสตริงที่เข้ารหัส JSON ของอาร์เรย์ที่กำหนด
user($attr = false) : ส่งคืนข้อมูลผู้ใช้ที่ได้รับการรับรองความถูกต้องปัจจุบันหรืออาร์เรย์ที่ว่างเปล่าหากไม่ได้รับการรับรองความถูกต้อง
store_media($file, string $newFileName) : จัดเก็บไฟล์สื่อที่มีชื่อที่กำหนดและส่งคืนไฟล์ - พา ธ หรือเปลี่ยนเส้นทางกลับด้วยข้อความแสดงข้อผิดพลาดหากการอัปโหลดไฟล์ล้มเหลว
setDataOnSession($key, $message) : ตั้งค่าข้อมูลในเซสชันด้วยคีย์และข้อความที่กำหนด
getDataOnSession($key) : ดึงข้อมูลจากเซสชันโดยใช้คีย์ที่กำหนด
setErrorMessageOnSession($message) : ตั้งค่าข้อความแสดงข้อผิดพลาดในเซสชัน
dd($value, ...$args) : แสดงค่าและอาร์กิวเมนต์เพิ่มเติมโดยใช้ var_dump () ภายในแท็กและออกจากแท็กและออก
route(string $alias) : ส่งคืน URL เส้นทางสำหรับนามแฝงที่กำหนด
redirect(string $alias) : เปลี่ยนเส้นทางผู้ใช้ไปยัง URL เส้นทางสำหรับนามแฝงที่กำหนด

คอนโทรลเลอร์ซุ้ม

คอนโทรลเลอร์ซุ้มมีฟังก์ชั่นที่มีประโยชน์สำหรับคลาสคอนโทรลเลอร์:

render($view, $title = '', $context = null) : ส่งคืนเส้นทางมุมมองแบบเต็มหรือเส้นทางดู 404 พร้อมข้อมูลบริบท ตรวจสอบว่าไฟล์มีอยู่หรือไม่และส่งคืนการตอบกลับที่เหมาะสมหรือไม่
html(string $html) : ส่งคืนอาร์เรย์ด้วยรหัส HTML แบบเต็มซึ่งมีประโยชน์สำหรับการส่งคืนการตอบกลับ HTML
can(array $user_type = null, string $column = 'roles') : ตรวจสอบว่าผู้ใช้ได้รับการรับรองความถูกต้องและมีประเภท/บทบาทของผู้ใช้ที่ระบุหรือไม่ เปลี่ยนเส้นทางกลับด้วยข้อความแสดงข้อผิดพลาดหากผู้ใช้ไม่มีบทบาทที่จำเป็น
mustAuthenticate(bool $statut = true) : ตรวจสอบว่าผู้ใช้ได้รับการรับรองความถูกต้องตามสถานะที่ให้ไว้หรือไม่ เปลี่ยนเส้นทางด้วยข้อความแสดงข้อผิดพลาดหากไม่ตรงกับสถานะการรับรองความถูกต้อง

ตัวอย่างการใช้งาน

การกำหนดเส้นทาง

 <?php

namespace Routes ;

use App  Controllers  WelcomeController ;
use Juste  Facades  Routes  Route ;

Route:: get ( " / " , [WelcomeController::class, ' welcome ' ])-> name ( ' welcome ' );
Route:: resource ( ' password ' , WelcomeController::class);


Route:: group ( function () {
    
})-> middlewares ([ ' auth ' ]);

require_once ' api.php ' ;

เส้นทาง API

 <?php

namespace Routes ;

use App  Controllers  MailsController ;
use Juste  Facades  Routes  Route ;

Route:: post ( ' api/mails ' , [MailsController::class, ' index ' ])-> name ( ' api ' )-> middlewares ([ ' cors ' ]);

มิดเดิลแวร์

 <?php

namespace App  Middleware ;

use Juste  Http  Middleware  MiddlewareInterface ;
use Juste  Facades  Controllers  Controller as Helpers ;

class Authenticate extends Helpers implements MiddlewareInterface
{

    public function handle (): mixed
    {
        if (! $ this -> user ()) {
            return $ this -> redirect ( ' login ' );
        }
        return 1 ;
    }
}

แบบอย่าง

 <?php

namespace App  Models ;

class User extends Model
{
    protected $ table = ' users ' ;

    protected $ fillable = [ ' nom ' , ' prenom ' , ' email ' , ' password ' ];
}

ผู้ควบคุม

 <?php

namespace App  Controllers ;

use App  Controllers  Controller ;
use Juste  Facades  Mails  JusteMailer ;

class MailsController extends Controller
{
    public function __construct ()
    {
        $ this -> mustAuthenticate ( false );
    }

    public function index ()
    {
        $ mail = new JusteMailer ();

        $ object = [
            ' to ' => ' [email protected] ' ,
            ' subject ' => ' Message d ' un potentiel client ' ,
        ];

        $ data = [
            ' name ' => $ this -> input ( ' name ' , " Anonymous " ),
            ' email ' => $ this -> input ( ' email ' , " [email protected] " ),
            ' subject ' => $ this -> input ( ' subject ' , " Anonyme " ),
            ' message ' => $ this -> input ( ' message ' , " Anonyme " ),
        ];

        $ mail -> view ( ' mails/contact ' , $ data )-> sendEmail ( $ object );
        return $ this -> back ();
    }
}