X-Git-Url: https://git.mxchange.org/?a=blobdiff_plain;f=INSTALL;h=ff755f2471e1f3396a31660dc8ff3cd9e9fe1159;hb=9e89a177c76741f7e696f09d778bd8b151f84d3f;hp=aad21756fe1c3f1976e97dcf956491604e626c95;hpb=49cf19ccfe4e86b28ab46ccbb02bccaeb3bb288e;p=quix0rs-gnu-social.git diff --git a/INSTALL b/INSTALL index aad21756fe..ff755f2471 100644 --- a/INSTALL +++ b/INSTALL @@ -26,7 +26,7 @@ PHP modules The following software packages are *required* for this software to run correctly. -- PHP 5.4+ For newer versions, some functions that are used may be +- PHP 5.5+ For newer versions, some functions that are used may be disabled by default, such as the pcntl_* family. See the section on 'Queues and daemons' for more information. - MariaDB 5+ GNU Social uses, by default, a MariaDB server for data @@ -49,6 +49,19 @@ functional setup of GNU Social: - php5-mysqlnd The native driver for PHP5 MariaDB connections. If you use MySQL, 'php5-mysql' or 'php5-mysqli' may be enough. +Or, for PHP7, some or all of these will be necessary. PHP7 support is still +experimental and not necessarily working: + php7.0-bcmath + php7.0-curl + php7.0-exif + php7.0-gd + php7.0-intl + php7.0-mbstring + php7.0-mysqlnd + php7.0-opcache + php7.0-readline + php7.0-xmlwriter + The above package names are for Debian based systems. In the case of Arch Linux, PHP is compiled with support for most extensions but they require manual enabling in the relevant php.ini file (mostly php5-gmp). @@ -109,11 +122,13 @@ especially if you've previously installed PHP/MariaDB packages. will enable "Fancy URL" support, which you can read more about if you scroll down a bit in this document. -3. Make your target directory writeable by the Web server. +3. Make your target directory writeable by the Web server, please note + however that 'a+w' will give _all_ users write access and securing the + webserver is not within the scope of this document. chmod a+w /var/www/gnusocial/ - On some systems, this will probably work: + On some systems, this will work as a more secure alternative: chgrp www-data /var/www/gnusocial/ chmod g+w /var/www/gnusocial/ @@ -122,16 +137,15 @@ especially if you've previously installed PHP/MariaDB packages. that user's default group instead. As a last resort, you can create a new group like "gnusocial" and add the Web server's user to the group. -4. You should also take this moment to make your avatar, background, and - file subdirectories writeable by the Web server. An insecure way to do +4. You should also take this moment to make your 'avatar' and 'file' sub- + directories writeable by the Web server. The _insecure_ way to do this is: chmod a+w /var/www/gnusocial/avatar - chmod a+w /var/www/gnusocial/background chmod a+w /var/www/gnusocial/file - You can also make the avatar, background, and file directories - writeable by the Web server group, as noted above. + You can also make the avatar, and file directories just writable by + the Web server group, as noted above. 5. Create a database to hold your site data. Something like this should work (you will be prompted for your database password): @@ -196,7 +210,9 @@ your server (like lighttpd or nginx). file is well commented. * For lighttpd, inspect the lighttpd.conf.example file and apply the appropriate changes in your virtualhost configuration for lighttpd. - * For nginx and other webservers, we gladly accept contributions of + * For nginx, inspect the nginx.conf.sample file and apply the appropriate + changes. + * For other webservers, we gladly accept contributions of server configuration examples. 2. Assuming your webserver is properly configured and have its settings @@ -363,12 +379,12 @@ Two mechanisms are available to achieve offline operations: ### OpportunisticQM plugin This plugin is enabled by default. It tries its best to do background -job during regular HTTP requests, like API or HTML pages calls. +jobs during regular HTTP requests, like API or HTML pages calls. Since queueing system is enabled by default, notices to be broadcasted will be stored, by default, into DB (table queue_item). -Each time it can, OpportunisticQM will try to handle some of them. +Whenever it has time, OpportunisticQM will try to handle some of them. This is a good solution whether you: