getgrav /grav

Modern, Crazy Fast, Ridiculously Easy and Amazingly Powerful Flat-File CMS powered by PHP, Markdown, Twig, and Symfony

★ 15,729⑂ 1,429👁 319⑃ 807● 3,462▤ 411
PHPMITCreated 2014-08-02getgrav.org
下载:2.2.292.2.29 ↓2.2.292026-11-11
+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 maj

Top issues

Discussions

Latest release

2.2.29 2.2.29 2026-11-11
New
- 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

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON