Verzeichnisstruktur phpBB-3.2.0


Veröffentlicht
06.01.2017

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.
Auf den Verzeichnisnamen klicken, dies zeigt nur das Verzeichnis mit Inhalt an

      (Beispiel Datei-Icons)

Auf das Icon klicken um den Quellcode anzuzeigen

vagrant.md

Zuletzt modifiziert: 09.10.2024, 12:51 - Dateigröße: 4.37 KiB


 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 14.04, PHP 5.6, Nginx, 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 root of your cloned fork of the phpBB Git repository
 012   
 013  ```sh
 014  $ vagrant up
 015  ```
 016   
 017  * Access phpBB at `http://192.168.10.10/`
 018  * Username: **admin**
 019  * Password: **adminadmin**
 020   
 021  ## Additional commands:
 022  * Access your Linux server from the command line:
 023   
 024  ```sh
 025  $ vagrant ssh
 026  ```
 027   
 028  * Pause your server:
 029   
 030  ```sh
 031  $ vagrant suspend
 032  ```
 033   
 034  * Shut down your server:
 035   
 036  ```sh
 037  $ vagrant halt
 038  ```
 039   
 040  * Delete and remove your server:
 041   
 042  ```sh
 043  $ vagrant destroy
 044  ```
 045   
 046  > 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.
 047   
 048  ## Customising the phpBB configuration
 049   
 050  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.
 051   
 052  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.
 053   
 054  ```
 055  192.168.10.10  phpbb.app
 056  ```
 057   
 058  ## How it all works
 059   
 060  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.
 061   
 062  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.
 063   
 064  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.
 065   
 066  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.
 067   
 068  For example, to export/import a MySQL database (using phpBB's `store` directory):
 069   
 070  SSH into the VM
 071   
 072  ```sh
 073  $ vagrant ssh
 074  ```
 075   
 076  Export MySQL:
 077   
 078  ```sh
 079  $ mysqldump -uhomestead -psecret phpbb > /home/vagrant/phpbb/phpBB/store/phpbb.sql
 080  ```
 081   
 082  Import MySQL:
 083   
 084  ```sh
 085  $ mysql -uhomestead -psecret phpbb < /home/vagrant/phpbb/phpBB/store/phpbb.sql
 086  ```
 087   
 088  ---
 089   
 090  ## About the Laravel/Homestead box
 091   
 092  ### Included Software
 093   
 094  * Ubuntu 14.04
 095  * Git
 096  * PHP 5.6
 097  * HHVM
 098  * Nginx
 099  * MySQL
 100  * Sqlite3
 101  * Postgres
 102  * Composer
 103  * Node (With PM2, Bower, Grunt, and Gulp)
 104  * Redis
 105  * Memcached
 106  * Beanstalkd
 107  * Blackfire Profiler
 108   
 109  ### MySQL Access
 110   
 111  - Hostname: 127.0.0.1
 112  - Username: homestead
 113  - Password: secret
 114  - Database: phpbb
 115  - Port: 3306
 116   
 117  ### PostgreSQL Access
 118   
 119  - Hostname: 127.0.0.1
 120  - Username: homestead
 121  - Password: secret
 122  - Database: phpbb
 123  - Port: 5432
 124