13 Commits
Author SHA1 Message Date
mathiaspalmqvist c1338fad8b Merge pull request 'Add support for Laravel 13' (#20) from laravel-13 into main
Fix PHP code style issues / php-code-styling (push) Successful in 6s
PHPStan / phpstan (push) Successful in 3m51s
run-tests / P8.3 - L11.* - prefer-lowest - ubuntu-latest (push) Failing after 34s
run-tests / P8.4 - L11.* - prefer-lowest - ubuntu-latest (push) Canceled after 0s
run-tests / P8.4 - L11.* - prefer-stable - ubuntu-latest (push) Canceled after 0s
run-tests / P8.3 - L12.* - prefer-lowest - ubuntu-latest (push) Canceled after 0s
run-tests / P8.3 - L12.* - prefer-stable - ubuntu-latest (push) Canceled after 0s
run-tests / P8.4 - L12.* - prefer-lowest - ubuntu-latest (push) Canceled after 0s
run-tests / P8.4 - L12.* - prefer-stable - ubuntu-latest (push) Canceled after 0s
run-tests / P8.3 - L13.* - prefer-lowest - ubuntu-latest (push) Canceled after 0s
run-tests / P8.3 - L13.* - prefer-stable - ubuntu-latest (push) Canceled after 0s
run-tests / P8.4 - L13.* - prefer-lowest - ubuntu-latest (push) Canceled after 0s
run-tests / P8.4 - L13.* - prefer-stable - ubuntu-latest (push) Canceled after 0s
run-tests / P8.3 - L11.* - prefer-stable - ubuntu-latest (push) Canceled after 2s
Reviewed-on: Github/laravel-plausible-proxy#20
2026-11-12 07:32:30 +00:00
mathiaspalmqvist f235fa0aaa Merge branch 'main' into laravel-13
dependabot-auto-merge / dependabot (pull_request_target) Skipped
Fix PHP code style issues / php-code-styling (push) Successful in 6s
PHPStan / phpstan (push) Successful in 2m42s
run-tests / P8.3 - L11.* - prefer-lowest - ubuntu-latest (push) Failing after 32s
run-tests / P8.4 - L11.* - prefer-lowest - ubuntu-latest (push) Canceled after 0s
run-tests / P8.4 - L11.* - prefer-stable - ubuntu-latest (push) Canceled after 0s
run-tests / P8.3 - L12.* - prefer-lowest - ubuntu-latest (push) Canceled after 0s
run-tests / P8.3 - L12.* - prefer-stable - ubuntu-latest (push) Canceled after 0s
run-tests / P8.4 - L12.* - prefer-lowest - ubuntu-latest (push) Canceled after 0s
run-tests / P8.4 - L12.* - prefer-stable - ubuntu-latest (push) Canceled after 0s
run-tests / P8.3 - L13.* - prefer-lowest - ubuntu-latest (push) Canceled after 0s
run-tests / P8.3 - L13.* - prefer-stable - ubuntu-latest (push) Canceled after 0s
run-tests / P8.4 - L13.* - prefer-lowest - ubuntu-latest (push) Canceled after 0s
run-tests / P8.4 - L13.* - prefer-stable - ubuntu-latest (push) Canceled after 0s
run-tests / P8.3 - L11.* - prefer-stable - ubuntu-latest (push) Canceled after 2s
2026-11-12 07:32:26 +00:00
mathiaspalmqvist 8e7bff9e61 Add support for Laravel 13
dependabot-auto-merge / dependabot (pull_request_target) Skipped
run-tests / P8.3 - L11.* - prefer-lowest - ubuntu-latest (push) Failing after 33s
run-tests / P8.4 - L11.* - prefer-lowest - ubuntu-latest (push) Canceled after 0s
run-tests / P8.4 - L11.* - prefer-stable - ubuntu-latest (push) Canceled after 0s
run-tests / P8.3 - L12.* - prefer-lowest - ubuntu-latest (push) Canceled after 0s
run-tests / P8.3 - L12.* - prefer-stable - ubuntu-latest (push) Canceled after 0s
run-tests / P8.4 - L12.* - prefer-lowest - ubuntu-latest (push) Canceled after 0s
run-tests / P8.4 - L12.* - prefer-stable - ubuntu-latest (push) Canceled after 0s
run-tests / P8.3 - L13.* - prefer-lowest - ubuntu-latest (push) Canceled after 0s
run-tests / P8.3 - L13.* - prefer-stable - ubuntu-latest (push) Canceled after 0s
run-tests / P8.4 - L13.* - prefer-lowest - ubuntu-latest (push) Canceled after 0s
run-tests / P8.4 - L13.* - prefer-stable - ubuntu-latest (push) Canceled after 0s
run-tests / P8.3 - L11.* - prefer-stable - ubuntu-latest (push) Canceled after 1s
- Allow illuminate/contracts ^13.0
- Allow orchestra/testbench ^11.0 and Pest 4 (with plugins) for dev
- Add Laravel 13 to the CI test matrix
- Update requirements in README
2026-11-12 08:31:34 +01:00
mathiaspalmqvist 77c0e38f84 Merge pull request 'Support custom Plausible script path' (#19) from issue-14-custom-script-path into main
PHPStan / phpstan (push) Successful in 2m41s
Fix PHP code style issues / php-code-styling (push) Successful in 6s
run-tests / P8.3 - L11.* - prefer-lowest - ubuntu-latest (push) Failing after 32s
run-tests / P8.4 - L11.* - prefer-lowest - ubuntu-latest (push) Canceled after 0s
run-tests / P8.4 - L11.* - prefer-stable - ubuntu-latest (push) Canceled after 0s
run-tests / P8.3 - L12.* - prefer-lowest - ubuntu-latest (push) Canceled after 0s
run-tests / P8.3 - L12.* - prefer-stable - ubuntu-latest (push) Canceled after 0s
run-tests / P8.4 - L12.* - prefer-lowest - ubuntu-latest (push) Canceled after 0s
run-tests / P8.4 - L12.* - prefer-stable - ubuntu-latest (push) Canceled after 0s
run-tests / P8.3 - L11.* - prefer-stable - ubuntu-latest (push) Canceled after 2s
Reviewed-on: Github/laravel-plausible-proxy#19
2026-11-12 07:29:22 +00:00
mathiaspalmqvist 91429ccd22 Merge branch 'main' into issue-14-custom-script-path
dependabot-auto-merge / dependabot (pull_request_target) Skipped
2026-11-12 07:29:12 +00:00
mathiaspalmqvist 513ceb61a0 Support custom Plausible script path
dependabot-auto-merge / dependabot (pull_request_target) Skipped
Fix PHP code style issues / php-code-styling (push) Successful in 6s
PHPStan / phpstan (push) Successful in 2m32s
run-tests / P8.3 - L11.* - prefer-lowest - ubuntu-latest (push) Failing after 34s
run-tests / P8.4 - L11.* - prefer-lowest - ubuntu-latest (push) Canceled after 0s
run-tests / P8.4 - L11.* - prefer-stable - ubuntu-latest (push) Canceled after 0s
run-tests / P8.3 - L12.* - prefer-lowest - ubuntu-latest (push) Canceled after 0s
run-tests / P8.3 - L12.* - prefer-stable - ubuntu-latest (push) Canceled after 0s
run-tests / P8.4 - L12.* - prefer-lowest - ubuntu-latest (push) Canceled after 0s
run-tests / P8.4 - L12.* - prefer-stable - ubuntu-latest (push) Canceled after 0s
run-tests / P8.3 - L11.* - prefer-stable - ubuntu-latest (push) Canceled after 2s
Add a PLAUSIBLE_SCRIPT config option so site-specific scripts
(js/pa-XXXXX.js) and legacy script extensions can be proxied. The
script is still served locally from /js/script.js and the cache key
is derived from the script URL so changing the script takes effect
immediately.

Closes #14
2026-11-12 08:27:43 +01:00
mathiaspalmqvist 711c4eafbc Merge pull request 'Rename package to mattitja/laravel-plausible-proxy (v2.0)' (#18) from rename-to-mattitja into main
PHPStan / phpstan (push) Successful in 2m37s
run-tests / P8.3 - L11.* - prefer-lowest - ubuntu-latest (push) Failing after 33s
Fix PHP code style issues / php-code-styling (push) Successful in 6s
run-tests / P8.4 - L11.* - prefer-lowest - ubuntu-latest (push) Canceled after 0s
run-tests / P8.4 - L11.* - prefer-stable - ubuntu-latest (push) Canceled after 0s
run-tests / P8.3 - L12.* - prefer-lowest - ubuntu-latest (push) Canceled after 0s
run-tests / P8.3 - L12.* - prefer-stable - ubuntu-latest (push) Canceled after 0s
run-tests / P8.4 - L12.* - prefer-lowest - ubuntu-latest (push) Canceled after 0s
run-tests / P8.4 - L12.* - prefer-stable - ubuntu-latest (push) Canceled after 0s
run-tests / P8.3 - L11.* - prefer-stable - ubuntu-latest (push) Canceled after 2s
Reviewed-on: Github/laravel-plausible-proxy#18
2026-11-12 07:25:41 +00:00
mathiaspalmqvist a60e4cbdcf Rename package to mattitja/laravel-plausible-proxy
dependabot-auto-merge / dependabot (pull_request_target) Skipped
PHPStan / phpstan (push) Successful in 2m32s
run-tests / P8.3 - L11.* - prefer-lowest - ubuntu-latest (push) Failing after 34s
Fix PHP code style issues / php-code-styling (push) Successful in 6s
run-tests / P8.4 - L11.* - prefer-lowest - ubuntu-latest (push) Canceled after 0s
run-tests / P8.4 - L11.* - prefer-stable - ubuntu-latest (push) Canceled after 0s
run-tests / P8.3 - L12.* - prefer-lowest - ubuntu-latest (push) Canceled after 0s
run-tests / P8.3 - L12.* - prefer-stable - ubuntu-latest (push) Canceled after 0s
run-tests / P8.4 - L12.* - prefer-lowest - ubuntu-latest (push) Canceled after 0s
run-tests / P8.4 - L12.* - prefer-stable - ubuntu-latest (push) Canceled after 0s
run-tests / P8.3 - L11.* - prefer-stable - ubuntu-latest (push) Canceled after 2s
- Rename Composer package to mattitja/laravel-plausible-proxy and
  namespace to Mattitja\LaravelPlausibleProxy
- Point homepage and links to git.mattitja.se
- Forward only User-Agent and visitor IP (X-Forwarded-For) to Plausible
  instead of all request headers
- Forward all event fields and return Plausible's upstream response
- Accept props as array or JSON string
- Drop Laravel 10, upgrade Larastan to 3 and PHPStan plugins to 2
- Remove broken facade alias and dead autoload paths
- Clean up README, issue template and remove invalid FUNDING.yml
2026-11-12 08:24:45 +01:00
github-actions[bot] 7f8eff628f Merge pull request #13 from MattitjaAB/dependabot/github_actions/dependabot/fetch-metadata-2.5.0
Bump dependabot/fetch-metadata from 2.4.0 to 2.5.0
2026-01-12 03:59:10 +00:00
dependabot[bot] 2196ec5d2d Bump dependabot/fetch-metadata from 2.4.0 to 2.5.0
Bumps [dependabot/fetch-metadata](https://github.com/dependabot/fetch-metadata) from 2.4.0 to 2.5.0.
- [Release notes](https://github.com/dependabot/fetch-metadata/releases)
- [Commits](https://github.com/dependabot/fetch-metadata/compare/v2.4.0...v2.5.0)

---
updated-dependencies:
- dependency-name: dependabot/fetch-metadata
  dependency-version: 2.5.0
  dependency-type: direct:production
  update-type: version-update:semver-minor
...

Signed-off-by: dependabot[bot] <support@github.com>
2026-01-12 03:58:59 +00:00
github-actions[bot] 364fbe7b4b Merge pull request #9 from MattitjaAB/dependabot/github_actions/aglipanci/laravel-pint-action-2.6
Bump aglipanci/laravel-pint-action from 2.5 to 2.6
2025-07-28 04:38:19 +00:00
dependabot[bot] 576c9803dc Bump aglipanci/laravel-pint-action from 2.5 to 2.6
Bumps [aglipanci/laravel-pint-action](https://github.com/aglipanci/laravel-pint-action) from 2.5 to 2.6.
- [Release notes](https://github.com/aglipanci/laravel-pint-action/releases)
- [Commits](https://github.com/aglipanci/laravel-pint-action/compare/2.5...2.6)

---
updated-dependencies:
- dependency-name: aglipanci/laravel-pint-action
  dependency-version: '2.6'
  dependency-type: direct:production
  update-type: version-update:semver-minor
...

Signed-off-by: dependabot[bot] <support@github.com>
2025-07-28 04:38:10 +00:00
mathiaspalmqvist f451d4f0b8 Update CHANGELOG 2025-06-25 19:36:20 +00:00
20 changed files with 253 additions and 141 deletions

No files matched your search

-1
View File
@@ -1 +0,0 @@
github: Mattitja AB
+5 -8
View File
@@ -1,11 +1,8 @@
blank_issues_enabled: false blank_issues_enabled: false
contact_links: contact_links:
- name: Ask a question - name: Ask a question or request a feature
url: https://github.com/mattitjaab/laravel-plausible-proxy/discussions/new?category=q-a url: https://git.mattitja.se/Github/laravel-plausible-proxy/issues
about: Ask the community for help about: Open an issue in the repository
- name: Request a feature
url: https://github.com/mattitjaab/laravel-plausible-proxy/discussions/new?category=ideas
about: Share ideas for new features
- name: Report a security issue - name: Report a security issue
url: https://github.com/mattitjaab/laravel-plausible-proxy/security/policy url: mailto:hej@mattitja.se
about: Learn how to notify us for sensitive bugs about: Please report security issues privately by email
+1 -1
View File
@@ -14,7 +14,7 @@ jobs:
- name: Dependabot metadata - name: Dependabot metadata
id: metadata id: metadata
uses: dependabot/fetch-metadata@v2.4.0 uses: dependabot/fetch-metadata@v2.5.0
with: with:
github-token: "${{ secrets.GITHUB_TOKEN }}" github-token: "${{ secrets.GITHUB_TOKEN }}"
@@ -20,7 +20,7 @@ jobs:
ref: ${{ github.head_ref }} ref: ${{ github.head_ref }}
- name: Fix PHP code style issues - name: Fix PHP code style issues
uses: aglipanci/laravel-pint-action@2.5 uses: aglipanci/laravel-pint-action@2.6
- name: Commit changes - name: Commit changes
uses: stefanzweifel/git-auto-commit-action@v5 uses: stefanzweifel/git-auto-commit-action@v5
+9 -5
View File
@@ -18,7 +18,7 @@ jobs:
matrix: matrix:
os: [ubuntu-latest] os: [ubuntu-latest]
php: [8.3, 8.4] php: [8.3, 8.4]
laravel: [11.*, 12.*] laravel: [11.*, 12.*, 13.*]
stability: [prefer-lowest, prefer-stable] stability: [prefer-lowest, prefer-stable]
include: include:
- laravel: 11.* - laravel: 11.*
@@ -37,6 +37,14 @@ jobs:
php: 8.4 php: 8.4
testbench: 10.* testbench: 10.*
carbon: ^3.8.4 carbon: ^3.8.4
- laravel: 13.*
php: 8.3
testbench: 11.*
carbon: ^3.8.4
- laravel: 13.*
php: 8.4
testbench: 11.*
carbon: ^3.8.4
name: P${{ matrix.php }} - L${{ matrix.laravel }} - ${{ matrix.stability }} - ${{ matrix.os }} name: P${{ matrix.php }} - L${{ matrix.laravel }} - ${{ matrix.stability }} - ${{ matrix.os }}
@@ -56,10 +64,6 @@ jobs:
echo "::add-matcher::${{ runner.tool_cache }}/php.json" echo "::add-matcher::${{ runner.tool_cache }}/php.json"
echo "::add-matcher::${{ runner.tool_cache }}/phpunit.json" echo "::add-matcher::${{ runner.tool_cache }}/phpunit.json"
- name: Remove Larastan if Laravel 12
if: startsWith(matrix.laravel, '12.')
run: composer remove larastan/larastan --dev --no-update || true
- name: Install dependencies - name: Install dependencies
run: | run: |
composer require \ composer require \
+8
View File
@@ -2,6 +2,14 @@
All notable changes to `laravel-plausible-proxy` will be documented in this file. All notable changes to `laravel-plausible-proxy` will be documented in this file.
## v1.5 - 2025-06-25
### What's Changed
* Cleanup by @mathiaspalmqvist in https://github.com/MattitjaAB/laravel-plausible-proxy/pull/8
**Full Changelog**: https://github.com/MattitjaAB/laravel-plausible-proxy/compare/v1.4...v1.5
## v1.4 - 2025-06-16 ## v1.4 - 2025-06-16
### What's Changed ### What's Changed
+66 -29
View File
@@ -1,21 +1,22 @@
# laravel-plausible-proxy # laravel-plausible-proxy
[![Latest Version on Packagist](https://img.shields.io/packagist/v/mattitjaab/laravel-plausible-proxy.svg?style=flat-square)](https://packagist.org/packages/mattitjaab/laravel-plausible-proxy) [![Latest Version on Packagist](https://img.shields.io/packagist/v/mattitja/laravel-plausible-proxy.svg?style=flat-square)](https://packagist.org/packages/mattitja/laravel-plausible-proxy)
[![GitHub Tests Action Status](https://img.shields.io/github/actions/workflow/status/mattitjaab/laravel-plausible-proxy/run-tests.yml?branch=main&label=tests&style=flat-square)](https://github.com/mattitjaab/laravel-plausible-proxy/actions?query=workflow%3Arun-tests+branch%3Amain) [![Tests](https://git.mattitja.se/Github/laravel-plausible-proxy/actions/workflows/run-tests.yml/badge.svg?branch=main)](https://git.mattitja.se/Github/laravel-plausible-proxy/actions?workflow=run-tests.yml)
[![GitHub Code Style Action Status](https://img.shields.io/github/actions/workflow/status/mattitjaab/laravel-plausible-proxy/fix-php-code-style-issues.yml?branch=main&label=code%20style&style=flat-square)](https://github.com/mattitjaab/laravel-plausible-proxy/actions?query=workflow%3A"Fix+PHP+code+style+issues"+branch%3Amain) [![Code Style](https://git.mattitja.se/Github/laravel-plausible-proxy/actions/workflows/fix-php-code-style-issues.yml/badge.svg?branch=main)](https://git.mattitja.se/Github/laravel-plausible-proxy/actions?workflow=fix-php-code-style-issues.yml)
[![Total Downloads](https://img.shields.io/packagist/dt/mattitjaab/laravel-plausible-proxy.svg?style=flat-square)](https://packagist.org/packages/mattitjaab/laravel-plausible-proxy) [![Total Downloads](https://img.shields.io/packagist/dt/mattitja/laravel-plausible-proxy.svg?style=flat-square)](https://packagist.org/packages/mattitja/laravel-plausible-proxy)
A Laravel package for proxying Plausible Analytics, improving performance. A Laravel package for proxying Plausible Analytics, improving performance and privacy.
## Requirements ## Requirements
- Laravel 12
- PHP 8.3, 8.4
## 🚀 Installation - Laravel 11, 12 or 13
- PHP 8.3 or 8.4
## Installation
1. Install the package via Composer: 1. Install the package via Composer:
```sh ```sh
composer require mattitjaab/laravel-plausible-proxy composer require mattitja/laravel-plausible-proxy
``` ```
2. Publish the configuration file: 2. Publish the configuration file:
@@ -23,45 +24,86 @@ A Laravel package for proxying Plausible Analytics, improving performance.
php artisan vendor:publish --tag=plausible-proxy-config php artisan vendor:publish --tag=plausible-proxy-config
``` ```
3. Add the following environment variables to your `.env` file: 3. Add the following environment variable to your `.env` file:
```env ```env
PLAUSIBLE_DOMAIN=https://plausible.io PLAUSIBLE_DOMAIN=https://plausible.io
``` ```
## ⚙️ Configuration ## Configuration
The `config/plausible-proxy.php` file allows you to customize the plausible domain: The `config/plausible-proxy.php` file allows you to customize the Plausible domain:
```php ```php
return [ return [
'domain' => env('PLAUSIBLE_DOMAIN', 'https://plausible.io'), 'domain' => env('PLAUSIBLE_DOMAIN', 'https://plausible.io'),
'script' => env('PLAUSIBLE_SCRIPT', 'js/script.js'),
]; ];
``` ```
## 🔥 Usage `PLAUSIBLE_SCRIPT` is the path of the script on your Plausible instance. Whatever script you choose, it is always served locally from `/js/script.js`.
## Usage
### 1. Proxying the JavaScript file
### **1. Proxying the JavaScript file**
This package proxies Plausible's `script.js` while caching it to improve performance and reduce external requests. This package proxies Plausible's `script.js` while caching it to improve performance and reduce external requests.
After installation, you can include the script like this: After installation, you can include the script like this:
```html ```html
<script defer data-domain="example.com" src="/js/script.js"></script> <script defer data-domain="example.com" src="/js/script.js"></script>
``` ```
The route `/js/script.js` is automatically handled and caches the script for **6 hours**. The route `/js/script.js` is handled automatically and caches the script for 6 hours.
### **2. Sending Events to Plausible** #### Site-specific script (pa-XXXXX.js)
Instead of sending events directly to plausible.io, the script is loaded from /js/script.js and proxies the request to Plausible via /api/event, helping to prevent blocking by ad blockers.
## ✅ Features Plausible's current installation instructions use a site-specific script such as `https://plausible.io/js/pa-12345ABCDE.js`, where optional measurements (outbound links, file downloads, etc.) are configured in the Plausible dashboard. To use it, set the script path in your `.env`:
- 🚀 **Fast & Optimized**: Caches the Plausible script to reduce external calls. ```env
- ✅ No issues with ad blockers: Proxies the request via a local API endpoint. PLAUSIBLE_SCRIPT=js/pa-12345ABCDE.js
- 🛠 **Fully Configurable**: Easily set your own Plausible instance via `.env`. ```
## 🛠 Testing Then load it locally and tell it to send events through the proxy with the `endpoint` option:
```html
<script async src="/js/script.js"></script>
<script>
window.plausible=window.plausible||function(){(plausible.q=plausible.q||[]).push(arguments)},plausible.init=plausible.init||function(i){plausible.o=i||{}};
plausible.init({ endpoint: '/api/event' })
</script>
```
#### Legacy script extensions
Legacy script variants work the same way, for example:
```env
PLAUSIBLE_SCRIPT=js/script.outbound-links.js
```
### 2. Sending events to Plausible
The script loaded from `/js/script.js` sends events to `/api/event` on your own domain, which forwards them to Plausible. This helps prevent blocking by ad blockers.
Only the visitor's `User-Agent` and IP address (as `X-Forwarded-For`) are forwarded to Plausible, which is what Plausible needs to count unique visitors. Cookies and other request headers are never forwarded.
If your application runs behind a load balancer or reverse proxy, make sure Laravel's [trusted proxies](https://laravel.com/docs/requests#configuring-trusted-proxies) are configured so the correct visitor IP is resolved.
## Upgrading from mattitjaab/laravel-plausible-proxy
Version 2.0 renames the package and its namespace:
1. Replace the package:
```sh
composer remove mattitjaab/laravel-plausible-proxy
composer require mattitja/laravel-plausible-proxy
```
2. If you reference any package classes directly, change the namespace from `MattitjaAB\LaravelPlausibleProxy` to `Mattitja\LaravelPlausibleProxy`.
3. Laravel 10 is no longer supported.
## Testing
You can run tests with:
```sh ```sh
composer test composer test
``` ```
@@ -70,18 +112,13 @@ composer test
Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently. Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently.
## Contributing
Please see [CONTRIBUTING](CONTRIBUTING.md) for details.
## Security Vulnerabilities ## Security Vulnerabilities
Please review [our security policy](../../security/policy) on how to report security vulnerabilities. Please report security vulnerabilities by email to hej@mattitja.se.
## Credits ## Credits
- [Mathias Palmqvist](https://github.com/mathiaspalmqvist) - [Mathias Palmqvist](https://github.com/mathiaspalmqvist)
- [All Contributors](../../contributors)
## License ## License
+16 -22
View File
@@ -1,14 +1,13 @@
{ {
"name": "mattitjaab/laravel-plausible-proxy", "name": "mattitja/laravel-plausible-proxy",
"description": "A Laravel package for proxying Plausible Analytics, improving performance and privacy.", "description": "A Laravel package for proxying Plausible Analytics, improving performance and privacy.",
"keywords": [ "keywords": [
"Mattitja AB", "Mattitja",
"MattitjaAB",
"laravel", "laravel",
"laravel-plausible-proxy", "laravel-plausible-proxy",
"plausible" "plausible"
], ],
"homepage": "https://github.com/mattitjaab/laravel-plausible-proxy", "homepage": "https://git.mattitja.se/Github/laravel-plausible-proxy",
"license": "MIT", "license": "MIT",
"authors": [ "authors": [
{ {
@@ -20,31 +19,29 @@
"require": { "require": {
"php": "^8.3", "php": "^8.3",
"spatie/laravel-package-tools": "^1.16", "spatie/laravel-package-tools": "^1.16",
"illuminate/contracts": "^10.0||^11.0||^12.0" "illuminate/contracts": "^11.0||^12.0||^13.0"
}, },
"require-dev": { "require-dev": {
"laravel/pint": "^1.14", "laravel/pint": "^1.14",
"nunomaduro/collision": "^8.1.1||^7.10.0", "nunomaduro/collision": "^8.1",
"larastan/larastan": "^2.9", "larastan/larastan": "^3.0",
"orchestra/testbench": "^9.0.0||^8.22.0", "orchestra/testbench": "^9.0||^10.0||^11.0",
"pestphp/pest": "^3.0", "pestphp/pest": "^3.0||^4.0",
"pestphp/pest-plugin-arch": "^3.0", "pestphp/pest-plugin-arch": "^3.0||^4.0",
"pestphp/pest-plugin-laravel": "^3.0", "pestphp/pest-plugin-laravel": "^3.0||^4.0",
"phpstan/extension-installer": "^1.3", "phpstan/extension-installer": "^1.3",
"phpstan/phpstan-deprecation-rules": "^1.1", "phpstan/phpstan-deprecation-rules": "^2.0",
"phpstan/phpstan-phpunit": "^1.3", "phpstan/phpstan-phpunit": "^2.0",
"spatie/laravel-ray": "^1.35" "spatie/laravel-ray": "^1.35"
}, },
"autoload": { "autoload": {
"psr-4": { "psr-4": {
"MattitjaAB\\LaravelPlausibleProxy\\": "src/", "Mattitja\\LaravelPlausibleProxy\\": "src/"
"MattitjaAB\\LaravelPlausibleProxy\\Database\\Factories\\": "database/factories/"
} }
}, },
"autoload-dev": { "autoload-dev": {
"psr-4": { "psr-4": {
"MattitjaAB\\LaravelPlausibleProxy\\Tests\\": "tests/", "Mattitja\\LaravelPlausibleProxy\\Tests\\": "tests/"
"Workbench\\App\\": "workbench/app/"
} }
}, },
"scripts": { "scripts": {
@@ -65,11 +62,8 @@
"extra": { "extra": {
"laravel": { "laravel": {
"providers": [ "providers": [
"MattitjaAB\\LaravelPlausibleProxy\\LaravelPlausibleProxyServiceProvider" "Mattitja\\LaravelPlausibleProxy\\LaravelPlausibleProxyServiceProvider"
], ]
"aliases": {
"LaravelPlausibleProxy": "MattitjaAB\\LaravelPlausibleProxy\\Facades\\LaravelPlausibleProxy"
}
} }
}, },
"minimum-stability": "dev", "minimum-stability": "dev",
+12
View File
@@ -3,5 +3,17 @@
// Config for Laravel Plausible Proxy // Config for Laravel Plausible Proxy
return [ return [
/*
* The Plausible instance to proxy, e.g. https://plausible.io or your
* self-hosted instance.
*/
'domain' => env('PLAUSIBLE_DOMAIN', 'https://plausible.io'), 'domain' => env('PLAUSIBLE_DOMAIN', 'https://plausible.io'),
/*
* Path of the script to fetch from the Plausible instance. Use this for
* site-specific scripts (e.g. js/pa-12345ABCDE.js) or legacy script
* extensions (e.g. js/script.outbound-links.js). The script is always
* served locally from /js/script.js.
*/
'script' => env('PLAUSIBLE_SCRIPT', 'js/script.js'),
]; ];
+4
View File
@@ -9,3 +9,7 @@ parameters:
tmpDir: build/phpstan tmpDir: build/phpstan
checkOctaneCompatibility: true checkOctaneCompatibility: true
checkModelProperties: true checkModelProperties: true
ignoreErrors:
-
identifier: larastan.noEnvCallsOutsideOfConfig
path: config/plausible-proxy.php
+1 -1
View File
@@ -16,7 +16,7 @@
backupStaticProperties="false" backupStaticProperties="false"
> >
<testsuites> <testsuites>
<testsuite name="MattitjaAB Test Suite"> <testsuite name="Mattitja Test Suite">
<directory>tests</directory> <directory>tests</directory>
</testsuite> </testsuite>
</testsuites> </testsuites>
+1 -1
View File
@@ -1,6 +1,6 @@
<?php <?php
use Illuminate\Support\Facades\Route; use Illuminate\Support\Facades\Route;
use MattitjaAB\LaravelPlausibleProxy\Http\Controllers\PlausibleEventApiController; use Mattitja\LaravelPlausibleProxy\Http\Controllers\PlausibleEventApiController;
Route::post('api/event', PlausibleEventApiController::class); Route::post('api/event', PlausibleEventApiController::class);
+1 -1
View File
@@ -1,6 +1,6 @@
<?php <?php
use Illuminate\Support\Facades\Route; use Illuminate\Support\Facades\Route;
use MattitjaAB\LaravelPlausibleProxy\Http\Controllers\PlausibleScriptProxyController; use Mattitja\LaravelPlausibleProxy\Http\Controllers\PlausibleScriptProxyController;
Route::get('/js/script.js', PlausibleScriptProxyController::class); Route::get('/js/script.js', PlausibleScriptProxyController::class);
@@ -1,22 +1,21 @@
<?php <?php
namespace MattitjaAB\LaravelPlausibleProxy\Http\Controllers; namespace Mattitja\LaravelPlausibleProxy\Http\Controllers;
use Illuminate\Http\JsonResponse; use Illuminate\Http\Response;
use Illuminate\Support\Facades\Http; use Illuminate\Support\Facades\Http;
use MattitjaAB\LaravelPlausibleProxy\Http\Requests\PlausibleEventRequest; use Mattitja\LaravelPlausibleProxy\Http\Requests\PlausibleEventRequest;
class PlausibleEventApiController class PlausibleEventApiController
{ {
public function __invoke(PlausibleEventRequest $request): JsonResponse public function __invoke(PlausibleEventRequest $request): Response
{ {
$headers = collect($request->headers->all()) $upstream = Http::withHeaders([
->mapWithKeys(fn ($value, $key) => [$key => implode(', ', $value)]) 'User-Agent' => (string) $request->userAgent(),
->all(); 'X-Forwarded-For' => (string) $request->ip(),
])->post(config('plausible-proxy.domain').'/api/event', $request->all());
Http::withHeaders($headers) return response($upstream->body(), $upstream->status())
->post(config('plausible-proxy.domain').'/api/event', $request->validated()); ->header('Content-Type', $upstream->header('Content-Type') ?: 'text/plain');
return response()->json(['status' => 'queued']);
} }
} }
@@ -1,6 +1,6 @@
<?php <?php
namespace MattitjaAB\LaravelPlausibleProxy\Http\Controllers; namespace Mattitja\LaravelPlausibleProxy\Http\Controllers;
use Illuminate\Http\Client\RequestException; use Illuminate\Http\Client\RequestException;
use Illuminate\Http\Response; use Illuminate\Http\Response;
@@ -12,18 +12,14 @@ class PlausibleScriptProxyController
{ {
public function __invoke(): Response public function __invoke(): Response
{ {
$url = rtrim((string) config('plausible-proxy.domain'), '/')
.'/'.ltrim((string) config('plausible-proxy.script', 'js/script.js'), '/');
try { try {
$script = Cache::remember( $script = Cache::remember(
key: 'plausible_script_js', key: 'plausible_script_js:'.md5($url),
ttl: now()->addHours(6), ttl: now()->addHours(6),
callback: function () { callback: fn () => Http::timeout(5)->get($url)->throw()->body(),
$plausibleDomain = config('plausible-proxy.domain');
return Http::timeout(5)
->get("{$plausibleDomain}/js/script.js")
->throw()
->body();
}
); );
} catch (RequestException $e) { } catch (RequestException $e) {
Log::error('Failed to fetch Plausible script: '.$e->getMessage()); Log::error('Failed to fetch Plausible script: '.$e->getMessage());
+10 -2
View File
@@ -1,6 +1,6 @@
<?php <?php
namespace MattitjaAB\LaravelPlausibleProxy\Http\Requests; namespace Mattitja\LaravelPlausibleProxy\Http\Requests;
use Illuminate\Foundation\Http\FormRequest; use Illuminate\Foundation\Http\FormRequest;
@@ -19,7 +19,15 @@ class PlausibleEventRequest extends FormRequest
'd' => ['required', 'string'], 'd' => ['required', 'string'],
'r' => ['nullable', 'url'], 'r' => ['nullable', 'url'],
'm' => ['nullable', 'string'], 'm' => ['nullable', 'string'],
'p' => ['nullable', 'array'], 'p' => ['nullable', function (string $attribute, mixed $value, \Closure $fail) {
if (is_array($value)) {
return;
}
if (! is_string($value) || ! is_array(json_decode($value, true))) {
$fail("The {$attribute} field must be an object or a JSON-encoded object.");
}
}],
]; ];
} }
} }
+1 -1
View File
@@ -1,6 +1,6 @@
<?php <?php
namespace MattitjaAB\LaravelPlausibleProxy; namespace Mattitja\LaravelPlausibleProxy;
use Spatie\LaravelPackageTools\Package; use Spatie\LaravelPackageTools\Package;
use Spatie\LaravelPackageTools\PackageServiceProvider; use Spatie\LaravelPackageTools\PackageServiceProvider;
+1 -1
View File
@@ -1,5 +1,5 @@
<?php <?php
use MattitjaAB\LaravelPlausibleProxy\Tests\TestCase; use Mattitja\LaravelPlausibleProxy\Tests\TestCase;
uses(TestCase::class)->in(__DIR__); uses(TestCase::class)->in(__DIR__);
+98 -34
View File
@@ -1,35 +1,65 @@
<?php <?php
use Illuminate\Support\Facades\Cache;
use Illuminate\Support\Facades\Http; use Illuminate\Support\Facades\Http;
it('returns plausible script from cache', function () { it('fetches plausible script and caches it', function () {
Cache::put('plausible_script_js', 'console.log("Cached script");', now()->addHours(6));
$response = $this->get('/js/script.js');
$response->assertStatus(200)
->assertHeader('Content-Type', 'application/javascript')
->assertSee('Cached script');
});
it('fetches plausible script if not cached', function () {
Http::fake([ Http::fake([
config('plausible-proxy.domain').'/js/script.js' => Http::response('console.log("Plausible script");', 200), 'https://plausible.io/js/script.js' => Http::response('console.log("Plausible script");', 200),
]); ]);
$response = $this->get('/js/script.js'); $this->get('/js/script.js')
->assertStatus(200)
$response->assertStatus(200)
->assertHeader('Content-Type', 'application/javascript') ->assertHeader('Content-Type', 'application/javascript')
->assertSee('Plausible script'); ->assertSee('Plausible script');
expect(Cache::get('plausible_script_js'))->toBe('console.log("Plausible script");'); $this->get('/js/script.js')
->assertStatus(200)
->assertSee('Plausible script');
Http::assertSentCount(1);
});
it('fetches a custom script path', function () {
config()->set('plausible-proxy.script', 'js/pa-12345ABCDE.js');
Http::fake([
'https://plausible.io/js/pa-12345ABCDE.js' => Http::response('console.log("Custom script");', 200),
]);
$this->get('/js/script.js')
->assertStatus(200)
->assertSee('Custom script');
Http::assertSent(fn ($request) => $request->url() === 'https://plausible.io/js/pa-12345ABCDE.js');
});
it('handles trailing and leading slashes in domain and script path', function () {
config()->set('plausible-proxy.domain', 'https://plausible.example.com/');
config()->set('plausible-proxy.script', '/js/script.outbound-links.js');
Http::fake([
'https://plausible.example.com/js/script.outbound-links.js' => Http::response('console.log("Outbound");', 200),
]);
$this->get('/js/script.js')->assertStatus(200)->assertSee('Outbound');
});
it('does not serve a cached script after the script path changes', function () {
Http::fake([
'https://plausible.io/js/script.js' => Http::response('console.log("Old script");', 200),
'https://plausible.io/js/pa-12345ABCDE.js' => Http::response('console.log("New script");', 200),
]);
$this->get('/js/script.js')->assertSee('Old script');
config()->set('plausible-proxy.script', 'js/pa-12345ABCDE.js');
$this->get('/js/script.js')->assertSee('New script');
}); });
it('handles failed script fetch', function () { it('handles failed script fetch', function () {
Http::fake([ Http::fake([
config('plausible-proxy.domain').'/js/script.js' => Http::response('', 500), 'https://plausible.io/js/script.js' => Http::response('', 500),
]); ]);
$response = $this->get('/js/script.js'); $response = $this->get('/js/script.js');
@@ -49,35 +79,69 @@ it('rejects invalid event data', function () {
->assertJsonValidationErrors(['u' => 'The u field must be a valid URL.']); ->assertJsonValidationErrors(['u' => 'The u field must be a valid URL.']);
}); });
it('accepts valid event data and forwards headers', function () { it('forwards only user agent and client ip to plausible', function () {
config()->set('plausible-proxy.domain', 'https://plausible.io'); config()->set('plausible-proxy.domain', 'https://plausible.io');
Http::fake([ Http::fake([
'https://plausible.io/api/event' => function ($request) { 'https://plausible.io/api/event' => Http::response('ok', 202),
return Http::response(['status' => 'queued'], 200);
},
]); ]);
$headers = [ $response = $this->withServerVariables(['REMOTE_ADDR' => '203.0.113.7'])
'User-Agent' => 'TestAgent', ->postJson('/api/event', [
'Accept' => 'application/json',
];
$response = $this->postJson('/api/event', [
'n' => 'pageview', 'n' => 'pageview',
'u' => 'https://example.com/page', 'u' => 'https://example.com/page',
'd' => 'example.com', 'd' => 'example.com',
], $headers); ], [
'User-Agent' => 'TestAgent',
'Cookie' => 'laravel_session=secret',
'Authorization' => 'Bearer secret',
]);
$response->assertStatus(200) $response->assertStatus(202);
->assertJson(['status' => 'queued']); expect($response->getContent())->toBe('ok');
Http::assertSentCount(1); Http::assertSentCount(1);
Http::assertSent(function ($request) { Http::assertSent(function ($request) {
return $request->url() === 'https://plausible.io/api/event' return $request->url() === 'https://plausible.io/api/event'
&& isset($request['n']) && $request['n'] === 'pageview' && $request->header('User-Agent') === ['TestAgent']
&& isset($request['u']) && $request['u'] === 'https://example.com/page' && $request->header('X-Forwarded-For') === ['203.0.113.7']
&& isset($request['d']) && $request['d'] === 'example.com'; && ! $request->hasHeader('Cookie')
&& ! $request->hasHeader('Authorization')
&& $request['n'] === 'pageview'
&& $request['u'] === 'https://example.com/page'
&& $request['d'] === 'example.com';
}); });
}); });
it('forwards additional plausible fields', function () {
config()->set('plausible-proxy.domain', 'https://plausible.io');
Http::fake([
'https://plausible.io/api/event' => Http::response('ok', 202),
]);
$this->postJson('/api/event', [
'n' => 'Purchase',
'u' => 'https://example.com/checkout',
'd' => 'example.com',
'i' => false,
'p' => '{"plan":"pro"}',
'$' => ['amount' => '9.99', 'currency' => 'EUR'],
])->assertStatus(202);
Http::assertSent(function ($request) {
return $request['i'] === false
&& $request['p'] === '{"plan":"pro"}'
&& $request['$'] === ['amount' => '9.99', 'currency' => 'EUR'];
});
});
it('rejects invalid props', function () {
$this->postJson('/api/event', [
'n' => 'pageview',
'u' => 'https://example.com/page',
'd' => 'example.com',
'p' => 'not-json',
])->assertStatus(422)->assertJsonValidationErrors(['p']);
});
+2 -12
View File
@@ -1,22 +1,12 @@
<?php <?php
namespace MattitjaAB\LaravelPlausibleProxy\Tests; namespace Mattitja\LaravelPlausibleProxy\Tests;
use Illuminate\Database\Eloquent\Factories\Factory; use Mattitja\LaravelPlausibleProxy\LaravelPlausibleProxyServiceProvider;
use MattitjaAB\LaravelPlausibleProxy\LaravelPlausibleProxyServiceProvider;
use Orchestra\Testbench\TestCase as Orchestra; use Orchestra\Testbench\TestCase as Orchestra;
class TestCase extends Orchestra class TestCase extends Orchestra
{ {
protected function setUp(): void
{
parent::setUp();
Factory::guessFactoryNamesUsing(
fn (string $modelName) => 'MattitjaAB\\LaravelPlausibleProxy\\Database\\Factories\\'.class_basename($modelName).'Factory'
);
}
protected function getPackageProviders($app) protected function getPackageProviders($app)
{ {
return [ return [