Ruby on Rails-vejledning

Rails blev skabt af David Heinemeier Hansson, bedre kendt som DHH. Det er et af de mest indflydelsesrige og populære værktøjer til at bygge webapplikationer. Det bruges af store websteder som Airbnb, GitHub og Shopify.

Hvorfor skinner?

Før værktøjskæden installeres, er det nyttigt at forstå, hvorfor Rails fortsat er et populært valg til skibsfart.ping webapplikationer hurtigt.

• Rails er pakket som en Ruby-perle, og du kan bruge den til at bygge en bred vifte af applikationer.
• Det giver dig mulighed for at bygge almindelige webapplikationer, e-handelssider, indholdsstyringssystemer og meget mere.
• Rails er et full-stack framework, der indeholder alt hvad du behøver for at oprette en databasedrevet webapplikation ved hjælp af Model-View-Controller (MVC)-mønsteret.
• Alle lag er designet til at fungere problemfrit sammen, så Rails-projekter kræver typisk færre linjer kode end tilsvarende projekter i andre frameworks.

Sådan downloades og installeres Ruby på Windows

Installationsprocessen afhænger af dit operativsystem. De næste afsnit dækker installation af Ruby på Windows, Mac og Linux.

Trin 1) Download Rubyinstaller.
Den nemmeste måde at installere Ruby på din Windows computeren er via Ruby Installer, tilgængelig på https://rubyinstaller.org/.

Når installationsprogrammet er downloadet, skal du køre det.

Trin 2) Klik på det downloadede installationsprogram.
Double-klik på den downloadede installationsfil, for eksempel rubyinstaller-2.4.1-2-x64.exe.

Trin 3) Accepter licensen.
Vælg alternativknappen "Jeg accepterer licensen", og klik på knappen "Næste". Du bør se skærmbilledet nedenfor.

Trin 4) Markér de to første afkrydsningsfelter.
Marker de to første afkrydsningsfelter for at gøre det nemmere at køre Ruby-scripts.

Klik på knappen “Installer” for at starte installationen. Du bør se skærmbilledet nedenfor, når den er færdig.

Trin 5) Klik på Udfør.
Fjern ikke markeringen i den indstilling, der installerer MSYS2. Klik på "Udfør" for at fuldføre installationen. Et kommandopromptvindue åbnes som vist nedenfor.

Trin 6) Installer MSYS2.
Dette trin installerer MSYS2, en byggeplatform med en pakkehåndtering til nem installation af pakker på Windows.

Tryk Enter for at installere alle komponenter, da de alle er nødvendige for et problemfrit Ruby on Rails-udviklingsmiljø. Windows.

Montering af skinner

Du burde have Ruby installeret fra det forrige afsnit. Installer derefter Rails. Du kan installere Rails ved hjælp af en pakke fra Rails Installer, men pakken leverer ofte ikke den nyeste version af alle nødvendige afhængigheder.

Hvis du allerede har den nyeste Ruby og de grundlæggende RubyGems og udvidelser installeret, skal du blot køre følgende kommando ved kommandoprompten for at installere Rails på dit system: gem install rails.

Du skal også installere node.js hvis du ikke allerede har det, fordi nogle biblioteker, som Rails er afhængige af, kræver en JavaScript-kørselstid skal fungere korrekt. Hent Node på https://nodejs.org.

En mere almindelig og foretrukken tilgang til Windows er at bruge Windows Undersystem til Linux. Det leverer et GNU/Linux-miljø med kommandolinjeværktøjer, værktøjer og almindelige applikationer direkte i det. Windows.

Installation af Ruby på Mac

Din Mac har allerede Ruby forudinstalleret. Den forudinstallerede version er dog ofte forældet, så du bør installere en nyere version.

Den nemmeste måde at gøre dette på er at bruge en pakkehåndtering som f.eks. homebrewDu skal muligvis først installere Homebrew ved at køre kommandoen nedenfor i terminalen.

/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

Dette viser en advarsel og beder dig om at indtaste din adgangskode. Indtast din Mac-adgangskode (tegnene vises ikke, når du skriver), og tryk på Enter, når du er færdig. Kør derefter denne Homebrew-kommando for at installere Ruby på din Mac.

brew install ruby

Kør derefter denne kommando:

echo 'export PATH="/usr/local/bin:/usr/local/sbin:$PATH"' >> ~/.bash_profile

Dette indstiller den nye Ruby-installation som standard Ruby på dit system i stedet for den forudinstallerede Ruby.

