Verzeichnisstruktur phpBB-3.3.16
- Veröffentlicht
- 27.04.2026
So funktioniert es
|
|
Auf das letzte Element klicken. Dies geht jeweils ein Schritt zurück |
Auf das Icon klicken, dies öffnet das Verzeichnis. Nochmal klicken schließt das Verzeichnis. |
|
|
(Beispiel Datei-Icons)
|
Auf das Icon klicken um den Quellcode anzuzeigen |
vagrant.md
001 ## Using Vagrant with phpBB
002
003 phpBB includes support for Vagrant. This allows developers and contributors to run phpBB without the need to set up their own local web server with traditional WAMP/MAMP stacks. It also provides a consistent environment between developers for writing and debugging code changes more productively.
004
005 phpBB uses the [Laravel/Homestead](https://laravel.com/docs/5.1/homestead) Vagrant box. It runs a Linux server with Ubuntu, PHP 7.2, Apache, SQLite3, MySQL, and a whole lot more (complete specs below).
006
007 ## Get Started
008
009 * Download and Install [Vagrant](https://www.vagrantup.com/downloads.html)
010 * Download and Install [VirtualBox](https://www.virtualbox.org/wiki/Downloads)
011 * Run `vagrant up` from the `vagrant` directory of your cloned fork of the phpBB Git repository
012
013 ```sh
014 $ cd vagrant
015 $ ../composer.phar install
016 $ vagrant up
017 ```
018
019 * Access phpBB at `http://192.168.56.56/`
020 * Username: **admin**
021 * Password: **adminadmin**
022
023 ## Additional commands:
024 * Access your Linux server from the command line:
025
026 ```sh
027 $ vagrant ssh
028 ```
029
030 * Pause your server:
031
032 ```sh
033 $ vagrant suspend
034 ```
035
036 * Shut down your server:
037
038 ```sh
039 $ vagrant halt
040 ```
041
042 * Delete and remove your server:
043
044 ```sh
045 $ vagrant destroy
046 ```
047
048 > Note: destroying the vagrant server will remove all traces of the VM from your computer, reclaiming any disk space used by it. However, it also means the next time you vagrant up, you will be creating a brand new VM with a fresh install of phpBB and a new database.
049
050 ## Customising the phpBB configuration
051
052 By default, phpBB is pre-configured to install with a MySQL database. You can, however, switch to PostegreSQL or SQLite3 by editing the `phpbb-install-config.yml` file in the vagrant directory. The next time you run `vagrant up` (or `vagrant provision`) it will be installed under the new configuration.
053
054 If you prefer to access phpBB from the more friendly URL `http://phpbb.app` then you must update your computer's hosts file. This file is typically located at `/etc/hosts` for Mac/Linux or `C:\Windows\System32\drivers\etc\hosts` for Windows. Open this file and add the following line to it, at the very bottom, and save.
055
056 ```
057 192.168.56.56 phpbb.app
058 ```
059
060 ## How it all works
061
062 When you vagrant up, the Laravel/Homestead box is transparently loaded as a Virtual Machine on your computer (this may take several minutes the very first time while it downloads the VM image to your computer). Your local phpBB repository clone is mirrored/shared with the VM, so you can work on the phpBB code on your computer, and see the changes immediately when you browse to phpBB at the URL provided by the VM.
063
064 This is very similar to traditional methods of working with a local WAMP/MAMP stack, except the webserver is now being provided by a VM of a Linux server. The advantages here are the exact same Linux server environment is being used by everybody who uses Vagrant with phpBB, so there will be consist behaviour unlike when everybody is developing on different versions of PHP, server configurations, etc.
065
066 The environment is also "sandboxed" from your system. This means you don't need to worry about adjusting your own computer's internal PHP settings, setting up databases, or doing damage to your system or to phpBB. Other than the phpBB codebase, which lives on your computer, all execution is taking place within the VM and you can at any time, halt or destroy the VM and start a brand new one.
067
068 There are some caveats, however. You can only run one vagrant VM for the phpBB repository. And of course, the database will be destroyed when you vagrant destroy. If the database is important, you should SSH into your vagrant VM and export/import the DB as needed using SSH commands.
069
070 For example, to export/import a MySQL database (using phpBB's `store` directory):
071
072 SSH into the VM
073
074 ```sh
075 $ vagrant ssh
076 ```
077
078 Export MySQL:
079
080 ```sh
081 $ mysqldump -uhomestead -psecret phpbb > /home/vagrant/phpbb/phpBB/store/phpbb.sql
082 ```
083
084 Import MySQL:
085
086 ```sh
087 $ mysql -uhomestead -psecret phpbb < /home/vagrant/phpbb/phpBB/store/phpbb.sql
088 ```
089
090 ---
091
092 ## About the Laravel/Homestead box
093
094 ### Included Software
095
096 * Ubuntu
097 * Git
098 * PHP 7.2
099 * HHVM
100 * Apache
101 * MySQL
102 * Sqlite3
103 * Postgres
104 * Composer
105 * Node (With PM2, Bower, Grunt, and Gulp)
106 * Redis
107 * Memcached
108 * Beanstalkd
109 * Blackfire Profiler
110
111 ### MySQL Access
112
113 - Hostname: 127.0.0.1
114 - Username: homestead
115 - Password: secret
116 - Database: phpbb
117 - Port: 3306
118
119 ### PostgreSQL Access
120
121 - Hostname: 127.0.0.1
122 - Username: homestead
123 - Password: secret
124 - Database: phpbb
125 - Port: 5432
126