ZenithPHP

Welcome to ZenithPHP, a simple and lightweight PHP framework designed to streamline web application development. ZenithPHP follows the MVC (Model-View-Controller) architecture and provides developers with a clean and flexible foundation to build modern PHP applications with ease.

Official Documentation

You can find the official documentation for ZenithPHP at ZenithPHP Documentation. The documentation provides detailed information on how to get started with ZenithPHP, including installation instructions, routing, controllers, models, views, and more.

Features

• MVC Architecture: Keeps code organized by separating the business logic, presentation, and data layers.
• Custom Routing: Define clean and flexible routes for your application with ease.
• Simple Namespacing: Eliminate the need for require_once with proper namespacing.
• Security Built-in: Features like password hashing and input validation to keep your app secure.
• Easy to Extend: Customize the framework to suit your application’s needs with minimal effort.
• Pluto Template Engine: Simplifies view rendering with a clean syntax and powerful directives.

Installation

To get started with ZenithPHP, follow the instructions below:

1. Clone the repository:

2. Navigate to the project directory:

3. Install dependencies using Composer:

4. Configure your environment:

   • Create a copy of the .env.example file and rename it to .env.
   • Set your database credentials and other necessary configurations.

5. Start your local development server:

6. Visit http://localhost:8000 in your browser to see the landing page.

Folder Structure

• App/: Contains the core application files.
• Config/: Configuration files like CORS for the application.
• Core/: The framework's core classes and functions.
• View/: Contains all view files (HTML/PHP templates).
• Public/: The main entry point for the application and assets (JS, CSS, images).
• .env: Environment variables for the application.
• .env.example: Example environment variables file.
• composer.json: Composer dependencies file.
• cli: Command-line interface for running the application and creating models and controllers.

How to Get Started

To create your first route:

1. Open App/routes.php and define your route:

2. Create a new controller (WelcomeController.php) inside App/Controllers/:

3. Now, create a new view file inside View/welcome.php:

4. Visit http://localhost:8000/welcome to see the result.

Working with APIs

Now you can create APIs with ZenithPHP. Here's how you can create a simple API:

1. First, create a new route in App/routes.php:

2. Create a new model using the CLI tool:

3. Implement the model method to fetch data from the database:

4. Create a new controller. For that, you can use the CLI tool:

5. Implement the controller method to return JSON data:

6. Visit http://localhost:8000/api/users to see the JSON response.

Pluto Template Engine

The Pluto template engine in ZenithPHP allows you to easily build dynamic views with clean and readable syntax. Here’s a quick overview of its directives:

Pluto Syntax

• Variable Output: Use << $variable >> to output PHP variables in the view.
• Conditional Statements: Pluto offers @if, @elseif, @else, and @endif directives for conditional rendering.
• Looping: Use @foreach and @endforeach to iterate over collections.
• Comments: Use << // >> to add comments in your templates.
• Yielding Sections: Use @yield to define a section that will be replaced with content from child templates.
• Section Definition: Use @section to define a section that can be filled in child templates.

Example Syntax

HomeController.php

home.pluto.php

Security Features

• Password Hashing: Built-in password hashing methods for user authentication.
• Input Validation: Functions to validate and sanitize user inputs.

Contributing

Contributions are welcome! To contribute:

1. Fork the repository.
2. Create a new branch for your feature/bugfix.
3. Submit a pull request with a clear description of your changes.

License

ZenithPHP is open-source and licensed under the MIT License. See the LICENSE file for more details.

Built with ❤️ by Dasun Nethsara