Total Pageviews

Sunday, 7 December 2025

PHP Runtime for Vercel

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

php.vercel.app

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.

<?php
phpinfo();

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.7.4"
    }
  }
}

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.3 (https://example-php-8-3.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.7.4"
    }
  },
  "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.7.4"
    },

    // Can be list also directly

    "api/index.php": {
      "runtime": "vercel-php@0.7.4"
    },
    "api/users.php": {
      "runtime": "vercel-php@0.7.4"
    },
    "api/books.php": {
      "runtime": "vercel-php@0.7.4"
    }
  }
}
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.7.4"
    },

    // Can be list also directly

    "api/index.php": {
      "runtime": "vercel-php@0.7.4"
    },
    "api/users.php": {
      "runtime": "vercel-php@0.7.4"
    },
    "api/books.php": {
      "runtime": "vercel-php@0.7.4"
    }
  }
}
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.7.4"
    },

    // Can be list also directly

    "api/index.php": {
      "runtime": "vercel-php@0.7.4"
    },
    "api/users.php": {
      "runtime": "vercel-php@0.7.4"
    },
    "api/books.php": {
      "runtime": "vercel-php@0.7.4"
    }
  }
}
2. How to route everything to index? 
{
  "functions": {
    "api/index.php": {
      "runtime": "vercel-php@0.7.4"
    }
  },
  "routes": [
    { "src": "/(.*)",  "dest": "/api/index.php" }
  ]
}
2. How to route everything to index? 
{
  "functions": {
    "api/index.php": {
      "runtime": "vercel-php@0.7.4"
    }
  },
  "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.7.4",
      "memory": 3008,
      "maxDuration": 60
    }
  }
}
3. How to update memory limit?

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

{
  "functions": {
    "api/*.php": {
      "runtime": "vercel-php@0.7.4",
      "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.7.4"
    }
  }
}
{
  "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.

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.7.4"
    }
  }
}
{
  "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.

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.7.4"
    }
  }
}
{
  "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.

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.7.4"
    }
  }
}
{
  "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 ?


    
      
    

      
    
  

    
      
    

      
    
  

    
      
    

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

    
      
    

      
    
  

    
      
    

      
    
  

    
      
    

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

    
      
    

      
    
  

    
      
    

      
    
  

    
      
    

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

    
      
    

      
    
  

    
      
    

      
    
  

    
      
    

      
    
  


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.7.4",
    "excludeFiles": "{foo/**,bar/config/*.yaml}",
  }
}

    
      
    

      
    
  


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


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.7.4",
    "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) ?

    
      
    

      
    
  
7. How to call composer script(s) ?

    
      
    

      
    
  


8. How to include some files of folders?


9. How to develop locally?

    
      
    

      
    
  
9. How to develop locally?

    
      
    

      
    
  


10. What Node.js runtime is supported?


👨🏻‍💻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
from  https://github.com/vercel-community/php










Posted by



at



























Labels:
,


















No comments:















Post a Comment


















        

      









Subscribe to:
Post Comments (Atom)