vercel-php80
v0.0.2TypeScript
Vercel PHP8 runtime
0/weekUpdated 2 years agoMITUnpacked: 42.3 KB
Published by lucifer2023
npm install vercel-php80PHP 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.
``sh`
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.
`json`
{
"functions": {
"api/*.php": {
"runtime": "vercel-php@0.5.2"
}
}
}
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.1.4
- 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
> List of all installable extensions is on this page https://blog.remirepo.net/pages/PECL-extensions-RPM-status.
💯 Versions
-
- PHP 8.1.x
- vercel-php@0.4.0 - PHP 8.0.x
- vercel-php@0.3.2 - PHP 7.4.x⚙️ 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.`json
{
"functions": {
"api/*.php": {
"runtime": "vercel-php@0.5.2"
}
},
"routes": [
{ "src": "/(.*)", "dest": "/api/index.php" }
]
}
`Do you have more questions (❓)? Let's move to FAQ.
👨💻
For running
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
- official - https://php.vercel.app/
- phpinfo - https://phpshow.vercel.app/
- extensions - https://phpshow.vercel.app/ext/
- ini - https://phpshow.vercel.app/ini/
- JSON API - https://phpshow.vercel.app/api/users.php
- test - https://phpshow.vercel.app/test.php
!PHP
🎯Examples
- PHP - fast & simple
- Composer - install dependencies
- Framework - Laravel
- Framework - Lumen
- Framework - Nette
- Framework - Phalcon
- Framework - Slim
- Framework - Symfony - Microservice
Browse more examples. 👀
📜 Resources
- 2019/10/23 - Code Examples
- 2019/10/19 - ZEIT - Deploy Serverless Microservices Right Now
- 2019/08/23 - Code Examples
- 2019/07/07 - Bleeding Edge PHP on ZEIT Now
- 2019/06/06 - Code Examples
- 2019/06/05 - ZEIT - Deploy Serverless Microservices Right Now (VIDEO)
🚧 Roadmap
See roadmap issue. Help wanted.
⁉️ FAQ
1. How to use more then one endpoint (index.php)?
sh
project
├── api
│ ├── index.php
│ ├── users.php
│ └── books.php
└── vercel.json
`
{
"functions": {
"api/*.php": {
"runtime": "vercel-php@0.5.2"
}, // Can be list also directly
"api/index.php": {
"runtime": "vercel-php@0.5.2"
},
"api/users.php": {
"runtime": "vercel-php@0.5.2"
},
"api/books.php": {
"runtime": "vercel-php@0.5.2"
}
}
}
2. How to route everything to index?
json
{
"functions": {
"api/index.php": {
"runtime": "vercel-php@0.5.2"
}
},
"routes": [
{ "src": "/(.*)", "dest": "/api/index.php" }
]
}
`
3. How to update memory limit?
Additional function properties are
, maxDuration. Learn more about functions.`json
{
"functions": {
"api/*.php": {
"runtime": "vercel-php@0.5.2",
"memory": 3008,
"maxDuration": 60
}
}
}
`
4. How to use it with Composer?
Yes, Composer is fully supported.
sh
project
├── api
│ └── index.php
├── composer.json
└── vercel.json
`json
{
"functions": {
"api/*.php": {
"runtime": "vercel-php@0.5.2"
}
}
}
`json
{
"require": {
"php": "^8.1",
"tracy/tracy": "^2.0"
}
}
`It's also good thing to create
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.`sh
project
├── api
│ ├── index.php
│ └── php.ini
└── vercel.json
`json
{
"functions": {
"api/*.php": {
"runtime": "vercel-php@0.5.2"
}
}
}
`json
Disable some functions
disable_functions = "exec, system"Update memory limit
memory_limit=1024M
`
6. How to exclude some files or folders ?
Runtimes support excluding some files or folders, take a look at doc.
json
{
"functions": {
"api/*/.php": {
"runtime": "vercel-php@0.5.2",
"excludeFiles": "{foo/*,bar/config/.yaml}",
}
}
`If you want to exclude files before uploading them to Vercel, use
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.`json
{
"require": { ... },
"require-dev": { ... },
"scripts": {
"vercel": [
"@php -v",
"npm -v"
]
}
}
`Files created during
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?
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
👨🏻💻CHANGELOG
Show me CHANGELOG
🧙Contribution
1. Clone this repository.
-
2. Install NPM dependencies
-
3. Make your changes
4. Run TypeScript compiler
-
5. Run tests
- 6. Create a PR