macOS 11.0 Big Sur Apache Setup: flera PHP-versioner

Del 1: macOS 11.0 Big Sur webbutvecklingsmiljö

att utveckla webbapplikationer på MacOS är en riktig glädje. Det finns många alternativ för att ställa in dina utvecklingsmiljöer, inklusive den ständigt populära MAMP Pro som ger ett bra användargränssnitt ovanpå Apache, PHP och MySQL. Det finns dock tillfällen då MAMP Pro har långsamma nedgångar, eller föråldrade versioner, eller helt enkelt beter sig dåligt på grund av sitt restriktiva system med konfigurationsmallar och icke-standardiserade byggnader.

det är tider som dessa att människor ofta letar efter ett alternativt tillvägagångssätt, och lyckligtvis finns det en, och det är relativt rakt fram att installera.

i det här blogginlägget kommer vi att gå igenom att konfigurera och konfigurera Apache 2.4 och flera PHP-versioner. I det andra blogginlägget i den här tvåpostserien kommer vi att täcka MySQL, Apache virtuella värdar, APC-caching och Xdebug-installation.

Om du inte redan har XCode installerat är det bäst att först installera kommandoradsverktygen eftersom dessa kommer att användas av homebrew:

xcode-select --install

Homebrew Installation

denna process är starkt beroende av macOS-pakethanteraren som heter Homebrew. Med kommandotbrew kan du enkelt lägga till kraftfull funktionalitet till din mac, men först måste vi installera den. Det här är en enkel process, men du måste starta din Terminal (/Applications/Utilities/Terminal) och ange sedan:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install.sh)"

följ bara terminalanvisningarna och ange ditt lösenord där det behövs. Det kan ta några minuter, men när det är klart, ett snabbt sätt att se till att du har installerat brew korrekt, skriv helt enkelt:

brew --version

Homebrew 2.5.10Homebrew/homebrew-core (git revision 542ff0; last commit 2020-11-13)

Du bör antagligen också köra följande kommando för att säkerställa att allt är korrekt konfigurerat:

brew doctor

det kommer att instruera dig om du behöver korrigera något.

Big Sur obligatoriska Bibliotek

När jag installerade fresh på Big Sur stötte jag på några bibliotek som saknades när jag slutförde alla stegen nedan. För att göra det enklare, vänligen helt enkelt köra detta nu:

brew install openssl

Apache Installation

aden senaste macOS 11.0 Big Sur levereras med Apache 2.4 förinstallerad, men det är inte längre en enkel uppgift att använda den här versionen med Homebrew eftersom Apple har tagit bort några nödvändiga skript i den här versionen. Lösningen är dock att installera Apache 2.4 via Homebrew och sedan konfigurera den så att den körs på standardportarna (80/443).

Om du redan har den inbyggda Apache igång, måste det vara avstängning först, och alla auto-lastning skript bort. Det gör verkligen inte ont att bara köra alla dessa kommandon i ordning – även om det är en ny installation:

sudo apachectl stopsudo launchctl unload -w /System/Library/LaunchDaemons/org.apache.httpd.plist 2>/dev/null

Nu måste vi installera den nya versionen som tillhandahålls av Brew:

brew install httpd

utan alternativ, httpd behöver inte byggas från källan, så det installeras ganska snabbt. När du är klar bör du se ett meddelande som:

🍺 /usr/local/Cellar/httpd/2.4.46: 1,658 files, 27.9MB

Nu behöver vi bara konfigurera saker så att vår nya Apache-server startas automatiskt

brew services start httpd

Du har nu installerat homebrews Apache och konfigurerat den för att starta automatiskt med ett privilegierat konto. Det borde redan vara igång, så du kan försöka nå din server i en webbläsare genom att peka den på http://localhost:8080, du borde se en enkel rubrik som säger ”Det fungerar!”.

felsökningstips

om du får ett meddelande om att webbläsaren inte kan ansluta till servern, kontrollera först att servern är uppe.

ps -aef | grep httpd

Du bör se några httpd-processer om Apache är igång.

försök att starta om Apache med:

brew services restart httpd

Du kan titta på Apache-felloggen i en ny Terminal flik / fönster under en omstart för att se om något är ogiltigt eller orsakar ett problem:

tail -f /usr/local/var/log/httpd/error_log

Apache styrs via kommandotbrew services så några användbara kommandon att använda är:

$ brew services stop httpd$ brew services start httpd$ brew services restart httpd

Visual Studio Code

