php-lsp 0.1.52

A PHP Language Server Protocol implementation
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79

# Getting Started

This guide takes you from zero to a working php-lsp setup in about five minutes.

## Step 1 — Install

Choose the method that suits your environment.

**Cargo** (recommended if you have a Rust toolchain):
```bash
cargo install php-lsp
```
The binary is placed at `~/.cargo/bin/php-lsp`.

**Pre-built binary** (no Rust required):

Download the binary for your platform from [Releases](https://github.com/jorgsowa/php-lsp/releases):

| File | Platform |
|---|---|
| `php-lsp-aarch64-apple-darwin` | macOS — Apple Silicon |
| `php-lsp-x86_64-apple-darwin` | macOS — Intel |
| `php-lsp-x86_64-unknown-linux-gnu` | Linux — 64-bit |

Then place it on your `PATH`:
```bash
sudo mv php-lsp /usr/local/bin/php-lsp
chmod +x /usr/local/bin/php-lsp
```

**Build from source:**
```bash
git clone https://github.com/jorgsowa/php-lsp
cd php-lsp
cargo build --release
# binary at target/release/php-lsp
```

## Step 2 — Verify

```bash
php-lsp --version
# php-lsp 0.1.50
```

If you get `command not found`, ensure the install directory is on your `PATH`:
```bash
# Cargo installs
export PATH="$HOME/.cargo/bin:$PATH"

# Manual installs — check with:
which php-lsp
```

## Step 3 — Connect your editor

php-lsp communicates over stdin/stdout and works with any editor that supports custom LSP servers. Follow the guide for your editor:

- **[VS Code](editors.md#vs-code)**
- **[Neovim 0.11+](editors.md#neovim-011)**
- **[Neovim 0.10 and older](editors.md#neovim-010-and-older)**
- **[Zed](editors.md#zed)**
- **[Cursor](editors.md#cursor)**
- **[PHPStorm](editors.md#phpstorm)**
- **[Claude Code](editors.md#claude-code)**

The key setting in every editor is the **command**: set it to the full path returned by `which php-lsp` (e.g. `/usr/local/bin/php-lsp` or `~/.cargo/bin/php-lsp`), and associate it with the `php` file type.

## Step 4 — Open a PHP project

Open a folder that contains a `composer.json`. php-lsp detects the workspace root from `composer.json` or `.git`, builds a PSR-4 index in the background, and starts serving completions, diagnostics, and navigation immediately.

You will see a `$/progress` spinner in your editor's status bar while the initial index is being built. Features work before indexing completes — the index just improves cross-file results.

## Next steps

- **[Configuration](configuration.md)** — set `phpVersion`, suppress noisy diagnostics, exclude generated paths
- **[Features](features.md)** — full list of everything php-lsp supports
- **[Architecture](architecture.md)** — internals for contributors and advanced users