For at bekræfte at installationen var vellykket, skal du køre følgende i Terminalen:

ruby --version

Dette udskriver det Ruby-versionsnummer, du har installeret. Outputtet ser nogenlunde sådan ud:

ruby 2.6.0p0 (2018-12-25 revision 66547) [x86_64-darwin18]

Installerer Ruby på Ubuntu (Linux)

Den nemmeste måde at installere Ruby på Ubuntu sker via apt-pakkehåndteringen. Kør følgende kommandoer i Terminalen for at installere den nyeste Ruby fra Ubuntu opbevaringssteder.

• sudo apt opdatering – Dette opdaterer standardindstillingen Ubuntu opbevaringssteder.
• sudo apt install ruby-full – Dette downloader og installerer den nyeste Ruby.

For at bekræfte installationen skal du køre ruby-versionDette udskriver den Ruby-version, du har installeret.

Montering af skinner på Ubuntu (Linux)

Følg nedenstående trin for at installere Rails på din Linux-maskine.

Trin 1) Opdater din ædelstensadministrator ved at køre perleopdateringssystem i Terminalen eller kommandoprompten.

Trin 2) Kør perle installationsskinner for at installere den seneste version af Rails på din computer.

Trin 3) Installer bundler-gem'en for nem administration af gem-afhængigheder i Rails-applikationen. Kør gem installation bundler.

To principper for skinner

Rails følger grundlæggende principper for softwaredesign og opfordrer dig til også at bruge dem.

De to mest almindelige er:

• Gentag ikke dig selv (TØR) – dette fører til kortfattet, ensartet og vedligeholdelig kode.
• Konvention frem for konfiguration – Rails er forudkonfigureret med fornuftige standardindstillinger, der passer til den mest almindelige brug. Dette gør applikationsudvikling hurtigere og giver dig mindre kode at vedligeholde.

Skinner – Projektfilstrukturer

Når Rails er installeret på dit system, skal du oprette en Rails-applikation. De næste afsnit gennemgår et Ruby on Rails-eksempel ved at bygge en Todo-liste-applikation. Kør følgende kommando i din terminal for at oprette applikationen:

rails new todo_app

Denne kommando opretter en mappe med navnet todo_app i den aktuelle mappe med den grundlæggende mappestruktur for en Rails-webapplikation, som vist nedenfor.

Her er de primære mapper, der er genereret til projektet:

app – grupperer undermapper til brugergrænsefladen/layoutet (visninger og hjælpere), controlleren (controllerfiler) og modellerne (forretnings-/applikationslogik).

app/controllere – gemmer controllerfiler, der bruges af Rails til at håndtere anmodninger fra klienten.

app/aktiver – indeholder statiske filer, der er nødvendige for applikationens frontend, grupperet efter type: JavaScript filer, billeder og stylesheets.

app/hjælpere – indeholder hjælpefunktioner, der holder din applikationsmodel, visning og controllerlogik fokuseret, lille og overskuelig.

app/modeller – indeholder filer, der modellerer din applikations database. Modelklasserne gør det meget nemt at arbejde med databasen.

app/visninger – indeholder de skabelon-/layoutfiler, som brugeren af ​​din applikation interagerer med. Skabelonerne kombinerer HTML med data fra databasen.

bin – indeholder Rails-scripts, der starter din applikation. Den kan også indeholde andre scripts, som du bruger til at konfigurere og opgradere applikationen.

config – indeholder konfigurationsfiler som f.eks. database.yml, miljø.rb, ruter.rbosv., som din applikation skal bruge for at køre.

db – indeholder filer og scripts, der bruges til at administrere din applikationsdatabase.

lib – indeholder udvidede moduler til din applikation.

log – indeholder logfiler som f.eks. server.log, development.log, test.log og production.log, bruges til fejlfinding eller overvågning af din applikation.

offentlige – indeholder statiske filer og kompilerede aktiver, såsom HTML-filer, JavaScriptfiler, billeder og stylesheets.

prøve – indeholder testfiler, du skriver for at teste din applikations funktionalitet.

tmp – indeholder midlertidige filer som cache- og pid-filer.

sælger – indeholder tredjepartsbiblioteker.

Gemfile – specificerer de grundlæggende krav til gems for at køre din webapplikation. Du kan gruppere gemsene i udvikling, test eller produktion, og Rails vil vide, hvornår hver gem skal inkluderes.

