Zed IDE, Neovim, and language server support

JakubMisek

Happy to announce general availability of PHP extension for Zed, and any other IDE supporting language servers.

See more at https://docs.devsense.com/other/ or jump to the language server as nodejs package at https://www.npmjs.com/package/devsense-php-ls

ColinMollenhour

JakubMisek

This is excellent! I really want to try this in Charm Crush! Can you check that out and add a section to the docs?

JakubMisek

ColinMollenhour thank you for pointing this out! You can try the following for Charm Crush

Install global package 'devsense-php-ls':

npm i -g devsense-php-ls

Add Crush config:

"lsp": {
    "typescript": {
      "command": "devsense-php-ls",
      "args": ["--stdio"]
    }
}

ColinMollenhour

JakubMisek

I've not had any luck so far.. trying both Crush and OpenCode.

At this point, I'm just trying to verify that it's working with my license so I am using a script like so - there is no output, though, it just exists cleanly with a 0 return code.

#!/bin/bash

# Helper function to send LSP message
send_message() {
    local msg=$(printf "%s" "$1")
    local len=${#msg}
    printf "Content-Length: %d\r\n\r\n%s" "$len" "$msg"
}

# Create a temporary file with all messages
{
    # Initialize
    send_message '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"processId":null,"clientInfo":{"name":"test-client"},"rootUri":"file://'$(pwd)'","name":"*****","email":"*****","expiration":"Tue, 11 Nov 2025 21:24:25 GMT","signature":"*****"}}'
    
    # Initialized notification  
    send_message '{"jsonrpc":"2.0","id":2,"method":"initialized","params":{}}'
    
    # Example hover request
    send_message '{"jsonrpc":"2.0","id":3,"method":"textDocument/hover","params":{"textDocument":{"uri":"file://'$(pwd)'/index.php"},"position":{"line":2,"character":5}}}'
    
} | devsense-php-ls --stdio

Does this look correct? Is there a debug mode or something I can use to get more feedback on what's happening?

ColinMollenhour

I thought I'd sahre an interesting approach I found to exposing for daignostic data.. Serena MCP opens a web server so you can view logs without affecting the stdout stream. It has these CLI options:

  --enable-web-dashboard BOOLEAN  Override dashboard setting in config.
  --enable-gui-log-window BOOLEAN
                                  Override GUI log window setting in config.
  --log-level [DEBUG|INFO|WARNING|ERROR|CRITICAL]
                                  Override log level in config.

JakubMisek

@ColinMollenhour as described on https://www.npmjs.com/package/devsense-php-ls, the license is passed in

"params": {
  "initializationOptions": {
    "0": "{JSON SIGNATURE}",
  }
}

But even without the license, you should have the basic features (code completion, diagnostics).

Do you have any responses on stdout?

ColinMollenhour

JakubMisek Thanks, I didn't quite understand the location of the init options, seems to be clear now. Unfortunately I still can't get it "working" and am not sure if it's the agent or the LSP. I tried capturing some "requests" from Crush and OpenCode using a wrapper script and found that Crush doesn't send the initialization options and I couldn't get OpenCode to do anything with the LSP so I'm not sure if it's working or not.

Is the LSP supposed to "respond" to the initialize and initialized commands? I've not seen it respond to these in any of my tests whether via agent or with a direct bash script or on the CLI.

Is this a valid test assuming my index.php file has characters at position 2:5?

{"jsonrpc":"2.0","id":3,"method":"textDocument/hover","params":{"textDocument":{"uri":"file://'$(pwd)'/index.php"},"position":{"line":2,"character":5}}}

It would be great to be able to verify with a test that the LSP is responding properly, so any guidance you can provide would be much appeciated.

Thanks!

JakubMisek

ColinMollenhour yes, this is the response to "initialize" request: https://microsoft.github.io/language-server-protocol/specifications/lsp/3.17/specification/#initializeResult

Then the client needs to send the "textDocument/didOpen", so the server sees the document content: https://microsoft.github.io/language-server-protocol/specifications/lsp/3.17/specification/#textDocument_didOpen

And there is response to the hover request: https://microsoft.github.io/language-server-protocol/specifications/lsp/3.17/specification/#textDocument_hover

Also be sure, the encoding of headers is ASCII, and encoding of JSON bodies is UTF-8

ColinMollenhour

Thanks for the info - I'll use the docs better if I have quetions on that going forward..

Any idea why this would exit with a 0 return code and nothing to stdout?

#!/bin/bash

export DEVSENSE_PHP_LS_LICENSE="{\"name\":\"Colin... ***REDACTED***"

# Helper function to send LSP message
send_message() {
    local msg=$(printf "%s" "$1")
    local len=${#msg}
    printf "Content-Length: %d\r\n\r\n%s" "$len" "$msg"
}

send_message '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"processId":22836,"clientInfo":{"name":"mcp-language-server","version":"0.1.0"},"rootPath":"'$(pwd)'","rootUri":"file://'$(pwd)'","capabilities":{"workspace":{"didChangeConfiguration":{"dynamicRegistration":true},"didChangeWatchedFiles":{"dynamicRegistration":true,"relativePatternSupport":true},"configuration":true},"textDocument":{"synchronization":{"dynamicRegistration":true,"didSave":true},"completion":{"completionItem":{}},"documentSymbol":{},"codeAction":{"codeActionLiteralSupport":{"codeActionKind":{"valueSet":[]}}},"codeLens":{"dynamicRegistration":true},"publishDiagnostics":{"versionSupport":true},"semanticTokens":{"requests":{"range":null,"full":null},"tokenTypes":[],"tokenModifiers":[],"formats":[]}},"window":{}},"initializationOptions":{"codelenses":{"generate":true,"regenerate_cgo":true,"test":true,"tidy":true,"upgrade_dependency":true,"vendor":true,"vulncheck":false}},"workDoneToken":null,"workspaceFolders":[{"uri":"file://'$(pwd)'","name":"'$(pwd)'"}]}}' \
 | devsense-php-ls --stdio
exit $!

ColinMollenhour

I did finally get it working with opencode using this config:

{
  "$schema": "https://opencode.ai/config.json",
  "lsp": {
    "devsense-php": {
      "command": ["/home/colin/.local/share/pnpm/devsense-php-ls", "--stdio"],
      "extensions": [".php", ".phtml"],
      "initialization": {
        "0": "{\"name\":\"Colin...***REDACTED***",
        "php.version": "8.2"
      }
    }
  }
}

Tested with opencode debug lsp diagnostics --print-logs ./index.php

Thanks again!

JakubMisek

ColinMollenhour so it was running a wrong binary ? If the full path to the devsense-php-ls solved it

ColinMollenhour

JakubMisek I think I wasn't passing the initialization correctly. Also Crush and OpenCode don't use the full capabilities of the LSP, they mostly just get problem hints. So I'm not entirely sure if it was using the absolute path or not - I think it wasn't the problem but I just left it to have fewer possible issues.

CharlieJ

This is awesome! Thank you, I switched to Zed and it's been fantastic using Devsense Phptools.

My only issue currently is this error, weirdly it doesn't show up on Cursor (And I did disable intelephense and phpactor in the Zed config)

(Off-topical, can my name be changed to "Charlie J" please as it doesn't let me)

JakubMisek

CharlieJ thank you!

It looks like your where method is defined in some kind of ide-helper (and incorrectly without the default values), because the signature is a bit different from what I have in vanilla Laravel:

Where does it navigate you, if you go to the definition of where (F12) ?

CharlieJ

JakubMisek Apologies for the delay!

It takes me to vendor/laravel_ide/model_helpers.php, this line:

@method static \Illuminate\Database\Eloquent\Builder<Country>|Country where(\Closure|string|array|\Illuminate\Contracts\Database\Query\Expression $column, mixed $operator, mixed $value, string $boolean)

I currently use laravel-ide-helper to help Zed with more project specific stuff

CharlieJ

My issue above seemingly seems to be ok, may've been a faulty ide-helper setup, not sure.

Also, would LOVE if you guys could support this https://community.devsense.com/d/869-auto-remove-unused-use-lines-on-save/2 but in Zed.

I have a key bind for the organise imports option in Zed, would just need to hook in.

JakubMisek

CharlieJ does this work? We can take a look in more details, why it's not being triggered on zed

https://zed.dev/docs/configuring-zed#:~:text=Organize%20imports%20on%20save

CharlieJ

JakubMisek Annoyingly not :( doesn't seem to do anything for PHP, works for JS and Vue though

JakubMisek

CharlieJ found it; we have a bit different naming of those settings (old naming did not allow to just sort, and it caused problems for people who periodically save files ...)

    "source.organizeImports": true,      // sort uses
    "source.sortImports": true,          // sort uses (same as "source.organizeImports")
    "source.sortAndRemoveImports": true, // removes unused uses and sorts them

More at https://docs.devsense.com/vscode/code%20actions/organize-uses/#remove-and-sort-uses-on-save (VSCode Settings)

CharlieJ

JakubMisek You're fantastic, this worked! Thank you, for anyone else who visits this, all I added was this to my Zed settings:

    "languages": {
        "PHP": {
            "code_actions_on_format": {
                "source.sortAndRemoveImports": true
            },
            // ... other options ...
            }
        }
    },

I'm sure a better way to do it but it's worked for me :)

That where bug has came back with the ide-helper, weirdly no issues with Cursor so I suspect its the PHP language server on Zed perhaps?

Cursor:

Zed:

This is the generated mixin if it helps for debugging: https://gist.github.com/charnary/0dd400e35690267b316e5d8ded8eb29f