From 898d48a57497011f6b96c98ddee35b511398fbd9 Mon Sep 17 00:00:00 2001
From: Sylvain Brunerie <sylvain.brunerie@gmail.com>
Date: Mon, 30 Sep 2024 09:02:12 +0200
Subject: [PATCH] php: Add syntax highlighting inside heredoc strings (#18368)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

PHP heredoc strings make it easy to define string literals over multiple
lines:

```php
    $someString = <<<EOT
        multiline
        text
        EOT;
```

That `EOT` identifier can be anything else, and it is actually being
used in Sublime Text and VS Code to inject syntax highlighting for
another language in said string, depending on the identifier. For
instance, if the identifier is SQL, SQL syntax highlighting will be
applied to the contents of the string. Likewise if the identifier is CSS
or JS.

```php
    $someString = <<<SQL
        SELECT *
        FROM my_table
        SQL;
```

This PR changes the PHP extension so that it supports that feature too.

Release Notes:

- php: Added syntax highlighting inside heredoc strings
---
 extensions/php/languages/php/injections.scm | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/extensions/php/languages/php/injections.scm b/extensions/php/languages/php/injections.scm
index 3b5cd70064..122d0b377a 100644
--- a/extensions/php/languages/php/injections.scm
+++ b/extensions/php/languages/php/injections.scm
@@ -5,3 +5,5 @@
 ((comment) @content
   (#match? @content "^/\\*\\*[^*]")
   (#set! "language" "phpdoc"))
+
+((heredoc_body) (heredoc_end) @language) @content