Download the PHP package sbasu/laravel-actuator without Composer

On this page you can find all versions of the php package sbasu/laravel-actuator. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
Some PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

  • Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
  • To use Composer is sometimes complicated. Especially for beginners.
  • Composer needs much resources. Sometimes they are not available on a simple webspace.
  • If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
  • Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Please rate this library. Is it a good library?

Informations about the package laravel-actuator

Laravel Actuator

Spring Boot Actuator-like monitoring endpoints for Laravel applications.

Latest Version on Packagist License PHP Version Laravel Version

Overview

Laravel Actuator provides production-ready HTTP endpoints to monitor and manage your Laravel application. Inspired by Spring Boot Actuator, it brings enterprise-grade monitoring to Laravel.

Get instant visibility into your app's health, performance metrics, and configuration.

Why Laravel Actuator?

Requirements

Installation

Step 1: Install via Composer

Step 2: Publish Configuration (Required)

This creates config/actuator.php in your application where you can customize behavior.

Step 3: Verify Installation

Start your Laravel server:

Test the health endpoint:

You should see a JSON response with status "UP".

Usage

Once installed and configured, your Laravel app automatically has monitoring endpoints available.

1. Health Check Endpoint

Check if your application and all dependencies are healthy.

Request:

Response:

Use Cases:


2. Metrics Endpoint

List available performance metrics and monitoring data.

Request:

Response:

Use Cases:


3. Application Info Endpoint

Get metadata about your application.

Request:

Response:

Use Cases:


4. Environment Variables Endpoint

View environment configuration. Disabled by default for security.

Enabling the Endpoint

Follow these steps to enable (development environments only):

Step 1: Open your .env file

Step 2: Add this line

ACTUATOR_SHOW_ENV=true

Step 3: Restart your server

Step 4: Test the endpoint

Example Response

⚠️ Security Warning

NEVER enable this endpoint in production!

Environment variables may contain:

Only enable in development environments.


Configuration

Edit config/actuator.php to customize the package behavior:

Configuration Options

Option Default Purpose
path actuator URI prefix for endpoints
middleware ['api'] Middleware to apply
indicators.database true Enable database health check
indicators.disk_space true Enable disk space check
indicators.cache true Enable cache health check
indicators.queue true Enable queue health check
show_details true Show detailed health info
show_env false Enable environment endpoint
log_access false Log endpoint requests

Real-World Examples

Kubernetes Deployment

Docker Health Check

Prometheus Monitoring

Load Balancer Health Check (Nginx)


Endpoints Reference

Endpoint Method Purpose Returns Status
/actuator/health GET Application health JSON with status 200/503
/actuator/metrics GET Available metrics JSON array 200
/actuator/info GET App information JSON metadata 200
/actuator/env GET Environment variables JSON config 200/403

Security Best Practices

Health Endpoints

Environment Endpoint

Protecting Endpoints

If you want authentication on actuator endpoints, edit config/actuator.php:

Option 1: Require API Authentication

Option 2: Rate Limiting

Option 3: Custom Middleware


Troubleshooting

Endpoints Return 404

Problem: Getting "Route not found" when accessing endpoints

Solution: You must publish the configuration first

Then restart your server.


Config File Not Found

Problem: config/actuator.php doesn't exist

Solution: Run the publish command


Database Shows DOWN

Problem: Health check returns database status as DOWN

Solution: Check your database connection


Cannot Enable /env Endpoint

Problem: Still get 403 when ACTUATOR_SHOW_ENV=true

Solution: Restart your server after editing .env


Roadmap

This is the first in a series of Spring Boot → Laravel packages bringing enterprise patterns to Laravel:

Follow @sbasu on GitHub for updates.


Support


Reporting Issues

Found a bug or have a suggestion?

Please include details like:

The more information you provide, the faster we can help!


Contributing

Contributions are welcome! Please feel free to submit a Pull Request.


License

The MIT License (MIT). Please see LICENSE file for more information.


About

Built by Shantanu Basu.

Inspired by Spring Boot Actuator.

Made with ❤️ for the Laravel community.


All versions of laravel-actuator with dependencies

PHP Build Version
Package Version
Requires php Version ^8.1
laravel/framework Version ^10 || ^11 || ^12 || ^13
Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package sbasu/laravel-actuator contains the following files

Loading the files please wait ...