doctor

doctor combines checks for PHP, extensions, project files, repository access and basic security into one diagnostic report.

DiagnosticsVersion 1.1.3Stable
lil-terminal

Overview

Start with doctor when the same lil-terminal build behaves differently on two hosting accounts. Then narrow the report to platform, extensions, files, repo or security.

Find the failing layer first

doctor does not repair the server automatically. Its job is to separate platform limits, missing extensions, filesystem problems, repository connectivity and security configuration so the next action is based on evidence instead of guesswork.

Syntax

lil-terminal
doctor [group] [-q|-j]

Reference

doctor

check everything

doctor platform

show PHP, SAPI, limits, session and OPcache checks

doctor extensions

show PHP extension checks

doctor files

check project paths, permissions and storage

doctor repo

check the lil-repository

doctor security

check HTTPS, authorization and cookies

-q

show warnings and failures only

-j

return machine-readable JSON

Interactive sandbox preview

Run the prepared examples directly on the page. Their results are prebuilt and shown in the browser; no terminal command is executed on the server.

Check project files, then show only problems

Install and manage

Install the current compatible version. Choose Base for the complete feature set or Minimum for the reduced package; use upgrade to update a module that is already installed.

Base and Minimum are two packages of the same current module release, not separate command versions.

Base package

Install the complete package with local command reference and every published mode.

install doctor
Minimum package

Install the reduced package. Local reference is omitted; help <cmd> -i opens the current server reference.

install doctor -m
Exact public version

Install exactly this published version.

install doctor -v 1.1.3
Check or update

Ask upgrade to check compatibility and replace the installed block only when needed.

upgrade doctor
Remove module

Remove the extension block while leaving the core and unrelated modules intact.

install doctor -u

Examples

Examples are copyable command lines, not actions executed by this website. Review paths, permissions and destructive flags before running them on a real project.

Check project files, then show only problems
cd \sandbox | doctor files | doctor -q
files      +
permissions +
storage    +

+
Show PHP, SAPI, limits, session and OPcache checks
doctor platform
PLATFORM
+ PHP        8.x fpm-fcgi
+ memory     512M
+ execution  60 s
+ session    available

OK    4
WARN  0
FAIL  0
Show PHP extension checks
doctor extensions
EXTENSIONS
+ json       loaded
+ curl       loaded
+ openssl    loaded
! imagick    optional

OK    3
WARN  1
FAIL  0
Check project paths, permissions and storage
doctor files
FILES
+ lil         sandbox/lil.php [w]
+ cwd         sandbox [w]
+ base        sandbox [w]
+ extensions  sandbox/.lil.php [w]

OK    4
WARN  0
FAIL  0
Check the lil-repository
doctor repo
REPOSITORY
+ endpoint   https://repo.lil.dog
+ api        1.23
+ installer  latest

OK    3
WARN  0
FAIL  0
Check HTTPS, authorization and cookies
doctor security
SECURITY
+ https          enabled
+ authorization  enabled
! cookie         Secure off

OK    2
WARN  1
FAIL  0
Show warnings and failures only
doctor -q
EXTENSIONS
! imagick  optional

SECURITY
! cookie   Secure off

OK    0
WARN  2
FAIL  0
Return machine-readable JSON
doctor -j
{
  \"summary\": {\"ok\": 39, \"warn\": 2, \"fail\": 0},
  \"checks\": [ ... ]
}
Reject an unknown diagnostic group
doctor unknown
?

Related documentation

What are the server requirements? →What if repo.lil.dog is unavailable? →What if lil.php cannot write files? →Why are large files or outputs limited? →

Current public release

v1.1.32026-08-10

First stable release

Current stable release of doctor. doctor combines checks for PHP, extensions, project files, repository access and basic security into one diagnostic report.

# Version history