GMSSH Product ManualGMSSH Product Manual
Changelog
Official Site
  • 简体中文
  • English
Changelog
Official Site
  • 简体中文
  • English
  • 📖 Documentation

    • Product Overview
    • Introduction
    • Quick Start
    • GMSSH Client

      • Machine Management
      • Command Center
      • Terminal
      • Batch Tasks
      • Settings
    • GMSSH Desktop

      • Built-in Apps
      • App Center
      • Docker Manager
      • PHP Manager
      • MySQL Manager
      • Nginx Manager
      • Site Manager
      • Firewall Manager
      • WAF Firewall
      • Redis Manager
      • Proxy Manager
      • VPN Manager
      • Source Manager
    • Gemius AI
    • FAQ

PHP Manager

GMSSH PHP Manager is a visual management tool for PHP runtime environments on Linux servers. It provides an intuitive graphical interface covering seven core modules: Console, Configuration, Disabled Functions, Performance, Logs, phpInfo, and Extensions, with multi-version PHP installation and switching support.

Core Features

ModulePurposeCore Capabilities
ConsoleRuntime MonitorBasic info, connection queue, process status, anomaly monitoring
ConfigurationParameter ConfigCommon, limits, session, config file, FPM config file
Disabled FunctionsSecurityEnable/disable dangerous PHP functions
PerformanceTuningPHP-FPM process pool and performance parameter tuning
LogsLog ViewerPHP runtime logs and slow logs
phpInfoEnvironmentComplete PHP runtime environment info
ExtensionsExtension MgmtPHP extension installation and management

Initialization

Smart Detection & Multi-Version Installation. When opening PHP Manager for the first time, the system automatically detects PHP installation status.

Initialization

  • Auto Detection: If PHP is not detected, the page prompts "PHP not installed, please select a version".
  • Version Selection: Click the "Install" button or the top version dropdown to open the "PHP Version Management" panel.

Version Management

Version Management

  • Version List: Table showing all available PHP versions with version number, status, and actions.
  • Multi-Version Coexistence: Supports installing multiple PHP versions simultaneously, switching via the top dropdown menu.
  • Current Default: The installed version marked as "Current Default" is the primary running version.

Console

PHP-FPM Runtime Status Monitor. The Console module displays PHP-FPM status and performance metrics in a dashboard format.

Console

  • Runtime Status: Header shows current PHP version (e.g., PHP-8.3.25) and service status ("Running"), green indicates normal operation.
  • Quick Actions: Three buttons in the top-right for one-click pause, stop, and restart.

Basic Runtime Info

MetricDescriptionExample
PoolCurrent PHP-FPM process pool namewww
Process ManagerProcess management modedynamic
Start TimePHP-FPM service start time2026-03-19 10:09:27

Connections & Queue

MetricDescription
Accepted ConnTotal accepted requests
Listen QueueCurrent pending request queue length
Max Listen QueueHistorical maximum queue length
Listen Queue LenSocket listen queue length

Processes

Displayed with progress bars and numeric values:

MetricDescription
Idle ProcessesCurrently idle processes
Active ProcessesCurrently processing requests
Total ProcessesTotal processes in the pool
Max Active ProcessesHistorical maximum active processes

Stability & Anomaly Monitoring

MetricDescription
Max Children ReachedTimes the process limit was reached; increase max_children if frequent
Slow RequestsRequests exceeding the slow threshold

Configuration

Visual PHP Parameter Configuration. The Configuration module provides five tabs covering all dimensions of PHP runtime configuration.

Common Settings

Common Settings

Key PHP parameters in form layout:

ParameterExampleUnitDescription
short_open_tagRunning—Short tag support (<? syntax)
max_execution_time300secMaximum script execution time
max_input_time60secMaximum input time
memory_limit128—Script memory limit
post_max_size50MBMaximum POST data size
file_uploadsRunning—Whether file uploads are allowed
upload_max_filesize50MBMaximum upload file size
max_file_uploads20—Maximum simultaneous uploads
default_socket_timeout60secSocket timeout
error_reportingE_ALL & ~E_NOTICE—Error reporting level
  • Save / Refresh: Click "Save" to write changes, "Refresh" to restore current values.

Limit Settings

Limit Settings

