BranchesTags

Repository files navigation

PHP Runtime for Vercel

Enjoyable & powerful 🐘 PHP Runtime (php.vercel.app) for Vercel platform.

🏋️‍♀️ It works with these frameworks and tools. Discover more at examples.

Made with ❤️ by @f3l1x (f3l1x.io) • 🐦 @xf3l1x

😎 Getting Started

Let's picture you want to deploy your awesome microproject written in PHP and you don't know where. You have found Vercel it's awesome, but for static sites. Not anymore! I would like to introduce you your new best friend vercel-php, PHP runtime for Vercel platform.

Most simple example project is this one, using following project structure.

project
├── api
│ └── index.php
└── vercel.json

First file api/index.php is entrypoint of our application. It should be placed in api folder, it's very standard location for Vercel.

<?phpphpinfo();

Second file vercel.json is pure gold here. Setup your project with configuration like this and voila. That's all.

{
"functions": {
"api/*.php": {
"runtime": "vercel-php@0.9.0"
}
}
}

Last thing you have to do is call vercel. If you are more interested take a look at features and usage.

# Install it globally
npm i -g vercel
# Log in
vercel login
# Let's fly
vercel

Are you ready to deploy your first PHP project to Vercel? Click & Go!

🤗 Features

  • Architecture: PHP development server (🚀 fast enough)
  • PHP version: 8.5 (https://example-php-8-5.vercel.app)
  • Extensions: apcu, bcmath, brotli, bz2, calendar, Core, ctype, curl, date, dom, ds, exif, fileinfo, filter, ftp, geoip, gettext, hash, iconv, igbinary, imap, intl, json, libxml, lua, mbstring, mongodb, msgpack, mysqli, mysqlnd, openssl, pcntl, pcre, PDO, pdo_mysql, pdo_pgsql, pdo_sqlite, pgsql, phalcon, Phar, protobuf, readline, redis, Reflection, runkit7, session, SimpleXML, soap, sockets, sodium, SPL, sqlite3, standard, swoole, timecop, tokenizer, uuid, xml, xmlreader, xmlrpc, xmlwriter, xsl, Zend OPcache, zlib, zip
  • Speed: cold ~250ms / warm ~5ms
  • Memory: ~90mb
  • Frameworks: Nette, Symfony, Lumen, Slim, Phalcon
  • Node.js: 22.x

List of all installable extensions is on this page https://blog.remirepo.net/pages/PECL-extensions-RPM-status.

💯 Versions

⚙️ Usage

Before you can start using this runtime, you should learn about Vercel and how runtimes works. Take a look at blogpost about Serverless Functions.

You should define functions property in vercel.json and list PHP files directly or using wildcard (*). If you need to route everything to index, use routes property.

{
"functions": {
"api/*.php": {
"runtime": "vercel-php@0.9.0"
}
},
"routes": [
{ "src": "/(.*)", "dest": "/api/index.php" }
]
}

Do you have more questions (❓)? Let's move to FAQ.

👨‍💻 vercel dev

For running vercel dev properly, you need to have PHP installed on your computer, learn more. But it's PHP and as you know PHP has built-in development server. It works out of box.

php -S localhost:8000 api/index.php

👀 Demo

PHP

🎯Examples

Browse more examples. 👀

📜 Resources

🚧 Roadmap

See roadmap issue. Help wanted.

⁉️ FAQ

1. How to use more then one endpoint (index.php)?
project
├── api
│ ├── index.php
│ ├── users.php
│ └── books.php
└── vercel.json
{
"functions": {
"api/*.php": {
"runtime": "vercel-php@0.9.0"
},
// Can be list also directly
"api/index.php": {
"runtime": "vercel-php@0.9.0"
},
"api/users.php": {
"runtime": "vercel-php@0.9.0"
},
"api/books.php": {
"runtime": "vercel-php@0.9.0"
}
}
}
2. How to route everything to index?
{
"functions": {
"api/index.php": {
"runtime": "vercel-php@0.9.0"
}
},
"routes": [
{ "src": "/(.*)", "dest": "/api/index.php" }
]
}
3. How to update memory limit?

Additional function properties are memory, maxDuration. Learn more about functions.

{
"functions": {
"api/*.php": {
"runtime": "vercel-php@0.9.0",
"memory": 3008,
"maxDuration": 60
}
}
}
4. How to use it with Composer?

Yes, Composer is fully supported.

project
├── api
│ └── index.php
├── composer.json
└── vercel.json
{
"functions": {
"api/*.php": {
"runtime": "vercel-php@0.9.0"
}
}
}
{
"require": {
"php": "^8.1",
"tracy/tracy": "^2.0"
}
}

It's also good thing to create .vercelignore file and put /vendor folder to this file. It will not upload /vendor folder to Vercel platform.

5. How to override php.ini / php configuration ?

Yes, you can override php configuration. Take a look at default configuration at first. Create a new file api/php.ini and place there your configuration. Don't worry, this particulary file will be removed during building phase on Vercel.

project
├── api
│ ├── index.php
│ └── php.ini
└── vercel.json
{
"functions": {
"api/*.php": {
"runtime": "vercel-php@0.9.0"
}
}
}
# Disable some functionsdisable_functions = "exec, system"# Update memory limitmemory_limit=1024M
6. How to exclude some files or folders ?

Runtimes support excluding some files or folders, take a look at doc.

{
"functions": {
"api/**/*.php": {
"runtime": "vercel-php@0.9.0",
"excludeFiles": "{foo/**,bar/config/*.yaml}",
}
}

If you want to exclude files before uploading them to Vercel, use .vercelignore file.

7. How to call composer script(s) ?

Calling composer scripts during build phase on Vercel is supported via script named vercel. You can easilly call php, npm or node.

{
"require": { ... },
"require-dev": { ... },
"scripts": {
"vercel": [
"@php -v",
"npm -v"
]
}
}

Files created during composer run vercel script can be used (require/include) in your PHP lambdas, but can't be accessed from browser (like assets). If you still want to access them, create fake assets.php lambda and require them. Example of PHP satis.

8. How to include some files of folders?

If you are looking for config.includeFiles in runtime, unfortunately you can't include extra files. All files in root folder are uploaded to Vercel, use .vercelignore to exclude them before upload.

9. How to develop locally?

I think the best way at this moment is use PHP Development Server.

php -S localhost:8000 api/index.php
10. What Node.js runtime is supported?

Use 22.x.

👨🏻‍💻CHANGELOG

Show me CHANGELOG

🧙Contribution

  1. Clone this repository.
    • git clone git@github.com:juicyfx/vercel-php.git
  2. Install NPM dependencies
    • make install
  3. Make your changes
  4. Run TypeScript compiler
    • make build
  5. Run tests
    • make test
  6. Create a PR

📝 License

Copyright © 2019 f3l1x. This project is MIT licensed.

About

🐘 PHP Runtime for ▲ Vercel Serverless Functions (support 7.4-8.5)

php.vercel.app

Topics

awslambdaphpruntimeserverlessvercel

Resources

Readme
MIT license
Activity
Custom properties

Stars

1.5k stars

Watchers

22 watching

Forks

332 forks
Report repository

Releases

Packages

Used by

Contributors

Languages

, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Add copy buttons to all 
 blocks\n(function() {\n function addCopyButtons() {\n document.querySelectorAll('pre code').forEach(function(codeBlock) {\n if (codeBlock.parentElement.hasAttribute('data-copy-added')) return;\n codeBlock.parentElement.setAttribute('data-copy-added', 'true');\n \n var btn = document.createElement('button');\n btn.textContent = 'Copy';\n btn.style.cssText = 'position:absolute;top:4px;right:4px;padding:2px 8px;font-size:11px;background:#4ecdc4;border:none;border-radius:4px;color:#1a1a2e;cursor:pointer;opacity:0.7;transition:opacity 0.2s;';\n btn.onmouseover = function() { this.style.opacity = '1'; };\n btn.onmouseout = function() { this.style.opacity = '0.7'; };\n btn.onclick = function() {\n navigator.clipboard.writeText(codeBlock.textContent).then(function() {\n btn.textContent = 'Copied!';\n setTimeout(function() { btn.textContent = 'Copy'; }, 1500);\n });\n };\n codeBlock.parentElement.style.position = 'relative';\n codeBlock.parentElement.appendChild(btn);\n });\n }\n \n addCopyButtons();\n \n // Re-run on dynamic content\n var observer = new MutationObserver(addCopyButtons);\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Add Copy Buttons to Code Blocks");
}
} catch(__e) { console.warn('[Userscript:Add Copy Buttons to Code Blocks]', __e); }
})();
(function(){
try {
var __m = "github.com";
var __re = new RegExp('^' + "github\\.com" + '

Skip to content
BranchesTags
Repository files navigation
PHP Runtime for Vercel

Enjoyable & powerful 🐘 PHP Runtime (php.vercel.app) for Vercel platform.

🏋️‍♀️ It works with these frameworks and tools. Discover more at examples.

Made with ❤️ by @f3l1x (f3l1x.io) • 🐦 @xf3l1x
😎 Getting Started
Let's picture you want to deploy your awesome microproject written in PHP and you don't know where. You have found Vercel it's awesome, but for static sites. Not anymore! I would like to introduce you your new best friend vercel-php, PHP runtime for Vercel platform.
Most simple example project is this one, using following project structure.
project
├── api
│ └── index.php
└── vercel.json
First file api/index.php is entrypoint of our application. It should be placed in api folder, it's very standard location for Vercel.
<?phpphpinfo();
Second file vercel.json is pure gold here. Setup your project with configuration like this and voila. That's all.
{
"functions": {
"api/*.php": {
"runtime": "vercel-php@0.9.0"
}
}
}
Last thing you have to do is call vercel. If you are more interested take a look at features and usage.
# Install it globally
npm i -g vercel
# Log in
vercel login
# Let's fly
vercel

Are you ready to deploy your first PHP project to Vercel? Click & Go!
🤗 Features
  • Architecture: PHP development server (🚀 fast enough)
  • PHP version: 8.5 (https://example-php-8-5.vercel.app)
  • Extensions: apcu, bcmath, brotli, bz2, calendar, Core, ctype, curl, date, dom, ds, exif, fileinfo, filter, ftp, geoip, gettext, hash, iconv, igbinary, imap, intl, json, libxml, lua, mbstring, mongodb, msgpack, mysqli, mysqlnd, openssl, pcntl, pcre, PDO, pdo_mysql, pdo_pgsql, pdo_sqlite, pgsql, phalcon, Phar, protobuf, readline, redis, Reflection, runkit7, session, SimpleXML, soap, sockets, sodium, SPL, sqlite3, standard, swoole, timecop, tokenizer, uuid, xml, xmlreader, xmlrpc, xmlwriter, xsl, Zend OPcache, zlib, zip
  • Speed: cold ~250ms / warm ~5ms
  • Memory: ~90mb
  • Frameworks: Nette, Symfony, Lumen, Slim, Phalcon
  • Node.js: 22.x
List of all installable extensions is on this page https://blog.remirepo.net/pages/PECL-extensions-RPM-status.
💯 Versions
⚙️ Usage
Before you can start using this runtime, you should learn about Vercel and how runtimes works. Take a look at blogpost about Serverless Functions.
You should define functions property in vercel.json and list PHP files directly or using wildcard (*).
If you need to route everything to index, use routes property.
{
"functions": {
"api/*.php": {
"runtime": "vercel-php@0.9.0"
}
},
"routes": [
{ "src": "/(.*)", "dest": "/api/index.php" }
]
}
Do you have more questions (❓)? Let's move to FAQ.
👨‍💻 vercel dev
For running vercel dev properly, you need to have PHP installed on your computer, learn more.
But it's PHP and as you know PHP has built-in development server. It works out of box.
php -S localhost:8000 api/index.php

👀 Demo
PHP
🎯Examples
Browse more examples. 👀
📜 Resources
🚧 Roadmap
See roadmap issue. Help wanted.
⁉️ FAQ
1. How to use more then one endpoint (index.php)?
project
├── api
│ ├── index.php
│ ├── users.php
│ └── books.php
└── vercel.json
{
"functions": {
"api/*.php": {
"runtime": "vercel-php@0.9.0"
},
// Can be list also directly
"api/index.php": {
"runtime": "vercel-php@0.9.0"
},
"api/users.php": {
"runtime": "vercel-php@0.9.0"
},
"api/books.php": {
"runtime": "vercel-php@0.9.0"
}
}
}

2. How to route everything to index?
{
"functions": {
"api/index.php": {
"runtime": "vercel-php@0.9.0"
}
},
"routes": [
{ "src": "/(.*)", "dest": "/api/index.php" }
]
}
3. How to update memory limit?
Additional function properties are memory, maxDuration. Learn more about functions.
{
"functions": {
"api/*.php": {
"runtime": "vercel-php@0.9.0",
"memory": 3008,
"maxDuration": 60
}
}
}
4. How to use it with Composer?
Yes, Composer is fully supported.
project
├── api
│ └── index.php
├── composer.json
└── vercel.json
{
"functions": {
"api/*.php": {
"runtime": "vercel-php@0.9.0"
}
}
}
{
"require": {
"php": "^8.1",
"tracy/tracy": "^2.0"
}
}
It's also good thing to create .vercelignore file and put /vendor folder to this file. It will not upload
/vendor folder to Vercel platform.
5. How to override php.ini / php configuration ?
Yes, you can override php configuration. Take a look at default configuration at first.
Create a new file api/php.ini and place there your configuration. Don't worry, this particulary file will be
removed during building phase on Vercel.
project
├── api
│ ├── index.php
│ └── php.ini
└── vercel.json
{
"functions": {
"api/*.php": {
"runtime": "vercel-php@0.9.0"
}
}
}
# Disable some functionsdisable_functions = "exec, system"# Update memory limitmemory_limit=1024M
6. How to exclude some files or folders ?
Runtimes support excluding some files or folders, take a look at doc.
{
"functions": {
"api/**/*.php": {
"runtime": "vercel-php@0.9.0",
"excludeFiles": "{foo/**,bar/config/*.yaml}",
}
}
If you want to exclude files before uploading them to Vercel, use .vercelignore file.
7. How to call composer script(s) ?
Calling composer scripts during build phase on Vercel is supported via script named vercel. You can easilly call php, npm or node.
{
"require": { ... },
"require-dev": { ... },
"scripts": {
"vercel": [
"@php -v",
"npm -v"
]
}
}
Files created during composer run vercel script can be used (require/include) in your PHP lambdas, but can't be accessed from browser (like assets). If you still want to access them, create fake assets.php lambda and require them. Example of PHP satis.
8. How to include some files of folders?
If you are looking for config.includeFiles in runtime, unfortunately you can't include extra files.
All files in root folder are uploaded to Vercel, use .vercelignore to exclude them before upload.
9. How to develop locally?
I think the best way at this moment is use PHP Development Server.
php -S localhost:8000 api/index.php

10. What Node.js runtime is supported?
Use 22.x.
👨🏻‍💻CHANGELOG
Show me CHANGELOG
🧙Contribution
  1. Clone this repository.

    • git clone git@github.com:juicyfx/vercel-php.git
  2. Install NPM dependencies

    • make install
  3. Make your changes
  4. Run TypeScript compiler

    • make build
  5. Run tests

    • make test
  6. Create a PR
📝 License
Copyright © 2019 f3l1x.
This project is MIT licensed.
About
🐘 PHP Runtime for ▲ Vercel Serverless Functions (support 7.4-8.5)
php.vercel.app
Topics
awslambdaphpruntimeserverlessvercel
Resources
Readme
MIT license
Activity
Custom properties
Stars
1.5k stars
Watchers
22 watching
Forks
332 forks
Report repository
Releases
Packages
Used by
Contributors
Languages

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Force GitHub README to respect dark mode\n(function() {\n var style = document.createElement('style');\n style.textContent = '\n .markdown-body {\n color-scheme: dark light;\n }\n .markdown-body pre { background: #161b22 !important; }\n .markdown-body code { background: rgba(110, 118, 129, 0.4) !important; }\n .markdown-body table th, .markdown-body table td { border-color: #30363d !important; }\n .markdown-body img { background: #0d1117; }\n .markdown-body blockquote { border-left-color: #8b949e; }\n .markdown-body hr { border-color: #30363d; }\n ';\n document.head.appendChild(style);\n})();", "GitHub Dark Mode README Fix");
}
} catch(__e) { console.warn('[Userscript:GitHub Dark Mode README Fix]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '

Skip to content
BranchesTags
Repository files navigation
PHP Runtime for Vercel

Enjoyable & powerful 🐘 PHP Runtime (php.vercel.app) for Vercel platform.

🏋️‍♀️ It works with these frameworks and tools. Discover more at examples.

Made with ❤️ by @f3l1x (f3l1x.io) • 🐦 @xf3l1x
😎 Getting Started
Let's picture you want to deploy your awesome microproject written in PHP and you don't know where. You have found Vercel it's awesome, but for static sites. Not anymore! I would like to introduce you your new best friend vercel-php, PHP runtime for Vercel platform.
Most simple example project is this one, using following project structure.
project
├── api
│ └── index.php
└── vercel.json
First file api/index.php is entrypoint of our application. It should be placed in api folder, it's very standard location for Vercel.
<?phpphpinfo();
Second file vercel.json is pure gold here. Setup your project with configuration like this and voila. That's all.
{
"functions": {
"api/*.php": {
"runtime": "vercel-php@0.9.0"
}
}
}
Last thing you have to do is call vercel. If you are more interested take a look at features and usage.
# Install it globally
npm i -g vercel
# Log in
vercel login
# Let's fly
vercel

Are you ready to deploy your first PHP project to Vercel? Click & Go!
🤗 Features
  • Architecture: PHP development server (🚀 fast enough)
  • PHP version: 8.5 (https://example-php-8-5.vercel.app)
  • Extensions: apcu, bcmath, brotli, bz2, calendar, Core, ctype, curl, date, dom, ds, exif, fileinfo, filter, ftp, geoip, gettext, hash, iconv, igbinary, imap, intl, json, libxml, lua, mbstring, mongodb, msgpack, mysqli, mysqlnd, openssl, pcntl, pcre, PDO, pdo_mysql, pdo_pgsql, pdo_sqlite, pgsql, phalcon, Phar, protobuf, readline, redis, Reflection, runkit7, session, SimpleXML, soap, sockets, sodium, SPL, sqlite3, standard, swoole, timecop, tokenizer, uuid, xml, xmlreader, xmlrpc, xmlwriter, xsl, Zend OPcache, zlib, zip
  • Speed: cold ~250ms / warm ~5ms
  • Memory: ~90mb
  • Frameworks: Nette, Symfony, Lumen, Slim, Phalcon
  • Node.js: 22.x
List of all installable extensions is on this page https://blog.remirepo.net/pages/PECL-extensions-RPM-status.
💯 Versions
⚙️ Usage
Before you can start using this runtime, you should learn about Vercel and how runtimes works. Take a look at blogpost about Serverless Functions.
You should define functions property in vercel.json and list PHP files directly or using wildcard (*).
If you need to route everything to index, use routes property.
{
"functions": {
"api/*.php": {
"runtime": "vercel-php@0.9.0"
}
},
"routes": [
{ "src": "/(.*)", "dest": "/api/index.php" }
]
}
Do you have more questions (❓)? Let's move to FAQ.
👨‍💻 vercel dev
For running vercel dev properly, you need to have PHP installed on your computer, learn more.
But it's PHP and as you know PHP has built-in development server. It works out of box.
php -S localhost:8000 api/index.php

👀 Demo
PHP
🎯Examples
Browse more examples. 👀
📜 Resources
🚧 Roadmap
See roadmap issue. Help wanted.
⁉️ FAQ
1. How to use more then one endpoint (index.php)?
project
├── api
│ ├── index.php
│ ├── users.php
│ └── books.php
└── vercel.json
{
"functions": {
"api/*.php": {
"runtime": "vercel-php@0.9.0"
},
// Can be list also directly
"api/index.php": {
"runtime": "vercel-php@0.9.0"
},
"api/users.php": {
"runtime": "vercel-php@0.9.0"
},
"api/books.php": {
"runtime": "vercel-php@0.9.0"
}
}
}

2. How to route everything to index?
{
"functions": {
"api/index.php": {
"runtime": "vercel-php@0.9.0"
}
},
"routes": [
{ "src": "/(.*)", "dest": "/api/index.php" }
]
}
3. How to update memory limit?
Additional function properties are memory, maxDuration. Learn more about functions.
{
"functions": {
"api/*.php": {
"runtime": "vercel-php@0.9.0",
"memory": 3008,
"maxDuration": 60
}
}
}
4. How to use it with Composer?
Yes, Composer is fully supported.
project
├── api
│ └── index.php
├── composer.json
└── vercel.json
{
"functions": {
"api/*.php": {
"runtime": "vercel-php@0.9.0"
}
}
}
{
"require": {
"php": "^8.1",
"tracy/tracy": "^2.0"
}
}
It's also good thing to create .vercelignore file and put /vendor folder to this file. It will not upload
/vendor folder to Vercel platform.
5. How to override php.ini / php configuration ?
Yes, you can override php configuration. Take a look at default configuration at first.
Create a new file api/php.ini and place there your configuration. Don't worry, this particulary file will be
removed during building phase on Vercel.
project
├── api
│ ├── index.php
│ └── php.ini
└── vercel.json
{
"functions": {
"api/*.php": {
"runtime": "vercel-php@0.9.0"
}
}
}
# Disable some functionsdisable_functions = "exec, system"# Update memory limitmemory_limit=1024M
6. How to exclude some files or folders ?
Runtimes support excluding some files or folders, take a look at doc.
{
"functions": {
"api/**/*.php": {
"runtime": "vercel-php@0.9.0",
"excludeFiles": "{foo/**,bar/config/*.yaml}",
}
}
If you want to exclude files before uploading them to Vercel, use .vercelignore file.
7. How to call composer script(s) ?
Calling composer scripts during build phase on Vercel is supported via script named vercel. You can easilly call php, npm or node.
{
"require": { ... },
"require-dev": { ... },
"scripts": {
"vercel": [
"@php -v",
"npm -v"
]
}
}
Files created during composer run vercel script can be used (require/include) in your PHP lambdas, but can't be accessed from browser (like assets). If you still want to access them, create fake assets.php lambda and require them. Example of PHP satis.
8. How to include some files of folders?
If you are looking for config.includeFiles in runtime, unfortunately you can't include extra files.
All files in root folder are uploaded to Vercel, use .vercelignore to exclude them before upload.
9. How to develop locally?
I think the best way at this moment is use PHP Development Server.
php -S localhost:8000 api/index.php

10. What Node.js runtime is supported?
Use 22.x.
👨🏻‍💻CHANGELOG
Show me CHANGELOG
🧙Contribution
  1. Clone this repository.

    • git clone git@github.com:juicyfx/vercel-php.git
  2. Install NPM dependencies

    • make install
  3. Make your changes
  4. Run TypeScript compiler

    • make build
  5. Run tests

    • make test
  6. Create a PR
📝 License
Copyright © 2019 f3l1x.
This project is MIT licensed.
About
🐘 PHP Runtime for ▲ Vercel Serverless Functions (support 7.4-8.5)
php.vercel.app
Topics
awslambdaphpruntimeserverlessvercel
Resources
Readme
MIT license
Activity
Custom properties
Stars
1.5k stars
Watchers
22 watching
Forks
332 forks
Report repository
Releases
Packages
Used by
Contributors
Languages

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Highlight search terms from Google/DuckDuckGo/Bing referrer\n(function() {\n var ref = document.referrer;\n var terms = [];\n \n if (ref.includes('google.com') || ref.includes('duckduckgo.com') || ref.includes('bing.com')) {\n var url = new URL(ref);\n var q = url.searchParams.get('q') || url.searchParams.get('p');\n if (q) {\n terms = q.split(/\\s+/).filter(function(t) { return t.length > 2; });\n }\n }\n \n if (terms.length === 0) return;\n \n var style = document.createElement('style');\n style.textContent = '.userscript-highlight { background: #fbbf24; color: #1a1a2e; padding: 1px 3px; border-radius: 2px; }';\n document.head.appendChild(style);\n \n function highlight(node) {\n if (node.nodeType === 3) { // text node\n var text = node.textContent;\n var found = false;\n terms.forEach(function(term) {\n var regex = new RegExp('(' + term.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\') + ')', 'gi');\n if (regex.test(text)) {\n found = true;\n var frag = document.createDocumentFragment();\n var parts = text.split(regex);\n parts.forEach(function(part, i) {\n if (i % 2 === 0) {\n frag.appendChild(document.createTextNode(part));\n } else {\n var span = document.createElement('span');\n span.className = 'userscript-highlight';\n span.textContent = part;\n frag.appendChild(span);\n }\n });\n node.parentNode.replaceChild(frag, node);\n }\n });\n } else if (node.nodeType === 1 && node.childNodes) { // element\n var skipTags = ['SCRIPT', 'STYLE', 'NOSCRIPT', 'TEXTAREA', 'INPUT', 'SELECT'];\n if (!skipTags.includes(node.tagName)) {\n Array.from(node.childNodes).forEach(highlight);\n }\n }\n }\n \n highlight(document.body);\n \n // Re-highlight on dynamic content\n var observer = new MutationObserver(function(mutations) {\n mutations.forEach(function(m) {\n m.addedNodes.forEach(function(node) {\n if (node.nodeType === 1 || node.nodeType === 3) highlight(node);\n });\n });\n });\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Highlight Search Terms");
}
} catch(__e) { console.warn('[Userscript:Highlight Search Terms]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '

Skip to content
BranchesTags
Repository files navigation
PHP Runtime for Vercel

Enjoyable & powerful 🐘 PHP Runtime (php.vercel.app) for Vercel platform.

🏋️‍♀️ It works with these frameworks and tools. Discover more at examples.

Made with ❤️ by @f3l1x (f3l1x.io) • 🐦 @xf3l1x
😎 Getting Started
Let's picture you want to deploy your awesome microproject written in PHP and you don't know where. You have found Vercel it's awesome, but for static sites. Not anymore! I would like to introduce you your new best friend vercel-php, PHP runtime for Vercel platform.
Most simple example project is this one, using following project structure.
project
├── api
│ └── index.php
└── vercel.json
First file api/index.php is entrypoint of our application. It should be placed in api folder, it's very standard location for Vercel.
<?phpphpinfo();
Second file vercel.json is pure gold here. Setup your project with configuration like this and voila. That's all.
{
"functions": {
"api/*.php": {
"runtime": "vercel-php@0.9.0"
}
}
}
Last thing you have to do is call vercel. If you are more interested take a look at features and usage.
# Install it globally
npm i -g vercel
# Log in
vercel login
# Let's fly
vercel

Are you ready to deploy your first PHP project to Vercel? Click & Go!
🤗 Features
  • Architecture: PHP development server (🚀 fast enough)
  • PHP version: 8.5 (https://example-php-8-5.vercel.app)
  • Extensions: apcu, bcmath, brotli, bz2, calendar, Core, ctype, curl, date, dom, ds, exif, fileinfo, filter, ftp, geoip, gettext, hash, iconv, igbinary, imap, intl, json, libxml, lua, mbstring, mongodb, msgpack, mysqli, mysqlnd, openssl, pcntl, pcre, PDO, pdo_mysql, pdo_pgsql, pdo_sqlite, pgsql, phalcon, Phar, protobuf, readline, redis, Reflection, runkit7, session, SimpleXML, soap, sockets, sodium, SPL, sqlite3, standard, swoole, timecop, tokenizer, uuid, xml, xmlreader, xmlrpc, xmlwriter, xsl, Zend OPcache, zlib, zip
  • Speed: cold ~250ms / warm ~5ms
  • Memory: ~90mb
  • Frameworks: Nette, Symfony, Lumen, Slim, Phalcon
  • Node.js: 22.x
List of all installable extensions is on this page https://blog.remirepo.net/pages/PECL-extensions-RPM-status.
💯 Versions
⚙️ Usage
Before you can start using this runtime, you should learn about Vercel and how runtimes works. Take a look at blogpost about Serverless Functions.
You should define functions property in vercel.json and list PHP files directly or using wildcard (*).
If you need to route everything to index, use routes property.
{
"functions": {
"api/*.php": {
"runtime": "vercel-php@0.9.0"
}
},
"routes": [
{ "src": "/(.*)", "dest": "/api/index.php" }
]
}
Do you have more questions (❓)? Let's move to FAQ.
👨‍💻 vercel dev
For running vercel dev properly, you need to have PHP installed on your computer, learn more.
But it's PHP and as you know PHP has built-in development server. It works out of box.
php -S localhost:8000 api/index.php

👀 Demo
PHP
🎯Examples
Browse more examples. 👀
📜 Resources
🚧 Roadmap
See roadmap issue. Help wanted.
⁉️ FAQ
1. How to use more then one endpoint (index.php)?
project
├── api
│ ├── index.php
│ ├── users.php
│ └── books.php
└── vercel.json
{
"functions": {
"api/*.php": {
"runtime": "vercel-php@0.9.0"
},
// Can be list also directly
"api/index.php": {
"runtime": "vercel-php@0.9.0"
},
"api/users.php": {
"runtime": "vercel-php@0.9.0"
},
"api/books.php": {
"runtime": "vercel-php@0.9.0"
}
}
}

2. How to route everything to index?
{
"functions": {
"api/index.php": {
"runtime": "vercel-php@0.9.0"
}
},
"routes": [
{ "src": "/(.*)", "dest": "/api/index.php" }
]
}
3. How to update memory limit?
Additional function properties are memory, maxDuration. Learn more about functions.
{
"functions": {
"api/*.php": {
"runtime": "vercel-php@0.9.0",
"memory": 3008,
"maxDuration": 60
}
}
}
4. How to use it with Composer?
Yes, Composer is fully supported.
project
├── api
│ └── index.php
├── composer.json
└── vercel.json
{
"functions": {
"api/*.php": {
"runtime": "vercel-php@0.9.0"
}
}
}
{
"require": {
"php": "^8.1",
"tracy/tracy": "^2.0"
}
}
It's also good thing to create .vercelignore file and put /vendor folder to this file. It will not upload
/vendor folder to Vercel platform.
5. How to override php.ini / php configuration ?
Yes, you can override php configuration. Take a look at default configuration at first.
Create a new file api/php.ini and place there your configuration. Don't worry, this particulary file will be
removed during building phase on Vercel.
project
├── api
│ ├── index.php
│ └── php.ini
└── vercel.json
{
"functions": {
"api/*.php": {
"runtime": "vercel-php@0.9.0"
}
}
}
# Disable some functionsdisable_functions = "exec, system"# Update memory limitmemory_limit=1024M
6. How to exclude some files or folders ?
Runtimes support excluding some files or folders, take a look at doc.
{
"functions": {
"api/**/*.php": {
"runtime": "vercel-php@0.9.0",
"excludeFiles": "{foo/**,bar/config/*.yaml}",
}
}
If you want to exclude files before uploading them to Vercel, use .vercelignore file.
7. How to call composer script(s) ?
Calling composer scripts during build phase on Vercel is supported via script named vercel. You can easilly call php, npm or node.
{
"require": { ... },
"require-dev": { ... },
"scripts": {
"vercel": [
"@php -v",
"npm -v"
]
}
}
Files created during composer run vercel script can be used (require/include) in your PHP lambdas, but can't be accessed from browser (like assets). If you still want to access them, create fake assets.php lambda and require them. Example of PHP satis.
8. How to include some files of folders?
If you are looking for config.includeFiles in runtime, unfortunately you can't include extra files.
All files in root folder are uploaded to Vercel, use .vercelignore to exclude them before upload.
9. How to develop locally?
I think the best way at this moment is use PHP Development Server.
php -S localhost:8000 api/index.php

10. What Node.js runtime is supported?
Use 22.x.
👨🏻‍💻CHANGELOG
Show me CHANGELOG
🧙Contribution
  1. Clone this repository.

    • git clone git@github.com:juicyfx/vercel-php.git
  2. Install NPM dependencies

    • make install
  3. Make your changes
  4. Run TypeScript compiler

    • make build
  5. Run tests

    • make test
  6. Create a PR
📝 License
Copyright © 2019 f3l1x.
This project is MIT licensed.
About
🐘 PHP Runtime for ▲ Vercel Serverless Functions (support 7.4-8.5)
php.vercel.app
Topics
awslambdaphpruntimeserverlessvercel
Resources
Readme
MIT license
Activity
Custom properties
Stars
1.5k stars
Watchers
22 watching
Forks
332 forks
Report repository
Releases
Packages
Used by
Contributors
Languages

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Strip utm_, fbclid, gclid, etc. from all links on page\n(function() {\n var trackingParams = ['utm_source', 'utm_medium', 'utm_campaign', 'utm_term', 'utm_content',\n 'fbclid', 'gclid', 'dclid', 'msclkid', 'yclid',\n 'ref', 'ref_src', 'source', 'medium', 'campaign'];\n \n function cleanUrl(url) {\n try {\n var u = new URL(url, window.location.origin);\n var changed = false;\n trackingParams.forEach(function(p) {\n if (u.searchParams.has(p)) {\n u.searchParams.delete(p);\n changed = true;\n }\n });\n return changed ? u.toString() : url;\n } catch (e) {\n return url;\n }\n }\n \n function cleanLinks() {\n document.querySelectorAll('a[href]').forEach(function(a) {\n var clean = cleanUrl(a.href);\n if (clean !== a.href) a.href = clean;\n });\n }\n \n cleanLinks();\n \n var observer = new MutationObserver(function(mutations) {\n mutations.forEach(function(m) {\n m.addedNodes.forEach(function(node) {\n if (node.nodeType === 1) {\n if (node.tagName === 'A') cleanLinks();\n node.querySelectorAll('a[href]').forEach(function(a) {\n var clean = cleanUrl(a.href);\n if (clean !== a.href) a.href = clean;\n });\n }\n });\n });\n });\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Remove Tracking Parameters from Links");
}
} catch(__e) { console.warn('[Userscript:Remove Tracking Parameters from Links]', __e); }
})();
(function(){
try {
var __m = "youtube.com";
var __re = new RegExp('^' + "youtube\\.com" + '

Skip to content
BranchesTags
Repository files navigation
PHP Runtime for Vercel

Enjoyable & powerful 🐘 PHP Runtime (php.vercel.app) for Vercel platform.

🏋️‍♀️ It works with these frameworks and tools. Discover more at examples.

Made with ❤️ by @f3l1x (f3l1x.io) • 🐦 @xf3l1x
😎 Getting Started
Let's picture you want to deploy your awesome microproject written in PHP and you don't know where. You have found Vercel it's awesome, but for static sites. Not anymore! I would like to introduce you your new best friend vercel-php, PHP runtime for Vercel platform.
Most simple example project is this one, using following project structure.
project
├── api
│ └── index.php
└── vercel.json
First file api/index.php is entrypoint of our application. It should be placed in api folder, it's very standard location for Vercel.
<?phpphpinfo();
Second file vercel.json is pure gold here. Setup your project with configuration like this and voila. That's all.
{
"functions": {
"api/*.php": {
"runtime": "vercel-php@0.9.0"
}
}
}
Last thing you have to do is call vercel. If you are more interested take a look at features and usage.
# Install it globally
npm i -g vercel
# Log in
vercel login
# Let's fly
vercel

Are you ready to deploy your first PHP project to Vercel? Click & Go!
🤗 Features
  • Architecture: PHP development server (🚀 fast enough)
  • PHP version: 8.5 (https://example-php-8-5.vercel.app)
  • Extensions: apcu, bcmath, brotli, bz2, calendar, Core, ctype, curl, date, dom, ds, exif, fileinfo, filter, ftp, geoip, gettext, hash, iconv, igbinary, imap, intl, json, libxml, lua, mbstring, mongodb, msgpack, mysqli, mysqlnd, openssl, pcntl, pcre, PDO, pdo_mysql, pdo_pgsql, pdo_sqlite, pgsql, phalcon, Phar, protobuf, readline, redis, Reflection, runkit7, session, SimpleXML, soap, sockets, sodium, SPL, sqlite3, standard, swoole, timecop, tokenizer, uuid, xml, xmlreader, xmlrpc, xmlwriter, xsl, Zend OPcache, zlib, zip
  • Speed: cold ~250ms / warm ~5ms
  • Memory: ~90mb
  • Frameworks: Nette, Symfony, Lumen, Slim, Phalcon
  • Node.js: 22.x
List of all installable extensions is on this page https://blog.remirepo.net/pages/PECL-extensions-RPM-status.
💯 Versions
⚙️ Usage
Before you can start using this runtime, you should learn about Vercel and how runtimes works. Take a look at blogpost about Serverless Functions.
You should define functions property in vercel.json and list PHP files directly or using wildcard (*).
If you need to route everything to index, use routes property.
{
"functions": {
"api/*.php": {
"runtime": "vercel-php@0.9.0"
}
},
"routes": [
{ "src": "/(.*)", "dest": "/api/index.php" }
]
}
Do you have more questions (❓)? Let's move to FAQ.
👨‍💻 vercel dev
For running vercel dev properly, you need to have PHP installed on your computer, learn more.
But it's PHP and as you know PHP has built-in development server. It works out of box.
php -S localhost:8000 api/index.php

👀 Demo
PHP
🎯Examples
Browse more examples. 👀
📜 Resources
🚧 Roadmap
See roadmap issue. Help wanted.
⁉️ FAQ
1. How to use more then one endpoint (index.php)?
project
├── api
│ ├── index.php
│ ├── users.php
│ └── books.php
└── vercel.json
{
"functions": {
"api/*.php": {
"runtime": "vercel-php@0.9.0"
},
// Can be list also directly
"api/index.php": {
"runtime": "vercel-php@0.9.0"
},
"api/users.php": {
"runtime": "vercel-php@0.9.0"
},
"api/books.php": {
"runtime": "vercel-php@0.9.0"
}
}
}

2. How to route everything to index?
{
"functions": {
"api/index.php": {
"runtime": "vercel-php@0.9.0"
}
},
"routes": [
{ "src": "/(.*)", "dest": "/api/index.php" }
]
}
3. How to update memory limit?
Additional function properties are memory, maxDuration. Learn more about functions.
{
"functions": {
"api/*.php": {
"runtime": "vercel-php@0.9.0",
"memory": 3008,
"maxDuration": 60
}
}
}
4. How to use it with Composer?
Yes, Composer is fully supported.
project
├── api
│ └── index.php
├── composer.json
└── vercel.json
{
"functions": {
"api/*.php": {
"runtime": "vercel-php@0.9.0"
}
}
}
{
"require": {
"php": "^8.1",
"tracy/tracy": "^2.0"
}
}
It's also good thing to create .vercelignore file and put /vendor folder to this file. It will not upload
/vendor folder to Vercel platform.
5. How to override php.ini / php configuration ?
Yes, you can override php configuration. Take a look at default configuration at first.
Create a new file api/php.ini and place there your configuration. Don't worry, this particulary file will be
removed during building phase on Vercel.
project
├── api
│ ├── index.php
│ └── php.ini
└── vercel.json
{
"functions": {
"api/*.php": {
"runtime": "vercel-php@0.9.0"
}
}
}
# Disable some functionsdisable_functions = "exec, system"# Update memory limitmemory_limit=1024M
6. How to exclude some files or folders ?
Runtimes support excluding some files or folders, take a look at doc.
{
"functions": {
"api/**/*.php": {
"runtime": "vercel-php@0.9.0",
"excludeFiles": "{foo/**,bar/config/*.yaml}",
}
}
If you want to exclude files before uploading them to Vercel, use .vercelignore file.
7. How to call composer script(s) ?
Calling composer scripts during build phase on Vercel is supported via script named vercel. You can easilly call php, npm or node.
{
"require": { ... },
"require-dev": { ... },
"scripts": {
"vercel": [
"@php -v",
"npm -v"
]
}
}
Files created during composer run vercel script can be used (require/include) in your PHP lambdas, but can't be accessed from browser (like assets). If you still want to access them, create fake assets.php lambda and require them. Example of PHP satis.
8. How to include some files of folders?
If you are looking for config.includeFiles in runtime, unfortunately you can't include extra files.
All files in root folder are uploaded to Vercel, use .vercelignore to exclude them before upload.
9. How to develop locally?
I think the best way at this moment is use PHP Development Server.
php -S localhost:8000 api/index.php

10. What Node.js runtime is supported?
Use 22.x.
👨🏻‍💻CHANGELOG
Show me CHANGELOG
🧙Contribution
  1. Clone this repository.

    • git clone git@github.com:juicyfx/vercel-php.git
  2. Install NPM dependencies

    • make install
  3. Make your changes
  4. Run TypeScript compiler

    • make build
  5. Run tests

    • make test
  6. Create a PR
📝 License
Copyright © 2019 f3l1x.
This project is MIT licensed.
About
🐘 PHP Runtime for ▲ Vercel Serverless Functions (support 7.4-8.5)
php.vercel.app
Topics
awslambdaphpruntimeserverlessvercel
Resources
Readme
MIT license
Activity
Custom properties
Stars
1.5k stars
Watchers
22 watching
Forks
332 forks
Report repository
Releases
Packages
Used by
Contributors
Languages

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Auto-enable theater mode on YouTube\n(function() {\n function tryTheater() {\n var btn = document.querySelector('button[aria-label=\"Theater mode\"], ytd-player #player button[title=\"Theater mode\"]');\n if (btn && !btn.classList.contains('activated')) {\n btn.click();\n }\n }\n \n // Try immediately\n tryTheater();\n \n // Try after navigation (SPA)\n var lastUrl = location.href;\n setInterval(function() {\n if (location.href !== lastUrl) {\n lastUrl = location.href;\n setTimeout(tryTheater, 500);\n }\n }, 1000);\n \n // Also try on player load\n var observer = new MutationObserver(tryTheater);\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "YouTube Theater Mode Default");
}
} catch(__e) { console.warn('[Userscript:YouTube Theater Mode Default]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '

Skip to content
BranchesTags
Repository files navigation
PHP Runtime for Vercel

Enjoyable & powerful 🐘 PHP Runtime (php.vercel.app) for Vercel platform.

🏋️‍♀️ It works with these frameworks and tools. Discover more at examples.

Made with ❤️ by @f3l1x (f3l1x.io) • 🐦 @xf3l1x
😎 Getting Started
Let's picture you want to deploy your awesome microproject written in PHP and you don't know where. You have found Vercel it's awesome, but for static sites. Not anymore! I would like to introduce you your new best friend vercel-php, PHP runtime for Vercel platform.
Most simple example project is this one, using following project structure.
project
├── api
│ └── index.php
└── vercel.json
First file api/index.php is entrypoint of our application. It should be placed in api folder, it's very standard location for Vercel.
<?phpphpinfo();
Second file vercel.json is pure gold here. Setup your project with configuration like this and voila. That's all.
{
"functions": {
"api/*.php": {
"runtime": "vercel-php@0.9.0"
}
}
}
Last thing you have to do is call vercel. If you are more interested take a look at features and usage.
# Install it globally
npm i -g vercel
# Log in
vercel login
# Let's fly
vercel

Are you ready to deploy your first PHP project to Vercel? Click & Go!
🤗 Features
  • Architecture: PHP development server (🚀 fast enough)
  • PHP version: 8.5 (https://example-php-8-5.vercel.app)
  • Extensions: apcu, bcmath, brotli, bz2, calendar, Core, ctype, curl, date, dom, ds, exif, fileinfo, filter, ftp, geoip, gettext, hash, iconv, igbinary, imap, intl, json, libxml, lua, mbstring, mongodb, msgpack, mysqli, mysqlnd, openssl, pcntl, pcre, PDO, pdo_mysql, pdo_pgsql, pdo_sqlite, pgsql, phalcon, Phar, protobuf, readline, redis, Reflection, runkit7, session, SimpleXML, soap, sockets, sodium, SPL, sqlite3, standard, swoole, timecop, tokenizer, uuid, xml, xmlreader, xmlrpc, xmlwriter, xsl, Zend OPcache, zlib, zip
  • Speed: cold ~250ms / warm ~5ms
  • Memory: ~90mb
  • Frameworks: Nette, Symfony, Lumen, Slim, Phalcon
  • Node.js: 22.x
List of all installable extensions is on this page https://blog.remirepo.net/pages/PECL-extensions-RPM-status.
💯 Versions
⚙️ Usage
Before you can start using this runtime, you should learn about Vercel and how runtimes works. Take a look at blogpost about Serverless Functions.
You should define functions property in vercel.json and list PHP files directly or using wildcard (*).
If you need to route everything to index, use routes property.
{
"functions": {
"api/*.php": {
"runtime": "vercel-php@0.9.0"
}
},
"routes": [
{ "src": "/(.*)", "dest": "/api/index.php" }
]
}
Do you have more questions (❓)? Let's move to FAQ.
👨‍💻 vercel dev
For running vercel dev properly, you need to have PHP installed on your computer, learn more.
But it's PHP and as you know PHP has built-in development server. It works out of box.
php -S localhost:8000 api/index.php

👀 Demo
PHP
🎯Examples
Browse more examples. 👀
📜 Resources
🚧 Roadmap
See roadmap issue. Help wanted.
⁉️ FAQ
1. How to use more then one endpoint (index.php)?
project
├── api
│ ├── index.php
│ ├── users.php
│ └── books.php
└── vercel.json
{
"functions": {
"api/*.php": {
"runtime": "vercel-php@0.9.0"
},
// Can be list also directly
"api/index.php": {
"runtime": "vercel-php@0.9.0"
},
"api/users.php": {
"runtime": "vercel-php@0.9.0"
},
"api/books.php": {
"runtime": "vercel-php@0.9.0"
}
}
}

2. How to route everything to index?
{
"functions": {
"api/index.php": {
"runtime": "vercel-php@0.9.0"
}
},
"routes": [
{ "src": "/(.*)", "dest": "/api/index.php" }
]
}
3. How to update memory limit?
Additional function properties are memory, maxDuration. Learn more about functions.
{
"functions": {
"api/*.php": {
"runtime": "vercel-php@0.9.0",
"memory": 3008,
"maxDuration": 60
}
}
}
4. How to use it with Composer?
Yes, Composer is fully supported.
project
├── api
│ └── index.php
├── composer.json
└── vercel.json
{
"functions": {
"api/*.php": {
"runtime": "vercel-php@0.9.0"
}
}
}
{
"require": {
"php": "^8.1",
"tracy/tracy": "^2.0"
}
}
It's also good thing to create .vercelignore file and put /vendor folder to this file. It will not upload
/vendor folder to Vercel platform.
5. How to override php.ini / php configuration ?
Yes, you can override php configuration. Take a look at default configuration at first.
Create a new file api/php.ini and place there your configuration. Don't worry, this particulary file will be
removed during building phase on Vercel.
project
├── api
│ ├── index.php
│ └── php.ini
└── vercel.json
{
"functions": {
"api/*.php": {
"runtime": "vercel-php@0.9.0"
}
}
}
# Disable some functionsdisable_functions = "exec, system"# Update memory limitmemory_limit=1024M
6. How to exclude some files or folders ?
Runtimes support excluding some files or folders, take a look at doc.
{
"functions": {
"api/**/*.php": {
"runtime": "vercel-php@0.9.0",
"excludeFiles": "{foo/**,bar/config/*.yaml}",
}
}
If you want to exclude files before uploading them to Vercel, use .vercelignore file.
7. How to call composer script(s) ?
Calling composer scripts during build phase on Vercel is supported via script named vercel. You can easilly call php, npm or node.
{
"require": { ... },
"require-dev": { ... },
"scripts": {
"vercel": [
"@php -v",
"npm -v"
]
}
}
Files created during composer run vercel script can be used (require/include) in your PHP lambdas, but can't be accessed from browser (like assets). If you still want to access them, create fake assets.php lambda and require them. Example of PHP satis.
8. How to include some files of folders?
If you are looking for config.includeFiles in runtime, unfortunately you can't include extra files.
All files in root folder are uploaded to Vercel, use .vercelignore to exclude them before upload.
9. How to develop locally?
I think the best way at this moment is use PHP Development Server.
php -S localhost:8000 api/index.php

10. What Node.js runtime is supported?
Use 22.x.
👨🏻‍💻CHANGELOG
Show me CHANGELOG
🧙Contribution
  1. Clone this repository.

    • git clone git@github.com:juicyfx/vercel-php.git
  2. Install NPM dependencies

    • make install
  3. Make your changes
  4. Run TypeScript compiler

    • make build
  5. Run tests

    • make test
  6. Create a PR
📝 License
Copyright © 2019 f3l1x.
This project is MIT licensed.
About
🐘 PHP Runtime for ▲ Vercel Serverless Functions (support 7.4-8.5)
php.vercel.app
Topics
awslambdaphpruntimeserverlessvercel
Resources
Readme
MIT license
Activity
Custom properties
Stars
1.5k stars
Watchers
22 watching
Forks
332 forks
Report repository
Releases
Packages
Used by
Contributors
Languages

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Remove or un-stick sticky/fixed headers that block content\n(function() {\n function unstick() {\n document.querySelectorAll('header, nav, [role=\"banner\"], .header, .navbar, .sticky, .fixed-top, [style*=\"position: fixed\"], [style*=\"position:sticky\"]').forEach(function(el) {\n if (el.style.position === 'fixed' || el.style.position === 'sticky' || \n getComputedStyle(el).position === 'fixed' || getComputedStyle(el).position === 'sticky') {\n el.style.position = 'static';\n el.style.top = 'auto';\n el.style.zIndex = 'auto';\n }\n });\n }\n \n unstick();\n \n var observer = new MutationObserver(unstick);\n observer.observe(document.body, { childList: true, subtree: true, attributes: true, attributeFilter: ['style', 'class'] });\n})();", "Kill Sticky Headers");
}
} catch(__e) { console.warn('[Userscript:Kill Sticky Headers]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '

Skip to content
BranchesTags
Repository files navigation
PHP Runtime for Vercel

Enjoyable & powerful 🐘 PHP Runtime (php.vercel.app) for Vercel platform.

🏋️‍♀️ It works with these frameworks and tools. Discover more at examples.

Made with ❤️ by @f3l1x (f3l1x.io) • 🐦 @xf3l1x
😎 Getting Started
Let's picture you want to deploy your awesome microproject written in PHP and you don't know where. You have found Vercel it's awesome, but for static sites. Not anymore! I would like to introduce you your new best friend vercel-php, PHP runtime for Vercel platform.
Most simple example project is this one, using following project structure.
project
├── api
│ └── index.php
└── vercel.json
First file api/index.php is entrypoint of our application. It should be placed in api folder, it's very standard location for Vercel.
<?phpphpinfo();
Second file vercel.json is pure gold here. Setup your project with configuration like this and voila. That's all.
{
"functions": {
"api/*.php": {
"runtime": "vercel-php@0.9.0"
}
}
}
Last thing you have to do is call vercel. If you are more interested take a look at features and usage.
# Install it globally
npm i -g vercel
# Log in
vercel login
# Let's fly
vercel

Are you ready to deploy your first PHP project to Vercel? Click & Go!
🤗 Features
  • Architecture: PHP development server (🚀 fast enough)
  • PHP version: 8.5 (https://example-php-8-5.vercel.app)
  • Extensions: apcu, bcmath, brotli, bz2, calendar, Core, ctype, curl, date, dom, ds, exif, fileinfo, filter, ftp, geoip, gettext, hash, iconv, igbinary, imap, intl, json, libxml, lua, mbstring, mongodb, msgpack, mysqli, mysqlnd, openssl, pcntl, pcre, PDO, pdo_mysql, pdo_pgsql, pdo_sqlite, pgsql, phalcon, Phar, protobuf, readline, redis, Reflection, runkit7, session, SimpleXML, soap, sockets, sodium, SPL, sqlite3, standard, swoole, timecop, tokenizer, uuid, xml, xmlreader, xmlrpc, xmlwriter, xsl, Zend OPcache, zlib, zip
  • Speed: cold ~250ms / warm ~5ms
  • Memory: ~90mb
  • Frameworks: Nette, Symfony, Lumen, Slim, Phalcon
  • Node.js: 22.x
List of all installable extensions is on this page https://blog.remirepo.net/pages/PECL-extensions-RPM-status.
💯 Versions
⚙️ Usage
Before you can start using this runtime, you should learn about Vercel and how runtimes works. Take a look at blogpost about Serverless Functions.
You should define functions property in vercel.json and list PHP files directly or using wildcard (*).
If you need to route everything to index, use routes property.
{
"functions": {
"api/*.php": {
"runtime": "vercel-php@0.9.0"
}
},
"routes": [
{ "src": "/(.*)", "dest": "/api/index.php" }
]
}
Do you have more questions (❓)? Let's move to FAQ.
👨‍💻 vercel dev
For running vercel dev properly, you need to have PHP installed on your computer, learn more.
But it's PHP and as you know PHP has built-in development server. It works out of box.
php -S localhost:8000 api/index.php

👀 Demo
PHP
🎯Examples
Browse more examples. 👀
📜 Resources
🚧 Roadmap
See roadmap issue. Help wanted.
⁉️ FAQ
1. How to use more then one endpoint (index.php)?
project
├── api
│ ├── index.php
│ ├── users.php
│ └── books.php
└── vercel.json
{
"functions": {
"api/*.php": {
"runtime": "vercel-php@0.9.0"
},
// Can be list also directly
"api/index.php": {
"runtime": "vercel-php@0.9.0"
},
"api/users.php": {
"runtime": "vercel-php@0.9.0"
},
"api/books.php": {
"runtime": "vercel-php@0.9.0"
}
}
}

2. How to route everything to index?
{
"functions": {
"api/index.php": {
"runtime": "vercel-php@0.9.0"
}
},
"routes": [
{ "src": "/(.*)", "dest": "/api/index.php" }
]
}
3. How to update memory limit?
Additional function properties are memory, maxDuration. Learn more about functions.
{
"functions": {
"api/*.php": {
"runtime": "vercel-php@0.9.0",
"memory": 3008,
"maxDuration": 60
}
}
}
4. How to use it with Composer?
Yes, Composer is fully supported.
project
├── api
│ └── index.php
├── composer.json
└── vercel.json
{
"functions": {
"api/*.php": {
"runtime": "vercel-php@0.9.0"
}
}
}
{
"require": {
"php": "^8.1",
"tracy/tracy": "^2.0"
}
}
It's also good thing to create .vercelignore file and put /vendor folder to this file. It will not upload
/vendor folder to Vercel platform.
5. How to override php.ini / php configuration ?
Yes, you can override php configuration. Take a look at default configuration at first.
Create a new file api/php.ini and place there your configuration. Don't worry, this particulary file will be
removed during building phase on Vercel.
project
├── api
│ ├── index.php
│ └── php.ini
└── vercel.json
{
"functions": {
"api/*.php": {
"runtime": "vercel-php@0.9.0"
}
}
}
# Disable some functionsdisable_functions = "exec, system"# Update memory limitmemory_limit=1024M
6. How to exclude some files or folders ?
Runtimes support excluding some files or folders, take a look at doc.
{
"functions": {
"api/**/*.php": {
"runtime": "vercel-php@0.9.0",
"excludeFiles": "{foo/**,bar/config/*.yaml}",
}
}
If you want to exclude files before uploading them to Vercel, use .vercelignore file.
7. How to call composer script(s) ?
Calling composer scripts during build phase on Vercel is supported via script named vercel. You can easilly call php, npm or node.
{
"require": { ... },
"require-dev": { ... },
"scripts": {
"vercel": [
"@php -v",
"npm -v"
]
}
}
Files created during composer run vercel script can be used (require/include) in your PHP lambdas, but can't be accessed from browser (like assets). If you still want to access them, create fake assets.php lambda and require them. Example of PHP satis.
8. How to include some files of folders?
If you are looking for config.includeFiles in runtime, unfortunately you can't include extra files.
All files in root folder are uploaded to Vercel, use .vercelignore to exclude them before upload.
9. How to develop locally?
I think the best way at this moment is use PHP Development Server.
php -S localhost:8000 api/index.php

10. What Node.js runtime is supported?
Use 22.x.
👨🏻‍💻CHANGELOG
Show me CHANGELOG
🧙Contribution
  1. Clone this repository.

    • git clone git@github.com:juicyfx/vercel-php.git
  2. Install NPM dependencies

    • make install
  3. Make your changes
  4. Run TypeScript compiler

    • make build
  5. Run tests

    • make test
  6. Create a PR
📝 License
Copyright © 2019 f3l1x.
This project is MIT licensed.
About
🐘 PHP Runtime for ▲ Vercel Serverless Functions (support 7.4-8.5)
php.vercel.app
Topics
awslambdaphpruntimeserverlessvercel
Resources
Readme
MIT license
Activity
Custom properties
Stars
1.5k stars
Watchers
22 watching
Forks
332 forks
Report repository
Releases
Packages
Used by
Contributors
Languages

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Universal Dark Mode - works on any site\n(function() {\n var enabled = true;\n \n function applyDarkMode() {\n if (!enabled) return;\n \n // Create style element if it doesn't exist\n var style = document.getElementById('universal-dark-mode-style');\n if (!style) {\n style = document.createElement('style');\n style.id = 'universal-dark-mode-style';\n document.head.appendChild(style);\n }\n \n // Dark mode CSS - inverts colors but preserves images/video\n style.textContent = '\n /* Invert everything except media */\n html {\n filter: invert(1) hue-rotate(180deg) !important;\n background: #1a1a2e !important;\n }\n \n /* Restore images, videos, iframes, canvas */\n img, video, iframe, canvas, svg, picture, [style*=\"background-image\"] {\n filter: invert(1) hue-rotate(180deg) !important;\n }\n \n /* Preserve specific elements that should not be inverted */\n .no-dark-mode, .no-dark-mode *,\n [data-theme=\"light\"], [data-theme=\"light\"],\n .ace_editor, .ace_editor *,\n .CodeMirror, .CodeMirror *,\n .monaco-editor, .monaco-editor *,\n .markdown-body pre, .markdown-body pre *,\n .highlight, .highlight *,\n pre code, pre code * {\n filter: none !important;\n }\n \n /* Fix common UI elements */\n .modal, .popup, .dropdown-menu, .tooltip, .popover {\n filter: invert(1) hue-rotate(180deg) !important;\n background: #2d2d44 !important;\n border-color: #444 !important;\n }\n \n /* Scrollbars */\n ::-webkit-scrollbar { background: #1a1a2e !important; }\n ::-webkit-scrollbar-thumb { background: #444 !important; }\n ::-webkit-scrollbar-thumb:hover { background: #555 !important; }\n \n /* Selection */\n ::selection { background: #4ecdc4 !important; color: #1a1a2e !important; }\n ::-moz-selection { background: #4ecdc4 !important; color: #1a1a2e !important; }\n ';\n }\n \n function removeDarkMode() {\n var style = document.getElementById('universal-dark-mode-style');\n if (style) style.remove();\n }\n \n // Toggle with Alt+Shift+D\n document.addEventListener('keydown', function(e) {\n if (e.altKey && e.shiftKey && e.key === 'D') {\n e.preventDefault();\n enabled = !enabled;\n if (enabled) {\n applyDarkMode();\n console.log('[Universal Dark Mode] Enabled');\n } else {\n removeDarkMode();\n console.log('[Universal Dark Mode] Disabled');\n }\n }\n });\n \n // Apply on load\n applyDarkMode();\n \n // Re-apply on dynamic content\n var observer = new MutationObserver(function(mutations) {\n if (enabled && !document.getElementById('universal-dark-mode-style')) {\n applyDarkMode();\n }\n });\n observer.observe(document.head, { childList: true });\n \n console.log('[Universal Dark Mode] Loaded - Press Alt+Shift+D to toggle');\n})();", "Universal Dark Mode");
}
} catch(__e) { console.warn('[Userscript:Universal Dark Mode]', __e); }
})();
})();

Skip to content
BranchesTags
Repository files navigation
PHP Runtime for Vercel

Enjoyable & powerful 🐘 PHP Runtime (php.vercel.app) for Vercel platform.

🏋️‍♀️ It works with these frameworks and tools. Discover more at examples.

Made with ❤️ by @f3l1x (f3l1x.io) • 🐦 @xf3l1x
😎 Getting Started
Let's picture you want to deploy your awesome microproject written in PHP and you don't know where. You have found Vercel it's awesome, but for static sites. Not anymore! I would like to introduce you your new best friend vercel-php, PHP runtime for Vercel platform.
Most simple example project is this one, using following project structure.
project
├── api
│ └── index.php
└── vercel.json
First file api/index.php is entrypoint of our application. It should be placed in api folder, it's very standard location for Vercel.
<?phpphpinfo();
Second file vercel.json is pure gold here. Setup your project with configuration like this and voila. That's all.
{
"functions": {
"api/*.php": {
"runtime": "vercel-php@0.9.0"
}
}
}
Last thing you have to do is call vercel. If you are more interested take a look at features and usage.
# Install it globally
npm i -g vercel
# Log in
vercel login
# Let's fly
vercel

Are you ready to deploy your first PHP project to Vercel? Click & Go!
🤗 Features
  • Architecture: PHP development server (🚀 fast enough)
  • PHP version: 8.5 (https://example-php-8-5.vercel.app)
  • Extensions: apcu, bcmath, brotli, bz2, calendar, Core, ctype, curl, date, dom, ds, exif, fileinfo, filter, ftp, geoip, gettext, hash, iconv, igbinary, imap, intl, json, libxml, lua, mbstring, mongodb, msgpack, mysqli, mysqlnd, openssl, pcntl, pcre, PDO, pdo_mysql, pdo_pgsql, pdo_sqlite, pgsql, phalcon, Phar, protobuf, readline, redis, Reflection, runkit7, session, SimpleXML, soap, sockets, sodium, SPL, sqlite3, standard, swoole, timecop, tokenizer, uuid, xml, xmlreader, xmlrpc, xmlwriter, xsl, Zend OPcache, zlib, zip
  • Speed: cold ~250ms / warm ~5ms
  • Memory: ~90mb
  • Frameworks: Nette, Symfony, Lumen, Slim, Phalcon
  • Node.js: 22.x
List of all installable extensions is on this page https://blog.remirepo.net/pages/PECL-extensions-RPM-status.
💯 Versions
⚙️ Usage
Before you can start using this runtime, you should learn about Vercel and how runtimes works. Take a look at blogpost about Serverless Functions.
You should define functions property in vercel.json and list PHP files directly or using wildcard (*).
If you need to route everything to index, use routes property.
{
"functions": {
"api/*.php": {
"runtime": "vercel-php@0.9.0"
}
},
"routes": [
{ "src": "/(.*)", "dest": "/api/index.php" }
]
}
Do you have more questions (❓)? Let's move to FAQ.
👨‍💻 vercel dev
For running vercel dev properly, you need to have PHP installed on your computer, learn more.
But it's PHP and as you know PHP has built-in development server. It works out of box.
php -S localhost:8000 api/index.php

👀 Demo
PHP
🎯Examples
Browse more examples. 👀
📜 Resources
🚧 Roadmap
See roadmap issue. Help wanted.
⁉️ FAQ
1. How to use more then one endpoint (index.php)?
project
├── api
│ ├── index.php
│ ├── users.php
│ └── books.php
└── vercel.json
{
"functions": {
"api/*.php": {
"runtime": "vercel-php@0.9.0"
},
// Can be list also directly
"api/index.php": {
"runtime": "vercel-php@0.9.0"
},
"api/users.php": {
"runtime": "vercel-php@0.9.0"
},
"api/books.php": {
"runtime": "vercel-php@0.9.0"
}
}
}

2. How to route everything to index?
{
"functions": {
"api/index.php": {
"runtime": "vercel-php@0.9.0"
}
},
"routes": [
{ "src": "/(.*)", "dest": "/api/index.php" }
]
}
3. How to update memory limit?
Additional function properties are memory, maxDuration. Learn more about functions.
{
"functions": {
"api/*.php": {
"runtime": "vercel-php@0.9.0",
"memory": 3008,
"maxDuration": 60
}
}
}
4. How to use it with Composer?
Yes, Composer is fully supported.
project
├── api
│ └── index.php
├── composer.json
└── vercel.json
{
"functions": {
"api/*.php": {
"runtime": "vercel-php@0.9.0"
}
}
}
{
"require": {
"php": "^8.1",
"tracy/tracy": "^2.0"
}
}
It's also good thing to create .vercelignore file and put /vendor folder to this file. It will not upload
/vendor folder to Vercel platform.
5. How to override php.ini / php configuration ?
Yes, you can override php configuration. Take a look at default configuration at first.
Create a new file api/php.ini and place there your configuration. Don't worry, this particulary file will be
removed during building phase on Vercel.
project
├── api
│ ├── index.php
│ └── php.ini
└── vercel.json
{
"functions": {
"api/*.php": {
"runtime": "vercel-php@0.9.0"
}
}
}
# Disable some functionsdisable_functions = "exec, system"# Update memory limitmemory_limit=1024M
6. How to exclude some files or folders ?
Runtimes support excluding some files or folders, take a look at doc.
{
"functions": {
"api/**/*.php": {
"runtime": "vercel-php@0.9.0",
"excludeFiles": "{foo/**,bar/config/*.yaml}",
}
}
If you want to exclude files before uploading them to Vercel, use .vercelignore file.
7. How to call composer script(s) ?
Calling composer scripts during build phase on Vercel is supported via script named vercel. You can easilly call php, npm or node.
{
"require": { ... },
"require-dev": { ... },
"scripts": {
"vercel": [
"@php -v",
"npm -v"
]
}
}
Files created during composer run vercel script can be used (require/include) in your PHP lambdas, but can't be accessed from browser (like assets). If you still want to access them, create fake assets.php lambda and require them. Example of PHP satis.
8. How to include some files of folders?
If you are looking for config.includeFiles in runtime, unfortunately you can't include extra files.
All files in root folder are uploaded to Vercel, use .vercelignore to exclude them before upload.
9. How to develop locally?
I think the best way at this moment is use PHP Development Server.
php -S localhost:8000 api/index.php

10. What Node.js runtime is supported?
Use 22.x.
👨🏻‍💻CHANGELOG
Show me CHANGELOG
🧙Contribution
  1. Clone this repository.

    • git clone git@github.com:juicyfx/vercel-php.git
  2. Install NPM dependencies

    • make install
  3. Make your changes
  4. Run TypeScript compiler

    • make build
  5. Run tests

    • make test
  6. Create a PR
📝 License
Copyright © 2019 f3l1x.
This project is MIT licensed.
About
🐘 PHP Runtime for ▲ Vercel Serverless Functions (support 7.4-8.5)
php.vercel.app
Topics
awslambdaphpruntimeserverlessvercel
Resources
Readme
MIT license
Activity
Custom properties
Stars
1.5k stars
Watchers
22 watching
Forks
332 forks
Report repository
Releases
Packages
Used by
Contributors
Languages