2017 © Pedro Peláez
 

application phpmyfaq

FAQ System

image

phpmyfaq/phpmyfaq

FAQ System

  • Tuesday, July 31, 2018
  • by thorsten
  • Repository
  • 48 Watchers
  • 377 Stars
  • 3 Installations
  • PHP
  • 0 Dependents
  • 0 Suggesters
  • 179 Forks
  • 186 Open issues
  • 70 Versions
  • 0 % Grown

The README.md

phpMyFAQ 4.1-dev

Packagist PHP Version Support GitHub GitHub commit activity Documentation Status, (*1)

What is phpMyFAQ?

phpMyFAQ is a multilingual, completely database-driven FAQ-system. It supports various databases to store all data; PHP 8.2+ is needed to access this data. phpMyFAQ also offers a multi-language Content Management System with a WYSIWYG editor and a media manager, real time search support with Elasticsearch, flexible multi-user support with user and group based permissions on categories and records, a wiki-like revision feature, a news system, user-tracking, 40+ supported languages, enhanced automatic content negotiation, HTML5/CSS3 based responsive templates, PDF-support, a backup and restore system, a dynamic sitemap, related FAQs, tagging, enhanced SEO features, built-in spam protection systems, Microsoft Entra ID, Microsoft Active Directory and OpenLDAP support, and an easy-to-use installation and update script., (*2)

Requirements

phpMyFAQ is only supported on PHP 8.2 and up, you need a database as well. Supported databases are MySQL, MariaDB, Percona Server, PostgreSQL, Microsoft SQL Server and SQLite3. If you want to use Elasticsearch as the main search engine, you need Elasticsearch 6.x or later. Check our detailed requirements on phpmyfaq.de for more information., (*3)

Installation

phpMyFAQ installation package for end-users

The best way to install phpMyFAQ is to download it on phpmyfaq.de, unzip the package and open http://www.example.org/phpmyfaq/setup/index.php in your preferred browser., (*4)

phpMyFAQ installation with Docker

Dockerfile

The Dockerfile provided in this repo only builds an environment to run any release for development purpose. It does not contain any code as the phpmyfaq folder is meant to be mounted as the /var/www/html folder in the container., (*5)

docker-compose.yml

For development purposes, you can start a full stack to run your current PhpMyFAQ source code from your local repo., (*6)

$ docker-compose up

The command above starts nine containers for multi database development as following., (*7)

Specific images started once to prepare the project:, (*8)

  • composer: update composer dependencies
  • pnpm: update pnpm dependencies

Running using named volumes:, (*9)

  • mariadb: image with MariaDB database with xtrabackup support
  • phpmyadmin: a PHP tool to have a look at your MariaDB database.
  • postgres: image with PostgreSQL database
  • pgadmin: a PHP tool to have a look at your PostgreSQL database.
  • sqlserver: image with Microsoft SQL Server for Linux
  • elasticsearch: Open Source Software image (it means it does not have XPack installed)

Running apache web server with PHP 8.4 support:, (*10)

  • phpmyfaq: mounts the phpmyfaq folder in place of /var/www/html.

