A PHP package to automate the Lighthouse Auditing for frontend development.

0.2.0 2019-02-17 04:49 UTC

This package is auto-updated.

Last update: 2022-06-17 13:07:05 UTC


Build Status codecov Scrutinizer Code Quality StyleCI Total Downloads Latest Stable Version License: MIT

Frontend Lighthouse Audit

A simple tool to audit all of the frontend HTML templates using lighthouse-ci CLI command.

Lighthouse Audit Example


This package will help you to measure and audit the quality of your frontend HTML templates. It will start a web-server automatically on the given document root path, scan all HTML files and analyse them one by one. You can also run this tool in your CI pipeline.

Table of contents


This package only supports PHP version 7.1 or higher.


This package is dependent to the lighthouse-ci package and Chrome /Chromium web browser, so you need to install them first.

You can install lighthouse-ci easily, using this command:

$ npm install -g lighthouse-ci


Install the package globally using Composer :

$ composer global require suitmedia/frontend-lighthouse-audit

CLI Usage

$ lighthouse-audit -h

  lighthouse-audit [options] [--] <path>

  path                                   Specify the path of a directory to analyse.

  -S, --server[=SERVER]                  Define the address and port that PHP web-server should serve. <address>:<port> [default: "localhost:8000"]
      --mode[=MODE]                      Define the mode to run Lighthouse audit. Option: mobile,desktop [default: "mobile"]
      --performance[=PERFORMANCE]        Define the minimal performance score for audit to pass [default: "80"]
      --best-practices[=BEST-PRACTICES]  Define the minimal best-practices score for audit to pass [default: "80"]
      --accessibility[=ACCESSIBILITY]    Define the minimal accessibility score for audit to pass [default: "80"]
      --seo[=SEO]                        Define the minimal seo score for audit to pass [default: "80"]
      --pwa[=PWA]                        Define the minimal pwa score for audit to pass [default: "0"]
      --except[=EXCEPT]                  Provide a list of filenames that you wish to exclude, separated by commas.

      --chrome-flags[=CHROME-FLAGS]      Custom flags to pass to Chrome (space-delimited). For a full list of flags,

  -h, --help                             Display this help message
  -V, --version                          Display this application version


The MIT License (MIT). Please see License File for more information.