Gemfile.lock – i modsætning til Gemfile, som eksplicit angiver de gems, du ønsker i din applikation, indeholder Gemfile.lock derudover andre gems, som de, der er angivet i Gemfile, afhænger af. Disse installeres automatisk for at opfylde afhængighederne.

Readme.md – brug denne fil til at dele vigtige detaljer om din applikation, f.eks. hvad appen gør, og hvordan den installeres og køres.

Rakefile – indeholder forskellige definitioner af rake-opgaver, der hjælper med at automatisere de daglige administrationsopgaver i din applikation.

config.ru – en rackkonfigurationsfil, der giver en grænseflade til webserveren for at starte din applikation.

Skift mappe til todo_app directory Rails genereret og kørt skinneserver for at starte applikationen. Type localhost: 3000 i adresselinjen i din webbrowser. Du burde se skærmbilledet nedenfor, hvis alt er gået godt.

Dette er standardstartsiden for din applikation. Du vil ændre den i et senere afsnit af denne Ruby on Rails-vejledning. Du kan stoppe serveren ved at trykke på Ctrl + C.

Rails – Generer kommandoer

Kommandoen "Rails generate" bruger skabeloner til at oprette mange nyttige ting i din applikation. Disse generatorer sparer dig en masse tid.

De skriver standardkode, der er nødvendig for at din webapplikation kan fungere. skinner genererer af sig selv ved kommandoprompten eller Terminalen for at se en liste over tilgængelige generatorer, som vist nedenfor.

Du kan også køre skinner genererer for at se en beskrivelse af, hvad kommandoen gør. Den viser praktiske muligheder og et eksempel på brug. Figuren nedenfor viser outputtet af at køre skinner genererer controller.

Brug kommandoen `rails generate scaffold` til automatisk at oprette modellen, visningen og controlleren til den Todo-listeapplikation, du er ved at bygge. Kør følgende i din Terminal (sørg for, at du stadig er i todo_app vejviser):

rails generate scaffold todo_list title:string description:text

Dette opretter en komplet CRUD (Opret, Læs, Opdater, Slet) webgrænseflade til TodoLists-tabellen.

En anden nyttig kommando at kende er skinner ødelæggerDet omvender hvad som helst skinner genererer gør.

Skinner – Routing

Rails routingsystem, kaldet Rails-routeren, håndterer alle indgående anmodninger til din webapplikation. Det undersøger URL af hver anmodning og knytter den til den controllerhandling, der er ansvarlig for at håndtere den, ved hjælp af den syntaks, der er angivet i routes-filen (config/routes.rb).

Rutefilen styrer alle URL aspekt af din webapplikation. Rails bruger et RESTful design baseret på REST-arkitekturstilen, som giver et kortping mellem HTTP-verber og anmodning URLs til controllerens handlinger.

Rutefilen blev genereret, da du løb nye skinner tidligere. Fortsæt med den Todo-applikation, du er ved at bygge, og kør følgende:

rails db:migrate

Sørg for, at du stadig er i roden af ​​applikationen (den todo_app vejviser).

Start serveren igen med skinneserver. Type http://localhost:3000/todo_lists/ i din browser og tryk på Enter. Du burde få en webside tilbage som den nedenfor.

Dette er den Todo-listevisning, som scaffold-kommandoen genererede, og den styres af TodoListsController's indeks handling.

Tilføj en todo-liste ved at klikke på "Ny todo-liste" på siden. Du bør se skærmbilledet nedenfor.

Læg mærke til URL er nu http://localhost:3000/todo_lists/newDette er siden til at oprette en ny Todo-liste, og den styres af TodoListsController's ny fremgangsmåde.

Indtast din Todo-listes titel og beskrivelse i formularen, og klik på "Opret Todo-liste". URL skulle ændre sig til http://localhost:3000/todo_lists/1, som vist nedenfor.

Dette er visningssiden for en Todo-liste, der styres af TodoListsController's Vis metode. Hvis du går tilbage til http://localhost:3000/todo_lists/, du burde nu se skærmen nedenfor med den nye Todo-liste tilføjet.

Rails var i stand til at knytte hver anmodning til den tilsvarende TodoListsController-handling ved hjælp af rutedefinitionen i config/routes.rb.

Hvis du kigger på denne fil, vil du se en enkelt linje ressourcer: todo_lister, som er Rails standardmetode til at skrive RESTful-ruter. Denne ene linje opretter syv ruter, alle kortlagtping til TodoLists-controlleren.

Ifølge konvention er hver controller-handling knyttet til en specifik CRUD-operation (Opret, Læs, Opdater, Slet) i databasen.

