+5
日增长
15,729
stars
1,429
forks
319
watchers
807
prs
3,462
issues
411
releases
README
! Grav
Grav is a Fast, Simple, and Flexible, file-based Web-platform. There is Zero installation required. Just extract the ZIP archive, and you are already up and running. It follows similar principles to other flat-file CMS platforms, but has a different design philosophy than most. Grav comes with a powerful Package Management System to allow for simple installation and upgrading of plugins and themes, as well as simple updating of Grav itself.
The underlying architecture of Grav is designed to use well-established and _best-in-class_ technologies to ensure that Grav is simple to use and easy to extend. Some of these key technologies include:
Twig Templating: for powerful control of the user interface
Markdown: for easy content creation
YAML: for simple configuration
Parsedown: for fast Markdown and Markdown Extra support
Symfony Cache: backend layer for performance
Pimple Dependency Injection Container: for extensibility and maintainability
Symfony Event Dispatcher: for plugin event handling
Symfony Console: for CLI interface
Gregwar Image Library: for dynamic image manipulation
Requirements
- PHP 8.3 or higher. Check the required modules list
- Check the Apache or IIS requirements
Documentation
The full documentation can be found from learn.getgrav.org.
QuickStart
These are the options to get Grav:
Downloading a Grav Package
You can download a ready-built package from the Downloads page on https://getgrav.org
With Composer
You can create a new project with the latest stable Grav release with the following command:
bash
composer create-project getgrav/grav ~/webroot/grav
From GitHub
1. Clone the Grav repository from https://github.com/getgrav/grav to a folder in the webroot of your server, e.g. ~/webroot/grav. Launch a terminal or console and navigate to the webroot folder:
bash
cd ~/webroot
git clone https://github.com/getgrav/grav.git
2. Install the plugin and theme dependencies by using the Grav CLI application bin/grav:
bash
cd ~/webroot/grav
bin/grav install
Check out the install procedures for more information.
Adding Functionality
You can download plugins or themes manually from the appropriate tab on the Downloads page on https://getgrav.org, but the preferred solution is to use the Grav Package Manager or GPM:
bash
bin/gpm index
This will display all the available plugins and then you can install one or more with:
bash
bin/gpm install
Updating
To update Grav you should use the Grav Package Manager or GPM:
bash
bin/gpm selfupgrade
To update plugins and themes:
bash
bin/gpm update
Upgrading from older version
Migrating from Grav 1.x to Grav 2.0? Grav 2.0 is a major release with a PHP 8.3+ baseline and a modernized core, and upgrading requires a dedicated migration — bin/gpm selfupgrade alone will not take you across the 1.x → 2.x boundary. Follow the step-by-step guide at getgrav.org/migrate-to-2 before running any upgrade command.
Within a majTop issues
#1767Roadmap for Grav 2138 comments · 2017-11-28#2814Updating from 1.6.15 to 1.6.20 failed32 comments · 2020-02-06#343Large Website "Rebuilding" Improvements30 comments · 2015-10-03#3389Failed to save entry: Forbidden28 comments · 2021-06-29#1641Can't use custom date header25 comments · 2017-09-05#3153Scheduler not working20 comments · 2021-01-16#3297Any chance to install grav compliant to Arch Linux' web application package guidelines19 comments · 2021-03-30#453Some suggestions for the Validation and Blueprint classes18 comments · 2015-11-18
Discussions
#4371Trash Bin for Grav 2.0: deleted pages go to a trash you can restore from1 comments · 2026-10-24#4338No « save as English » button in a Multi-lingual site.1 comments · 2026-09-30#4283What do Editor Pro and other premium plugins offer?1 comments · 2026-09-03#4273Set up Grav 2.0 with Admin1 comments · 2026-09-01#4033Requesting help with custom plugin1 comments · 2026-02-12#3929Watching all discussions2 comments · 2025-06-07#3925Interoperability - Transferability1 comments · 2025-06-05#3900Issues on moving existent Grav to a different domain. Install on subdirectory but load as root.0 comments · 2025-02-06
Latest release
2.2.29 2.2.29 2026-11-11New - Log files in logs/ now rotate when they reach 10 MB: grav.log becomes grav.log.1, older copies are gzipped (grav.log.2.gz and on), and five are kept. grav.log, security.log and scheduler.log rotate as they are written, an hourly log-rotate scheduler job catches plugin logs, and bin/grav logrotate runs it by hand. Change or turn it off under system.log.rotate (Configuration → System → Error handler) - A page can unpublish everything below it along with itself. Set cascade_unpublish: true on a page (Options → "Unpublish child pages too"), and while that page is unpublished, by published: f