initial commit

Author: gbprod

CODE_OF_CONDUCT.md

@@ -0,0 +1,3 @@
+# Contributor Code of Conduct
+
+[Don't be a jerk.](https://meta.wikimedia.org/wiki/Don%27t_be_a_jerk)

LICENCE

@@ -0,0 +1,13 @@
+           DO WHAT THE FUCK YOU WANT TO PUBLIC LICENSE
+
+Copyright (C) 2024 Gilles Roustan <[email protected]>
+
+Everyone is permitted to copy and distribute verbatim or modified
+copies of this license document, and changing it is allowed as long
+as the name is changed.
+
+           DO WHAT THE FUCK YOU WANT TO PUBLIC LICENSE
+  TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
+
+ 0. You just DO WHAT THE FUCK YOU WANT TO.
+

README.md

@@ -1,2 +1,29 @@
 # none-ls-php.nvim
+
 Native PHP diagnostic plugin for none-ls.nvim
+
+Since this diagnostic will be deprecated from [none-ls.nvim](https://github.com/nvimtools/none-ls.nvim)
+(see [this issue](https://github.com/nvimtools/none-ls.nvim/issues/58)) because a LSP alternative is available,
+this repository allows to keep using native php linter with none-ls.nvim.
+
+**Note:** This plugin is not intended to be used alone, it is a dependency of none-ls.nvim.
+
+## 📦 Installation
+
+This should be used as a dependency of **none-ls.nvim**.
+
+### [lazy.nvim](https://github.com/folke/lazy.nvim)
+
+```lua
+{
+  {
+    "nvimtools/none-ls.nvim",
+    config = function()
+        require("null-ls").register(require("none-ls-php.diagnostics.php"))
+    end,
+    dependencies = {
+        "gbprod/none-ls-php.nvim",
+    },
+  },
+}
+```

lua/none-ls-php/diagnostics/php.lua

@@ -0,0 +1,53 @@
+-- Tested using PHP 7.x and PHP 8.x.
+local h = require("null-ls.helpers")
+local methods = require("null-ls.methods")
+
+local DIAGNOSTICS = methods.internal.DIAGNOSTICS
+
+return h.make_builtin({
+  name = "php",
+  meta = {
+    url = "https://www.php.net/",
+    description = "Uses the php command-line tool's built in `-l` flag to check for syntax errors.",
+  },
+  method = DIAGNOSTICS,
+  filetypes = { "php" },
+  generator_opts = {
+    command = "php",
+    -- Send file to stdin otherwise checking is only done when the file is saved.
+    to_stdin = true,
+    to_temp_file = false,
+    -- -d display_errors=STDERR ensures errors are reported to stderr.
+    -- -d log_errors=Off Disables logging of errors.
+    --
+    -- Without these, a setting in php.ini can turn off error reporting, or
+    -- change where errors are reported.
+    args = { "-l", "-d", "display_errors=STDERR", "-d", " log_errors=Off" },
+    from_stderr = true,
+    format = "line",
+    check_exit_code = function(code)
+      -- Code 0 means no syntax errors.
+      -- Code 255 means syntax errors.
+      -- Other codes mean something went wrong.
+      return code == 0 or code == 255
+    end,
+    on_output = h.diagnostics.from_patterns({
+      {
+        -- Example of an error when checking a file:
+        -- Parse error: syntax error, unexpected '$appends' (T_VARIABLE), expecting function (T_FUNCTION) or const (T_CONST) in app/Config.php on line 16
+
+        -- Example of an error when checking stdin:
+        -- Parse error: syntax error, unexpected token "=>", expecting "," or ";" in Standard input code on line 21
+
+        -- This pattern should match both.
+        pattern = [[Parse error: (.*) in (.*) on line (%d+)]],
+        groups = { "message", "junk", "row" },
+        overrides = {
+          diagnostic = { severity = h.diagnostics.severities["error"] },
+          offsets = { col = 1, end_col = 1 },
+        },
+      },
+    }),
+  },
+  factory = h.generator_factory,
+})