i tidigare guider har jag alltid gett instruktioner för att redigera filer med standardTextEdit program som kommer förinstallerat. Men det här är inte vad jag använder mig själv eftersom det är en hemsk redaktör och när jag testade min guide för Big Sur fortsatte jag att stöta på problem med kodning, hitta radnummer etc. Den bättre lösningen är att helt enkelt installera en bättre redaktör. Så installera den otroligt mångsidiga men ändå 100% gratis Visual Studio-koden. Den är tillgänglig på Mac, Windows och Linux, men just nu bryr vi oss bara om mac-versionen.

gå till Visual Studio Code-webbplatsen och klicka på Ladda ner för Mac

När du har laddat ner drar du programmet till din önskade applikationsplats. Därefter vill du installera kommandoradsverktygen, så följ de officiella steg-för-steg-instruktionerna så att du kan använda kommandot code från terminalen.

Apache-konfiguration

Nu när vi har en fungerande webbserver vill vi göra några konfigurationsändringar så att det fungerar bättre som en lokal utvecklingsserver.

i den senaste versionen av Brew måste du manuellt ställa in lyssningsporten från standard 8080 till 80, så vi måste redigera Apaches konfigurationsfil /usr/local/etc/httpd/httpd.conf.

om du följde instruktionerna ovan bör du kunna använda Visual Studio-kod för att redigera dina filer med kommandotcode Terminal. Men om du vill använda Standardtexteditor-programmet för att utföra redigeringar kan du använda kommandot open -e följt av sökvägen till filen.

code /usr/local/etc/httpd/httpd.conf

hitta raden som säger

Listen 8080

och ändra den till 80:

Listen 80

nästa konfigurerar vi den för att använda för att ändra dokumentroten för Apache. Det här är mappen där Apache ser ut att tjäna filen från. Som standard är dokumentroten konfigurerad som /usr/local/var/www. Eftersom det här är en utvecklingsmaskin, låt oss anta att vi vill ändra dokumentroten för att peka på en mapp i vår egen hemkatalog.

Sök efter termen DocumentRoot, och du bör se följande rad:

DocumentRoot "/usr/local/var/www"

ändra detta för att peka på din användarkatalog där your_user är namnet på ditt användarkonto:

DocumentRoot /Users/your_user/Sites

Du måste också ändra <Directory> taggreferens precis under DocumentRoot-raden. Detta bör också ändras för att peka på din nya dokumentrot också:

<Directory "/Users/your_user/Sites">

i samma<Directory> – block hittar du en AllowOverride – inställning, detta bör ändras enligt följande:

## AllowOverride controls what directives may be placed in .htaccess files.# It can be "All", "None", or any combination of the keywords:# AllowOverride FileInfo AuthConfig Limit#AllowOverride All

Vi bör också nu aktivera mod_rewrite som kommenteras som standard. Sök efter mod_rewrite.so och Avkommentera linjen genom att ta bort den ledande # genom att trycka ⌘/ på linjen (detta är ett snabbt sätt att Avkommentera och kommentera en eller flera rader:

LoadModule rewrite_module lib/httpd/modules/mod_rewrite.so

användare & grupp

nu har vi Apache-konfigurationen som pekar på en Sites mapp i vår hemkatalog. Ett problem finns dock fortfarande. Som Standard körs apache som användaren daemon och grupp daemon. Detta kommer att orsaka behörighetsproblem när du försöker komma åt filer i vår hemkatalog. Ungefär en tredjedel av vägen ner i filen httpd.conf det finns två inställningar för att ställa in User och Group Apache kommer att köras under. Ändra dessa för att matcha ditt användarkonto (ersätt your_user med ditt riktiga användarnamn), med en grupp av staff:

User your_userGroup staff

servernamn

Apache gillar att ha ett servernamn i konfigurationen, men detta är inaktiverat som standard, så sök efter:

#ServerName www.example.com:8080

och ersätt det med:

ServerName localhost

sites folder

nu måste du skapa en Sites mapp i roten till din hemkatalog. Du kan göra detta i din terminal eller i Finder. I denna nyaSites mapp skapa en enkel index.html och sätta några dummy innehåll i det som: <h1>My User Web Root</h1>.

mkdir ~/Sitesecho "<h1>My User Web Root</h1>" > ~/Sites/index.html

Starta om apache för att säkerställa att dina konfigurationsändringar har trätt i kraft:

brew services stop httpdbrew services start httpd

Om du pekar din webbläsare på http://localhost ska du visa ditt nya meddelande. Om du har att arbeta, vi kan gå vidare!

felsökning av icke-Sudo httpd-tjänster Start

i år, med macOS Big Sur, har jag bytt från att använda sudo för att starta httpd med root (även om det körde som användaren/gruppen definierad i httpd.conf), och för personer som har uppgraderat från den versionen till det här har det varit problem.

