PHPackages                             firevel/firevel - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Framework](/categories/framework)
4. /
5. firevel/firevel

ActiveProject[Framework](/categories/framework)

firevel/firevel
===============

The Serverless Laravel Framework for Google App Engine + Firestore.

12.0.1(3mo ago)30639412MITBladePHP ^8.2CI failing

Since Jul 23Pushed 3mo ago10 watchersCompare

[ Source](https://github.com/firevel/firevel)[ Packagist](https://packagist.org/packages/firevel/firevel)[ RSS](/packages/firevel-firevel/feed)WikiDiscussions master Synced today

READMEChangelog (10)Dependencies (30)Versions (19)Used By (0)

[![](https://camo.githubusercontent.com/6c4d7c40c033b7f7c6423d2e56c78e690c48b98aa7afb7115826b853fd427742/68747470733a2f2f73746f726167652e676f6f676c65617069732e636f6d2f6669726576656c2d7075626c69632f696d616765732f6c6f676f2e706e67)](https://camo.githubusercontent.com/6c4d7c40c033b7f7c6423d2e56c78e690c48b98aa7afb7115826b853fd427742/68747470733a2f2f73746f726167652e676f6f676c65617069732e636f6d2f6669726576656c2d7075626c69632f696d616765732f6c6f676f2e706e67)

About Firevel
-------------

[](#about-firevel)

Firevel is a modified, serverless version of [Laravel 12](https://laravel.com/) designed to work inside Google App Engine PHP 8.4 standard environment, together with [Google Firestore](https://cloud.google.com/firestore/) as database and cache.

In addition to standard [Laravel Framework](https://laravel.com/) benefits it offers:

- Simple, serverless setup.
- Downscaling to zero.
- Micro-service friendly design.
- [Free tier eligibility](https://cloud.google.com/free/).
- Capacity to deal with high loads.

Requirements
------------

[](#requirements)

- [Laravel Server Requirements](https://laravel.com/docs/12.x/deployment#server-requirements)
- [gRPC extension](https://cloud.google.com/php/grpc)
- [gcloud command-line tool](https://cloud.google.com/sdk/docs/quickstarts)

Before you start
----------------

[](#before-you-start)

- Make sure you `gcloud` is initialized using `gcloud init` command.
- Make sure you created project at [Google Cloud Platform Console](https://console.cloud.google.com/project) and set it on your console using `gcloud config set project PROJECT_ID`.
- Login to [Google Console](https://console.cloud.google.com/) find [Firesore section](https://console.cloud.google.com/firestore) and make sure that your project is running on Native mode. If your project is already using Datastore mode you might need to create a new project.

Installation
------------

[](#installation)

1. Create a project in the [Google Cloud Platform Console](https://console.cloud.google.com/project)
2. [Install](https://cloud.google.com/sdk/docs/quickstarts) and initialize (`gcloud init`) [gcloud command-line tool](https://cloud.google.com/sdk/gcloud)
3. Create firevel project with `composer create-project firevel/firevel`
4. Generate your `app.yaml` file using `php artisan firevel:generate app.yaml`
5. Deploy project with `gcloud beta app deploy`

Firevel does not require any credentials while running inside App Engine. If you like to run it locally you will also need to set `GOOGLE_CLOUD_PROJECT` and `GOOGLE_APPLICATION_CREDENTIALS` .env variables. You might also need to enable App Engine Admin API.

Local Development with Docker and Buildpacks
--------------------------------------------

[](#local-development-with-docker-and-buildpacks)

### Building the Image

[](#building-the-image)

To replicate the production environment for local development, you can utilize Buildpacks. Use the [pack](https://buildpacks.io/docs/tools/pack/) command with specific environment variables:

```
pack build your_image_name --env=GOOGLE_COMPOSER_ARGS=--dev --builder=gcr.io/buildpacks/builder:v1
```

Once the image is built, it can be integrated with Docker, typically through a `docker-compose.yaml` file.

### Configuration

[](#configuration)

You can configure PHP extensions for development mode using the `php.local.ini` file. This allows for customized behavior during local development.

### Accessing the Container Environment

[](#accessing-the-container-environment)

To execute PHP commands within the container, use the `/cnb/lifecycle/launcher`. For instance:

```
/cnb/lifecycle/launcher php route:list
```

For those looking to utilize Composer within the container, it comes pre-installed. Access it with:

```
/cnb/lifecycle/launcher php vendor/bin/composer
```

### Laravel Tinker

[](#laravel-tinker)

To run Laravel Tinker, execute the following command:

```
/cnb/lifecycle/launcher php artisan tinker
```

For MacBook users, ensure the `TERM` variable is set correctly. As an example:

```
docker exec -e TERM=$TERM -it your_container_name /cnb/lifecycle/launcher php artisan tinker
```

Differences between [Laravel](https://laravel.com) and Firevel.
---------------------------------------------------------------

[](#differences-between-laravel-and-firevel)

Firevel is a Laravel 12 after small updates and packages installation:

- [Firestore Session driver](https://github.com/firevel/firestore-session-driver)
- [Firestore Cache driver](https://github.com/firevel/firestore-cache-driver)
- [Laravel Firestore wrapper](https://github.com/firevel/firestore)

Usage
-----

[](#usage)

You can use Firevel in the same way you use Laravel. Be aware of [Firebase limits](https://firebase.google.com/docs/firestore/quotas) and [Google App Engine limits](https://cloud.google.com/appengine/docs/standard/php7/runtime).

### File Storage

[](#file-storage)

By default Firevel running inside App Engine is using [Google Cloud Storage file system](https://github.com/Superbalist/laravel-google-cloud-storage), and `{GOOGLE_CLOUD_PROJECT}.appspot.com/services/{GAE_SERVICE}/storage/` path.

### Logging

[](#logging)

If you are using `app.yaml` generated by `firevel:generate app` your logs going to be stored in Stackdriver.

### Artisan

[](#artisan)

To run artisan commands inside serverless containers, install .

### Workers

[](#workers)

If you are going to use serverless workers, install .

Roadmap
-------

[](#roadmap)

- CI generator as separate package.
- Improved MySQL handling (socket connections + passwordless authentication).

More
----

[](#more)

- [Serverless PHP on App Engine + Cloud Firestore with Firevel](https://medium.com/firebase-developers/serverless-php-on-app-engine-firestore-c22a119dc608)
- [App Engine documentation](https://cloud.google.com/appengine/docs/standard/php7/)
- [How Requests are Routed](https://cloud.google.com/appengine/docs/standard/php7/how-requests-are-routed)
- [Get to know Cloud Firestore](https://www.youtube.com/watch?v=v_hR4K4auoQ&list=PLl-K7zZEsYLluG5MCVEzXAQ7ACZBCuZgZ)

Credits
-------

[](#credits)

- [Taylor Otwell](https://medium.com/@taylorotwell) - for building Laravel.
- [SpringboardVR](https://springboardvr.com/) - for allowing this project to happen by providing initial production case.
- [Google Cloud](https://cloud.google.com/) - for building great products.

###  Health Score

54

—

FairBetter than 97% of packages

Maintenance72

Regular maintenance activity

Popularity31

Limited adoption so far

Community17

Small or concentrated contributor base

Maturity80

Battle-tested with a long release history

 Bus Factor1

Top contributor holds 75.7% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~215 days

Total

12

Last Release

115d ago

Major Versions

7.0.1 → 8.0.02023-03-15

8.0.0 → 9.0.02023-08-15

9.0.0 → 10.0.02023-08-18

10.2.7 → 11.3.32025-02-19

11.3.3 → 12.0.02025-10-11

PHP version history (7 changes)5.8.0PHP ^7.1.3

7.0.0PHP ^7.2

7.0.1PHP ^7.2.5|^8.0

8.0.0PHP ^7.3|^8.0

9.0.0PHP 8.1.\*

10.0.0PHP ^8.1

11.3.3PHP ^8.2

### Community

Maintainers

![](https://www.gravatar.com/avatar/3ef4a79c6f9a9afe04267a19b98fe0a5a45930c92d08fd720b233ab21ae102ca?d=identicon)[sl0wik](/maintainers/sl0wik)

---

Top Contributors

[![sl0wik](https://avatars.githubusercontent.com/u/2696038?v=4)](https://github.com/sl0wik "sl0wik (230 commits)")[![laravel-shift](https://avatars.githubusercontent.com/u/15991828?v=4)](https://github.com/laravel-shift "laravel-shift (73 commits)")[![GrahamCampbell](https://avatars.githubusercontent.com/u/2829600?v=4)](https://github.com/GrahamCampbell "GrahamCampbell (1 commits)")

---

Tags

frameworklaravelgcpapp enginefirevel

###  Code Quality

TestsPHPUnit

Code StyleLaravel Pint

### Embed Badge

![Health badge](/badges/firevel-firevel/health.svg)

```
[![Health](https://phpackages.com/badges/firevel-firevel/health.svg)](https://phpackages.com/packages/firevel-firevel)
```

###  Alternatives

[codewithdennis/larament

Larament is a time-saving starter kit to quickly launch Laravel 13.x projects. It includes FilamentPHP 5.x pre-installed and configured, along with additional tools and features to streamline your development workflow.

3691.5k](/packages/codewithdennis-larament)[ercogx/laravel-filament-starter-kit

This is a Filament v3 Starter Kit for Laravel 12, designed to accelerate the development of Filament-powered applications.

401.5k](/packages/ercogx-laravel-filament-starter-kit)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)