ParameterExampleUnitDescription
Upload Limit50MBFile upload size limit
Timeout Limit100secRequest timeout
  • Scope: Both settings affect the Nginx configuration file.

Session Settings

Session Settings

  • Storage Mode: Select session storage via dropdown (default files), with options for Redis, Memcache, etc.
  • Performance Tip: For high-concurrency sites, Redis or Memcache can effectively improve PHP concurrency.
  • Notes:
    • If website access becomes abnormal after changing session mode, switch back to the original mode.
    • Switching session mode will cause active user sessions to be lost; switch during low-traffic periods.

Config File

Config File

  • Code Editor: Displays the full php.ini configuration with line numbers and syntax highlighting, supporting direct editing.
  • Shortcuts: Ctrl+F for search, Ctrl+H for find & replace.
  • Save: Click "Save" to write changes.
  • Note: This is the main PHP config file. Do not modify if unfamiliar with configuration rules. OpenSSL/Curl/MySQL extensions are enabled by default.

FPM Config File

FPM Config File

  • Code Editor: Displays the PHP-FPM config file ([global] and [www] sections) with syntax highlighting.
  • Shortcuts: Ctrl+F for search, Ctrl+H for find & replace.
  • Note: This is the PHP-FPM config file. Do not modify if unfamiliar with configuration rules.

Disabled Functions

PHP Dangerous Function Security Control. Displays all disabled PHP functions in a card grid with search and management capabilities.

Disabled Functions

  • Disabled Function List: Purple card grid showing all disabled function names (e.g., passthru, exec, system, shell_exec, popen, proc_open).
  • Search: Top search box for quick function lookup.
  • Add Function: "Add Function" button in the top-right to add new functions to the disabled list.
  • Security Recommendation: Strongly recommended to disable dangerous functions like exec and system.

Performance

PHP-FPM Process Pool Tuning. Provides visual configuration of PHP-FPM core performance parameters with preset concurrency plans.

Performance

ParameterExampleDescription
Concurrency Plan4GB MemoryPreset plan based on server memory
Connection TypeUnix SocketUnix socket recommended over TCP
Connection Info/tmp/php-cgi-83.sockBind IP, listen port, or socket path
IP Whitelist127.0.0.1Allowed IPs, comma-separated
Run ModeStaticPHP-FPM run mode
max_children150Maximum child processes
start_servers10Initial processes on startup
  • Run Modes:
    • Static: Maintains a fixed number of child processes. Higher memory usage but better concurrency.
    • Dynamic: Reclaims processes based on max idle setting. Lower memory, recommended for small-memory servers.
    • On-Demand: Creates processes based on demand. Minimal memory but slightly lower concurrency.
  • Notes:
    • Higher max_children = better concurrency, but do not exceed 5000.
    • Each PHP child process uses ~20MB memory; excessively high max_children may cause instability.
    • For external access, switch to TCP socket, set bind IP to 0.0.0.0, and configure IP whitelist and firewall.

Logs

PHP-FPM Runtime & Slow Log Management. Provides "Logs" and "Slow Logs" tabs.

Logs

Runtime Logs

  • Displays PHP-FPM runtime logs including FPM startup info and connection ready status with precise timestamps.

Slow Logs

  • Displays slow request records exceeding the threshold, helping identify performance bottlenecks.

phpInfo

Complete PHP Runtime Environment Info. Displays structured information about the current PHP version.

phpInfo

Basic Info

ItemDescription
VersionCurrent PHP version (e.g., 8.3.25)
Install PathPHP installation directory
php.iniConfig file path
LoadedList of loaded PHP extension modules
  • View phpinfo: Top-right link to open the full phpinfo() page.

Extensions

One-Click PHP Extension Installation. Lists all available PHP extensions with one-click install support.

Extensions

  • Extension List:
ColumnDescription
NameExtension name (e.g., intl, Swoole5, Swoole6)
TypeCategory (General / Cache)
DescriptionExtension functionality
Status✅ Installed / Not installed
ActionInstall / Uninstall button
  • Notes:
    • Some extensions (e.g., Redis) only support single-version installation.
    • OPcache, XCache, APCu are mutually exclusive cache extensions — install only one.
    • Check installation logs if installation fails.
Last Updated: 3/19/26, 4:26 PM
Contributors: xiarui
Prev
Docker Manager
Next
MySQL Manager