Use Vite's speed and tooling to process PHP-files!
// vite.config.js
import { defineConfig } from 'vite';
import usePHP from 'vite-plugin-php';
export default defineConfig({
plugins: [usePHP()],
});Check out the starter repo for an easy and convenient start:
<!-- index.php -->
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8" />
<meta http-equiv="X-UA-Compatible" content="IE=edge" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
</head>
<body>
<?="Render some text with PHP!";?>
<?php if(isset($_GET['dont_load'])) { ?>
<script src="./src/some_script.js" type="module"></script>
<?php } ?>
</body>
</html>The plugin will serve you the processed index.php as usual, including all imported and preprocessed files that are supported by Vite and other loaders.
By default the plugin is trying to access the system php-binary and load the index.php file as the main entry point.
However you have the possibility to use an other binary or even compile multiple entry-points:
usePHP({
binary: '/opt/lampp/bin/php-8.1.10',
entry: ['index.php', 'about.php', 'contact.php'],
});Should you have multiple entry-points, you will be able to access each one according to this chart:
| Entry file | Accessible routes | Build file |
|---|---|---|
| index.php | / /index /index.php |
index.php |
| about.php | /about /about.php |
about.php |
| about/details.php | /about/details /about/details.php |
about/details.php |
| contact.php | /contact /contact.php |
contact.php |
| shop/index.php | /shop/ /shop/index.php |
shop/index.php |
| ... | ... | ... |
⚡️ New feature: Wildcard selectors!
Since version 1.0.6 you can specify wildcard entry points:
usePHP({
binary: '/opt/lampp/bin/php-8.1.10',
entry: [
'index.php',
'about.php',
'contact.php',
'pages/**/*.php',
'partials/*.php',
],
});These entries will also render according to the routing table above.
Vite won't be able to process PHP-computed styles, scripts or images:
<script src="./src/<?='dynamic_script_name';?>.js" type="module"></script>If you encounter any other bugs or need some other features feel free to open an issue.
Love open source? Enjoying my project?
Your support can keep the momentum going! Consider a donation to fuel the creation of more innovative open source software.
| via Ko-Fi | Buy me a coffee | via PayPal |
|
|
|
