Download the PHP package folded/orm without Composer

folded/orm

A standalone Eloquent ORM for you web app.

Summary

• About
• Features
• Requirements
• Installation
• Examples
• Version support
• Credits

About

Provides a standalone package to use Eloquent model inside your web app, with minimal configuration.

Folded is a constellation of packages to help you setting up a web app easily, using ready to plug in packages.

• folded/action: A way to organize your controllers for your web app.
• folded/config: Configuration utilities for your PHP web app.
• folded/crypt: Encrypt and decrypt strings for your web app.
• folded/exception: Various kind of exception to throw for your web app.
• folded/history: Manipulate the browser history for your web app.
• folded/request: Request utilities, including a request validator, for your PHP web app.
• folded/routing: Routing functions for your PHP web app.
• folded/session: Session functions for your web app.
• folded/view: View utilities for your PHP web app.

Features

• All the features provided by Laravel's Eloquent
• Eager load the engine, so if a request does not call an eloquent method, it is never booted
• Enable the Eloquent events only if you need them

Requirements

• PHP version >= 7.4.0
• Composer installed
• Knowledge with Eloquent ORM

Installation

• 1. Install the package
• 2. Add a database connection
• 3. Create your model class

1. Install the package

In your root directory, run this command:

2. Add a database connection

Call this method before using your Eloquent model to provide with your database connection information:

You can see a complete list of options in the example [put example here].

3. Create your model file

Anywhere you want, create a class to map your table.

Examples

As this library relies on Eloquent, you will find a useful amount of information about all the capability of this ORM in the official documentation.

• 1. Get all the data from your model
• 2. Add more information to the database connection
• 3. Enable/disable eloquent events
• 4. Go to a specific page before paginating

1. Get all the data from your model

In this example, we will use our Post class to get all the posts.

2. Add more information to the database connection

In this example, we will see a complete list of keys you can set on the database connection.

3. Enable/disable eloquent events

In this example, we will enable, then disable the Eloquent events system. Learn more on the official documentation.

4. Go to a specific page before paginating

In this example, we will instruct the paginator to go to a certain page before paginating. As we are not in Laravel, this is required to correctly returns the items according to the browsed page.

The page number should come for example from the query strings, like when the user browse /post?page=2.

However, for technical reasons, I could not find how to provide the same method after you call eloquent methods before. Which means that the following code will not work:

To fix this issue, use the verbose version of ->paginate():

Version support

Credits

This library would not have see the light without the impressive work from Matt Stauffer with Torch.

Torch is a project to provide instructions and examples for using Illuminate components as standalone components in non-Laravel applications, including Eloquent.

Give this man an ice cold beer, a star to this great idea, and follow him on Twitter @stauffermatt!