jag stötte på några problem själv men kunde få det att fungera ganska enkelt, men andra har rapporterat mer utbredda problem. Försök med dessa steg om din Apache inte startar när du använder brew services start httpd.

försök först att starta apache direkt med:

/usr/local/bin/httpd -k start

detta kringgår kommandot brew services och skriver ofta ut specifika problem. Om du har problem rapporterade om att inte kunna skriva till loggfiler, försök ta bort alla aktuella log httpd loggfiler:

rm -Rf /usr/local/var/log/httpd/*

försök sedan starta igen.

Om du har ett meddelande som säger något som Address already in use: AH00072: make_sock: could not bind to address, försök ändra Listen config i httpd.conf till:

Listen 0.0.0.0:80

PHP Installation

fram till slutet av mars 2018 hanterades alla PHP – relaterade bryggningar avHomebrew/php fliken, men det har blivit föråldrat, så nu använder vi vad som finns tillgängligt i paketetHomebrew/core. Detta borde vara en bättre underhållen, men är en mycket mindre komplett uppsättning paket.

PHP 5.6, PHP 7.0 och PHP 7.1 har avlägsnats och tagits bort från Brew eftersom de inte har stöd, och även om det inte rekommenderas för produktion finns det legitima skäl att testa dessa versioner som inte stöds i en utvecklingsmiljö. Dessa versioner måste också ”byggd från källan”för att kunna använda de senaste versionerna av icu4c och openssl.

Kom ihåg att endast PHP 7.2 till 7.4 stöds officiellt av Brew, men dessa måste också byggas vilket är ganska långsamt. För den senaste versionen av vår guide kommer vi att använda den nya kranen från @shivammahtur eftersom det finns många versioner (inklusive PHP 8.0-byggnader) förbyggda.

PHP 8.0 har precis släppts och du kan installera det, men det kan ta lite tid för kompatibla PHP-moduler är fullt tillgängliga.

brew tap shivammathur/php

vi fortsätter genom att installera olika versioner av PHP och använda ett enkelt skript för att växla mellan dem som vi behöver. Uteslut gärna alla versioner du inte vill installera.

brew install shivammathur/php/[email protected] install shivammathur/php/[email protected] install shivammathur/php/[email protected] install shivammathur/php/[email protected] install shivammathur/php/[email protected] install shivammathur/php/[email protected] install shivammathur/php/[email protected]

Du kan också behöva justera konfigurationsinställningarna för PHP efter dina behov. En vanlig sak att ändra är minnesinställningen ellerdate.timezone konfiguration. Filerna php.ini för varje version av PHP finns i följande kataloger:

/usr/local/etc/php/5.6/php.ini/usr/local/etc/php/7.0/php.ini/usr/local/etc/php/7.1/php.ini/usr/local/etc/php/7.2/php.ini/usr/local/etc/php/7.3/php.ini/usr/local/etc/php/7.4/php.ini/usr/local/etc/php/8.0/php.ini

Vi har installerat men INTE länkat dessa PHP-versioner. För att byta till PHP 5.6 till exempel kan vi skriva:

brew unlink php && brew link --overwrite --force [email protected]

snabbtest att vi är i rätt version:

php -v

PHP 5.6.40 (cli) (built: Jul 2 2020 04:41:54) Copyright (c) 1997-2016 The PHP GroupZend Engine v2.6.0, Copyright (c) 1998-2016 Zend Technologies with Zend OPcache v7.0.6-dev, Copyright (c) 1999-2016, by Zend Technologies

och att byta till att 7.4:

brew unlink php && brew link --overwrite --force [email protected]

och kontrollera att den har ändrats korrekt:

php -v

PHP 7.4.12 (cli) (built: Oct 30 2020 00:56:27) ( NTS )Copyright (c) The PHP GroupZend Engine v3.4.0, Copyright (c) Zend Technologies with Zend OPcache v7.4.12, Copyright (c), by Zend Technologies

Apache PHP Setup – Part 1

Du har installerat dina PHP-versioner, men vi måste berätta Apache att använda dem. Du måste återigen redigera /usr/local/etc/httpd/httpd.conf – filen bläddra till botten av LoadModule – posterna.

om du har följt den här guiden korrekt bör den sista posten vara din mod_rewrite modul:

LoadModule rewrite_module lib/httpd/modules/mod_rewrite.so

under detta lägg till följandelibphp moduler:

LoadModule php5_module /usr/local/opt/[email protected]/lib/httpd/modules/libphp5.so#LoadModule php7_module /usr/local/opt/[email protected]/lib/httpd/modules/libphp7.so#LoadModule php7_module /usr/local/opt/[email protected]/lib/httpd/modules/libphp7.so#LoadModule php7_module /usr/local/opt/[email protected]/lib/httpd/modules/libphp7.so#LoadModule php7_module /usr/local/opt/[email protected]/lib/httpd/modules/libphp7.so#LoadModule php7_module /usr/local/opt/[email protected]/lib/httpd/modules/libphp7.so#LoadModule php_module /usr/local/opt/[email protected]/lib/httpd/modules/libphp.so

Vi kan bara ha en modul som behandlar PHP åt gången, så för nu, så vi har lämnat vår [email protected] post uncommented medan alla andra kommenteras. Detta kommer att berätta för Apache att använda PHP 5.6 för att hantera PHP-förfrågningar. (Vi lägger till möjligheten att byta PHP-versioner senare).

Du måste också ange katalogindex för PHP uttryckligen, så sök efter det här blocket:

<IfModule dir_module> DirectoryIndex index.html</IfModule>

och ersätt det med detta:

<IfModule dir_module> DirectoryIndex index.php index.html</IfModule><FilesMatch \.php$> SetHandler application/x-httpd-php</FilesMatch>

spara filen och stoppa Apache och starta sedan igen, nu när vi har installerat PHP:

brew services stop httpdbrew services start httpd

validera PHP-Installation

det bästa sättet att testa om PHP är installerat och körs som förväntat är att använda phpinfo(). Detta är inte något du vill lämna på en produktionsmaskin, men det är ovärderligt i en utvecklingsmiljö.

skapa helt enkelt en fil som heter info.php I din Sites/ mapp som du skapade tidigare med den här enfodret.

echo "<?php phpinfo();" > ~/Sites/info.php

peka din webbläsare på http://localhost/info.php och du bör se en blank PHP-informationssida:

om du ser ett liknande phpinfo-resultat, grattis! Du har nu Apache och PHP som körs framgångsrikt. Du kan testa de andra PHP-versionerna genom att kommenteraLoadModule ... [email protected] ... posten och uncommenting en av de andra. Starta sedan om apache och ladda om samma sida.

PHP Switcher Script

Vi hårdkodade Apache för att använda PHP 5.6, men vi vill verkligen kunna växla mellan versioner. Lyckligtvis har vissa flitiga individer redan gjort det hårda arbetet för oss och skrivit ett mycket praktiskt litet PHP switcher-skript.

vi installerar sphp skriptet i brews standard /usr/local/bin:

curl -L https://gist.githubusercontent.com/rhukster/f4c04f1bf59e0b74e335ee5d186a98e2/raw/0c36a5067fbd63e6a36700a6aaa119df0836bdfc/sphp.sh > /usr/local/bin/sphpchmod +x /usr/local/bin/sphp

kontrollera din sökväg

Homebrew borde ha lagt till sitt föredragna /usr/local/bin och /usr/local/sbin till din sökväg som en del av installationsprocessen. Testa snabbt detta genom att skriva:

echo $PATH/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin

om du inte ser detta, försök först att stänga din terminal och starta om den. Om det inte fungerar, kontrollera att du har /usr/local/bin före /usr/bin och /usr/local/sbin före /usr/sbin I sökvägsdefinitionen för ditt ~/.zshrc fil. Du kan göra det tillfälligt i skalet genom att skriva:

export PATH=/usr/local/bin:/usr/local/sbin:$PATH

testa PHP-växlingen

När du har slutfört dessa steg bör du kunna byta PHP-version genom att använda kommandot sphp följt av ett tvåsiffrigt värde för PHP-versionen:

sphp 7.1

Du kan byta PHP-version kommer förmodligen att behöva ange ditt administratörslösenord, och det bör ge dig lite feedback:

Switching to [email protected]

Switching to [email protected] your shellUnlinking /usr/local/Cellar/[email protected]/5.6.40... 0 symlinks removedUnlinking /usr/local/Cellar/[email protected]/7.1.33... 0 symlinks removedUnlinking /usr/local/Cellar/[email protected]/7.2.34... 0 symlinks removedUnlinking /usr/local/Cellar/php/7.4.12... 24 symlinks removedLinking /usr/local/Cellar/php/7.4.12... 24 symlinks createdSwitching your apache confRestarting apachePHP 7.4.12 (cli) (built: Oct 30 2020 00:56:27) ( NTS )Copyright (c) The PHP GroupZend Engine v3.4.0, Copyright (c) Zend Technologies with Zend OPcache v7.4.12, Copyright (c), by Zend TechnologiesAll done!

test för att se om din Apache nu kör PHP 7.4 genom att återigen peka din webbläsare till http://localhost/info.php. Med lite tur bör du se något så här:

felsökning av PHP-växling

Om du har uppgraderat från en tidigare version av den här guiden och har installerat PHP8 kan du se meddelande som: Unknown version of PHP. PHP Switcher can only handle arguments of: 5.6,7.0,7.1,7.2,7.3,7.4, måste du installera om sphp skript som har uppdaterats.

om du får ett meddelande om motstridiga PHP-versioner, har du förmodligen en konflikt med kranar. Du måste avinstallera dina tidigare PHP-versioner, ta bort den gamla kranen, lägg sedan till den nya kranen och installera sedan om PHP-versioner med syntaxen ovan. Till exempel:

brew untap exolnet/deprecatedbrew tap shivammathur/phpbrew install shivammathur/php/[email protected]

testa din installation med Grav CMS!

vilket bättre sätt att testa din nya kraftfulla installation än att snabbt installera och testa Grav. Den bästa platt-fil CMS i världen bisexuell! Vi kan göra detta med bara ett par snabba terminalkommandon:

cd ~/Sitescurl -OJL https://getgrav.org/download/core/grav-admin/latest

 % Total % Received % Xferd Average Speed Time Time Time Current Dload Upload Total Spent Left Speed 0 0 0 0 0 0 0 0 --:--:-- --:--:-- --:--:-- 0100 646 100 646 0 0 1664 0 --:--:-- --:--:-- --:--:-- 1664100 10.5M 100 10.5M 0 0 8198k 0 0:00:01 0:00:01 --:--:-- 21.6Mcurl: Saved to filename 'grav-admin-v1.6.28.zip'

extrahera sedan zip-filen:

unzip grav-admin-v1.6.28.zip

detta kommer att extrahera zip till en ~/Sites/grav-admin mapp. Peka sedan helt enkelt din webbläsare på den här katalogen http://localhost/grav-admin:

fyll i relevant information för att skapa en ny administratörsanvändare och klicka bara på Skapa användare för att komma in i administratören. Inga andra steg behövs.

allt klart!!!!

uppdatering av PHP och andra Brew-paket

Brew gör det superenkelt att uppdatera PHP och de andra paketen du installerar. Det första steget är att uppdatera Brew så att det får en lista över tillgängliga uppdateringar:

brew update

detta kommer att spotta ut en lista över tillgängliga uppdateringar och eventuella raderade formler. För att uppgradera paketen skriver du bara:

brew upgrade

aktivera specifika/senaste PHP-versioner

På grund av hur vår PHP-länkning är inställd är endast en version av PHP länkad åt gången, bara den nuvarande aktiva versionen av PHP kommer att uppdateras till den senaste versionen. Du kan se den aktuella aktiva versionen genom att skriva:

php -v

och du kan se de specifika versionerna av ett PHP-paket genom att skriva:

brew info [email protected]

PHP 7.4.12 (cli) (built: Oct 30 2020 00:56:27) ( NTS )Copyright (c) The PHP GroupZend Engine v3.4.0, Copyright (c) Zend Technologies with Zend OPcache v7.4.12, Copyright (c), by Zend Technologiesrhuk@macos-big-sur ~ % brew info [email protected]: stable 7.4.12 (bottled), HEADGeneral-purpose scripting languagehttps://www.php.net//usr/local/Cellar/php/7.4.12 (497 files, 72.2MB) * Poured from bottle on 2020-11-13 at 11:57:43From: https://github.com/Homebrew/homebrew-core/blob/HEAD/Formula/php.rbLicense: PHP-3.01==> DependenciesBuild: httpd ✔, pkg-config ✔Required: apr ✔, apr-util ✔, argon2 ✔, aspell ✔, autoconf ✔, curl-openssl ✔, freetds ✔, gd ✔, gettext ✔, glib ✔, gmp ✔, icu4c ✔, krb5 ✔, libffi ✔, libpq ✔, libsodium ✔, libzip ✔, oniguruma ✔, openldap ✔, [email protected] ✔, pcre2 ✔, sqlite ✔, tidy-html5 ✔, unixodbc ✔...

OK, som sveper upp Del 1 av denna 3 del serien har du nu en fullt fungerande Apache 2.4 installation med ett snabbt och enkelt sätt att växla mellan PHP 5.6, 7.0, 7.1, 7.2, 7.3, 7.4, och 8.0. Kolla in Del 2 för att ta reda på hur du ställer in din miljö med MySQL, virtuella värdar, APC-caching, YAML och Xdebug. Ta också en gander på Del 3 för att ta reda på hur du ställer in SSL för dina Apache virtuella värdar.