PHPackages                             nervsys/ns - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Framework](/categories/framework)
4. /
5. nervsys/ns

ActiveLibrary[Framework](/categories/framework)

nervsys/ns
==========

Nervsys - A minimalist, high-performance PHP framework with built-in modules, process manager, and CLI support.

v8.2.5(1y ago)961042Apache-2.0PHPPHP ^8.1CI passing

Since Jul 1Pushed 2d ago13 watchersCompare

[ Source](https://github.com/Jerry-Shaw/NervSys)[ Packagist](https://packagist.org/packages/nervsys/ns)[ RSS](/packages/nervsys-ns/feed)WikiDiscussions master Synced 3d ago

READMEChangelog (10)DependenciesVersions (14)Used By (0)

Nervsys - Minimalist PHP Framework
==================================

[](#nervsys---minimalist-php-framework)

[![release](https://camo.githubusercontent.com/c5d22833fe41fa189b0768b83aa6abaebb6bcf937704047ec6cb57f66f2656f7/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f72656c656173652d382e332e302d626c75653f7374796c653d666c61742d737175617265)](https://github.com/Jerry-Shaw/Nervsys/releases)[![php](https://camo.githubusercontent.com/ed9df261f9de05a549035527ed4a151d05ed4cc210f3725d7fad9b8567ae82c5/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f7068702d382e312b2d627269676874677265656e3f7374796c653d666c61742d737175617265)](https://www.php.net/)[![license](https://camo.githubusercontent.com/f33da71a29405001aa02da9ecc600166564fbf91b075090f06daf1a0012969a3/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d417061636865253230322e302d626c75653f7374796c653d666c61742d737175617265)](LICENSE.md)

### README: [English](README.md) | [简体中文](README_zh-CN.md)

[](#readme-english--简体中文)

Overview
--------

[](#overview)

**Nervsys** (derived from "Nerve System") is a minimalist, high-performance PHP framework designed for modern web applications and API development. Inspired by the neural system, the framework aims to process data streams flexibly like nerve cells, helping developers build intelligent application systems based on pure data calls.

🚀 Core Features
---------------

[](#-core-features)

- **Lightweight Design**: Core components are streamlined without redundant dependencies
- **Intelligent Routing**: Automatic parameter mapping reduces repetitive code
- **Dual Mode Support**: Supports both Web (CGI) and Command Line (CLI) modes
- **Module Mode**: Organize code into self-contained modules, each with its own entry file and metadata – ideal for large, reusable applications
- **Comprehensive Security**: Built-in XSS protection, CORS support, API security validation
- **Performance Analysis**: Built-in performance monitoring and optimization tools
- **Concurrent Processing**: Supports fibers, multi-process, and Socket communication
- **Highly Extensible**: Modular design, easy to customize and extend

📋 Requirements
--------------

[](#-requirements)

- PHP 8.1 or higher
- Support for both CLI and Web running modes
- Common web servers (Apache/Nginx/IIS) or direct CLI execution

---

🚦 Quick Start
-------------

[](#-quick-start)

### Installation

[](#installation)

1. **Clone the framework source code**

```
git clone https://github.com/Jerry-Shaw/Nervsys.git
```

> 💡 **Tip**: One server only needs one set of Nervsys framework to run multiple projects

2. **Create project structure**

```
project_root/
├── api/           # API interface classes (default mode)
├── modules/       # Module directories (module mode)
├── app/           # Application classes
├── www/           # Web entry directory
│   └── index.php  # Main entry file
└── logs/          # Log directory (auto-created)

```

3. **Configure entry file** (`www/index.php`)

```