Kør skinneruter i din kommandolinje for at se de forskellige ruter, der er tilgængelige i din applikation. Figuren nedenfor viser outputtet fra at køre skinneruter.

Skinner – Udsigter

View-laget er en af ​​komponenterne i MVC-paradigmet og er ansvarlig for at generere HTML-svaret for hver anmodning til din applikation. Rails bruger som standard ERB (Embedded Ruby), som er et kraftfuldt skabelonsystem til Ruby.

ERB gør skabeloner nemme at skrive og vedligeholde ved at kombinere almindelig tekst med Ruby-kode til variabelsubstitution og flowkontrol. En ERB-skabelon bruger .html.erb udvidelse.

Du vil primært bruge to tagmarkører, som hver især forårsager, at den integrerede kode behandles og håndteres på en bestemt måde.

Et tag med et lighedstegn <%= %> angiver, at den integrerede kode er et udtryk, og at resultatet af koden skal indsættes i outputtet, når skabelonen gengives.

Det andet tag uden lighedstegn <% %> indikerer til rendereren, at resultatet af koden ikke skal erstattes eller udskrives i outputtet.

Hver controller i din Rails-applikation har en tilsvarende undermappe i app/visninger, og hver handling i en controller har en tilsvarende .html.erb filen i den undermappe.

Tag et kig på app/visninger af den Todo-app, du er ved at bygge. Du finder en undermappe med navnet todo-lister Indeholder .html.erb filer med navne svarende til handlingerne i Todolister controller.

Skinner – ActiveRecord, Active Record Pattern og ORM

ActiveRecord er Ruby-implementeringen af ​​Active Record-mønsteret. I dette mønster repræsenterer en klasse en databasetabel, og en instans af klassen repræsenterer en række i den pågældende tabel.

ActiveRecord kaldes almindeligvis for en ORM (Object Relational Map).ping)-laget, en teknik der lader dig administrere din database ved hjælp af et sprog, du er mest komfortabel med. Det er databaseuafhængigt, så du nemt kan skifte mellem databaser – for eksempel, SQLite, MySQL, PostgreSQL, SQL Server eller Oracle — ved hjælp af den samme kode og logik.

For eksempel, for at få et array, der indeholder alle todo-lister i din applikation, behøver du ikke at skrive kode, der åbner en forbindelse, kører en SQL SELECT-forespørgsel og konverterer resultatet.

Du skriver bare TodoList.all, og ActiveRecord returnerer arrayet fyldt med TodoList-objekter, som du kan bruge, som du vil.

Alt du skal gøre er at konfigurere config/database.yml, og ActiveRecord håndterer forskellene mellem databasesystemer. Når du skifter fra én database til en anden, behøver du ikke at omskrive din kode.

Du fokuserer på applikationslogik, og ActiveRecord tager sig af de mere avancerede detaljer omkring forbindelse til din database. Programmet bruger navngivningskonventioner til at knytte modeller til databasetabeller.

Rails bruger flertal på dine modelklassenavne for at finde den tilsvarende databasetabel. Så for en klasse TodoList, ActiveRecord bruger en databasetabel kaldet todo-lister.

Skinner – Migrationer

En Rails-migrering er et script, som du bruger til at udvikle din applikationsdatabase. Det bruges til at opsætte eller ændre din database uden manuelt at skrive SQL.

Den bruger Ruby til at definere ændringer i databaseskemaet og gør det muligt at bruge versionskontrol til at holde din database synkroniseret på tværs af miljøer.

Rails-migrationer bruger et Ruby Domain Specific Language (DSL). Dette fungerer som et abstracog gør det muligt at bruge eller ændre din databasemotor baseret på dine krav.

Migreringer kan deles med alle, der arbejder på applikationen, og kan også rulles tilbage for at fortryde ændringer. Dette er en stærk sikkerhedsmekanisme, så du behøver ikke bekymre dig om at forårsage permanent skade på din database.

Rails – ActiveRecord Associations

En forbindelse mellem to ActiveRecord-modeller kaldes en association. Associationer gør det meget nemmere at udføre handlinger på relaterede poster i din kode. Der er fire almindelige kategorier.

En til en: En post indeholder præcis én forekomst af en anden model. Et godt eksempel er en brugerprofil – en bruger har kun én profil. Den bruger har_en nøgleord.

En til mange: den mest almindelige association — én model har nul eller flere forekomster af en anden model. Brug har_mange nøgleord for at angive denne forening.

