hettiger / larawire
Merges Laravel with ProcessWire to get the best of both worlds!
Requires
- php: >=5.4.0
- illuminate/support: 4.2.*
This package is not auto-updated.
Last update: 2024-11-19 03:56:48 UTC
README
This package is intended to merge Laravel with ProcessWire to get the best of both worlds!
Be aware: This package is work in progress!
Installation
The installation instructions might seem a bit unfamiliar to you but are required as there is no composer package of processwire. Also the releases on GitHub are off so I've forked the original package maintaining the releases myself. I hope you understand that I refuse to put a fork on packagist.
Open your composer.json
file and add the following block right above the require section:
// composer.json ... "repositories": [ { "type": "package", "package": { "name": "ryancramerdesign/processwire", "version": "2.5.3", "dist": { "url": "https://github.com/hettiger/ProcessWire/archive/2.5.3.zip", "type": "zip" } } } ], "require": { ...
Now append the require section with following packages:
// composer.json ... "require": { ... "ryancramerdesign/processwire": "2.5.*", "hettiger/larawire": "0.*" }, ...
Run a composer update in your terminal:
composer update -o
After updating composer, add the ServiceProvider to the providers array in app/config/app.php
// app/config/app.php ... 'providers' => array( ... 'Hettiger\Larawire\LarawireServiceProvider', ), ...
You can now install larawire, to merge Laravel with ProcessWire using your terminal:
php artisan larawire:install
Follow the instructions prompted by your terminal.
What's next?
You are able to require public/laravel.php
in your template files now. Just think a second about it. This gives you a lot of power ...
Example 1
- Create a template file for your 404-Error-Page
- Require
public/laravel.php
in your new template file - Use Laravel to take care of 404-Error's
- Feel free to use Laravel the way you're used to
- Be aware that ProcessWire URL's can "overwrite" Laravel's routes
- Enjoy full access to ProcessWire's API within Laravel
Example 2
- Create a "Laravel" template file
- Require
public/laravel.php
in your new template file - Use your new "Laravel" template file for each template that should be "Laravel powered"
- Generate routes in Laravel using ProcessWire Selectors (template=name)
- Feel free to use Laravel the way you're used to
- Enjoy full access to ProcessWire's API within Laravel
Example 3
- Mix
Example 1
andExample 2
- Go crazy :-)
Future
- Optimized ProcessWire site
- Supporting services for route generation
- Proper Apache and nginx configuration files
- ...
Pull Requests / any form of help are very welcome.