Light-weight loader for the RedBeanPHP ORM

RedBeanPHP ProcessWire Module

This module loads and initializes RedBeanPHP – an easy to use ORM for PHP. RedBeanPHP is particularly easy to get started with for two reasons: first of all there are no config files, and second of all it has the ability to create the database schema for you on the fly.

The main task of this module is loading the RedBeanPHP library and initializing it with the database creentials found from ProcessWire's $config settings. Module config contains some settings, and the module exposes some often used RedBeanPHP methods, but that's it.

Requirements


The master branch of this module requires ProcessWire 3.0+. If you're running an earlier version of ProcessWire, you probably should consider updating it – but if that's not an option, check out the legacy branch instead:

https://github.com/teppokoivula/RedBeanPHP/tree/legacy

RedBeanPHP ORM


RedBeanPHP is an easy to use ORM for PHP. It's a Zero Config ORM lib that 'automagically' builds your database schema. — https://redbeanphp.com/index.php

RedBeanPHP has two operating modes, "fluid" and "frozen". When in fluid mode, RedBeanPHP can create the database schema for you. While this may not be desirable in production, it can be quite useful during the development phase.

One interesting aspect with RedBeanPHP is that it contains no Query Builder, instead relying on raw SQL with parameter binding. While some may see this as a shortcoming, the reason for this particular design decision is keeping things simple.

Learning the basics of RedBeanPHP takes minutes, but grasping how to define relations between beans (objects), how to define models, etc. can take a while longer. The docs at redbeanphp.com are quite detailed, so definitely check them out if you're interested in hearing more.

RedBeanPHP is copyright (c) 2018 Gabor de Mooij and the RedBeanPHP community, dual licensed under New BSD and GPLv2. You may choose the license that fits best for your project.

ORM and ProcessWire


ProcessWire has a very effective way of modeling and managing data built-in, so most of the time you'll find a separate ORM nothing but a distraction. For cases in which you may prefer to drop out of the typical workflow, though, an ORM such as RedBeanPHP is an easy and light-weight solution.

Some examples of situations in which RedBeanPHP may come in handy:

  • Working with (possibly large) sets of existing data
  • Working with SQLite or PostgreSQL databases
  • Working with multiple databases all at once
  • Rapid prototyping (using code only)

.. and so on. The main point here is that situations can vary, and if you feel that a separate ORM is the best option for your particular use case, then by all means go for it.

Install and use modules at your own risk. Always have a site and database backup before installing new modules.

Twitter updates

  • ProcessWire 3.0.185 (dev) core updates, plus new Session Allow module— More
    17 September 2021
  • Three new ProcessWire Textformatter modules: Find/Replace, Markdown in Markup, and Emoji— More
    3 September 2021
  • This week we have a new master version released after a year in the making. With nearly 40 pull requests, hundreds of new additions and more than 100 issue reports resolved, this new version has a ton of great new stuff— More
    27 August 2021

Latest news

  • ProcessWire Weekly #388
    In the 388th issue of ProcessWire Weekly we'll check out the latest core update, introduce two new third party modules, and more. Read on!
    Weekly.pw / 16 October 2021
  • ProcessWire 3.0.184 new master/main version
    This week we have a new master/main version released after a full year in the making. As you might imagine, this new version has a ton of great new stuff and we’ll try to cover much of it here.
    Blog / 27 August 2021
  • Subscribe to weekly ProcessWire news

“Indeed, if ProcessWire can be considered as a CMS in its own right, it also offers all the advantages of a CMF (Content Management Framework). Unlike other solutions, the programmer is not forced to follow the proposed model and can integrate his/her ways of doing things.” —Guy Verville, Spiria Digital Inc.