Mange til mange: lidt mere kompliceret. ActiveRecord tilbyder to måder at håndtere det på: har_og_tilhører_mange og har_mange :igennem, som giver dig adgang til den join-model, der er defineret i en separat tabel.

Polymorf én til mange: en mere avanceret association i Rails. Den definerer en model, der kan tilhøre mange forskellige modeller på en enkelt association.

Skinner – ActiveRecord-valideringer

Validering er med til at sikre, at du har korrekte data, fordi det er risikabelt og kan koste din virksomhed penge at arbejde med dårlige data.

Validering giver også et ekstra lag af sikkerhed mod ondsindede brugere, der forsøger at indsætte skadelige data i din database. Rails tilbyder en ren API af valideringshjælpere i ActiveRecord, der holder din database ren, sikker og fri for fejl.

ActiveRecord-valideringer kører på modelobjekter, før de gemmes i databasen, hvilket gør dem mere pålidelige og følger bedste praksis.

Følgende ActiveRecord-metoder udløser valideringer, når de kaldes på modelobjekter: opret, opret!, gem, gem!, opdater og opdater!Bang-versionerne (opret!, gem! og opdater!) opretter en undtagelse, hvis posten er ugyldig, mens ikke-bang-versionerne returnerer falsk i stedet.

De mest almindelige ActiveRecord-valideringshjælpemidler er:

• Bekræftelse: validerer, at to felter har samme værdi, for eksempel adgangskode og adgangskodebekræftelse. Det bruges sammen med tilstedeværelsesvalideringshjælpen.
• Tilstedeværelse: kontrollerer at feltet ikke er tomt.
• Enestående: sikrer en unik værdi for et felt, for eksempel brugernavn.
• Længde: håndhæver en grænse for tegnlængden i et felt.

Du kan også oprette din egen brugerdefinerede validering ved hjælp af validere metode og give den navnet på en brugerdefineret valideringsmetode.

Tjek modellens fejl objekt for at finde ud af, hvorfor en validering mislykkedes. Dette giver dig alt, hvad du behøver for at gøre din applikation mere begrænset og sikker, så kun gyldige data tillades i din database.

Skinner – ActionController

Rails-controlleren er centrum for din webapplikation. Det letter og koordinerer kommunikationen mellem brugeren, modellerne og synspunkterne.

Dine controllerklasser arver fra Application Controller, som indeholder kode, der kan køres i alle andre controllere, og som igen arver fra ActionController::Base.

Controlleren leverer følgende til din applikation:

• Den sender eksterne anmodninger til interne handlinger.
• Den administrerer caching, hvilket giver din applikations ydeevneforbedringer.
• Den administrerer hjælpemetoder, der udvider visningsskabelonfunktioner, og administrerer også brugersessioner, hvilket giver brugerne en problemfri oplevelse.

Skinner – konfigurationer

Du kan konfigurere komponenter såsom initialiseringsprogrammer, aktiver, generatorer og middleware ved hjælp af dine Rails-applikationsinitialiseringsprogrammer og konfigurationsfiler i config mappe. Filer som config/applikation.rb, config/miljøer/udvikling.rbog config/miljøer/test.rb bruges her. Du kan også tilføje brugerdefinerede indstillinger til din applikation.

Skinner – Fejlretning

Når du bygger din applikation, skal du foretage fejlfinding i din kode. Rails gør dette nemt med farvel gem. Du kan starte en fejlfindingssession ved at placere nøgleordet farvel hvor som helst i din applikationskode.

Dette stopper midlertidigt udførelsen på det tidspunkt. Byebug-gem'en tilbyder flere kommandoer. De mest nyttige er:

• Næste: går til næste kodelinje, springer overping alle metoder, der kaldes af den aktuelle linje.
• trin: svarende til næste, men træder ind i hver påkaldt metode.
• pause: stopper kodeudførelsen.
• Blive ved: fortsætter kodeudførelsen.

Andre fejlfindingsjuveler er tilgængelige, såsom lirkeDe tilbyder alle lignende funktionalitet med lidt forskellig syntaks. Debugging gems bør ikke bruges i produktion, da de udgør risici for din applikation og en dårlig oplevelse for dine brugere.

Logfiler kan inspiceres for fejl i produktionen og håndteres i overensstemmelse hermed. Du bør også følge en testdrevet udviklingsmetode (TDD), når du bygger din applikation, for at sikre, at alt fungerer korrekt, før den implementeres i produktion.

Ofte Stillede Spørgsmål