Then services will be available at the following addresses:, (*11)

  • phpMyFAQ: (https://localhost:443 or http://localhost:8080 as fallback)
  • phpMyAdmin: (http://localhost:8000)
  • pgAdmin: (http://localhost:8008)

Running tests

To run the test using Docker, you have to install the Composer development dependencies, (*12)

$ curl -s https://getcomposer.org/installer | php
$ php composer.phar install
$ php composeer.phar test

Quote from Elasticsearch documentation

The vm.max_map_count kernel setting needs to be set to at least 262144 for production use. Depending on your platform:, (*13)

Linux

The vm.max*map_count setting should be set permanently in */etc/sysctl.conf_:, (*14)

$ grep vm.max_map_count /etc/sysctl.conf
vm.max_map_count=262144

To apply the setting on a live system type: sysctl -w vm.max_map_count=262144, (*15)

macOS with Docker for Mac

The vm.max_map_count setting must be set within the xhyve virtual machine:, (*16)

$ screen ~/Library/Containers/com.docker.docker/Data/com.docker.driver.amd64-linux/tty

Log in with root and no password. Then configure the sysctl setting as you would for Linux:, (*17)

$ sysctl -w vm.max_map_count=262144
Windows and macOS with Docker Toolbox

The vm.max_map_count setting must be set via docker-machine:, (*18)

$ docker-machine ssh
$ sudo sysctl -w vm.max_map_count=262144

phpMyFAQ local installation from Github

To run phpMyFAQ locally, you need at least a running web server with PHP support and a database., (*19)

$ git clone git://github.com/thorsten/phpMyFAQ.git
$ cd phpMyFAQ
$ git checkout main
$ curl -s https://getcomposer.org/installer | php
$ php composer.phar install
$ curl -fsSL https://get.pnpm.io/install.sh | sh -
$ pnpm install
$ pnpm build

Then just open http://www.example.org/phpmyfaq/setup/index.php in your browser., (*20)

Testing

PHP

To run our unit tests via PHPUnit v11.x, just execute this command on your CLI, (*21)

$ curl -s https://getcomposer.org/installer | php
$ php composer.phar install
$ ./vendor/bin/phpunit

Please note that phpMyFAQ needs to be installed via Composer., (*22)

Javascript

To run our Javascript tests via Jest, just execute this command on your CLI, (*23)

$ curl -fsSL https://get.pnpm.io/install.sh | sh -
$ pnpm install
$ pnpm test

Versioning

For transparency and insight into our release cycle, and for striving to maintain backward compatibility, phpMyFAQ will be maintained under the Semantic Versioning guidelines as much as possible., (*24)

Releases will be numbered with the following format:, (*25)

<major>.<minor>.<patch>, (*26)

And constructed with the following guidelines:, (*27)

  • Breaking backward compatibility bumps the major (and resets the minor and patch)
  • New additions without breaking backward compatibility bumps the minor (and resets the patch)
  • Bug fixes and misc changes bumps the patch

For more information on SemVer, please visit http://semver.org/., (*28)

Issue tracker

Found a bug, or do you have a feature request? Please open a new issue. Before opening any issue, please search for existing issues., (*29)

Contributing

Please check out our page about contributing on phpmyfaq.de., (*30)

Documentation

You can read the complete documentation on here., (*31)

REST API v3.0 documentation

The REST API documentation is available as OpenAPI 3.0 specification:, (*32)

The Swagger UI is available at https://api-docs.phpmyfaq.de/., (*33)

Discord server

If you like to chat with the phpMyFAQ team, please join our Discord server. We're happy to help you with your questions!, (*34)

License

Mozilla Public License 2.0, see LICENSE for more information., (*35)

Copyright © 2001–2024 Thorsten Rinne and the phpMyFAQ Team, (*36)

The Versions

01/01 2018

2.10.x-dev

2.10.9999999.9999999-dev http://www.phpmyfaq.de

FAQ System

  Sources   Download

MPL 2.0

The Requires

 

The Development Requires

by Thorsten Rinne

faq phpmyfaq

19/07 2017
31/05 2016

2.8.x-dev

2.8.9999999.9999999-dev http://www.phpmyfaq.de

FAQ System

  Sources   Download

MPL 2.0

The Requires

 

The Development Requires

by Thorsten Rinne

faq phpmyfaq

31/05 2016

2.8.29

2.8.29.0 http://www.phpmyfaq.de

FAQ System

  Sources   Download

MPL 2.0

The Requires

 

The Development Requires

by Thorsten Rinne

faq phpmyfaq

12/05 2016

2.8.28

2.8.28.0 http://www.phpmyfaq.de

FAQ System

  Sources   Download

MPL 2.0

The Requires

 

The Development Requires

by Thorsten Rinne

faq phpmyfaq

17/04 2016
11/04 2016
11/04 2016

2.8.27

2.8.27.0 http://www.phpmyfaq.de

FAQ System

  Sources   Download

MPL 2.0

The Requires

 

The Development Requires

by Thorsten Rinne

faq phpmyfaq

20/03 2016
12/03 2016
11/02 2016

2.8.26

2.8.26.0 http://www.phpmyfaq.de

FAQ System

  Sources   Download

MPL 2.0

The Requires

 

The Development Requires

by Thorsten Rinne

faq phpmyfaq

06/01 2016
05/12 2015

2.9.0-beta

2.9.0.0-beta http://www.phpmyfaq.de

FAQ System

  Sources   Download

MPL 2.0

The Requires

 

The Development Requires

by Thorsten Rinne

faq phpmyfaq

05/12 2015

2.8.25

2.8.25.0 http://www.phpmyfaq.de

FAQ System

  Sources   Download

MPL 2.0

The Requires

 

The Development Requires

by Thorsten Rinne

faq phpmyfaq

22/09 2015

2.9.0-alpha4

2.9.0.0-alpha4 http://www.phpmyfaq.de

FAQ System

  Sources   Download

MPL 2.0

The Requires

 

The Development Requires

by Thorsten Rinne

faq phpmyfaq

29/08 2015

2.9.0-alpha3

2.9.0.0-alpha3 http://www.phpmyfaq.de

FAQ System

  Sources   Download

MPL 2.0

The Requires

 

The Development Requires

by Thorsten Rinne

faq phpmyfaq

27/07 2015

2.8.24

2.8.24.0 http://www.phpmyfaq.de

FAQ System

  Sources   Download

MPL 2.0

The Requires

 

The Development Requires

by Thorsten Rinne

faq phpmyfaq

13/06 2015

2.8.23

2.8.23.0 http://www.phpmyfaq.de

FAQ System

  Sources   Download

MPL 2.0

The Requires

 

The Development Requires

by Thorsten Rinne

faq phpmyfaq

31/03 2015

2.8.22

2.8.22.0 http://www.phpmyfaq.de

FAQ System

  Sources   Download

MPL 2.0

The Requires

 

The Development Requires

by Thorsten Rinne

faq phpmyfaq

28/02 2015

2.8.21

2.8.21.0 http://www.phpmyfaq.de

FAQ System

  Sources   Download

MPL 2.0

The Requires

 

The Development Requires

by Thorsten Rinne

faq phpmyfaq

07/02 2015

2.8.20

2.8.20.0 http://www.phpmyfaq.de

FAQ System

  Sources   Download

MPL 2.0

The Requires

 

The Development Requires

by Thorsten Rinne

faq phpmyfaq

01/02 2015

2.9.0-alpha2

2.9.0.0-alpha2 http://www.phpmyfaq.de

FAQ System

  Sources   Download

MPL 2.0

The Requires

 

The Development Requires

by Thorsten Rinne

faq phpmyfaq

31/12 2014

2.8.19

2.8.19.0 http://www.phpmyfaq.de

FAQ System

  Sources   Download

MPL 2.0

The Requires

 

The Development Requires

by Thorsten Rinne

faq phpmyfaq

30/11 2014

2.8.18

2.8.18.0 http://www.phpmyfaq.de

FAQ System

  Sources   Download

MPL 2.0

The Requires

 

The Development Requires

by Thorsten Rinne

faq phpmyfaq

05/11 2014

2.8.17

2.8.17.0 http://www.phpmyfaq.de

FAQ System

  Sources   Download

MPL 2.0

The Requires

 

The Development Requires

by Thorsten Rinne

faq phpmyfaq

03/11 2014

2.8.16

2.8.16.0 http://www.phpmyfaq.de

FAQ System

  Sources   Download

MPL 2.0

The Requires

 

The Development Requires

by Thorsten Rinne

faq phpmyfaq

02/10 2014

2.8.15

2.8.15.0 http://www.phpmyfaq.de

FAQ System

  Sources   Download

MPL 2.0

The Requires

 

The Development Requires

by Thorsten Rinne

faq phpmyfaq

01/10 2014

2.8.14

2.8.14.0 http://www.phpmyfaq.de

FAQ System

  Sources   Download

MPL 2.0

The Requires

 

The Development Requires

by Thorsten Rinne

faq phpmyfaq

16/09 2014

2.8.13

2.8.13.0 http://www.phpmyfaq.de

FAQ System

  Sources   Download

MPL 2.0

The Requires

 

The Development Requires

by Thorsten Rinne

faq phpmyfaq

12/08 2014

2.9.0-alpha

2.9.0.0-alpha http://www.phpmyfaq.de

FAQ System

  Sources   Download

MPL 2.0

The Requires

 

The Development Requires

by Thorsten Rinne

faq phpmyfaq

02/08 2014

2.8.12

2.8.12.0 http://www.phpmyfaq.de

FAQ System

  Sources   Download

MPL 2.0

The Requires

 

The Development Requires

by Thorsten Rinne

faq phpmyfaq

28/06 2014

2.8.11

2.8.11.0 http://www.phpmyfaq.de

FAQ System

  Sources   Download

MPL 2.0

The Requires

 

The Development Requires

by Thorsten Rinne

faq phpmyfaq

30/05 2014

2.8.10

2.8.10.0 http://www.phpmyfaq.de

FAQ System

  Sources   Download

MPL 2.0

The Requires

 

The Development Requires

by Thorsten Rinne

faq phpmyfaq

28/04 2014

2.8.9

2.8.9.0 http://www.phpmyfaq.de

FAQ System

  Sources   Download

MPL 2.0

The Requires

 

The Development Requires

by Thorsten Rinne

faq phpmyfaq

18/03 2014

2.8.8

2.8.8.0 http://www.phpmyfaq.de

FAQ System

  Sources   Download

MPL 2.0

The Requires

 

The Development Requires

by Thorsten Rinne

faq phpmyfaq

05/02 2014

2.8.7

2.8.7.0 http://www.phpmyfaq.de

FAQ System

  Sources   Download

MPL 2.0

The Requires

 

The Development Requires

by Thorsten Rinne

faq phpmyfaq

04/02 2014

2.8.6

2.8.6.0 http://www.phpmyfaq.de

FAQ System

  Sources   Download

MPL 2.0

The Requires

 

The Development Requires

by Thorsten Rinne

faq phpmyfaq

30/12 2013

2.8.5

2.8.5.0 http://www.phpmyfaq.de

FAQ System

  Sources   Download

MPL 2.0

The Requires

 

by Thorsten Rinne

faq phpmyfaq

26/11 2013

2.8.4

2.8.4.0 http://www.phpmyfaq.de

FAQ System

  Sources   Download

MPL 2.0

The Requires

 

by Thorsten Rinne

faq phpmyfaq

18/11 2013

2.8.3

2.8.3.0 http://www.phpmyfaq.de

FAQ System

  Sources   Download

MPL 2.0

The Requires

 

by Thorsten Rinne

faq phpmyfaq

25/07 2013

2.8.2

2.8.2.0 http://www.phpmyfaq.de

FAQ System

  Sources   Download

MPL 2.0

The Requires

 

by Thorsten Rinne

faq phpmyfaq

26/06 2013

2.8.1

2.8.1.0 http://www.phpmyfaq.de

FAQ System

  Sources   Download

MPL 2.0

The Requires

 

by Thorsten Rinne

faq phpmyfaq

21/05 2013

2.8.0

2.8.0.0 http://www.phpmyfaq.de

FAQ System

  Sources   Download

MPL 2.0

The Requires

 

by Thorsten Rinne

faq phpmyfaq

18/04 2013

2.8.0-RC4

2.8.0.0-RC4 http://www.phpmyfaq.de

FAQ System

  Sources   Download

MPL 2.0

The Requires

 

by Thorsten Rinne

faq phpmyfaq

14/03 2013

2.8.0-RC3

2.8.0.0-RC3 http://www.phpmyfaq.de

FAQ System

  Sources   Download

MPL 2.0

The Requires

 

by Thorsten Rinne

faq phpmyfaq

02/03 2013

2.8.0-RC2

2.8.0.0-RC2 http://www.phpmyfaq.de

FAQ System

  Sources   Download

MPL 2.0

The Requires

 

by Thorsten Rinne

faq phpmyfaq

12/02 2013

2.8.0-RC

2.8.0.0-RC http://www.phpmyfaq.de

FAQ System

  Sources   Download

MPL 2.0

The Requires

 

by Thorsten Rinne

faq phpmyfaq

28/01 2013

2.8.0-beta3

2.8.0.0-beta3 http://www.phpmyfaq.de

FAQ System

  Sources   Download

MPL 2.0

The Requires

 

by Thorsten Rinne

faq phpmyfaq

02/01 2013

2.8.0-beta2

2.8.0.0-beta2 http://www.phpmyfaq.de

FAQ System

  Sources   Download

MPL 2.0

The Requires

 

by Thorsten Rinne

faq phpmyfaq

30/12 2012

2.8.0-beta

2.8.0.0-beta http://www.phpmyfaq.de

FAQ System

  Sources   Download

MPL 2.0

The Requires

 

by Thorsten Rinne

faq phpmyfaq

20/11 2012

2.8.0-alpha3

2.8.0.0-alpha3 http://www.phpmyfaq.de

FAQ System

  Sources   Download

MPL 2.0

The Requires

  • php >=5.3.2
  • phpseclib master
  • tcpdf master
  • twitteroauth master

 

by Thorsten Rinne

faq phpmyfaq

27/08 2012

2.8.0-alpha2

2.8.0.0-alpha2 http://www.phpmyfaq.de

FAQ System

  Sources   Download

MPL 2.0

The Requires

  • php >=5.3.2

 

by Thorsten Rinne

faq phpmyfaq