Accentsconagua
Share
Wat je gaat creërenWilt u meer weten over Yii? Lezen Introductie tot het Yii Framework en volg onze Yii-programmeringsreeks.
In de tutorial van vandaag leggen we uit hoe je Yii kunt installeren in een lokale ontwikkelomgeving voor zowel Windows als macOS. Voor de Windows-gids vertrouwen we op WAMP Server, een Windows-webontwikkelingsomgeving voor Apache, PHP en Mac, en voor de Mac-gids gebruiken we zijn neef, MAMP. Hoewel Rod WAMP gebruikt in de zelfstudie van vandaag, is er ook een Windows-versie van MAMP.
Ik schrijf het Mac-gedeelte van deze handleiding en mijn collega Rod Ussing schrijft de Windows-kant. Ik ontmoette Rod op de middelbare school in Californië tijdens mijn tweede programmeeropdracht, een zeer groot hexadecimaal getal in jaren geleden. Hij gebruikt nog steeds Windows, maar na acht jaar werken bij Microsoft en het opnieuw opstarten van het systeem om Outlook opnieuw te starten, vertrok ik naar macOS.
Yii is een ongelooflijk betrouwbaar, goed ontworpen, krachtig kader voor PHP, omdat Rails voor Ruby is en vergelijkbaar is met Laravel. Als je je afvraagt of je real-world applicaties kunt bouwen in Yii, ga dan naar Meeting Planner en onze Building Your Startup-serie.
Ik hou van coderen in Yii. Alles is sneller en gemakkelijker voor mij. En het is relatief eenvoudig voor zover het raamwerk gaat (dat ben ik die schaduw werpt op Rails).
We beginnen met de basis van wat Yii uniek installeert in macOS en gaan dan verder met Windows. Naarmate wat nodig is om de installatie op elk platform te voltooien, convergeert, beschrijven we de resterende instructies in een uniforme vorm voor beide platforms.
Yii Basic is de eenvoudigste vorm van Yii. Je kunt er allerlei soorten applicaties mee bouwen, maar het is het beste voor een enkele laag, bijvoorbeeld één klantgerichte kant.
Hier is de mapstructuur van een Yii Basic-applicatie met slechts een reeks mappen voor een enkele applicatie:
assets / bevat commando's voor het definiëren van assets / bevat console-opdrachten (controllers) config / bevat toepassingsconfiguraties controllers / bevat webcontrollerklassen mail / bevat viewbestanden voor e-mailmodellen / bevat modelklassen runtime / bevat bestanden die zijn gegenereerd tijdens runtimetests / bevat verschillende tests voor de leverancier van de basisapplicatie / bevat afhankelijke weergaven van derden van derden / bevat weergavebestanden voor het webtoepassingsweb / bevat het invoerscript en webbronnen
De geavanceerde projectsjabloon Yii 2 is de beste oplossing voor het ontwikkelen van complexe webtoepassingen met meerdere lagen, zoals frontend, back-end en console, die elk een afzonderlijke Yii-toepassing zijn. Administratieve sites kunnen bijvoorbeeld op de achtergrond worden uitgevoerd en cron-taken kunnen in de console-omgeving worden uitgevoerd.
Hier is echter de mapstructuur voor een Yii Advanced-toepassing met meerdere niveaus:
common config / bevat gedeelde configuraties mail / bevat weergavebestanden voor e-mailmodellen / bevat modelklassen die worden gebruikt in zowel backend- als frontend-tests / bevat tests voor gemeenschappelijke klassen console config / bevat consoleconfiguraties controllers / bevat consolebesturingen (opdrachten) migraties / bevat database migratiemodellen / bevat console-specifieke modelklassen runtime / bevat bestanden gegenereerd tijdens runtime backend-assets / bevat applicatie-assets zoals JavaScript en CSS config / bevat backend-configuraties controllers / bevat Web controller classes models / bevat backend-specifieke modelklassen runtime / contains bestanden gegenereerd tijdens runtime testen / bevat tests voor backend applicatie views / bevat weergavebestanden voor het webtoepassingsweb / bevat het invoerscript en webresources frontend assets / bevat applicatie-assets zoals JavaScript en CSS config / bevat frontend configuraties controllers / bevat webcontroller klassenmodellen / contai ns frontend-specifieke modelklassen runtime / bevat bestanden gegenereerd tijdens runtime testen / bevat tests voor frontend applicatie views / bevat beeldbestanden voor het webtoepassingsweb / bevat het invoerscript en webresources widgets / bevat frontend widgets leverancier / bevat afhankelijke 3rd-party pakketten omgevingen / bevat op omgeving gebaseerde overschrijvingen
Elke laag is zijn eigen site, maar kan desgewenst eenvoudig code en een gemeenschappelijke database delen. Ik gebruik deze sjabloon in onze opstartreeks. Yii Advanced biedt ook ingebouwde configuratie-ondersteuning voor verschillende omgevingen, waardoor teamontwikkeling eenvoudiger wordt.
Ik codeer nu al verschillende jaren in Yii op macOS. Natuurlijk zijn er veel verschillende manieren om een Apache, MySQL, PHP-omgeving op een Mac uit te voeren, maar ik geef de voorkeur aan MAMP.
Ga in principe gewoon naar de MAMP-website en download het macOS-pakket:
Eenmaal gedownload, kunt u het pakket naar de slepen toepassingen map en dubbelklik om MAMP te starten. Dit toont een MAMP-venster:
Klik voorkeuren om de poorten waar je de server op wilt configureren (gebruik ik 8888 voor Apache):
Klik Web Server om de directory van uw server te bekijken of te wijzigen. Ik gebruik Apache lokaal:
Yii2 vereist Composer, een populaire afhankelijkheidsmanager voor PHP. Als Composer nog niet is geïnstalleerd, doet u het volgende:
curl -s http://getcomposer.org/installer | php mv composer.phar / usr / local / bin / composer
Gebruik vervolgens Composer om Yii2 te installeren. Het installatieverzoek vereist dat u uw eigen GitHub-accountgegevens gebruikt; meld u aan als u geen account hebt.
Zoals Rod hieronder verder beschrijft, vereist het installeren van Yii de plug-in voor componenten van componenten:
composer global vereist "fxp / composer-asset-plugin: 1.0.0-beta2"
Hij raadt aan om een account aan te maken met GitHub en een toegangstoken configureren. De reden hiervoor is dat tijdens de installatie van Yii het aantal verzoeken de GitHub API-snelheidslimiet kan overschrijden, en Composer kan stoppen en om uw GitHub-aanmeldingsreferenties vragen om een GitHub API-toegangstoken te verkrijgen tijdens de installatie.
Als je klaar bent, kun je Yii installeren. We gebruiken Yii basic en installeren het in de ~ / Sites / hello directory:
composer create-project --prefer-dist yiisoft / yii2-app-basic hallo
Maak vervolgens een symlink voor MAMP in de directory van uw Sites-app:
cd / Toepassingen / MAMP / htdocs ln -s ~ / Sites / hallo / / Toepassingen / MAMP / htdocs / hallo
Als u besluit Yii Advanced te installeren, kan het helpen om uw virtuele hostbestand te activeren en aan te passen:
$ nano /Applications/MAMP/conf/apache/httpd.conf # Virtuele hosts omvatten /Applications/MAMP/conf/apache/extra/httpd-vhosts.conf
Hieronder heb ik frontend.dev en backend.dev geconfigureerd om toe te wijzen aan een Yii Advanced-installatie in de ~ / Sites / yiiplus map met een symbolische link in / Applications / MAMP.
$ nano /Applications/MAMP/conf/apache/extra/httpd-vhosts.conf NameVirtualHost *: 8888Servernaam frontend.dev DocumentRoot / Toepassingen / MAMP / htdocs / yiiplus / frontend / web / # gebruik mod_rewrite voor mooie URL-ondersteuning RewriteEngine op # Als een map of bestand bestaat, gebruik dan de aanvraag direct RewriteCond% REQUEST_FILENAME! -f RewriteCond% REQUEST_FILENAME! -d # Stuur het verzoek door naar index.php RewriteRule. index.php # gebruik index.php als indexbestand DirectoryIndex index.php # ... andere instellingen ... Servernaam backend.dev DocumentRoot / Toepassingen / MAMP / htdocs / yiiplus / backend / web / # gebruik mod_rewrite voor mooie URL-ondersteuning RewriteEngine op # Als een map of bestand bestaat, gebruik dan de aanvraag direct RewriteCond% REQUEST_FILENAME! -f RewriteCond% REQUEST_FILENAME! -d # Stuur het verzoek door naar index.php RewriteRule. index.php # gebruik index.php als indexbestand DirectoryIndex index.php # ... andere instellingen ...
Als u besluit om Yii Advanced te gebruiken, moedig ik u aan ook mijn tutorial over deze te bekijken die meer details biedt.
Dat zijn de platformspecifieke stappen voor macOS. Laten we nu kijken naar de voorbereiding voor Yii op Windows. Later keren we terug om de configuraties af te maken met stappen die voor beide platforms werken. Als je een macOS-gebruiker bent, ga je naar de De Yii-configuratie voltooien sectie.
Voor Yii op Windows gaan we WAMP gebruiken. Om te beginnen moet u WAMP downloaden en configureren op uw Windows-computer. Voor deze zelfstudie installeren we WAMP op uw lokale computer (die de server zal aanspreken als localhost). Als u op een Windows-productieserver wilt installeren, moet u contact opnemen met uw provider voor servergegevens en de aanbevelingen voor het installeren en configureren van WAMP Server of een andere Apache, MySQL, PHP-stack voor die omgeving opvolgen.
Omdat de focus van deze tutorial ligt op het installeren van Yii, raden we je aan een van de vele uitstekende bestaande tutorials te raadplegen die betrekking hebben op het installeren van WAMP; je zult verrast zijn hoe gemakkelijk het is. Omdat het ook een PHP-toepassing is, is de WordPress-handleiding voor het installeren van WAMP een goed startpunt.
Nadat WAMP is geïnstalleerd en geconfigureerd, moeten Composer worden geïnstalleerd, een afhankelijkheidsbeheerder en een installatieprogramma voor PHP-projecten. Dit zal ons in staat stellen aan de slag te gaan met onze Yii-installatie.
Hoewel je Yii-pakketten van GitHub kunt downloaden, gebruiken we in deze zelfstudie Composer om het te installeren. Als u niet bekend bent met Composer, kunt u meer informatie vinden in deze zelfstudie.
Laten we eerst naar GitHub gaan om de nieuwste versie van Composer-setup.exe te downloaden en installeren, die op dit moment v4.5.0 is.
Nadat de installatie is voltooid, is het een goed idee om opnieuw uit te loggen en opnieuw aan te melden om er zeker van te zijn dat alle bestanden zijn bijgewerkt [Jeff hier: of koop een Mac].
U kunt uw installatie controleren door de opdrachtprompt te openen en naar:
cd \ Gebruikers \ uw gebruikersnaam
Voer de volgende opdracht in:
componist -V
De versiegegevens voor Composer moeten dan worden weergegeven, bijvoorbeeld:
Componist versie 1.4.1 2017-03-10 09:29:45
Als u uw projectactiva in Composer .json wilt beheren zonder NPM of Bower te hoeven installeren, moet u ervoor zorgen dat Composer alle benodigde pakketten heeft door de opdracht install voor de Composer Assets-plug-in uit te voeren.
Open de opdrachtprompt in Windows en ga naar de map waar uw PHP-map zich bevindt. In deze installatie bevindt PHP zich in de directory wamp64 \ bin \ en het is PHP versie 7.0.10, dus we typen:
cd \ wamp64 \ bin \ php \ php7.0.10
Typ vervolgens de volgende opdracht:
composer global vereist "fxp / composer-asset-plugin: ^ 1.3.1"
Houd er rekening mee dat er softwarewijzigingen plaatsvinden, dus controleer altijd of u met de meest recente, stabiele versie werkt. Wees voorzichtig met bèta's, want als je te ver uit de buurt raakt, kan het beginnen te breken.
Voor de meest recente versies van Composer en Composer Asset Plugin:
Laten we WAMP voor Yii configureren. Wijzig uw map in de WAMP-installatie \ www voor deze installatie:
cd \ wamp64 \ www
In deze map zullen we een nieuwe map maken met de naam Yii Basic door te typen:
mkdir yii-basic
Dit is waar we Yii Basic gaan installeren. U kunt deze stap overslaan en Yii rechtstreeks in de www-directory installeren, maar het maken van een duidelijk genoemde directory voorkomt verwarring, vooral als u van plan bent zowel Yii Basic als Yii geavanceerde sjablonen te installeren.
In de nieuwe map yii-basic voeren we de volgende opdracht uit om de Yii Basic-sjabloon te installeren:
composer create-project --prefer-dist --stability = dev yiisoft / yii2-app-basic yii-basic
We kunnen Yii verifiëren door te navigeren naar de map "Basic" in de map die u hebt gemaakt:
cd \ wamp64 \ bin \ www \
Nu typen we het commando:
PHP yii serveren
Hiermee wordt Yii gestart met de PHP-engine van WAMP.
Als u de lokale browseradressen voor uw site wilt aanpassen of duidelijk naar de voorkant en achterkant van de Yii-Advanced-site wilt verwijzen, moet u iets meer doen.
Ofwel met behulp van de teksteditor Open bestand dropdown of door direct te navigeren in Windows Verkenner, ga naar het bestand:
C: \ Windows \ system32 \ drivers \ etc \ hosts
We zijn op zoek naar de volgende sectie:
# localhost name resolution wordt afgehandeld binnen DNS zelf. 127.0.0.1 localhost
Ter voorbereiding op de meerdere sites van Yii-Advanced, laten we er een voor frontend en een voor backend toevoegen:
127.0.0.1 frontend.dev 127.0.0.1 backend.dev
Het ziet er als volgt uit:
U kunt hier meer informatie vinden over het vinden en instellen van uw Windows Host-bestand.
Het is een goed idee om te controleren of virtuele hosts zijn ingeschakeld in het bestand httpd.conf van Apache.
Wees heel voorzichtig bij het bewerken van het httpd.conf-bestand - maak een kopie voordat je begint en zorg dat je begrijpt wat je aan het doen bent voordat je wijzigingen aanbrengt, anders kun je je WAMP-server gemakkelijk verpesten. [Jeff hier, klinkt alsof Rod vanuit ervaring spreekt.]
Om httpd.conf te vinden, typt u:
cd \ wamp64 \ bin \ apache \ apache2.4.23 \ conf
Ik hou van deze handleiding voor een meer gedetailleerde uitleg van het bewerken van httpd.conf om functies met betrekking tot virtuele hosts in Apache in te schakelen en virtuele hosts op WAMP te configureren.
We moeten nu onze Apache Virtual Hosts configureren. Gebruikend ons tekstbewerkingsmenu of Windows Verkenner, zullen we naar de volgende map gaan:
C: Wamp64 \ bin \ apache \ apache2.4.23 \ conf \ extra \ httpd-vhosts.conf
Er zou al een Virtual Host moeten zijn voor localhost, dus nu moeten we Virtual Hosts voor Yii frontend en Yii backend toevoegen. Ik raad u aan de naam boven elke virtuele host te typen om verwarring te voorkomen. (Vergeet niet om de naam uit te spreken!)
d.w.z. #Voorkant
Het configuratiebestand van de virtuele host zou er ongeveer zo uit moeten zien.
In dit voorbeeld hebben we Yii Advanced geïnstalleerd c: / wamp64 / www / yu-geavanceerde en creëerde een applicatie met de naam yii-applicatie. Het is ook goed om Yii op www te installeren, zodat je pad eenvoudiger kan lezen c: / wamp64 / www / myapp / frontend / web.
Besteed veel aandacht aan de DocumentRoot en directory lijnen. Ze moeten allebei het volledige pad bevatten naar de Yii-toepassingsdirectory helemaal naar het "web" -bestand dat zich respectievelijk in de frontend- en backend-directory bevindt. De inhoud van DocumentRoot en Directory is identiek, behalve dat het pad voor Directory tussen aanhalingstekens staat.
Om de geavanceerde Yii-sjabloon te installeren, gaan we terug naar de map wamp64 \ www:
cd \ wamp64 \ www
Nu zullen we een nieuwe map maken met de naam yii-advanced:
mkdir yii-advanced
In de nieuwe map voeren we de volgende opdracht uit, die de Yii Advanced-sjabloon zal installeren:
composer create-project --prefer-dist yiisoft / yii2-app-advanced yii-application
Tot nu toe is de installatie van Yii Basic en Yii Advanced hetzelfde gebleven. Nu moeten we nog een paar stappen toevoegen om uw Yii Advanced Template gereed te maken voor actie.
Ervan uitgaande dat PHPmyAdmin is geïnstalleerd op uw WAMP-server (het is inbegrepen bij MAMP), kunt u de database eigenlijk maken via de PHPmyAdmin GUI, maar we gaan de handen uit de mouwen steken en de SQL-opdrachtregel gebruiken, die eerlijk gezegd niet veel moeite kost.
Ga op de Windows-opdrachtregel naar de map MySQL door het volgende te typen:
cd \ wamp64 \ www \ bin \ mysql \ mysql5.7.14 \ bin
U kunt dit ook vanaf elke locatie doen zolang WAMP of MAMP zich in uw lokale omgeving bevindt.
Typ vervolgens voor zowel Mac als Windows:
mysql -u root -p
Dit brengt ons naar de mysql-opdrachtregel. Nu zullen we de volgende opdracht in SQL uitvoeren:
maak een database aan yii2test;
(U kunt de database een naam geven die u maar wilt, op voorwaarde dat u tijdens de rest van het proces de juiste naam gebruikt.)
Nu zullen we een gebruikersnaam en wachtwoord voor deze database maken door de volgende SQL-opdrachten te typen:
GEEF ALLEN OP yiit2est. * NAAR 'uw-gebruikersnaam' @ 'localhost' IDENTIFICEED DOOR 'uw_gekozen_wachtwoord'; VOORRECHTEN VOOR FLU'S; UITGANG;
U verlaat nu MySQL en keert terug naar de commandolijn van de console.
Houd de gebruikersnaam en het wachtwoord van de database bij de hand, want we hebben het nodig om het PHP-configuratiebestand (common / config / main-local.php) in te stellen, zodat Yii veilig kan communiceren met MySQL.
Dit is niet nodig voor Yii-basisinstallaties.
Om Yii advanced te initialiseren, moeten we naar de Yii-Advanced-toepassingsmap navigeren. In dit geval zou dat zijn:
cd \ wamp64 \ www \ yii-advanced \
Typ dan in het:
Hiermee start u het initialisatiescript dat u zal vragen of u Yii wilt initialiseren voor een ontwikkelings- of productieomgeving; hoogstwaarschijnlijk zal het er zo uitzien:
In welke omgeving wilt u de toepassing initialiseren? [0] Ontwikkeling [1] Productie
Voor het doel van deze tutorial werken we in een ontwikkelomgeving, dus typ 0 en druk op enter en typ 'yes' (zonder aanhalingstekens) wanneer daarom wordt gevraagd en de initialisatie wordt voltooid.
We zijn bijna klaar - alles wat nu overblijft zijn een paar configuratiestappen, en je kunt gaan werken met Yii.
Voor Yii-basic zul je aan het bewerken zijn /yii-basic/config/db.ini. Voor, Yii-advanced, zult u aan het bewerken zijn /yii-advanced/common/config/main-local.php.
Om dit bestand te kunnen bewerken, moeten we een teksteditor gebruiken. Atom is een goede keuze die je goed van dienst zal zijn als je aan meer geavanceerde codering begint.
Om het configuratiebestand te openen, gebruikt u de Open bestand dropdown in de teksteditor of ga rechtstreeks naar het configuratiebestand met Windows Verkenner en klik met de rechtermuisknop Openen met en selecteer je teksteditor. (In Windows moet u mogelijk de teksteditor uitvoeren als beheerder.)
Het volgende voorbeeld van de installatie die we vandaag gebruiken, illustreert dit proces. Houd er rekening mee dat u mogelijk een andere schijfaanduiding gebruikt en een enigszins ander pad hebt, afhankelijk van wat u uw mappen hebt genoemd.
Het configuratiebestand zou er ongeveer zo uit moeten zien:
Vergeet niet om dezelfde gebruikersnaam en hetzelfde wachtwoord in te voeren als je hebt gebruikt om je Yii MySQL-database in te stellen, anders spelen Yii en MySQL niet leuk!
En denk er alsjeblieft niet aan om de root gebruikersnaam en het wachtwoord van je database te gebruiken in het configuratiebestand! [Jeff hier ... echt, niet]
Yii Advanced heeft zijn eigen migraties. Nu MySQL is ingesteld, hebben we een aantal tabellen nodig. De Yii-migraties maken programmatisch tabellen en schema's in uw MySQL-database.
Om het Yii-migratietool in Windows te starten, moeten we naar onze Yii-installatiedirectory gaan door het volgende te typen:
cd \ wamp64 \ www \ yii-advanced \ yii-applicatie
Nogmaals, je kunt ervoor kiezen om het te installeren zonder de bovenliggende map die Rod heeft gemaakt voor deze demo. Voor MAMP gebruik ik bijvoorbeeld:
$ cd ~ / sites / yii-advanced
Typ nu de volgende opdracht:
yii migreren
In een oogwenk wordt u gevraagd of u dat wilt "De bovenstaande migratie toepassen?"
Type Ja en druk op Return. Als alles goed gaat, krijgen we een bericht dat Yii succesvol is gemigreerd.
Nu voor het moment van de waarheid. Wanneer je op bezoek komt localhost: 8888 in je browser zou je moeten zien:
Voor Yii Advanced moet je misschien proberen frontend.dev of omvat de frontend of backend-site, b.v.. localhost: 8888 / frontend. Als u uw hostbestand niet inschakelt, kunt u rechtstreeks via het pad naar Yii gaan, localhost: 8888 / web.
Als u de geavanceerde sjabloon hebt geïnstalleerd, gaat u naar Inschrijven link en voer een gebruikersnaam, het e-mailadres dat u wilt gebruiken en een wachtwoord in.
Gebruik uw MySQL-wachtwoord (het wachtwoord dat u in het PHP-configuratiebestand hebt ingevoerd) niet. Dit is de Yii-gebruikersaccountdatabase met nieuwe gebruikersnamen en wachtwoorden.
Uw eerste gebruikersregistratie is ook de beheerder van de Yii-toepassing met toegang tot alles.
Nu u bent aangemeld, typt u in de browser:
backend.dev
U zou een beheerdersaanmeldscherm moeten krijgen waar u uw nieuwe gebruikersnaam en wachtwoord kunt invoeren:
Dit brengt je meteen terug naar de bovenstaande Yii "Gefeliciteerd"Pagina maar als een geverifieerde gebruiker.
Nu, met alle felicitaties die rondgaan, waarom feliciteer jezelf niet omdat je Yii met succes hebt geïnstalleerd. Keurig gedaan. [Jeff, als je dit in Windows hebt gedaan, koop dan een Mac en probeer het daar.]
Ik hoop dat onze tutorial van vandaag je helpt aan de slag te gaan met Yii. Rod en ik genoten ervan dit samen te schrijven.
Bekijk de komende tutorials in onze Programming with Yii2-serie terwijl we verder duiken in verschillende aspecten van het framework. Bekijk zeker onze Building Your Startup met PHP-serie die Yii2's geavanceerde sjabloon gebruikt terwijl we een real-world applicatie bouwen.
Hoe te programmeren Met de Aan de slag-aflevering van Yii kun je prima in detail gaan over het instellen van Yii basic en een productie-Linux-server.
Als je wilt weten wanneer de volgende Yii2-handleiding aankomt, volg me dan @reifman op Twitter of bekijk mijn instructeurspagina. Op mijn instructeurspagina staan alle artikelen uit deze serie zodra ze zijn gepubliceerd.
