https://mediawiki.a-eskwadraat.nl/wiki/api.php?action=feedcontributions&feedformat=atom&user=Pepijno 2026-08-10T11:20:15Z User contributions MediaWiki 1.23.2 https://mediawiki.a-eskwadraat.nl/wiki/index.php/IDEAL 2017-09-13T13:40:46Z

<p>Pepijno: </p> <hr /> <div>Voorbeeld iDEAL-code:<br /> <br /> &lt;code&gt;&lt;pre&gt;<br /> $ideal = new iDeal(&quot;BOEKWEB&quot;, &quot;VERKOOP&quot;, $lid, $verkoopPrijs,<br /> &quot;Introductiekamp 2017&quot;, new DateTimeLocale(), &quot;iDealtransactie introkamp 2017&quot;,<br /> $voorraad, EVENEMENTENREKENING, null);<br /> <br /> $ideal-&gt;setEmailAdres(tryPar('email'));<br /> $ideal-&gt;setStatus('INACTIVE');<br /> $ideal-&gt;setReturnURL('http://bachelor.intro-utrecht.nl/aanmelden/geslaagd');<br /> <br /> $ideal-&gt;startTransactie();<br /> &lt;/pre&gt;&lt;/code&gt;<br /> <br /> == Hoe check ik dat een transactie gelukt is? ==<br /> <br /> Dit doe je met de Mollie webhook, die iDeal::handelAf aanroept. Dat wordt dan weer gedelegeerd aan iDeal::handel${artikelsoort}Af, waar je een switch kan neerzetten op het precieze ID. In de juiste branch roep je dan de verwerkfunctie aan.<br /> [[Category:WebCie]]</div>

Pepijno https://mediawiki.a-eskwadraat.nl/wiki/index.php/Bestuurswissel_Sysop 2017-08-24T12:59:10Z

<p>Pepijno: </p> <hr /> <div>[[Category:Sysop]]<br /> <br /> Bestuursrechten op het systeem en in IPA worden indirect geleverd door middel van het kb-account van het desbetreffende bestuur. Door de group van het kb-account (bv de group kb1617) in de user groups van de group bestuur te zetten, krijgen alle users in de kb-group alle bestuursrechten op het systeem.<br /> <br /> De rechten van de individuele bestuursaccount zoals voorz, secr, etc, gebeurt door de nieuwe bestuursleden bij de groepen op de A-Eskwadraatwebsite te zetten. De website zet ze dan ook automatisch in de juiste group in IPA.<br /> <br /> Wat dan nog niet automatisch gebeurt zijn de symlinks in de ~/cies/ van de nieuwe bestuursleden, dit moet nog handmatig gebeuren.</div>

Pepijno https://mediawiki.a-eskwadraat.nl/wiki/index.php/Bestuurswissel_Sysop 2017-08-21T09:11:17Z

<p>Pepijno: </p> <hr /> <div>[[Category:Sysop]]<br /> <br /> Bestuursrechten op het systeem en in IPA worden indirect geleverd door middel van het kb-account van het desbetreffende bestuur. Door de group van het kb-account (bv de group kb1617) in de user groups van de group bestuur te zetten, krijgen alle users in de kb-group alle bestuursrechten op het systeem.<br /> <br /> De rechten van de individuele bestuursaccount zoals voorz, secr, etc, gebeurt door de nieuwe bestuursleden bij de groepen op de A-Eskwadraatwebsite te zetten. De website zet ze dan ook automatisch in de juiste group in IPA.</div>

Pepijno https://mediawiki.a-eskwadraat.nl/wiki/index.php/Bestuurswissel_Sysop 2017-08-21T09:09:10Z

<p>Pepijno: </p> <hr /> <div>[[Category:Sysop]]<br /> <br /> Bestuursrechten op het systeem en in IPA worden indirect geleverd door middel van het kb-account van het desbetreffende bestuur. Door de group van het kb-account (bv de group kb1617) in de user groups van de group bestuur te zetten, krijgen alle users in de kb-group alle bestuursrechten op het systeem.</div>

Pepijno https://mediawiki.a-eskwadraat.nl/wiki/index.php/Bestuurswissel_Sysop 2017-08-21T09:01:20Z

<p>Pepijno: Created page with &quot;Category:Sysop&quot;</p> <hr /> <div>[[Category:Sysop]]</div>

Pepijno https://mediawiki.a-eskwadraat.nl/wiki/index.php/Haskell 2017-06-13T17:37:48Z

<p>Pepijno: </p> <hr /> <div>{{DISPLAYTITLE:Haskell}}<br /> [[category:hardware]]<br /> [[category:sysop]]<br /> '''Haskell''' is een server die gekocht is voor gebruik bij het [http://2012.bapc.eu BAPC 2012]. De machine is overgedragen aan A–Eskwadraat en heeft [[max]] vervangen. Hij is vernoemd naar de Amerikaanse wiskundige en logicus [http://nl.wikipedia.org/wiki/Haskell_Curry Haskell Brooks Curry].<br /> <br /> == Hardware (niet meer helemaal up-to-date) ==<br /> Haskell is in tegenstelling tot [[max]] een zelf samengestelde computer, maar wel met serverwaardige onderdelen. Te noemen:<br /> * 1x Intel P4308XXMFEN (behuizing met voeding)<br /> * 1x Intel Server Board S2600CP4 (moederbord)<br /> * 2x Intel Xeon E5-2620 (processor)<br /> * 1x Intel passieve processorkoeler<br /> * 8x Kingston ValueRAM 8G (ram)<br /> * 5x Seagate Barracuda 7200.14 2TB (hardeschijven)<br /> * 1x Plextor M6 Pro (SSD, gebruikt voor [[ZFS|ZIL]])<br /> <br /> == Software ==<br /> Haskell draait [http://www.proxmox.com/proxmox-ve Proxmox VE], een debian-distributie gericht op virtualisatie.<br /> Deze server hangt dan ook niet in salt, wel in ipa.<br /> <br /> Om de virtuele omgevingen te beheren kan alleen ingelogd worden als root op [http://haskell.a-eskwadraat.nl:8006/ de site].<br /> <br /> === Functionaliteiten en andere benodigheden ===<br /> Omdat haskell alle homedirs in zfs heeft staan heeft haskell een script wat een aantal keren per dag backups maakt en deze backups over zet naar nikola, de backup-server. Voor het overzetten van de snapshots is er een ssh-key-pair op haskell en nikola zodat haskell kan ssh-en naar nikola.<br /> <br /> Ook draait haskell het script wat checkt of users over quotum zitten, hiervoor heeft haskell de users van ipa nodig.<br /> <br /> Haskell heeft ook nog een script waarmee oude bestanden van scratch verwijderd worden.<br /> <br /> === APT ===<br /> Debian gebruikt apt als package manager.<br /> Beheer van de packages op haskell valt niet zoals de andere systemen onder salt.</div>

Pepijno https://mediawiki.a-eskwadraat.nl/wiki/index.php/Haskell 2017-06-13T17:32:13Z

<p>Pepijno: </p> <hr /> <div>{{DISPLAYTITLE:Haskell}}<br /> [[category:hardware]]<br /> [[category:sysop]]<br /> '''Haskell''' is een server die gekocht is voor gebruik bij het [http://2012.bapc.eu BAPC 2012]. De machine is overgedragen aan A–Eskwadraat en heeft [[max]] vervangen. Hij is vernoemd naar de Amerikaanse wiskundige en logicus [http://nl.wikipedia.org/wiki/Haskell_Curry Haskell Brooks Curry].<br /> <br /> == Hardware (niet meer helemaal up-to-date) ==<br /> Haskell is in tegenstelling tot [[max]] een zelf samengestelde computer, maar wel met serverwaardige onderdelen. Te noemen:<br /> * 1x Intel P4308XXMFEN (behuizing met voeding)<br /> * 1x Intel Server Board S2600CP4 (moederbord)<br /> * 2x Intel Xeon E5-2620 (processor)<br /> * 1x Intel passieve processorkoeler<br /> * 8x Kingston ValueRAM 8G (ram)<br /> * 5x Seagate Barracuda 7200.14 2TB (hardeschijven)<br /> * 1x Plextor M6 Pro (SSD, gebruikt voor [[ZFS|ZIL]])<br /> <br /> == Software ==<br /> Haskell draait [http://www.proxmox.com/proxmox-ve Proxmox VE], een debian-distributie gericht op virtualisatie.<br /> Deze server hangt dan ook niet in salt, wel in ipa.<br /> <br /> Om de virtuele omgevingen te beheren kan alleen ingelogd worden als root op [http://haskell.a-eskwadraat.nl:8006/ de site].<br /> <br /> === Functionaliteiten en andere benodigheden ===<br /> Omdat haskell alle homedirs in zfs heeft staan heeft haskell een script wat een aantal keren per dag backups maakt en deze backups over zet naar nikola, de backup-server. Ook draait haskell het script wat checkt of users over quotum zitten, hiervoor heeft haskell de users van ipa nodig. Haskell heeft ook nog een script waarmee oude bestanden van scratch verwijderd worden.<br /> <br /> === APT ===<br /> Debian gebruikt apt als package manager.<br /> Beheer van de packages op haskell valt niet zoals de andere systemen onder salt.</div>

Pepijno https://mediawiki.a-eskwadraat.nl/wiki/index.php/Nieuw_WWW-lid 2017-05-07T13:05:17Z

<p>Pepijno: </p> <hr /> <div>Wat je moet doen voor een nieuw lid van de [[WebCie|www]]:<br /> <br /> == Bestuur ==<br /> <br /> #Toevoegen aan 'webcie' (inloggen op de server en bij de repo)<br /> <br /> == Webcie ==<br /> <br /> Op de vm-www-debug:<br /> <br /> Toevoegen aan de htpasswd:<br /> htpasswd /srv/htpasswd $USER<br /> Toevoegen aan de htgroups<br /> vim /srv/config/vm-www-debug/httpd/conf.d/htgroups<br /> vim /srv/config/vm-www/httpd/conf.d/htgroups<br /> Toevoegen aan de wwwdebug.conf<br /> cd /srv/config/vm-www-debug/httpd/conf.d/<br /> vim wwwdebug.sh<br /> ./wwwdebug.sh<br /> git commit wwwdebug.sh wwwdebug.conf<br /> git push<br /> sudo service httpd restart<br /> <br /> <br /> == Nieuw lid ==<br /> <br /> Als eerste ga je je eigen debug omgeving aanmaken:<br /> <br /> cd /mnt/wwwdebug<br /> mkdir $USER/<br /> cd $USER<br /> kinit $USER<br /> git clone ssh://vm-www/srv/git wwwdebug<br /> cd wwwdebug/www<br /> ./manage build --enable-debug --hostname=$bla-debug.a-eskwadraat.nl<br /> ln -s /mnt/wwwdebug/$USER/wwwdebug/ ~/wwwdebug<br /> <br /> === Je eerste commit doen ===<br /> <br /> In de root van je website (dat is de map ~/wwwdebug/www/ dus doe als je daar nog niet in zit &lt;code&gt;cd ~/wwwdebug/www/&lt;/code&gt;) staat de map space/auth/ met daarin het bestand init.php. Voeg jezelf hier toe bij de $GODNRS. Om dit bestand vervolgens te committen doe je<br /> git commit space/auth/init.php<br /> Vervolgens moet je het bestand pushen zodat de rest van de webcieërs het binnen kunnen halen<br /> git push<br /> <br /> [[Category:WebCie]]</div>

Pepijno https://mediawiki.a-eskwadraat.nl/wiki/index.php/Nieuw_WWW-lid 2017-05-07T12:59:54Z

<p>Pepijno: </p> <hr /> <div>Wat je moet doen voor een nieuw lid van de [[WebCie|www]]:<br /> <br /> == Bestuur ==<br /> <br /> #Toevoegen aan 'webcie' (inloggen op de server en bij de repo)<br /> <br /> == WWW ==<br /> <br /> Als eerste ga je je eigen debug omgeving aanmaken:<br /> <br /> cd /mnt/wwwdebug<br /> mkdir $USER/<br /> cd $USER<br /> kinit $USER<br /> git clone ssh://vm-www/srv/git wwwdebug<br /> cd wwwdebug/www<br /> ./manage build --enable-debug --hostname=$bla-debug.a-eskwadraat.nl<br /> ln -s /mnt/wwwdebug/$USER/wwwdebug/ ~/wwwdebug<br /> <br /> De rest moet worden uitgevoerd op de vm-www-debug (dus doe &lt;code&gt;ssh vm-www-debug&lt;/code&gt;).<br /> <br /> &lt;code&gt;/srv/&lt;/code&gt;:<br /> <br /> #toevoegen aan htpasswd: &lt;code&gt;htpasswd /srv/htpasswd $USER&lt;/code&gt;)<br /> #toevoegen aan htgroups: &lt;code&gt;nano /srv/config/vm-www-debug/httpd/conf.d/htgroups&lt;/code&gt; en &lt;code&gt;nano /srv/config/vm-www/httpd/conf.d/htgroups&lt;/code&gt; (of gebruik &lt;code&gt;vi&lt;/code&gt; i.p.v. &lt;code&gt;nano&lt;/code&gt; als je cool bent ;))<br /> <br /> <br /> #&lt;code&gt;&lt;span data-cke-bookmark=&quot;1&quot; id=&quot;cke_bm_99S&quot; style=&quot;display: none;&quot;&gt;&amp;nbsp;&lt;/span&gt;cd ~/wwwdebug/www; autoconf; ./configure --enable-debug --with-hostname=$bla-debug.a-eskwadraat.nl&lt;/code&gt;<br /> #&lt;code&gt;ln -s /srv/http/www/www/{agenda.rss,agenda.vcs,tweets.html} .&lt;/code&gt;<br /> <br /> &lt;code&gt;/srv/config/vm-www-debug/httpd/conf.d/&lt;/code&gt;:<br /> <br /> Als user webcie:<br /> <br /> #toevoegen aan wwwdebug.sh<br /> #&lt;code&gt;./wwwdebug.sh&lt;/code&gt;<br /> #&lt;code&gt;git commit -a&lt;/code&gt; '''(nog niet getest, doe onder begeleiding van een WebCie'er!)'''<br /> #&lt;code&gt;logout&lt;/code&gt;<br /> #&lt;code&gt;sudo /etc/init.d/httpd reload&lt;/code&gt;<br /> #in de map gettext het script &lt;code&gt;update&lt;/code&gt; uitvoeren<br /> <br /> === Je eerste commit doen ===<br /> <br /> In de root van je website (dat is de map ~/wwwdebug/www/ dus doe als je daar nog niet in zit &lt;code&gt;cd ~/wwwdebug/www/&lt;/code&gt;) staat de map space/auth/ met daarin het bestand init.php. Voeg jezelf hier toe bij de $GODNRS. Om dit bestand vervolgens te committen doe je<br /> git commit space/auth/init.php<br /> Vervolgens moet je het bestand pushen zodat de rest van de webcieërs het binnen kunnen halen<br /> git push<br /> <br /> [[Category:WebCie]]</div>

Pepijno https://mediawiki.a-eskwadraat.nl/wiki/index.php/Nieuw_WWW-lid 2017-05-07T12:56:27Z

<p>Pepijno: </p> <hr /> <div>Wat je moet doen voor een nieuw lid van de [[WebCie|www]]:<br /> <br /> == Bestuur ==<br /> <br /> #Toevoegen aan 'webcie' (inloggen op de server en bij de repo)<br /> <br /> == WWW ==<br /> <br /> Als eerste ga je je eigen debug omgeving aanmaken:<br /> <br /> cd /mnt/wwwdebug<br /> mkdir $USER/<br /> cd $USER<br /> kinit $USER<br /> git clone ssh://vm-www/srv/git wwwdebug<br /> cd wwwdebug/www<br /> ./manage build --enable-debug --hostname=$bla-debug.a-eskwadraat.nl<br /> <br /> De rest moet worden uitgevoerd op de vm-www-debug (dus doe &lt;code&gt;ssh vm-www-debug&lt;/code&gt;).<br /> <br /> &lt;code&gt;/srv/&lt;/code&gt;:<br /> <br /> #toevoegen aan htpasswd: &lt;code&gt;htpasswd /srv/htpasswd $USER&lt;/code&gt;)<br /> #toevoegen aan htgroups: &lt;code&gt;nano /srv/config/vm-www-debug/httpd/conf.d/htgroups&lt;/code&gt; en &lt;code&gt;nano /srv/config/vm-www/httpd/conf.d/htgroups&lt;/code&gt; (of gebruik &lt;code&gt;vi&lt;/code&gt; i.p.v. &lt;code&gt;nano&lt;/code&gt; als je cool bent ;))<br /> <br /> <br /> #&lt;code&gt;&lt;span data-cke-bookmark=&quot;1&quot; id=&quot;cke_bm_99S&quot; style=&quot;display: none;&quot;&gt;&amp;nbsp;&lt;/span&gt;cd ~/wwwdebug/www; autoconf; ./configure --enable-debug --with-hostname=$bla-debug.a-eskwadraat.nl&lt;/code&gt;<br /> #&lt;code&gt;ln -s /srv/http/www/www/{agenda.rss,agenda.vcs,tweets.html} .&lt;/code&gt;<br /> <br /> &lt;code&gt;/srv/config/vm-www-debug/httpd/conf.d/&lt;/code&gt;:<br /> <br /> Als user webcie:<br /> <br /> #toevoegen aan wwwdebug.sh<br /> #&lt;code&gt;./wwwdebug.sh&lt;/code&gt;<br /> #&lt;code&gt;git commit -a&lt;/code&gt; '''(nog niet getest, doe onder begeleiding van een WebCie'er!)'''<br /> #&lt;code&gt;logout&lt;/code&gt;<br /> #&lt;code&gt;sudo /etc/init.d/httpd reload&lt;/code&gt;<br /> #in de map gettext het script &lt;code&gt;update&lt;/code&gt; uitvoeren<br /> <br /> De rest hoeft niet meer op de vm-www-debug gedaan te worden.<br /> <br /> #in de map www draai &lt;code&gt;php composer install&lt;/code&gt; en &lt;code&gt;./bowerphp_key install&lt;/code&gt;<br /> #in de map www het script &lt;code&gt;minify&lt;/code&gt; uitvoeren (op dit punt zou de debug moeten werken, check dit in je browser)<br /> #in &lt;code&gt;$GODNRS&lt;/code&gt; zetten (space/auth/init.php)<br /> #Vertel deze persoon 'even' hoe subversion werkt enzo<br /> #op de whoswho toevoegen, natuurlijk!<br /> <br /> [[Category:WebCie]]</div>

Pepijno https://mediawiki.a-eskwadraat.nl/wiki/index.php/Nieuw_WWW-lid 2017-05-07T12:55:07Z

<p>Pepijno: </p> <hr /> <div>Wat je moet doen voor een nieuw lid van de [[WebCie|www]]:<br /> <br /> == Bestuur ==<br /> <br /> #Toevoegen aan 'webcie' (inloggen op de server en bij de repo)<br /> <br /> == WWW ==<br /> <br /> Als eerste ga je je eigen debug omgeving aanmaken:<br /> <br /> cd /mnt/wwwdebug<br /> mkdir $USER/<br /> #&lt;code&gt;cd $USER&lt;/code&gt;<br /> #&lt;code&gt;kinit $USER&lt;/code&gt; &lt;!-- TODO: dit was nodig voor svn maar nu niet meer waarschijnlijk? --&gt;<br /> #&lt;code&gt;git clone ssh://vm-www/srv/git wwwdebug&lt;/code&gt;<br /> #&lt;code&gt;cd wwwdebug&lt;/code&gt; (als je dat hierboven nog niet hebt gedaan)<br /> #&lt;code&gt;chmod o= .&lt;/code&gt; (de punt hoort erbij)<br /> #&lt;code&gt;sudo chgrp apache .&lt;/code&gt; (het kan zijn dat je deze op de vm-www-debug moet doen)<br /> #&lt;code&gt;ln -s /mnt/wwwdebug/$USER/wwwdebug ~/&lt;/code&gt;<br /> <br /> De rest moet worden uitgevoerd op de vm-www-debug (dus doe &lt;code&gt;ssh vm-www-debug&lt;/code&gt;).<br /> <br /> &lt;code&gt;/srv/&lt;/code&gt;:<br /> <br /> #toevoegen aan htpasswd: &lt;code&gt;htpasswd /srv/htpasswd $USER&lt;/code&gt;)<br /> #toevoegen aan htgroups: &lt;code&gt;nano /srv/config/vm-www-debug/httpd/conf.d/htgroups&lt;/code&gt; en &lt;code&gt;nano /srv/config/vm-www/httpd/conf.d/htgroups&lt;/code&gt; (of gebruik &lt;code&gt;vi&lt;/code&gt; i.p.v. &lt;code&gt;nano&lt;/code&gt; als je cool bent ;))<br /> <br /> <br /> #&lt;code&gt;&lt;span data-cke-bookmark=&quot;1&quot; id=&quot;cke_bm_99S&quot; style=&quot;display: none;&quot;&gt;&amp;nbsp;&lt;/span&gt;cd ~/wwwdebug/www; autoconf; ./configure --enable-debug --with-hostname=$bla-debug.a-eskwadraat.nl&lt;/code&gt;<br /> #&lt;code&gt;ln -s /srv/http/www/www/{agenda.rss,agenda.vcs,tweets.html} .&lt;/code&gt;<br /> <br /> &lt;code&gt;/srv/config/vm-www-debug/httpd/conf.d/&lt;/code&gt;:<br /> <br /> Als user webcie:<br /> <br /> #toevoegen aan wwwdebug.sh<br /> #&lt;code&gt;./wwwdebug.sh&lt;/code&gt;<br /> #&lt;code&gt;git commit -a&lt;/code&gt; '''(nog niet getest, doe onder begeleiding van een WebCie'er!)'''<br /> #&lt;code&gt;logout&lt;/code&gt;<br /> #&lt;code&gt;sudo /etc/init.d/httpd reload&lt;/code&gt;<br /> #in de map gettext het script &lt;code&gt;update&lt;/code&gt; uitvoeren<br /> <br /> De rest hoeft niet meer op de vm-www-debug gedaan te worden.<br /> <br /> #in de map www draai &lt;code&gt;php composer install&lt;/code&gt; en &lt;code&gt;./bowerphp_key install&lt;/code&gt;<br /> #in de map www het script &lt;code&gt;minify&lt;/code&gt; uitvoeren (op dit punt zou de debug moeten werken, check dit in je browser)<br /> #in &lt;code&gt;$GODNRS&lt;/code&gt; zetten (space/auth/init.php)<br /> #Vertel deze persoon 'even' hoe subversion werkt enzo<br /> #op de whoswho toevoegen, natuurlijk!<br /> <br /> [[Category:WebCie]]</div>

Pepijno https://mediawiki.a-eskwadraat.nl/wiki/index.php/Nieuw_WWW-lid 2017-05-07T12:54:55Z

<p>Pepijno: </p> <hr /> <div>Wat je moet doen voor een nieuw lid van de [[WebCie|www]]:<br /> <br /> == Bestuur ==<br /> <br /> #Toevoegen aan 'webcie' (inloggen op de server en bij de repo)<br /> <br /> == WWW ==<br /> <br /> Als eerste ga je je eigen debug omgeving aanmaken:<br /> <br /> cd /mnt/wwwdebug<br /> #&lt;code&gt;mkdir $USER/&lt;/code&gt;<br /> #&lt;code&gt;cd $USER&lt;/code&gt;<br /> #&lt;code&gt;kinit $USER&lt;/code&gt; &lt;!-- TODO: dit was nodig voor svn maar nu niet meer waarschijnlijk? --&gt;<br /> #&lt;code&gt;git clone ssh://vm-www/srv/git wwwdebug&lt;/code&gt;<br /> #&lt;code&gt;cd wwwdebug&lt;/code&gt; (als je dat hierboven nog niet hebt gedaan)<br /> #&lt;code&gt;chmod o= .&lt;/code&gt; (de punt hoort erbij)<br /> #&lt;code&gt;sudo chgrp apache .&lt;/code&gt; (het kan zijn dat je deze op de vm-www-debug moet doen)<br /> #&lt;code&gt;ln -s /mnt/wwwdebug/$USER/wwwdebug ~/&lt;/code&gt;<br /> <br /> De rest moet worden uitgevoerd op de vm-www-debug (dus doe &lt;code&gt;ssh vm-www-debug&lt;/code&gt;).<br /> <br /> &lt;code&gt;/srv/&lt;/code&gt;:<br /> <br /> #toevoegen aan htpasswd: &lt;code&gt;htpasswd /srv/htpasswd $USER&lt;/code&gt;)<br /> #toevoegen aan htgroups: &lt;code&gt;nano /srv/config/vm-www-debug/httpd/conf.d/htgroups&lt;/code&gt; en &lt;code&gt;nano /srv/config/vm-www/httpd/conf.d/htgroups&lt;/code&gt; (of gebruik &lt;code&gt;vi&lt;/code&gt; i.p.v. &lt;code&gt;nano&lt;/code&gt; als je cool bent ;))<br /> <br /> <br /> #&lt;code&gt;&lt;span data-cke-bookmark=&quot;1&quot; id=&quot;cke_bm_99S&quot; style=&quot;display: none;&quot;&gt;&amp;nbsp;&lt;/span&gt;cd ~/wwwdebug/www; autoconf; ./configure --enable-debug --with-hostname=$bla-debug.a-eskwadraat.nl&lt;/code&gt;<br /> #&lt;code&gt;ln -s /srv/http/www/www/{agenda.rss,agenda.vcs,tweets.html} .&lt;/code&gt;<br /> <br /> &lt;code&gt;/srv/config/vm-www-debug/httpd/conf.d/&lt;/code&gt;:<br /> <br /> Als user webcie:<br /> <br /> #toevoegen aan wwwdebug.sh<br /> #&lt;code&gt;./wwwdebug.sh&lt;/code&gt;<br /> #&lt;code&gt;git commit -a&lt;/code&gt; '''(nog niet getest, doe onder begeleiding van een WebCie'er!)'''<br /> #&lt;code&gt;logout&lt;/code&gt;<br /> #&lt;code&gt;sudo /etc/init.d/httpd reload&lt;/code&gt;<br /> #in de map gettext het script &lt;code&gt;update&lt;/code&gt; uitvoeren<br /> <br /> De rest hoeft niet meer op de vm-www-debug gedaan te worden.<br /> <br /> #in de map www draai &lt;code&gt;php composer install&lt;/code&gt; en &lt;code&gt;./bowerphp_key install&lt;/code&gt;<br /> #in de map www het script &lt;code&gt;minify&lt;/code&gt; uitvoeren (op dit punt zou de debug moeten werken, check dit in je browser)<br /> #in &lt;code&gt;$GODNRS&lt;/code&gt; zetten (space/auth/init.php)<br /> #Vertel deze persoon 'even' hoe subversion werkt enzo<br /> #op de whoswho toevoegen, natuurlijk!<br /> <br /> [[Category:WebCie]]</div>

Pepijno https://mediawiki.a-eskwadraat.nl/wiki/index.php/Nieuw_WWW-lid 2017-05-04T15:57:50Z

<p>Pepijno: </p> <hr /> <div>Wat je moet doen voor een nieuw lid van de [[WebCie|www]]:<br /> <br /> == Bestuur ==<br /> <br /> #Toevoegen aan 'webcie' (inloggen op de server en bij de repo)<br /> <br /> == WWW ==<br /> <br /> #&lt;code&gt;cd /mnt/wwwdebug&lt;/code&gt;<br /> #&lt;code&gt;mkdir $USER/&lt;/code&gt;<br /> #&lt;code&gt;cd $USER&lt;/code&gt;<br /> #&lt;code&gt;kinit $USER&lt;/code&gt; &lt;!-- TODO: dit was nodig voor svn maar nu niet meer waarschijnlijk? --&gt;<br /> #&lt;code&gt;git clone ssh://vm-www/srv/git wwwdebug&lt;/code&gt;<br /> #&lt;code&gt;cd wwwdebug&lt;/code&gt; (als je dat hierboven nog niet hebt gedaan)<br /> #&lt;code&gt;chmod o= .&lt;/code&gt; (de punt hoort erbij)<br /> #&lt;code&gt;sudo chgrp apache .&lt;/code&gt; (het kan zijn dat je deze op de vm-www-debug moet doen)<br /> #&lt;code&gt;ln -s /mnt/wwwdebug/$USER/wwwdebug ~/&lt;/code&gt;<br /> <br /> De rest moet worden uitgevoerd op de vm-www-debug (dus doe &lt;code&gt;ssh vm-www-debug&lt;/code&gt;).<br /> <br /> &lt;code&gt;/srv/&lt;/code&gt;:<br /> <br /> #toevoegen aan htpasswd: &lt;code&gt;htpasswd /srv/htpasswd $USER&lt;/code&gt;)<br /> #toevoegen aan htgroups: &lt;code&gt;nano /srv/config/vm-www-debug/httpd/conf.d/htgroups&lt;/code&gt; en &lt;code&gt;nano /srv/config/vm-www/httpd/conf.d/htgroups&lt;/code&gt; (of gebruik &lt;code&gt;vi&lt;/code&gt; i.p.v. &lt;code&gt;nano&lt;/code&gt; als je cool bent ;))<br /> <br /> <br /> #&lt;code&gt;&lt;span data-cke-bookmark=&quot;1&quot; id=&quot;cke_bm_99S&quot; style=&quot;display: none;&quot;&gt;&amp;nbsp;&lt;/span&gt;cd ~/wwwdebug/www; autoconf; ./configure --enable-debug --with-hostname=$bla-debug.a-eskwadraat.nl&lt;/code&gt;<br /> #&lt;code&gt;ln -s /srv/http/www/www/{agenda.rss,agenda.vcs,tweets.html} .&lt;/code&gt;<br /> <br /> &lt;code&gt;/srv/config/vm-www-debug/httpd/conf.d/&lt;/code&gt;:<br /> <br /> Als user webcie:<br /> <br /> #toevoegen aan wwwdebug.sh<br /> #&lt;code&gt;./wwwdebug.sh&lt;/code&gt;<br /> #&lt;code&gt;git commit -a&lt;/code&gt; '''(nog niet getest, doe onder begeleiding van een WebCie'er!)'''<br /> #&lt;code&gt;logout&lt;/code&gt;<br /> #&lt;code&gt;sudo /etc/init.d/httpd reload&lt;/code&gt;<br /> #in de map gettext het script &lt;code&gt;update&lt;/code&gt; uitvoeren<br /> <br /> De rest hoeft niet meer op de vm-www-debug gedaan te worden.<br /> <br /> #in de map www draai &lt;code&gt;php composer install&lt;/code&gt; en &lt;code&gt;./bowerphp_key install&lt;/code&gt;<br /> #in de map www het script &lt;code&gt;minify&lt;/code&gt; uitvoeren (op dit punt zou de debug moeten werken, check dit in je browser)<br /> #in &lt;code&gt;$GODNRS&lt;/code&gt; zetten (space/auth/init.php)<br /> #Vertel deze persoon 'even' hoe subversion werkt enzo<br /> #op de whoswho toevoegen, natuurlijk!<br /> <br /> [[Category:WebCie]]</div>

Pepijno https://mediawiki.a-eskwadraat.nl/wiki/index.php/Nieuw_WWW-lid 2017-04-28T18:11:59Z

<p>Pepijno: /* WWW */</p> <hr /> <div>Wat je moet doen voor een nieuw lid van de [[WebCie|www]]:<br /> <br /> == Bestuur ==<br /> <br /> #Toevoegen aan 'webcie' (inloggen op de server en bij de repo)<br /> <br /> == WWW ==<br /> <br /> #&lt;code&gt;cd /mnt/wwwdebug&lt;/code&gt;<br /> #&lt;code&gt;mkdir $USER/&lt;/code&gt;<br /> #&lt;code&gt;cd $USER&lt;/code&gt;<br /> #&lt;code&gt;kinit $USER&lt;/code&gt; &lt;!-- TODO: dit was nodig voor svn maar nu niet meer waarschijnlijk? --&gt;<br /> #&lt;code&gt;git clone ssh://vm-www/srv/git wwwdebug&lt;/code&gt;<br /> #&lt;code&gt;cd wwwdebug&lt;/code&gt; (als je dat hierboven nog niet hebt gedaan)<br /> #&lt;code&gt;chmod o= .&lt;/code&gt; (de punt hoort erbij)<br /> #&lt;code&gt;sudo chgrp apache .&lt;/code&gt; (het kan zijn dat je deze op de vm-www-debug moet doen)<br /> #&lt;code&gt;ln -s /mnt/wwwdebug/$USER/wwwdebug ~/&lt;/code&gt;<br /> <br /> De rest moet worden uitgevoerd op de vm-www-debug (dus doe &lt;code&gt;ssh vm-www-debug&lt;/code&gt;).<br /> <br /> &lt;code&gt;/srv/&lt;/code&gt;:<br /> <br /> #toevoegen aan htpasswd: &lt;code&gt;htpasswd /srv/htpasswd $USER&lt;/code&gt;)<br /> #toevoegen aan htgroups: &lt;code&gt;nano /srv/config/vm-www-debug/httpd/conf.d/htgroups&lt;/code&gt; en &lt;code&gt;nano /srv/config/vm-www/httpd/conf.d/htgroups&lt;/code&gt; (of gebruik &lt;code&gt;vi&lt;/code&gt; i.p.v. &lt;code&gt;nano&lt;/code&gt; als je cool bent ;))<br /> <br /> <br /> #&lt;code&gt;&lt;span data-cke-bookmark=&quot;1&quot; id=&quot;cke_bm_99S&quot; style=&quot;display: none;&quot;&gt;&amp;nbsp;&lt;/span&gt;cd ~/wwwdebug/www; autoconf; ./configure --enable-debug --with-hostname=$bla-debug.a-eskwadraat.nl&lt;/code&gt;<br /> #&lt;code&gt;ln -s /srv/http/www/www/{agenda.rss,agenda.vcs,tweets.html} .&lt;/code&gt;<br /> <br /> &lt;code&gt;/srv/config/vm-www-debug/httpd/conf.d/&lt;/code&gt;:<br /> <br /> Als user webcie:<br /> <br /> #toevoegen aan wwwdebug.sh<br /> #&lt;code&gt;./wwwdebug.sh&lt;/code&gt;<br /> #&lt;code&gt;git commit -a&lt;/code&gt; '''(nog niet getest, doe onder begeleiding van een WebCie'er!)'''<br /> #&lt;code&gt;logout&lt;/code&gt;<br /> #&lt;code&gt;sudo /etc/init.d/httpd reload&lt;/code&gt;<br /> #in de map gettext het script &lt;code&gt;update&lt;/code&gt; uitvoeren<br /> <br /> De rest hoeft niet meer op de vm-www-debug gedaan te worden.<br /> <br /> #in de map www draai &lt;code&gt;php composer install&lt;/code&gt; en &lt;code&gt;./vendor/bin/bowerphp install&lt;/code&gt;<br /> #in de map www het script &lt;code&gt;minify&lt;/code&gt; uitvoeren (op dit punt zou de debug moeten werken, check dit in je browser)<br /> #in &lt;code&gt;$GODNRS&lt;/code&gt; zetten (space/auth/init.php)<br /> #Vertel deze persoon 'even' hoe subversion werkt enzo<br /> #op de whoswho toevoegen, natuurlijk!<br /> <br /> [[Category:WebCie]]</div>

Pepijno https://mediawiki.a-eskwadraat.nl/wiki/index.php/Nieuw_WWW-lid 2017-04-28T18:11:39Z

<p>Pepijno: /* WWW */</p> <hr /> <div>Wat je moet doen voor een nieuw lid van de [[WebCie|www]]:<br /> <br /> == Bestuur ==<br /> <br /> #Toevoegen aan 'webcie' (inloggen op de server en bij de repo)<br /> <br /> == WWW ==<br /> <br /> #&lt;code&gt;cd /mnt/wwwdebug&lt;/code&gt;<br /> #&lt;code&gt;mkdir $USER/&lt;/code&gt;<br /> #&lt;code&gt;cd $USER&lt;/code&gt;<br /> #&lt;code&gt;kinit $USER&lt;/code&gt; &lt;!-- TODO: dit was nodig voor svn maar nu niet meer waarschijnlijk? --&gt;<br /> #&lt;code&gt;git clone ssh://vm-www/srv/git wwwdebug&lt;/code&gt;<br /> #&lt;code&gt;cd wwwdebug&lt;/code&gt; (als je dat hierboven nog niet hebt gedaan)<br /> #&lt;code&gt;chmod o= .&lt;/code&gt; (de punt hoort erbij)<br /> #&lt;code&gt;sudo chgrp apache .&lt;/code&gt; (het kan zijn dat je deze op de vm-www-debug moet doen)<br /> #&lt;code&gt;ln -s /mnt/wwwdebug/$USER/wwwdebug ~/&lt;/code&gt;<br /> <br /> De rest moet worden uitgevoerd op de vm-www-debug (dus doe &lt;code&gt;ssh vm-www-debug&lt;/code&gt;).<br /> <br /> &lt;code&gt;/srv/&lt;/code&gt;:<br /> <br /> #toevoegen aan htpasswd: &lt;code&gt;htpasswd /srv/htpasswd $USER&lt;/code&gt;)<br /> #toevoegen aan htgroups: &lt;code&gt;nano /srv/config/vm-www-debug/httpd/conf.d/htgroups&lt;/code&gt; en &lt;code&gt;nano /srv/config/vm-www/httpd/conf.d/htgroups&lt;/code&gt; (of gebruik &lt;code&gt;vi&lt;/code&gt; i.p.v. &lt;code&gt;nano&lt;/code&gt; als je cool bent ;))<br /> <br /> <br /> #&lt;code&gt;&lt;span data-cke-bookmark=&quot;1&quot; id=&quot;cke_bm_99S&quot; style=&quot;display: none;&quot;&gt;&amp;nbsp;&lt;/span&gt;cd ~/wwwdebug/www; autoconf; ./configure --enable-debug --with-hostname=$bla-debug.a-eskwadraat.nl&lt;/code&gt;<br /> #&lt;code&gt;ln -s /srv/http/www/www/{agenda.rss,agenda.vcs,tweets.html} .&lt;/code&gt;<br /> <br /> &lt;code&gt;/srv/config/vm-www-debug/httpd/conf.d/&lt;/code&gt;:<br /> <br /> Als user webcie:<br /> <br /> #toevoegen aan wwwdebug.sh<br /> #&lt;code&gt;./wwwdebug.sh&lt;/code&gt;<br /> #&lt;code&gt;git commit -a&lt;/code&gt; '''(nog niet getest, doe onder begeleiding van een WebCie'er!)'''<br /> #&lt;code&gt;logout&lt;/code&gt;<br /> #&lt;code&gt;sudo /etc/init.d/httpd reload&lt;/code&gt;<br /> #in de map gettext het script &lt;code&gt;update&lt;/code&gt; uitvoeren<br /> <br /> De rest hoeft niet meer op de vm-www-debug gedaan te worden.<br /> <br /> #in de map www draai &lt;code&gt;php composer install&lt;/code&gt; en &lt;code&gt;./vendor/bin/bowerphp install&lt;/code&gt;<br /> #in de map www het script &lt;code&gt;minify&lt;/code&gt; uitvoeren (op dit punt zou de debug moeten werken, check dit in je browser)<br /> #in &lt;code&gt;$GODNRS&lt;/code&gt; zetten (space/auth/init.php)<br /> #Vertel deze persoon 'even' hoe subversion werkt enzo<br /> #op de whoswho toevoegen, natuurlijk!<br /> <br /> &lt;b&gt;WebCie protip:&lt;/b&gt;<br /> Je kan in je ~/.bashrc de regel<br /> export PATH=$PATH:~/wwwdebug/www/<br /> [[Category:WebCie]]</div>

Pepijno https://mediawiki.a-eskwadraat.nl/wiki/index.php/Nieuw_WWW-lid 2017-04-28T18:10:57Z

<p>Pepijno: /* WWW */</p> <hr /> <div>Wat je moet doen voor een nieuw lid van de [[WebCie|www]]:<br /> <br /> == Bestuur ==<br /> <br /> #Toevoegen aan 'webcie' (inloggen op de server en bij de repo)<br /> <br /> == WWW ==<br /> <br /> #&lt;code&gt;cd /mnt/wwwdebug&lt;/code&gt;<br /> #&lt;code&gt;mkdir $USER/&lt;/code&gt;<br /> #&lt;code&gt;cd $USER&lt;/code&gt;<br /> #&lt;code&gt;kinit $USER&lt;/code&gt; &lt;!-- TODO: dit was nodig voor svn maar nu niet meer waarschijnlijk? --&gt;<br /> #&lt;code&gt;git clone ssh://vm-www/srv/git wwwdebug&lt;/code&gt;<br /> #&lt;code&gt;cd wwwdebug&lt;/code&gt; (als je dat hierboven nog niet hebt gedaan)<br /> #&lt;code&gt;chmod o= .&lt;/code&gt; (de punt hoort erbij)<br /> #&lt;code&gt;sudo chgrp apache .&lt;/code&gt; (het kan zijn dat je deze op de vm-www-debug moet doen)<br /> #&lt;code&gt;ln -s /mnt/wwwdebug/$USER/wwwdebug ~/&lt;/code&gt;<br /> <br /> De rest moet worden uitgevoerd op de vm-www-debug (dus doe &lt;code&gt;ssh vm-www-debug&lt;/code&gt;).<br /> <br /> &lt;code&gt;/srv/&lt;/code&gt;:<br /> <br /> #toevoegen aan htpasswd: &lt;code&gt;htpasswd /srv/htpasswd $USER&lt;/code&gt;)<br /> #toevoegen aan htgroups: &lt;code&gt;nano /srv/config/vm-www-debug/httpd/conf.d/htgroups&lt;/code&gt; en &lt;code&gt;nano /srv/config/vm-www/httpd/conf.d/htgroups&lt;/code&gt; (of gebruik &lt;code&gt;vi&lt;/code&gt; i.p.v. &lt;code&gt;nano&lt;/code&gt; als je cool bent ;))<br /> <br /> <br /> #&lt;code&gt;&lt;span data-cke-bookmark=&quot;1&quot; id=&quot;cke_bm_99S&quot; style=&quot;display: none;&quot;&gt;&amp;nbsp;&lt;/span&gt;cd ~/wwwdebug/www; autoconf; ./configure --enable-debug --with-hostname=$bla-debug.a-eskwadraat.nl&lt;/code&gt;<br /> #&lt;code&gt;ln -s /srv/http/www/www/{agenda.rss,agenda.vcs,tweets.html} .&lt;/code&gt;<br /> <br /> &lt;code&gt;/srv/config/vm-www-debug/httpd/conf.d/&lt;/code&gt;:<br /> <br /> Als user webcie:<br /> <br /> #toevoegen aan wwwdebug.sh<br /> #&lt;code&gt;./wwwdebug.sh&lt;/code&gt;<br /> #&lt;code&gt;git commit -a&lt;/code&gt; '''(nog niet getest, doe onder begeleiding van een WebCie'er!)'''<br /> #&lt;code&gt;logout&lt;/code&gt;<br /> #&lt;code&gt;sudo /etc/init.d/httpd reload&lt;/code&gt;<br /> #in de map gettext het script &lt;code&gt;update&lt;/code&gt; uitvoeren<br /> <br /> De rest hoeft niet meer op de vm-www-debug gedaan te worden.<br /> <br /> #in de map www draai &lt;code&gt;php composer install&lt;/code&gt; en &lt;code&gt;./vendor/bin/bowerphp install&lt;/code&gt;<br /> #in de map www het script &lt;code&gt;minify&lt;/code&gt; uitvoeren (op dit punt zou de debug moeten werken, check dit in je browser)<br /> #in &lt;code&gt;$GODNRS&lt;/code&gt; zetten (space/auth/init.php)<br /> #Vertel deze persoon 'even' hoe subversion werkt enzo<br /> #op de whoswho toevoegen, natuurlijk!<br /> <br /> WebCie protip:<br /> Je kan in je ~/.bashrc de regel<br /> export PATH=$PATH:~/wwwdebug/www/<br /> [[Category:WebCie]]</div>

Pepijno https://mediawiki.a-eskwadraat.nl/wiki/index.php/Nieuw_WWW-lid 2017-04-24T09:30:46Z

<p>Pepijno: /* WWW */</p> <hr /> <div>Wat je moet doen voor een nieuw lid van de [[WebCie|www]]:<br /> <br /> == Bestuur ==<br /> <br /> #Toevoegen aan 'webcie' (inloggen op de server en bij de repo)<br /> <br /> == WWW ==<br /> <br /> #&lt;code&gt;cd /mnt/wwwdebug&lt;/code&gt;<br /> #&lt;code&gt;mkdir $USER/&lt;/code&gt;<br /> #&lt;code&gt;cd $USER&lt;/code&gt;<br /> #&lt;code&gt;kinit $USER&lt;/code&gt; &lt;!-- TODO: dit was nodig voor svn maar nu niet meer waarschijnlijk? --&gt;<br /> #&lt;code&gt;git clone ssh://vm-www/srv/git wwwdebug&lt;/code&gt;<br /> #&lt;code&gt;cd wwwdebug&lt;/code&gt; (als je dat hierboven nog niet hebt gedaan)<br /> #&lt;code&gt;chmod o= .&lt;/code&gt; (de punt hoort erbij)<br /> #&lt;code&gt;sudo chgrp apache .&lt;/code&gt; (het kan zijn dat je deze op de vm-www-debug moet doen)<br /> #&lt;code&gt;ln -s /mnt/wwwdebug/$USER/wwwdebug ~/&lt;/code&gt;<br /> <br /> De rest moet worden uitgevoerd op de vm-www-debug (dus doe &lt;code&gt;ssh vm-www-debug&lt;/code&gt;).<br /> <br /> &lt;code&gt;/srv/&lt;/code&gt;:<br /> <br /> #toevoegen aan htpasswd: &lt;code&gt;htpasswd /srv/htpasswd $USER&lt;/code&gt;)<br /> #toevoegen aan htgroups: &lt;code&gt;nano /srv/config/vm-www-debug/httpd/conf.d/htgroups&lt;/code&gt; en &lt;code&gt;nano /srv/config/vm-www/httpd/conf.d/htgroups&lt;/code&gt; (of gebruik &lt;code&gt;vi&lt;/code&gt; i.p.v. &lt;code&gt;nano&lt;/code&gt; als je cool bent ;))<br /> <br /> <br /> #&lt;code&gt;&lt;span data-cke-bookmark=&quot;1&quot; id=&quot;cke_bm_99S&quot; style=&quot;display: none;&quot;&gt;&amp;nbsp;&lt;/span&gt;cd ~/wwwdebug/www; autoconf; ./configure --enable-debug --with-hostname=$bla-debug.a-eskwadraat.nl&lt;/code&gt;<br /> #&lt;code&gt;ln -s /srv/http/www/www/{agenda.rss,agenda.vcs,tweets.html} .&lt;/code&gt;<br /> <br /> &lt;code&gt;/srv/config/vm-www-debug/httpd/conf.d/&lt;/code&gt;:<br /> <br /> Als user webcie:<br /> <br /> #toevoegen aan wwwdebug.sh<br /> #&lt;code&gt;./wwwdebug.sh&lt;/code&gt;<br /> #&lt;code&gt;git commit -a&lt;/code&gt; '''(nog niet getest, doe onder begeleiding van een WebCie'er!)'''<br /> #&lt;code&gt;logout&lt;/code&gt;<br /> #&lt;code&gt;sudo /etc/init.d/httpd reload&lt;/code&gt;<br /> #in de map gettext het script &lt;code&gt;update&lt;/code&gt; uitvoeren<br /> <br /> De rest hoeft niet meer op de vm-www-debug gedaan te worden.<br /> <br /> #in de map www draai &lt;code&gt;php composer install&lt;/code&gt; en &lt;code&gt;./vendor/bin/bowerphp install&lt;/code&gt;<br /> #in de map www het script &lt;code&gt;minify&lt;/code&gt; uitvoeren (op dit punt zou de debug moeten werken, check dit in je browser)<br /> #in &lt;code&gt;$GODNRS&lt;/code&gt; zetten (space/auth/init.php)<br /> #Vertel deze persoon 'even' hoe subversion werkt enzo<br /> #op de whoswho toevoegen, natuurlijk!<br /> [[Category:WebCie]]</div>

Pepijno https://mediawiki.a-eskwadraat.nl/wiki/index.php/Nieuw_WWW-lid 2017-04-20T12:23:57Z

<p>Pepijno: </p> <hr /> <div>Wat je moet doen voor een nieuw lid van de [[WebCie|www]]:<br /> <br /> == Bestuur ==<br /> <br /> #Toevoegen aan 'webcie' (inloggen op de server en bij de repo)<br /> <br /> == WWW ==<br /> <br /> #&lt;code&gt;cd /mnt/wwwdebug&lt;/code&gt;<br /> #&lt;code&gt;mkdir $USER/&lt;/code&gt;<br /> #&lt;code&gt;cd $USER&lt;/code&gt;<br /> #&lt;code&gt;kinit $USER&lt;/code&gt; &lt;!-- TODO: dit was nodig voor svn maar nu niet meer waarschijnlijk? --&gt;<br /> #&lt;code&gt;git clone ssh://vm-www/srv/git wwwdebug&lt;/code&gt;<br /> #&lt;code&gt;cd wwwdebug&lt;/code&gt; (als je dat hierboven nog niet hebt gedaan)<br /> #&lt;code&gt;chmod o= .&lt;/code&gt; (de punt hoort erbij)<br /> #&lt;code&gt;sudo chgrp apache .&lt;/code&gt; (het kan zijn dat je deze op de vm-www-debug moet doen)<br /> #&lt;code&gt;ln -s /mnt/wwwdebug/$USER/wwwdebug ~/&lt;/code&gt;<br /> <br /> De rest moet worden uitgevoerd op de vm-www-debug (dus doe &lt;code&gt;ssh vm-www-debug&lt;/code&gt;).<br /> <br /> &lt;code&gt;/srv/&lt;/code&gt;:<br /> <br /> #toevoegen aan htpasswd: &lt;code&gt;htpasswd /srv/htpasswd $USER&lt;/code&gt;)<br /> #toevoegen aan htgroups: &lt;code&gt;nano /srv/config/vm-www-debug/httpd/conf.d/htgroups&lt;/code&gt; en &lt;code&gt;nano /srv/config/vm-www/httpd/conf.d/htgroups&lt;/code&gt; (of gebruik &lt;code&gt;vi&lt;/code&gt; i.p.v. &lt;code&gt;nano&lt;/code&gt; als je cool bent ;))<br /> <br /> <br /> #&lt;code&gt;&lt;span data-cke-bookmark=&quot;1&quot; id=&quot;cke_bm_99S&quot; style=&quot;display: none;&quot;&gt;&amp;nbsp;&lt;/span&gt;cd ~/wwwdebug/www; autoconf; ./configure --enable-debug --with-hostname=$bla-debug.a-eskwadraat.nl&lt;/code&gt;<br /> #&lt;code&gt;ln -s /srv/http/www/www/{agenda.rss,agenda.vcs,tweets.html} .&lt;/code&gt;<br /> <br /> &lt;code&gt;/srv/config/vm-www-debug/httpd/conf.d/&lt;/code&gt;:<br /> <br /> Als user webcie:<br /> <br /> #toevoegen aan wwwdebug.sh<br /> #&lt;code&gt;./wwwdebug.sh&lt;/code&gt;<br /> #&lt;code&gt;git commit -a&lt;/code&gt; '''(nog niet getest, doe onder begeleiding van een WebCie'er!)'''<br /> #&lt;code&gt;logout&lt;/code&gt;<br /> #&lt;code&gt;sudo /etc/init.d/httpd reload&lt;/code&gt;<br /> #in de map gettext het script &lt;code&gt;update&lt;/code&gt; uitvoeren<br /> <br /> De rest hoeft niet meer op de vm-www-debug gedaan te worden.<br /> <br /> #in de map www draai &lt;code&gt;npm install&lt;/code&gt; en &lt;code&gt;php composer install&lt;/code&gt;<br /> #in de map www het script &lt;code&gt;minify&lt;/code&gt; uitvoeren (op dit punt zou de debug moeten werken, check dit in je browser)<br /> #in &lt;code&gt;$GODNRS&lt;/code&gt; zetten (space/auth/init.php)<br /> #Vertel deze persoon 'even' hoe subversion werkt enzo<br /> #op de whoswho toevoegen, natuurlijk!<br /> [[Category:WebCie]]</div>

Pepijno https://mediawiki.a-eskwadraat.nl/wiki/index.php/Quota 2017-03-28T19:35:49Z

<p>Pepijno: </p> <hr /> <div>[[category:sysop]]<br /> Om het gebruik van schrijfruimte te beperken gebruiken we een quota systeem dat gebouwd is op de faciliteiten die zfs biedt als filesystem. Momenteel gebruiken we alleen userquota en geen groupquota. <br /> <br /> Als mensen direct bestanden kunnen aanpassen bij comissieaccounts worden zij wel owner van die files. Om dit probleem te vermijden zullen groupquota's gebruikt moeten gaan worden, maar dit zal een relatief kleine aanpassing zijn mits de permissies goed staan. De zfs dataset(s) waarop userquota gebruikt worden is storage/home. <br /> <br /> De quota worden opgeslagen in een sqlite3 file ''/home/quota.db''. Het is niet de bedoeling dat deze file direct gemanipuleerd wordt, maar er is een wrapper beschikbaar in de vorm van het script ''changequota'' Elke nacht wordt aan de hand van deze file met een cronjob de userquota ingesteld op de dataset(s). Mocht er accuut iets aangepast moeten worden, dan moet dit ook nog handmatig aangepast worden op haskell.<br /> <br /> In het hypotetische geval dat de ''spocie'' op hard quotum zit dan moeten er 2 dingen gedaan worden. Voer ''changequota'' uit als root:<br /> <br /> sudo /usr/local/bin/changequota $user<br /> <br /> Toevoegen Quotum<br /> # Bij het toevoegen van quota vul hier de hoeveelheid extra quota in (bv. 42MB, 1.5G, etc).<br /> # Het is ook mogelijk om een tijdslimiet hierop te zetten (bv. serious quotum), doe dit preferabel in een formaat als ''dd-mm-yyyy''.<br /> # Vul de reden in waarom de gebruiker meer quotum behoeft<br /> <br /> Verwijderen Quotum<br /> # Bij het verwijderen van quota wordt er een lijst getoond van entries in de database en hoeveel extra quotum deze entry de gebruiker geeft. Deze lijst is 0 indexed. Standaard heeft elke gebruiker/comissie 1Gb quotum. <br /> # Vul hier het getal in van de entry die je wilt verwijderen. Zou je dus je standaard quotum willen verwijderen dan vul je hier 0 in.<br /> <br /> ZFS werkt met hard quotum. Het harde quotum is standaard quotum +10GB. Wanneer de grace periode van 2 weken over is wordt het quotum op 1 bit gezet.<br /> Standaard quota worden elke nacht gegenereerd en in de database gezet, mocht deze per ongeluk verwijderd worden dan is het handiger om deze automatisch te laten genereren in plaats van dit weer handmatig te fixen.</div>

Pepijno https://mediawiki.a-eskwadraat.nl/wiki/index.php/Webcie-vms 2017-03-05T11:45:16Z

<p>Pepijno: </p> <hr /> <div>[[Category:Sysop]]<br /> In het vm-park draaien 3 virtuele machines voor de WebCie. Dit zijn de vm-www, de vm-www-debug en de vm-www-inwerking. Deze zijn om de website van A-Eskwadraat op te draaien en om een ontwikkelingsomgeving en inwerkomgeving voor de WebCie te draaien.<br /> <br /> == Packages ==<br /> Op dit moment zijn er de volgende packages die op alle 3 de vm's geïnstaleerd moeten staan:<br /> <br /> ImageMagick<br /> autoconf<br /> doxygen<br /> fcgi<br /> gcc<br /> gettext<br /> git<br /> git-svn<br /> graphviz<br /> graphviz-php <br /> httpd<br /> httpd-tools<br /> mod_auth_kerb <br /> mod_auth_pam <br /> mod_authnz_pam <br /> mod_extract_forwarded<br /> mod_intercept_form_submit<br /> mod_lookup_identity<br /> mod_proxy_fcgi <br /> mod_ssl<br /> mysql<br /> mysql-libs<br /> mysql-server <br /> perl-Image-ExifTool<br /> php<br /> php-bcmath<br /> php-cli<br /> php-common<br /> php-devel<br /> php-fpm<br /> php-gd<br /> php-mbstring <br /> php-mcrypt<br /> php-mysql<br /> php-pdo<br /> php-pear<br /> php-pecl-apcu <br /> php-pecl-zendopcache<br /> php-php-gettext<br /> php-process<br /> php-tcpdf<br /> php-tcpdf-dejavu-sans-fonts<br /> php-tidy<br /> php-xml<br /> phpMyAdmin<br /> subversion<br /> subversion-perl<br /> webalizer<br /> <br /> == Rechten ==<br /> <br /> Omdat alleen de webcie op alle vm's mag inloggen is er in IPA de host-group webcie-vms. Op deze manier kan er makkelijk met een HBAC-regel gezegd worden dat alleen de webcie op deze vm's in mag loggen. Het is alleen wel handig als er een aparte HBAC-regel komt voor de vm-www-inwerking, zodat er makkelijk tijdelijk nieuwe potentieële webcie-leden aan toegevoegd kunnen worden.<br /> <br /> De website maakt nog gebruik van twee dingen die met accounts te maken hebben. Een daarvan is het automatisch laten inloggen op de de A-Eskwadraatwebsite op het interne netwerk en de andere regel is de mogelijkheid om met je systeemaccount in te kunnen loggen op de website.<br /> <br /> Voor het automatisch inloggen (zie ook bij [[Automatisch inloggen]]) is er in IPA de HBAC-regel 'allow_www-auth'. Die zegt dat mensjes via de services www-login en www-auth op de vm-www.a-eskwadraat.nl en www-auth.a-eskwadraat.nl.<br /> <br /> De regel voor het laten inloggen met je systeemaccount op de website is de regel 'allow_systeemLogin' en die zegt dat mensjes op alle webcie-vms met de service httpd_systeemlogin kunnen.<br /> <br /> Omdat de website ook commando's met IPA mogelijk maakt is er een speciale user website-ipa die de rechten heeft om de juiste commando's uit te voeren op de vm-www<br /> <br /> == Mounts ==<br /> <br /> == Automatisch inloggen ==<br /> <br /> CERTS!<br /> <br /> == Instellingen ==<br /> <br /> == Installatie ==<br /> <br /> === vm-www ===<br /> <br /> === vm-www-debug ===<br /> <br /> Highstate de vm. Als het goed is staan veel instellingen nu al goed. Voer<br /> mysql_secure_installation<br /> uit. Let erop dat je de test databases niet weghaalt. Geef ook een nieuw root-wachtwoord. Zet nu in de home van zowel root als de user webcie het bestand .my.cnf (LET OP: alleen leesbaar voor de user zelf!!) en zet daarin het volgende:<br /> [client]<br /> user = root<br /> pass = *passwd*<br /> Dit zorgt ervoor dat als er commando's op mysql gedaan moeten worden de user automatisch als root autenticeert.<br /> <br /> Kopieer nu de debug.pub van de vm-www en stop m in de map /root/.ssh. Pas het bestand aan en zet aan het begin van de reget<br /> command=&quot;mysql $SSH_ORIGINAL_COMMAND&quot; ssh-rsa AAAAB3Nza...<br /> Dit zorgt ervoor dat de vm-www zonder wachtwoord mysqlcommando's uit kan voeren voor het kopiëren van de db's.<br /> <br /> Maak een dump van de mysql-db (hierin staan oa alle users) op de vm-www en kopieer deze naar de mysql-db en flush de privileges op mysql. Maak nu de benodigde test_db's aan (op moment van schrijven test_benamite, test_boeken en test_whoswho4). Kopieer nu de databases van de vm-www naar de desbetreffende test_db's.</div>

Pepijno https://mediawiki.a-eskwadraat.nl/wiki/index.php/Webcie-vms 2017-03-05T11:43:01Z

<p>Pepijno: /* vm-www-debug */</p> <hr /> <div>[[Category:Sysop]]<br /> In het vm-park draaien 3 virtuele machines voor de WebCie. Dit zijn de vm-www, de vm-www-debug en de vm-www-inwerking. Deze zijn om de website van A-Eskwadraat op te draaien en om een ontwikkelingsomgeving en inwerkomgeving voor de WebCie te draaien.<br /> <br /> == Packages ==<br /> Op dit moment zijn er de volgende packages die op alle 3 de vm's geïnstaleerd moeten staan:<br /> <br /> ImageMagick<br /> autoconf<br /> doxygen<br /> fcgi<br /> gcc<br /> gettext<br /> git<br /> git-svn<br /> graphviz<br /> graphviz-php <br /> httpd<br /> httpd-tools<br /> mod_auth_kerb <br /> mod_auth_pam <br /> mod_authnz_pam <br /> mod_extract_forwarded<br /> mod_intercept_form_submit<br /> mod_lookup_identity<br /> mod_proxy_fcgi <br /> mod_ssl<br /> mysql<br /> mysql-libs<br /> mysql-server <br /> perl-Image-ExifTool<br /> php<br /> php-bcmath<br /> php-cli<br /> php-common<br /> php-devel<br /> php-fpm<br /> php-gd<br /> php-mbstring <br /> php-mcrypt<br /> php-mysql<br /> php-pdo<br /> php-pear<br /> php-pecl-apcu <br /> php-pecl-zendopcache<br /> php-php-gettext<br /> php-process<br /> php-tcpdf<br /> php-tcpdf-dejavu-sans-fonts<br /> php-tidy<br /> php-xml<br /> phpMyAdmin<br /> subversion<br /> subversion-perl<br /> webalizer<br /> <br /> == Rechten ==<br /> <br /> Omdat alleen de webcie op alle vm's mag inloggen is er in IPA de host-group webcie-vms. Op deze manier kan er makkelijk met een HBAC-regel gezegd worden dat alleen de webcie op deze vm's in mag loggen. Het is alleen wel handig als er een aparte HBAC-regel komt voor de vm-www-inwerking, zodat er makkelijk tijdelijk nieuwe potentieële webcie-leden aan toegevoegd kunnen worden.<br /> <br /> De website maakt nog gebruik van twee dingen die met accounts te maken hebben. Een daarvan is het automatisch laten inloggen op de de A-Eskwadraatwebsite op het interne netwerk en de andere regel is de mogelijkheid om met je systeemaccount in te kunnen loggen op de website.<br /> <br /> Voor het automatisch inloggen (zie ook bij [[Automatisch inloggen]]) is er in IPA de HBAC-regel 'allow_www-auth'. Die zegt dat mensjes via de services www-login en www-auth op de vm-www.a-eskwadraat.nl en www-auth.a-eskwadraat.nl.<br /> <br /> De regel voor het laten inloggen met je systeemaccount op de website is de regel 'allow_systeemLogin' en die zegt dat mensjes op alle webcie-vms met de service httpd_systeemlogin kunnen.<br /> <br /> Omdat de website ook commando's met IPA mogelijk maakt is er een speciale user website-ipa die de rechten heeft om de juiste commando's uit te voeren op de vm-www<br /> <br /> == Mounts ==<br /> <br /> == Automatisch inloggen ==<br /> <br /> CERTS!<br /> <br /> == Instellingen ==<br /> <br /> == Installatie ==<br /> <br /> === vm-www ===<br /> <br /> === vm-www-debug ===<br /> <br /> Highstate de vm. Als het goed is staan veel instellingen nu al goed. Voer<br /> mysql_secure_installation<br /> uit. Let erop dat je de test databases niet weghaalt. Geef ook een nieuw root-wachtwoord. Zet nu in de home van zowel root als de user webcie het bestand .my.cnf (LET OP: alleen leesbaar voor de user zelf!!) en zet daarin het volgende:<br /> [client]<br /> user = root<br /> pass = *passwd*<br /> Dit zorgt ervoor dat als er commando's op mysql gedaan moeten worden de user automatisch als root autenticeert.<br /> <br /> Kopieer nu de debug.pub van de vm-www en stop m in de map /root/.ssh. Pas het bestand aan en zet aan het begin van de reget<br /> command=&quot;mysql $SSH_ORIGINAL_COMMAND&quot; ssh-rsa AAAAB3Nza...<br /> Dit zorgt ervoor dat de vm-www zonder wachtwoord mysqlcommando's uit kan voeren voor het kopiëren van de db's.</div>

Pepijno https://mediawiki.a-eskwadraat.nl/wiki/index.php/Webcie-vms 2017-03-05T11:39:26Z

<p>Pepijno: </p> <hr /> <div>[[Category:Sysop]]<br /> In het vm-park draaien 3 virtuele machines voor de WebCie. Dit zijn de vm-www, de vm-www-debug en de vm-www-inwerking. Deze zijn om de website van A-Eskwadraat op te draaien en om een ontwikkelingsomgeving en inwerkomgeving voor de WebCie te draaien.<br /> <br /> == Packages ==<br /> Op dit moment zijn er de volgende packages die op alle 3 de vm's geïnstaleerd moeten staan:<br /> <br /> ImageMagick<br /> autoconf<br /> doxygen<br /> fcgi<br /> gcc<br /> gettext<br /> git<br /> git-svn<br /> graphviz<br /> graphviz-php <br /> httpd<br /> httpd-tools<br /> mod_auth_kerb <br /> mod_auth_pam <br /> mod_authnz_pam <br /> mod_extract_forwarded<br /> mod_intercept_form_submit<br /> mod_lookup_identity<br /> mod_proxy_fcgi <br /> mod_ssl<br /> mysql<br /> mysql-libs<br /> mysql-server <br /> perl-Image-ExifTool<br /> php<br /> php-bcmath<br /> php-cli<br /> php-common<br /> php-devel<br /> php-fpm<br /> php-gd<br /> php-mbstring <br /> php-mcrypt<br /> php-mysql<br /> php-pdo<br /> php-pear<br /> php-pecl-apcu <br /> php-pecl-zendopcache<br /> php-php-gettext<br /> php-process<br /> php-tcpdf<br /> php-tcpdf-dejavu-sans-fonts<br /> php-tidy<br /> php-xml<br /> phpMyAdmin<br /> subversion<br /> subversion-perl<br /> webalizer<br /> <br /> == Rechten ==<br /> <br /> Omdat alleen de webcie op alle vm's mag inloggen is er in IPA de host-group webcie-vms. Op deze manier kan er makkelijk met een HBAC-regel gezegd worden dat alleen de webcie op deze vm's in mag loggen. Het is alleen wel handig als er een aparte HBAC-regel komt voor de vm-www-inwerking, zodat er makkelijk tijdelijk nieuwe potentieële webcie-leden aan toegevoegd kunnen worden.<br /> <br /> De website maakt nog gebruik van twee dingen die met accounts te maken hebben. Een daarvan is het automatisch laten inloggen op de de A-Eskwadraatwebsite op het interne netwerk en de andere regel is de mogelijkheid om met je systeemaccount in te kunnen loggen op de website.<br /> <br /> Voor het automatisch inloggen (zie ook bij [[Automatisch inloggen]]) is er in IPA de HBAC-regel 'allow_www-auth'. Die zegt dat mensjes via de services www-login en www-auth op de vm-www.a-eskwadraat.nl en www-auth.a-eskwadraat.nl.<br /> <br /> De regel voor het laten inloggen met je systeemaccount op de website is de regel 'allow_systeemLogin' en die zegt dat mensjes op alle webcie-vms met de service httpd_systeemlogin kunnen.<br /> <br /> Omdat de website ook commando's met IPA mogelijk maakt is er een speciale user website-ipa die de rechten heeft om de juiste commando's uit te voeren op de vm-www<br /> <br /> == Mounts ==<br /> <br /> == Automatisch inloggen ==<br /> <br /> CERTS!<br /> <br /> == Instellingen ==<br /> <br /> == Installatie ==<br /> <br /> === vm-www ===<br /> <br /> === vm-www-debug ===<br /> <br /> Highstate de vm. Als het goed is staan veel instellingen nu al goed. Voer<br /> mysql_secure_installation<br /> uit. Let erop dat je de test databases niet weghaalt. Geef ook een nieuw root-wachtwoord. Zet nu in de home van zowel root als de user webcie het bestand .my.cnf (LET OP: alleen leesbaar voor de user zelf!!) en zet daarin het volgende:<br /> [client]<br /> user = root<br /> pass = *passwd*<br /> Dit zorgt ervoor dat als er commando's op mysql gedaan moeten worden de user automatisch als root autenticeert.</div>

Pepijno https://mediawiki.a-eskwadraat.nl/wiki/index.php/Webcie-vms 2017-03-05T11:34:58Z

<p>Pepijno: </p> <hr /> <div>[[Category:Sysop]]<br /> In het vm-park draaien 3 virtuele machines voor de WebCie. Dit zijn de vm-www, de vm-www-debug en de vm-www-inwerking. Deze zijn om de website van A-Eskwadraat op te draaien en om een ontwikkelingsomgeving en inwerkomgeving voor de WebCie te draaien.<br /> <br /> == Packages ==<br /> Op dit moment zijn er de volgende packages die op alle 3 de vm's geïnstaleerd moeten staan:<br /> <br /> ImageMagick<br /> autoconf<br /> doxygen<br /> fcgi<br /> gcc<br /> gettext<br /> git<br /> git-svn<br /> graphviz<br /> graphviz-php <br /> httpd<br /> httpd-tools<br /> mod_auth_kerb <br /> mod_auth_pam <br /> mod_authnz_pam <br /> mod_extract_forwarded<br /> mod_intercept_form_submit<br /> mod_lookup_identity<br /> mod_proxy_fcgi <br /> mod_ssl<br /> mysql<br /> mysql-libs<br /> mysql-server <br /> perl-Image-ExifTool<br /> php<br /> php-bcmath<br /> php-cli<br /> php-common<br /> php-devel<br /> php-fpm<br /> php-gd<br /> php-mbstring <br /> php-mcrypt<br /> php-mysql<br /> php-pdo<br /> php-pear<br /> php-pecl-apcu <br /> php-pecl-zendopcache<br /> php-php-gettext<br /> php-process<br /> php-tcpdf<br /> php-tcpdf-dejavu-sans-fonts<br /> php-tidy<br /> php-xml<br /> phpMyAdmin<br /> subversion<br /> subversion-perl<br /> webalizer<br /> <br /> == Rechten ==<br /> <br /> Omdat alleen de webcie op alle vm's mag inloggen is er in IPA de host-group webcie-vms. Op deze manier kan er makkelijk met een HBAC-regel gezegd worden dat alleen de webcie op deze vm's in mag loggen. Het is alleen wel handig als er een aparte HBAC-regel komt voor de vm-www-inwerking, zodat er makkelijk tijdelijk nieuwe potentieële webcie-leden aan toegevoegd kunnen worden.<br /> <br /> De website maakt nog gebruik van twee dingen die met accounts te maken hebben. Een daarvan is het automatisch laten inloggen op de de A-Eskwadraatwebsite op het interne netwerk en de andere regel is de mogelijkheid om met je systeemaccount in te kunnen loggen op de website.<br /> <br /> Voor het automatisch inloggen (zie ook bij [[Automatisch inloggen]]) is er in IPA de HBAC-regel 'allow_www-auth'. Die zegt dat mensjes via de services www-login en www-auth op de vm-www.a-eskwadraat.nl en www-auth.a-eskwadraat.nl.<br /> <br /> De regel voor het laten inloggen met je systeemaccount op de website is de regel 'allow_systeemLogin' en die zegt dat mensjes op alle webcie-vms met de service httpd_systeemlogin kunnen.<br /> <br /> Omdat de website ook commando's met IPA mogelijk maakt is er een speciale user website-ipa die de rechten heeft om de juiste commando's uit te voeren op de vm-www<br /> <br /> == Mounts ==<br /> <br /> == Automatisch inloggen ==<br /> <br /> CERTS!<br /> <br /> == Instellingen ==<br /> <br /> == Installatie ==</div>

Pepijno https://mediawiki.a-eskwadraat.nl/wiki/index.php/QueryBuilder 2017-02-28T22:41:02Z

<p>Pepijno: </p> <hr /> <div>Om SQL-queries makkelijker te maken heeft de WebCie haar eigen sql-library geschreven, de QueryBuilder. De QueryBuilder maakt queries op dmv van een QueryBuilder-object waaraan properties veranderd worden. Op die manier wordt de query pas gebouwd als de query uitgevoerd moet worden. Hierdoor is er meer mogelijkheid voor controle en sanity checks.<br /> <br /> De QueryBuilder bestaat uit de Query-klasse, de QueryBuilder-klasse en alle uitbreidingen. De Query-klasse is een extensie van de QueryBuilder-klasse. Het verschil tussen de twee klasses is dat de QueryBuilder-klasse wordt gebruikt om de query op te bouwen en de Query-klasse wordt gebruikt om van het geheel een werkende query te maken, alsmede verschillende functies zoals het verzamelen van objecten te implementeren.<br /> <br /> == QueryBuilder starten ==<br /> Omdat je een query altijd wilt gebruiken voor WhosWho4-objecten heeft elk WhosWho4-object zijn eigen query-classe die een uitbreiding is van de Query-klasse. Zo heb je bv de PersoonQuery-klasse en de LidQuery-klasse. Deze extensies hebben niet hun eigen speciale constructor. in plaats daarvan heeft elk van deze klassen de methode table waarmee een Query-klasse wordt aangemaakt, het object als table bij de query wordt gezet en het ObjectQuery-object wordt gereturnd zodat er meteen methoden op kunnen worden toegepast. Voor uitgebreide klasse zoals Persoon en Lid worden automatisch de onderliggende klassen gejoind zodat je dit niet zelf hoeft te doen en bij deze data kan.<br /> Een voorbeeld:<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = PersoonQuery::table();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> == Query uitvoeren ==<br /> Een query kan je uitvoeren met de methode &lt;code&gt;get&lt;/code&gt;. &lt;code&gt;get&lt;/code&gt; heeft geen argumenten nodig. Als je verder niets aan je Query-object hebt toegevoegd selecteert de query automatisch alle objecten in de table. Met het volgende voorbeeld worden alle entries uit de Persoon-table opgevraagd:<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $personen = PersoonQuery::table()-&gt;get();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;first&lt;/code&gt; ===<br /> De methode &lt;code&gt;first&lt;/code&gt; voert de query uit zoals &lt;code&gt;get&lt;/code&gt; dat doet en geeft vervolgens alleen het eerste resultaat terug. Met het volgende voorbeeld wordt de eerste entry uit de Persoon-table opgehaald:<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $personen = PersoonQuery::table()-&gt;first();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;aggregate&lt;/code&gt; (TODO: in de php-code moet deze functie nog worden aangepast) ===<br /> De methode &lt;code&gt;aggregate&lt;/code&gt; voert een aggregator uit op de query. De toegestane aggregators zijn: &lt;code&gt;COUNT&lt;/code&gt;, &lt;code&gt;SUM&lt;/code&gt;, &lt;code&gt;MAX&lt;/code&gt;, &lt;code&gt;MIN&lt;/code&gt; en &lt;code&gt;YEAR&lt;/code&gt;. De aggregator pakt op dit moment nog alles ipv een specifieke kolom. &lt;code&gt;aggregate&lt;/code&gt; haalt ook de huidige selectie weg. Een voorbeeld om alle entries in de Persoon-table te tellen:<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $aantal_personen = PersoonQuery::table()-&gt;aggregate('COUNT');<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;count&lt;/code&gt; ===<br /> Om makkelijker entries te tellen is de speciale methode &lt;code&gt;count&lt;/code&gt;. Deze methode telt het aantal entries en haalt ook de orderBys, limits en offset van de query weg.<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $aantal_personen = PersoonQuery::table()-&gt;count();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;verzamel&lt;/code&gt; ===<br /> De methode die het vaakst gebruikt wordt is &lt;code&gt;verzamel&lt;/code&gt;. Net zoals &lt;code&gt;verzamel&lt;/code&gt; van elke Verzameling van een WhosWho4-object verzamelt deze query-methode alle WhosWho4-objecten die met de query opgehaald worden. Hierbij verdwijnen alle huidige selects van de query. De methode kan twee argumenten krijgen: de naam van de klasse om de objecten van te verzamelen as string en of de objecten distinct moeten zijn als bool. Zonder argumenten is distinct true en worden de objecten opgehaald van de klasse waarvan je het query-object gemaakt hebt. Als voorbeeld, haal alle Persoon-objecten op:<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $persoon_objecten = PersoonQuery::table()-&gt;verzamel();<br /> &lt;/syntaxhighlight&gt;<br /> Haal alle distinct bugmelders op (dit voorbeeld gebruikt ook &lt;code&gt;join&lt;/code&gt;):<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $persoon_objecten = BugQuery::table()<br /> -&gt;join('Persoon')<br /> -&gt;verzamel('Persoon', true);<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;geef&lt;/code&gt; ===<br /> Net zoals de methode &lt;code&gt;geef&lt;/code&gt; voor objecten heeft de QueryBuilder een soortgelijke methode. De methode geeft een object terug die wordt opgevraagd dmv de query. Net als bij &lt;code&gt;verzamel&lt;/code&gt; heeft de methode een argument voor het soort object wat je op wilt halen.<br /> Geef het lid-object met ID 5794<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $persoon = PersoonQuery::table()<br /> -&gt;whereInt('contactID', 5794)<br /> -&gt;geef();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> == Joins ==<br /> De QueryBuilder heeft uiteraard ook de mogelijkheid om joins uit te voeren op tables. Nieuwe tabellen worden automatisch op de juiste velden gejoind, dus dit hoef je niet meer zelf te doen. Mocht de QueryBuilder het toch niet zelf kunnen, dan hebben de join-methoden extra argumenten nodig voor het joinen.<br /> <br /> === (left) &lt;code&gt;join&lt;/code&gt; ===<br /> De standaard &lt;code&gt;join&lt;/code&gt; is een left join. Je hoeft als enige argument de table mee te geven om op te joinen. Zo kan je bv de table Persoon joinen met Bug<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = BugQuery::table()-&gt;join('Persoon');<br /> &lt;/syntaxhighlight&gt;<br /> Als het echt nodig is kan je zelf de twee namen van de kolommen meegeven waarop gejoined moet worden<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = BugQuery::table()-&gt;join('Persoon', 'Bug.melder_contactID', 'Persoon.contactID');<br /> &lt;/syntaxhighlight&gt;<br /> <br /> Je kan ook ipv een string als naam voor de table bij je join een array plaatsen met als key een string en als value je tablename. De key wordt dan de AS in de query. Dus om in bovenstaand voorbeelde de table Persoon AS p te joinen<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = BugQuery::table()-&gt;join(array('p' =&gt; 'Persoon'));<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;rightJoin&lt;/code&gt; ===<br /> De &lt;code&gt;rightJoin&lt;/code&gt; werkt hetzelfde als &lt;code&gt;join&lt;/code&gt; alleen voert het een right join uit ipv een left join.<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = BugQuery::table()-&gt;rightJoin('Persoon');<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;innerJoin&lt;/code&gt; ===<br /> De &lt;code&gt;innerJoin&lt;/code&gt; werkt ook hetzelfde als &lt;code&gt;join&lt;/code&gt; alleen voert het een inner join uit ipv een left join.<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = BugQuery::table()-&gt;innerJoin('Persoon');<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;fullJoin&lt;/code&gt; ===<br /> De &lt;code&gt;fullJoin&lt;/code&gt; werkt ook hetzelfde als &lt;code&gt;join&lt;/code&gt; alleen voert het een full join uit ipv een left join.<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = BugQuery::table()-&gt;fullJoin('Persoon');<br /> &lt;/syntaxhighlight&gt;<br /> <br /> == Where ==<br /> Uiteraard heeft een query ook where's nodig. Daarom heeft de QueryBuilder verschillende methoden om where toe te voegen.<br /> <br /> === &lt;code&gt;whereProp&lt;/code&gt; ===<br /> De belangrijkste where-methode is &lt;code&gt;whereProp&lt;/code&gt;. Met deze methode wordt de where automatisch uitgevoerd op een eigenschap van de objecten waarvan de tables in de query zitten (met from of dmv een join). Hiervoor is het ook nodig dat waarmee je wilt matchen in je where van het juiste type is. Zo is een ID een int en wil je daar dus geen string voor meegeven. De whereProp zoekt ook automatisch de table waarbij de property hoort. Als er meerdere mogelijkheden zijn kan je er altijd 'tablename.' voor zetten, net zoals met normale sql.<br /> <br /> Je kan &lt;code&gt;whereProp&lt;/code&gt; twee of drie argumenten meegeven. Als je twee argumenten meegeeft wordt er een match op gelijkheid aan je query toegevoegd. Hierbij is het eerste argument welke property je wilt matchen en je tweede argument waarmee gematcht wordt.<br /> Selecteer alle Bugs met melder $melder ($melder moet een Persoonobject zijn)<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $bugs = BugQuery::table()-&gt;whereProp('melder', $melder)-&gt;verzamel();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> Als je drie argumenten meegeeft is het eerste argument nog steeds welke property je wilt matchen, je tweede argument is je operator en je derde argument is waarmee gematcht wordt. De mogelijkheden voor de operatoren zijn <br /> Selecteer alle Bugs waarvan melder niet $melder is ($melder moet een Persoonobject zijn)<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $bugs = BugQuery::table()-&gt;whereProp('melder', '!=', $melder)-&gt;verzamel();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;whereProp&lt;/code&gt; varianten ===<br /> <br /> Met de standaard &lt;code&gt;whereProp&lt;/code&gt; kan je alleen een paar operatoren toevoegen aan je where. Daarom zijn er de methoden &lt;code&gt;whereNotProp&lt;/code&gt;, &lt;code&gt;whereLikeProp&lt;/code&gt;, &lt;code&gt;whereNotLikeProp&lt;/code&gt;, &lt;code&gt;whereInProp&lt;/code&gt; en &lt;code&gt;whereNotInProp&lt;/code&gt;. Wat deze methoden doen zit in de naam van de methoden. Voor de &lt;code&gt;whereLikeProp&lt;/code&gt; en &lt;code&gt;whereNotLikeProp&lt;/code&gt; heb je twee argumenten nodig, als eerste de property en als tweede de string. Voor de methoden &lt;code&gt;whereInProp&lt;/code&gt; en &lt;code&gt;whereNotInProp&lt;/code&gt; heb je ook twee argumenten nodig, de property en als tweede de array waar de property in moet zitten.<br /> Haal alle bugs op waarbij het email de string 'pepijno' bevat<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $bugs = BugQuery::table()-&gt;wherePropLike('melderEmail', '%pepijno%')-&gt;verzamel();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === OR ipv AND ===<br /> <br /> Als je meerdere &lt;code&gt;whereProp&lt;/code&gt;-methoden hebt worden ze in de WHERE automatisch aan elkaar geplakt met het AND keyword. Om ze met OR aan elkaar te plakken gebruik je de methode &lt;code&gt;orWhereProp&lt;/code&gt;. Voor alle andere soorten &lt;code&gt;whereProp&lt;/code&gt;-methode kan je op dezelfde manier de or voor de methodenaam plakken en dan worden de where-clausules met OR aan elkaar geplakt.<br /> <br /> === Overige &lt;code&gt;where&lt;/code&gt;-methoden ===<br /> <br /> Als je een WHERE-clausule wilt gebruiken kan je ipv &lt;code&gt;whereProp&lt;/code&gt; ook standaard &lt;code&gt;where&lt;/code&gt;-methoden gebruiken. Deze gebruik je op dezelfde manier als &lt;code&gt;whereProp&lt;/code&gt;-methoden, behalve dat je de Prop moet vervangen door het type van de value die je in je WHERE wilt gebruiken. Als je bv wilt kijken of een ID gelijk is aan een int, moet je &lt;code&gt;whereInt&lt;/code&gt; gebruiken.<br /> Haal alle Bugs op met melder_contactID gelijk aan 5794 (hier kan je als het lid-object van lidnr 5794 hebt ook whereProp gebruiken)<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $bugs = BugQuery::table()-&gt;whereInt('melder_contactID', 5794)-&gt;verzamel();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> Naast deze standaard &lt;code&gt;where&lt;/code&gt;-methode heb je ook de self explainatory methoden &lt;code&gt;whereNot&lt;/code&gt;, &lt;code&gt;whereIn&lt;/code&gt;, &lt;code&gt;whereNotIn&lt;/code&gt;, &lt;code&gt;whereLike&lt;/code&gt;, &lt;code&gt;whereNotLike&lt;/code&gt;, &lt;code&gt;whereNull&lt;/code&gt; en &lt;code&gt;whereNotNull&lt;/code&gt;. Let op dat je dus ook bij deze methoden het type van de value bij de methode naam moet zetten! Ook al deze methode kan je met een OR lijmen door or voor de methodenaam te zetten zoals bv bij &lt;code&gt;orWhereProp&lt;/code&gt;.<br /> <br /> === Nested where's &amp; Closures ===<br /> <br /> Stel, je wilt de volgende WHERE-clausule:<br /> WHERE (a = 0 OR a = 1) AND (a = 2 OR a = 3)<br /> Dit krijg je in de QueryBuilder dmv Closures in php. De bovenstaande where-prop krijg je als volgt<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> ...-&gt;where(function($q) use ($var1, $var2) {<br /> $q-&gt;whereInt('a', 0)<br /> -&gt;orWhereInt('a', 1);<br /> })-&gt;where(function($q) {<br /> $q-&gt;whereInt('a', 2)<br /> -&gt;orWhereInt('a', 3);<br /> })<br /> &lt;/syntaxhighlight&gt;<br /> <br /> In een where kan je dus een closure gebruiken om nested where's te krijgen.<br /> <br /> == Selects ==<br /> <br /> Om selects toe te voegen aan je query gebruik je de methode &lt;code&gt;select&lt;/code&gt;. Elk argument wat je aan de methode meegeeft wordt als select toegevoegd. Ipv de argumenten als strings mee te geven kan je ook een array toevoegen met een string als key en de select als value. Dan wordt de key de AS van de select.<br /> Om alle contactID's te selecteren van de Persoontable<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $ids = PersoonQuery::table()-&gt;select('contactID')-&gt;get();<br /> &lt;/syntaxhighlight&gt;<br /> Om alle contactID's als 'ID' en alle voornamen te selecteren van de Persoontable<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $ids = PersoonQuery::table()-&gt;select(array('ID' =&gt; 'contactID'), 'voornaam')-&gt;get();<br /> &lt;/syntaxhighlight&gt;<br /> Om selects distinct te maken kan je de methode &lt;code&gt;selectDistinct&lt;/code&gt; gebruiken.<br /> <br /> == Order by ==<br /> <br /> Order by's can de QueryBuilder ook aan. Er zijn twee methoden &lt;code&gt;orderByAsc&lt;/code&gt; en &lt;code&gt;orderByDesc&lt;/code&gt;. Allebei de methoden hebben slechts 1 argument nodig, de kolom om de order op uit te voeren.<br /> Selecteer alle Personen geordered op contactID<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $personen = PersoonQuery::table()-&gt;orderByAsc('contactID')-&gt;verzamel();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> == Limit &amp; offset ==<br /> <br /> Om de limit en offset van een query te bepalen zijn er de twee methoden &lt;code&gt;offset&lt;/code&gt; en &lt;code&gt;limit&lt;/code&gt;. Beide methoden hebben 1 argument nodig, de offset of limit respectivelijk.<br /> Selecteer de personen 200 t/m 300<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $personen = PersoonQuery::table()-&gt;limit(100)-&gt;offset(200)-&gt;verzamel();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> == Havings ==<br /> <br /> Havings werken op dezelfde manier als alle where-methoden, zowel de standaard &lt;code&gt;having&lt;/code&gt; als de standaard &lt;code&gt;havingProp&lt;/code&gt;. De namen van de methoden zijn precies hetzelfde als de where-methoden, alleen is elke where vervangen door having.<br /> <br /> [[Category:WebCie]]</div>

Pepijno https://mediawiki.a-eskwadraat.nl/wiki/index.php/QueryBuilder 2017-02-28T22:37:31Z

<p>Pepijno: </p> <hr /> <div>Om SQL-queries makkelijker te maken heeft de WebCie haar eigen sql-library geschreven, de QueryBuilder. De QueryBuilder maakt queries op dmv van een QueryBuilder-object waaraan properties veranderd worden. Op die manier wordt de query pas gebouwd als de query uitgevoerd moet worden. Hierdoor is er meer mogelijkheid voor controle en sanity checks.<br /> <br /> De QueryBuilder bestaat uit de Query-klasse, de QueryBuilder-klasse en alle uitbreidingen. De Query-klasse is een extensie van de QueryBuilder-klasse. Het verschil tussen de twee klasses is dat de QueryBuilder-klasse wordt gebruikt om de query op te bouwen en de Query-klasse wordt gebruikt om van het geheel een werkende query te maken, alsmede verschillende functies zoals het verzamelen van objecten te implementeren.<br /> <br /> == QueryBuilder starten ==<br /> Omdat je een query altijd wilt gebruiken voor WhosWho4-objecten heeft elk WhosWho4-object zijn eigen query-classe die een uitbreiding is van de Query-klasse. Zo heb je bv de PersoonQuery-klasse en de LidQuery-klasse. Deze extensies hebben niet hun eigen speciale constructor. in plaats daarvan heeft elk van deze klassen de methode table waarmee een Query-klasse wordt aangemaakt, het object als table bij de query wordt gezet en het ObjectQuery-object wordt gereturnd zodat er meteen methoden op kunnen worden toegepast. Voor uitgebreide klasse zoals Persoon en Lid worden automatisch de onderliggende klassen gejoind zodat je dit niet zelf hoeft te doen en bij deze data kan.<br /> Een voorbeeld:<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = PersoonQuery::table();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> == Query uitvoeren ==<br /> Een query kan je uitvoeren met de methode &lt;code&gt;get&lt;/code&gt;. &lt;code&gt;get&lt;/code&gt; heeft geen argumenten nodig. Als je verder niets aan je Query-object hebt toegevoegd selecteert de query automatisch alle objecten in de table. Met het volgende voorbeeld worden alle entries uit de Persoon-table opgevraagd:<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $personen = PersoonQuery::table()-&gt;get();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;first&lt;/code&gt; ===<br /> De methode &lt;code&gt;first&lt;/code&gt; voert de query uit zoals &lt;code&gt;get&lt;/code&gt; dat doet en geeft vervolgens alleen het eerste resultaat terug. Met het volgende voorbeeld wordt de eerste entry uit de Persoon-table opgehaald:<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $personen = PersoonQuery::table()-&gt;first();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;aggregate&lt;/code&gt; (TODO: in de php-code moet deze functie nog worden aangepast) ===<br /> De methode &lt;code&gt;aggregate&lt;/code&gt; voert een aggregator uit op de query. De toegestane aggregators zijn: &lt;code&gt;COUNT&lt;/code&gt;, &lt;code&gt;SUM&lt;/code&gt;, &lt;code&gt;MAX&lt;/code&gt;, &lt;code&gt;MIN&lt;/code&gt; en &lt;code&gt;YEAR&lt;/code&gt;. De aggregator pakt op dit moment nog alles ipv een specifieke kolom. &lt;code&gt;aggregate&lt;/code&gt; haalt ook de huidige selectie weg. Een voorbeeld om alle entries in de Persoon-table te tellen:<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $aantal_personen = PersoonQuery::table()-&gt;aggregate('COUNT');<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;count&lt;/code&gt; ===<br /> Om makkelijker entries te tellen is de speciale methode &lt;code&gt;count&lt;/code&gt;. Deze methode telt het aantal entries en haalt ook de orderBys, limits en offset van de query weg.<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $aantal_personen = PersoonQuery::table()-&gt;count();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;verzamel&lt;/code&gt; ===<br /> De methode die het vaakst gebruikt wordt is &lt;code&gt;verzamel&lt;/code&gt;. Net zoals &lt;code&gt;verzamel&lt;/code&gt; van elke Verzameling van een WhosWho4-object verzamelt deze query-methode alle WhosWho4-objecten die met de query opgehaald worden. Hierbij verdwijnen alle huidige selects van de query. De methode kan twee argumenten krijgen: de naam van de klasse om de objecten van te verzamelen as string en of de objecten distinct moeten zijn als bool. Zonder argumenten is distinct true en worden de objecten opgehaald van de klasse waarvan je het query-object gemaakt hebt. Als voorbeeld, haal alle Persoon-objecten op:<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $persoon_objecten = PersoonQuery::table()-&gt;verzamel();<br /> &lt;/syntaxhighlight&gt;<br /> Haal alle distinct bugmelders op (dit voorbeeld gebruikt ook &lt;code&gt;join&lt;/code&gt;):<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $persoon_objecten = BugQuery::table()<br /> -&gt;join('Persoon')<br /> -&gt;verzamel('Persoon', true);<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;geef&lt;/code&gt; ===<br /> Net zoals de methode &lt;code&gt;geef&lt;/code&gt; voor objecten heeft de QueryBuilder een soortgelijke methode. De methode geeft een object terug die wordt opgevraagd dmv de query. Net als bij &lt;code&gt;verzamel&lt;/code&gt; heeft de methode een argument voor het soort object wat je op wilt halen.<br /> Geef het lid-object met ID 5794<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $persoon = PersoonQuery::table()<br /> -&gt;whereInt('contactID', 5794)<br /> -&gt;geef();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> == Joins ==<br /> De QueryBuilder heeft uiteraard ook de mogelijkheid om joins uit te voeren op tables. Nieuwe tabellen worden automatisch op de juiste velden gejoind, dus dit hoef je niet meer zelf te doen. Mocht de QueryBuilder het toch niet zelf kunnen, dan hebben de join-methoden extra argumenten nodig voor het joinen.<br /> <br /> === (left) &lt;code&gt;join&lt;/code&gt; ===<br /> De standaard &lt;code&gt;join&lt;/code&gt; is een left join. Je hoeft als enige argument de table mee te geven om op te joinen. Zo kan je bv de table Persoon joinen met Bug<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = BugQuery::table()-&gt;join('Persoon');<br /> &lt;/syntaxhighlight&gt;<br /> Als het echt nodig is kan je zelf de twee namen van de kolommen meegeven waarop gejoined moet worden<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = BugQuery::table()-&gt;join('Persoon', 'Bug.melder_contactID', 'Persoon.contactID');<br /> &lt;/syntaxhighlight&gt;<br /> <br /> Je kan ook ipv een string als naam voor de table bij je join een array plaatsen met als key een string en als value je tablename. De key wordt dan de AS in de query. Dus om in bovenstaand voorbeelde de table Persoon AS p te joinen<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = BugQuery::table()-&gt;join(array('p' =&gt; 'Persoon'));<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;rightJoin&lt;/code&gt; ===<br /> De &lt;code&gt;rightJoin&lt;/code&gt; werkt hetzelfde als &lt;code&gt;join&lt;/code&gt; alleen voert het een right join uit ipv een left join.<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = BugQuery::table()-&gt;rightJoin('Persoon');<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;innerJoin&lt;/code&gt; ===<br /> De &lt;code&gt;innerJoin&lt;/code&gt; werkt ook hetzelfde als &lt;code&gt;join&lt;/code&gt; alleen voert het een inner join uit ipv een left join.<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = BugQuery::table()-&gt;innerJoin('Persoon');<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;fullJoin&lt;/code&gt; ===<br /> De &lt;code&gt;fullJoin&lt;/code&gt; werkt ook hetzelfde als &lt;code&gt;join&lt;/code&gt; alleen voert het een full join uit ipv een left join.<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = BugQuery::table()-&gt;fullJoin('Persoon');<br /> &lt;/syntaxhighlight&gt;<br /> <br /> == Where ==<br /> Uiteraard heeft een query ook where's nodig. Daarom heeft de QueryBuilder verschillende methoden om where toe te voegen.<br /> <br /> === &lt;code&gt;whereProp&lt;/code&gt; ===<br /> De belangrijkste where-methode is &lt;code&gt;whereProp&lt;/code&gt;. Met deze methode wordt de where automatisch uitgevoerd op een eigenschap van de objecten waarvan de tables in de query zitten (met from of dmv een join). Hiervoor is het ook nodig dat waarmee je wilt matchen in je where van het juiste type is. Zo is een ID een int en wil je daar dus geen string voor meegeven. De whereProp zoekt ook automatisch de table waarbij de property hoort. Als er meerdere mogelijkheden zijn kan je er altijd 'tablename.' voor zetten, net zoals met normale sql.<br /> <br /> Je kan &lt;code&gt;whereProp&lt;/code&gt; twee of drie argumenten meegeven. Als je twee argumenten meegeeft wordt er een match op gelijkheid aan je query toegevoegd. Hierbij is het eerste argument welke property je wilt matchen en je tweede argument waarmee gematcht wordt.<br /> Selecteer alle Bugs met melder $melder ($melder moet een Persoonobject zijn)<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $bugs = BugQuery::table()-&gt;whereProp('melder', $melder)-&gt;verzamel();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> Als je drie argumenten meegeeft is het eerste argument nog steeds welke property je wilt matchen, je tweede argument is je operator en je derde argument is waarmee gematcht wordt. De mogelijkheden voor de operatoren zijn <br /> Selecteer alle Bugs waarvan melder niet $melder is ($melder moet een Persoonobject zijn)<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $bugs = BugQuery::table()-&gt;whereProp('melder', '!=', $melder)-&gt;verzamel();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;whereProp&lt;/code&gt; varianten ===<br /> <br /> Met de standaard &lt;code&gt;whereProp&lt;/code&gt; kan je alleen een paar operatoren toevoegen aan je where. Daarom zijn er de methoden &lt;code&gt;whereNotProp&lt;/code&gt;, &lt;code&gt;whereLikeProp&lt;/code&gt;, &lt;code&gt;whereNotLikeProp&lt;/code&gt;, &lt;code&gt;whereInProp&lt;/code&gt; en &lt;code&gt;whereNotInProp&lt;/code&gt;. Wat deze methoden doen zit in de naam van de methoden. Voor de &lt;code&gt;whereLikeProp&lt;/code&gt; en &lt;code&gt;whereNotLikeProp&lt;/code&gt; heb je twee argumenten nodig, als eerste de property en als tweede de string. Voor de methoden &lt;code&gt;whereInProp&lt;/code&gt; en &lt;code&gt;whereNotInProp&lt;/code&gt; heb je ook twee argumenten nodig, de property en als tweede de array waar de property in moet zitten.<br /> Haal alle bugs op waarbij het email de string 'pepijno' bevat<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $bugs = BugQuery::table()-&gt;wherePropLike('melderEmail', '%pepijno%')-&gt;verzamel();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === OR ipv AND ===<br /> <br /> Als je meerdere &lt;code&gt;whereProp&lt;/code&gt;-methoden hebt worden ze in de WHERE automatisch aan elkaar geplakt met het AND keyword. Om ze met OR aan elkaar te plakken gebruik je de methode &lt;code&gt;orWhereProp&lt;/code&gt;. Voor alle andere soorten &lt;code&gt;whereProp&lt;/code&gt;-methode kan je op dezelfde manier de or voor de methodenaam plakken en dan worden de where-clausules met OR aan elkaar geplakt.<br /> <br /> === Overige &lt;code&gt;where&lt;/code&gt;-methoden ===<br /> <br /> Als je een WHERE-clausule wilt gebruiken kan je ipv &lt;code&gt;whereProp&lt;/code&gt; ook standaard &lt;code&gt;where&lt;/code&gt;-methoden gebruiken. Deze gebruik je op dezelfde manier als &lt;code&gt;whereProp&lt;/code&gt;-methoden, behalve dat je de Prop moet vervangen door het type van de value die je in je WHERE wilt gebruiken. Als je bv wilt kijken of een ID gelijk is aan een int, moet je &lt;code&gt;whereInt&lt;/code&gt; gebruiken.<br /> Haal alle Bugs op met melder_contactID gelijk aan 5794 (hier kan je als het lid-object van lidnr 5794 hebt ook whereProp gebruiken)<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $bugs = BugQuery::table()-&gt;whereInt('melder_contactID', 5794)-&gt;verzamel();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> Naast deze standaard &lt;code&gt;where&lt;/code&gt;-methode heb je ook de self explainatory methoden &lt;code&gt;whereNot&lt;/code&gt;, &lt;code&gt;whereIn&lt;/code&gt;, &lt;code&gt;whereNotIn&lt;/code&gt;, &lt;code&gt;whereLike&lt;/code&gt;, &lt;code&gt;whereNotLike&lt;/code&gt;, &lt;code&gt;whereNull&lt;/code&gt; en &lt;code&gt;whereNotNull&lt;/code&gt;. Let op dat je dus ook bij deze methoden het type van de value bij de methode naam moet zetten! Ook al deze methode kan je met een OR lijmen door or voor de methodenaam te zetten zoals bv bij &lt;code&gt;orWhereProp&lt;/code&gt;.<br /> <br /> === Nested where's &amp; Closures ===<br /> <br /> Stel, je wilt de volgende WHERE-clausule:<br /> WHERE (a = 0 OR a = 1) AND (a = 2 OR a = 3)<br /> Dit krijg je in de QueryBuilder dmv Closures in php. De bovenstaande where-prop krijg je als volgt<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> ...-&gt;where(function($q) use ($var1, $var2) {<br /> $q-&gt;whereInt('a', 0)<br /> -&gt;orWhereInt('a', 1);<br /> })-&gt;where(function($q) {<br /> $q-&gt;whereInt('a', 2)<br /> -&gt;orWhereInt('a', 3);<br /> })<br /> &lt;/syntaxhighlight&gt;<br /> <br /> In een where kan je dus een closure gebruiken om nested where's te krijgen.<br /> <br /> == Selects ==<br /> <br /> Om selects toe te voegen aan je query gebruik je de methode &lt;code&gt;select&lt;/code&gt;. Elk argument wat je aan de methode meegeeft wordt als select toegevoegd. Ipv de argumenten als strings mee te geven kan je ook een array toevoegen met een string als key en de select als value. Dan wordt de key de AS van de select.<br /> Om alle contactID's te selecteren van de Persoontable<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $ids = PersoonQuery::table()-&gt;select('contactID')-&gt;get();<br /> &lt;/syntaxhighlight&gt;<br /> Om alle contactID's als 'ID' en alle voornamen te selecteren van de Persoontable<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $ids = PersoonQuery::table()-&gt;select(array('ID' =&gt; 'contactID'), 'voornaam')-&gt;get();<br /> &lt;/syntaxhighlight&gt;<br /> Om selects distinct te maken kan je de methode &lt;code&gt;selectDistinct&lt;/code&gt; gebruiken.<br /> <br /> == Order by ==<br /> <br /> Order by's can de QueryBuilder ook aan. Er zijn twee methoden &lt;code&gt;orderByAsc&lt;/code&gt; en &lt;code&gt;orderByDesc&lt;/code&gt;. Allebei de methoden hebben slechts 1 argument nodig, de kolom om de order op uit te voeren.<br /> Selecteer alle Personen geordered op contactID<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $personen = PersoonQuery::table()-&gt;orderByAsc('contactID')-&gt;verzamel();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> == Limit &amp; offset ==<br /> <br /> Om de limit en offset van een query te bepalen zijn er de twee methoden &lt;code&gt;offset&lt;/code&gt; en &lt;code&gt;limit&lt;/code&gt;. Beide methoden hebben 1 argument nodig, de offset of limit respectivelijk.<br /> Selecteer de personen 200 t/m 300<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $personen = PersoonQuery::table()-&gt;limit(100)-&gt;offset(200)-&gt;verzamel();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> [[Category:WebCie]]</div>

Pepijno https://mediawiki.a-eskwadraat.nl/wiki/index.php/QueryBuilder 2017-02-28T22:35:03Z

<p>Pepijno: </p> <hr /> <div>Om SQL-queries makkelijker te maken heeft de WebCie haar eigen sql-library geschreven, de QueryBuilder. De QueryBuilder maakt queries op dmv van een QueryBuilder-object waaraan properties veranderd worden. Op die manier wordt de query pas gebouwd als de query uitgevoerd moet worden. Hierdoor is er meer mogelijkheid voor controle en sanity checks.<br /> <br /> De QueryBuilder bestaat uit de Query-klasse, de QueryBuilder-klasse en alle uitbreidingen. De Query-klasse is een extensie van de QueryBuilder-klasse. Het verschil tussen de twee klasses is dat de QueryBuilder-klasse wordt gebruikt om de query op te bouwen en de Query-klasse wordt gebruikt om van het geheel een werkende query te maken, alsmede verschillende functies zoals het verzamelen van objecten te implementeren.<br /> <br /> == QueryBuilder starten ==<br /> Omdat je een query altijd wilt gebruiken voor WhosWho4-objecten heeft elk WhosWho4-object zijn eigen query-classe die een uitbreiding is van de Query-klasse. Zo heb je bv de PersoonQuery-klasse en de LidQuery-klasse. Deze extensies hebben niet hun eigen speciale constructor. in plaats daarvan heeft elk van deze klassen de methode table waarmee een Query-klasse wordt aangemaakt, het object als table bij de query wordt gezet en het ObjectQuery-object wordt gereturnd zodat er meteen methoden op kunnen worden toegepast. Voor uitgebreide klasse zoals Persoon en Lid worden automatisch de onderliggende klassen gejoind zodat je dit niet zelf hoeft te doen en bij deze data kan.<br /> Een voorbeeld:<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = PersoonQuery::table();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> == Query uitvoeren ==<br /> Een query kan je uitvoeren met de methode &lt;code&gt;get&lt;/code&gt;. &lt;code&gt;get&lt;/code&gt; heeft geen argumenten nodig. Als je verder niets aan je Query-object hebt toegevoegd selecteert de query automatisch alle objecten in de table. Met het volgende voorbeeld worden alle entries uit de Persoon-table opgevraagd:<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $personen = PersoonQuery::table()-&gt;get();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;first&lt;/code&gt; ===<br /> De methode &lt;code&gt;first&lt;/code&gt; voert de query uit zoals &lt;code&gt;get&lt;/code&gt; dat doet en geeft vervolgens alleen het eerste resultaat terug. Met het volgende voorbeeld wordt de eerste entry uit de Persoon-table opgehaald:<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $personen = PersoonQuery::table()-&gt;first();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;aggregate&lt;/code&gt; (TODO: in de php-code moet deze functie nog worden aangepast) ===<br /> De methode &lt;code&gt;aggregate&lt;/code&gt; voert een aggregator uit op de query. De toegestane aggregators zijn: &lt;code&gt;COUNT&lt;/code&gt;, &lt;code&gt;SUM&lt;/code&gt;, &lt;code&gt;MAX&lt;/code&gt;, &lt;code&gt;MIN&lt;/code&gt; en &lt;code&gt;YEAR&lt;/code&gt;. De aggregator pakt op dit moment nog alles ipv een specifieke kolom. &lt;code&gt;aggregate&lt;/code&gt; haalt ook de huidige selectie weg. Een voorbeeld om alle entries in de Persoon-table te tellen:<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $aantal_personen = PersoonQuery::table()-&gt;aggregate('COUNT');<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;count&lt;/code&gt; ===<br /> Om makkelijker entries te tellen is de speciale methode &lt;code&gt;count&lt;/code&gt;. Deze methode telt het aantal entries en haalt ook de orderBys, limits en offset van de query weg.<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $aantal_personen = PersoonQuery::table()-&gt;count();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;verzamel&lt;/code&gt; ===<br /> De methode die het vaakst gebruikt wordt is &lt;code&gt;verzamel&lt;/code&gt;. Net zoals &lt;code&gt;verzamel&lt;/code&gt; van elke Verzameling van een WhosWho4-object verzamelt deze query-methode alle WhosWho4-objecten die met de query opgehaald worden. Hierbij verdwijnen alle huidige selects van de query. De methode kan twee argumenten krijgen: de naam van de klasse om de objecten van te verzamelen as string en of de objecten distinct moeten zijn als bool. Zonder argumenten is distinct true en worden de objecten opgehaald van de klasse waarvan je het query-object gemaakt hebt. Als voorbeeld, haal alle Persoon-objecten op:<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $persoon_objecten = PersoonQuery::table()-&gt;verzamel();<br /> &lt;/syntaxhighlight&gt;<br /> Haal alle distinct bugmelders op (dit voorbeeld gebruikt ook &lt;code&gt;join&lt;/code&gt;):<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $persoon_objecten = BugQuery::table()<br /> -&gt;join('Persoon')<br /> -&gt;verzamel('Persoon', true);<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;geef&lt;/code&gt; ===<br /> Net zoals de methode &lt;code&gt;geef&lt;/code&gt; voor objecten heeft de QueryBuilder een soortgelijke methode. De methode geeft een object terug die wordt opgevraagd dmv de query. Net als bij &lt;code&gt;verzamel&lt;/code&gt; heeft de methode een argument voor het soort object wat je op wilt halen.<br /> Geef het lid-object met ID 5794<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $persoon = PersoonQuery::table()<br /> -&gt;whereInt('contactID', 5794)<br /> -&gt;geef();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> == Joins ==<br /> De QueryBuilder heeft uiteraard ook de mogelijkheid om joins uit te voeren op tables. Nieuwe tabellen worden automatisch op de juiste velden gejoind, dus dit hoef je niet meer zelf te doen. Mocht de QueryBuilder het toch niet zelf kunnen, dan hebben de join-methoden extra argumenten nodig voor het joinen.<br /> <br /> === (left) &lt;code&gt;join&lt;/code&gt; ===<br /> De standaard &lt;code&gt;join&lt;/code&gt; is een left join. Je hoeft als enige argument de table mee te geven om op te joinen. Zo kan je bv de table Persoon joinen met Bug<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = BugQuery::table()-&gt;join('Persoon');<br /> &lt;/syntaxhighlight&gt;<br /> Als het echt nodig is kan je zelf de twee namen van de kolommen meegeven waarop gejoined moet worden<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = BugQuery::table()-&gt;join('Persoon', 'Bug.melder_contactID', 'Persoon.contactID');<br /> &lt;/syntaxhighlight&gt;<br /> <br /> Je kan ook ipv een string als naam voor de table bij je join een array plaatsen met als key een string en als value je tablename. De key wordt dan de AS in de query. Dus om in bovenstaand voorbeelde de table Persoon AS p te joinen<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = BugQuery::table()-&gt;join(array('p' =&gt; 'Persoon'));<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;rightJoin&lt;/code&gt; ===<br /> De &lt;code&gt;rightJoin&lt;/code&gt; werkt hetzelfde als &lt;code&gt;join&lt;/code&gt; alleen voert het een right join uit ipv een left join.<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = BugQuery::table()-&gt;rightJoin('Persoon');<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;innerJoin&lt;/code&gt; ===<br /> De &lt;code&gt;innerJoin&lt;/code&gt; werkt ook hetzelfde als &lt;code&gt;join&lt;/code&gt; alleen voert het een inner join uit ipv een left join.<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = BugQuery::table()-&gt;innerJoin('Persoon');<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;fullJoin&lt;/code&gt; ===<br /> De &lt;code&gt;fullJoin&lt;/code&gt; werkt ook hetzelfde als &lt;code&gt;join&lt;/code&gt; alleen voert het een full join uit ipv een left join.<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = BugQuery::table()-&gt;fullJoin('Persoon');<br /> &lt;/syntaxhighlight&gt;<br /> <br /> == Where ==<br /> Uiteraard heeft een query ook where's nodig. Daarom heeft de QueryBuilder verschillende methoden om where toe te voegen.<br /> <br /> === &lt;code&gt;whereProp&lt;/code&gt; ===<br /> De belangrijkste where-methode is &lt;code&gt;whereProp&lt;/code&gt;. Met deze methode wordt de where automatisch uitgevoerd op een eigenschap van de objecten waarvan de tables in de query zitten (met from of dmv een join). Hiervoor is het ook nodig dat waarmee je wilt matchen in je where van het juiste type is. Zo is een ID een int en wil je daar dus geen string voor meegeven. De whereProp zoekt ook automatisch de table waarbij de property hoort. Als er meerdere mogelijkheden zijn kan je er altijd 'tablename.' voor zetten, net zoals met normale sql.<br /> <br /> Je kan &lt;code&gt;whereProp&lt;/code&gt; twee of drie argumenten meegeven. Als je twee argumenten meegeeft wordt er een match op gelijkheid aan je query toegevoegd. Hierbij is het eerste argument welke property je wilt matchen en je tweede argument waarmee gematcht wordt.<br /> Selecteer alle Bugs met melder $melder ($melder moet een Persoonobject zijn)<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $bugs = BugQuery::table()-&gt;whereProp('melder', $melder)-&gt;verzamel();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> Als je drie argumenten meegeeft is het eerste argument nog steeds welke property je wilt matchen, je tweede argument is je operator en je derde argument is waarmee gematcht wordt. De mogelijkheden voor de operatoren zijn <br /> Selecteer alle Bugs waarvan melder niet $melder is ($melder moet een Persoonobject zijn)<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $bugs = BugQuery::table()-&gt;whereProp('melder', '!=', $melder)-&gt;verzamel();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;whereProp&lt;/code&gt; varianten ===<br /> <br /> Met de standaard &lt;code&gt;whereProp&lt;/code&gt; kan je alleen een paar operatoren toevoegen aan je where. Daarom zijn er de methoden &lt;code&gt;whereNotProp&lt;/code&gt;, &lt;code&gt;whereLikeProp&lt;/code&gt;, &lt;code&gt;whereNotLikeProp&lt;/code&gt;, &lt;code&gt;whereInProp&lt;/code&gt; en &lt;code&gt;whereNotInProp&lt;/code&gt;. Wat deze methoden doen zit in de naam van de methoden. Voor de &lt;code&gt;whereLikeProp&lt;/code&gt; en &lt;code&gt;whereNotLikeProp&lt;/code&gt; heb je twee argumenten nodig, als eerste de property en als tweede de string. Voor de methoden &lt;code&gt;whereInProp&lt;/code&gt; en &lt;code&gt;whereNotInProp&lt;/code&gt; heb je ook twee argumenten nodig, de property en als tweede de array waar de property in moet zitten.<br /> Haal alle bugs op waarbij het email de string 'pepijno' bevat<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $bugs = BugQuery::table()-&gt;wherePropLike('melderEmail', '%pepijno%')-&gt;verzamel();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === OR ipv AND ===<br /> <br /> Als je meerdere &lt;code&gt;whereProp&lt;/code&gt;-methoden hebt worden ze in de WHERE automatisch aan elkaar geplakt met het AND keyword. Om ze met OR aan elkaar te plakken gebruik je de methode &lt;code&gt;orWhereProp&lt;/code&gt;. Voor alle andere soorten &lt;code&gt;whereProp&lt;/code&gt;-methode kan je op dezelfde manier de or voor de methodenaam plakken en dan worden de where-clausules met OR aan elkaar geplakt.<br /> <br /> === Overige &lt;code&gt;where&lt;/code&gt;-methoden ===<br /> <br /> Als je een WHERE-clausule wilt gebruiken kan je ipv &lt;code&gt;whereProp&lt;/code&gt; ook standaard &lt;code&gt;where&lt;/code&gt;-methoden gebruiken. Deze gebruik je op dezelfde manier als &lt;code&gt;whereProp&lt;/code&gt;-methoden, behalve dat je de Prop moet vervangen door het type van de value die je in je WHERE wilt gebruiken. Als je bv wilt kijken of een ID gelijk is aan een int, moet je &lt;code&gt;whereInt&lt;/code&gt; gebruiken.<br /> Haal alle Bugs op met melder_contactID gelijk aan 5794 (hier kan je als het lid-object van lidnr 5794 hebt ook whereProp gebruiken)<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $bugs = BugQuery::table()-&gt;whereInt('melder_contactID', 5794)-&gt;verzamel();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> Naast deze standaard &lt;code&gt;where&lt;/code&gt;-methode heb je ook de self explainatory methoden &lt;code&gt;whereNot&lt;/code&gt;, &lt;code&gt;whereIn&lt;/code&gt;, &lt;code&gt;whereNotIn&lt;/code&gt;, &lt;code&gt;whereLike&lt;/code&gt;, &lt;code&gt;whereNotLike&lt;/code&gt;, &lt;code&gt;whereNull&lt;/code&gt; en &lt;code&gt;whereNotNull&lt;/code&gt;. Let op dat je dus ook bij deze methoden het type van de value bij de methode naam moet zetten! Ook al deze methode kan je met een OR lijmen door or voor de methodenaam te zetten zoals bv bij &lt;code&gt;orWhereProp&lt;/code&gt;.<br /> <br /> === Nested where's &amp; Closures ===<br /> <br /> Stel, je wilt de volgende WHERE-clausule:<br /> WHERE (a = 0 OR a = 1) AND (a = 2 OR a = 3)<br /> Dit krijg je in de QueryBuilder dmv Closures in php. De bovenstaande where-prop krijg je als volgt<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> ...-&gt;where(function($q) use ($var1, $var2) {<br /> $q-&gt;whereInt('a', 0)<br /> -&gt;orWhereInt('a', 1);<br /> })-&gt;where(function($q) {<br /> $q-&gt;whereInt('a', 2)<br /> -&gt;orWhereInt('a', 3);<br /> })<br /> &lt;/syntaxhighlight&gt;<br /> <br /> In een where kan je dus een closure gebruiken om nested where's te krijgen.<br /> <br /> == Selects ==<br /> <br /> Om selects toe te voegen aan je query gebruik je de methode &lt;code&gt;select&lt;/code&gt;. Elk argument wat je aan de methode meegeeft wordt als select toegevoegd. Ipv de argumenten als strings mee te geven kan je ook een array toevoegen met een string als key en de select als value. Dan wordt de key de AS van de select.<br /> Om alle contactID's te selecteren van de Persoontable<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $ids = PersoonQuery::table()-&gt;select('contactID')-&gt;get();<br /> &lt;/syntaxhighlight&gt;<br /> Om alle contactID's als 'ID' en alle voornamen te selecteren van de Persoontable<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $ids = PersoonQuery::table()-&gt;select(array('ID' =&gt; 'contactID'), 'voornaam')-&gt;get();<br /> &lt;/syntaxhighlight&gt;<br /> Om selects distinct te maken kan je de methode &lt;code&gt;selectDistinct&lt;/code&gt; gebruiken.<br /> <br /> == Order by ==<br /> <br /> Order by's can de QueryBuilder ook aan. Er zijn twee methoden &lt;code&gt;orderByAsc&lt;/code&gt; en &lt;code&gt;orderByDesc&lt;/code&gt;. Allebei de methoden hebben slechts 1 argument nodig, de kolom om de order op uit te voeren.<br /> Selecteer alle Personen geordered op contactID<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $personen = PersoonQuery::table()-&gt;orderByAsc('contactID')-&gt;verzamel();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> [[Category:WebCie]]</div>

Pepijno https://mediawiki.a-eskwadraat.nl/wiki/index.php/QueryBuilder 2017-02-28T22:34:22Z

<p>Pepijno: /* Order by */</p> <hr /> <div>Om SQL-queries makkelijker te maken heeft de WebCie haar eigen sql-library geschreven, de QueryBuilder. De QueryBuilder maakt queries op dmv van een QueryBuilder-object waaraan properties veranderd worden. Op die manier wordt de query pas gebouwd als de query uitgevoerd moet worden. Hierdoor is er meer mogelijkheid voor controle en sanity checks.<br /> <br /> De QueryBuilder bestaat uit de Query-klasse, de QueryBuilder-klasse en alle uitbreidingen. De Query-klasse is een extensie van de QueryBuilder-klasse. Het verschil tussen de twee klasses is dat de QueryBuilder-klasse wordt gebruikt om de query op te bouwen en de Query-klasse wordt gebruikt om van het geheel een werkende query te maken, alsmede verschillende functies zoals het verzamelen van objecten te implementeren.<br /> <br /> == QueryBuilder starten ==<br /> Omdat je een query altijd wilt gebruiken voor WhosWho4-objecten heeft elk WhosWho4-object zijn eigen query-classe die een uitbreiding is van de Query-klasse. Zo heb je bv de PersoonQuery-klasse en de LidQuery-klasse. Deze extensies hebben niet hun eigen speciale constructor. in plaats daarvan heeft elk van deze klassen de methode table waarmee een Query-klasse wordt aangemaakt, het object als table bij de query wordt gezet en het ObjectQuery-object wordt gereturnd zodat er meteen methoden op kunnen worden toegepast. Voor uitgebreide klasse zoals Persoon en Lid worden automatisch de onderliggende klassen gejoind zodat je dit niet zelf hoeft te doen en bij deze data kan.<br /> Een voorbeeld:<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = PersoonQuery::table();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> == Query uitvoeren ==<br /> Een query kan je uitvoeren met de methode &lt;code&gt;get&lt;/code&gt;. &lt;code&gt;get&lt;/code&gt; heeft geen argumenten nodig. Als je verder niets aan je Query-object hebt toegevoegd selecteert de query automatisch alle objecten in de table. Met het volgende voorbeeld worden alle entries uit de Persoon-table opgevraagd:<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $personen = PersoonQuery::table()-&gt;get();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;first&lt;/code&gt; ===<br /> De methode &lt;code&gt;first&lt;/code&gt; voert de query uit zoals &lt;code&gt;get&lt;/code&gt; dat doet en geeft vervolgens alleen het eerste resultaat terug. Met het volgende voorbeeld wordt de eerste entry uit de Persoon-table opgehaald:<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $personen = PersoonQuery::table()-&gt;first();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;aggregate&lt;/code&gt; (TODO: in de php-code moet deze functie nog worden aangepast) ===<br /> De methode &lt;code&gt;aggregate&lt;/code&gt; voert een aggregator uit op de query. De toegestane aggregators zijn: &lt;code&gt;COUNT&lt;/code&gt;, &lt;code&gt;SUM&lt;/code&gt;, &lt;code&gt;MAX&lt;/code&gt;, &lt;code&gt;MIN&lt;/code&gt; en &lt;code&gt;YEAR&lt;/code&gt;. De aggregator pakt op dit moment nog alles ipv een specifieke kolom. &lt;code&gt;aggregate&lt;/code&gt; haalt ook de huidige selectie weg. Een voorbeeld om alle entries in de Persoon-table te tellen:<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $aantal_personen = PersoonQuery::table()-&gt;aggregate('COUNT');<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;count&lt;/code&gt; ===<br /> Om makkelijker entries te tellen is de speciale methode &lt;code&gt;count&lt;/code&gt;. Deze methode telt het aantal entries en haalt ook de orderBys, limits en offset van de query weg.<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $aantal_personen = PersoonQuery::table()-&gt;count();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;verzamel&lt;/code&gt; ===<br /> De methode die het vaakst gebruikt wordt is &lt;code&gt;verzamel&lt;/code&gt;. Net zoals &lt;code&gt;verzamel&lt;/code&gt; van elke Verzameling van een WhosWho4-object verzamelt deze query-methode alle WhosWho4-objecten die met de query opgehaald worden. Hierbij verdwijnen alle huidige selects van de query. De methode kan twee argumenten krijgen: de naam van de klasse om de objecten van te verzamelen as string en of de objecten distinct moeten zijn als bool. Zonder argumenten is distinct true en worden de objecten opgehaald van de klasse waarvan je het query-object gemaakt hebt. Als voorbeeld, haal alle Persoon-objecten op:<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $persoon_objecten = PersoonQuery::table()-&gt;verzamel();<br /> &lt;/syntaxhighlight&gt;<br /> Haal alle distinct bugmelders op (dit voorbeeld gebruikt ook &lt;code&gt;join&lt;/code&gt;):<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $persoon_objecten = BugQuery::table()<br /> -&gt;join('Persoon')<br /> -&gt;verzamel('Persoon', true);<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;geef&lt;/code&gt; ===<br /> Net zoals de methode &lt;code&gt;geef&lt;/code&gt; voor objecten heeft de QueryBuilder een soortgelijke methode. De methode geeft een object terug die wordt opgevraagd dmv de query. Net als bij &lt;code&gt;verzamel&lt;/code&gt; heeft de methode een argument voor het soort object wat je op wilt halen.<br /> Geef het lid-object met ID 5794<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $persoon = PersoonQuery::table()<br /> -&gt;whereInt('contactID', 5794)<br /> -&gt;geef();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> == Joins ==<br /> De QueryBuilder heeft uiteraard ook de mogelijkheid om joins uit te voeren op tables. Nieuwe tabellen worden automatisch op de juiste velden gejoind, dus dit hoef je niet meer zelf te doen. Mocht de QueryBuilder het toch niet zelf kunnen, dan hebben de join-methoden extra argumenten nodig voor het joinen.<br /> <br /> === (left) &lt;code&gt;join&lt;/code&gt; ===<br /> De standaard &lt;code&gt;join&lt;/code&gt; is een left join. Je hoeft als enige argument de table mee te geven om op te joinen. Zo kan je bv de table Persoon joinen met Bug<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = BugQuery::table()-&gt;join('Persoon');<br /> &lt;/syntaxhighlight&gt;<br /> Als het echt nodig is kan je zelf de twee namen van de kolommen meegeven waarop gejoined moet worden<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = BugQuery::table()-&gt;join('Persoon', 'Bug.melder_contactID', 'Persoon.contactID');<br /> &lt;/syntaxhighlight&gt;<br /> <br /> Je kan ook ipv een string als naam voor de table bij je join een array plaatsen met als key een string en als value je tablename. De key wordt dan de AS in de query. Dus om in bovenstaand voorbeelde de table Persoon AS p te joinen<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = BugQuery::table()-&gt;join(array('p' =&gt; 'Persoon'));<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;rightJoin&lt;/code&gt; ===<br /> De &lt;code&gt;rightJoin&lt;/code&gt; werkt hetzelfde als &lt;code&gt;join&lt;/code&gt; alleen voert het een right join uit ipv een left join.<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = BugQuery::table()-&gt;rightJoin('Persoon');<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;innerJoin&lt;/code&gt; ===<br /> De &lt;code&gt;innerJoin&lt;/code&gt; werkt ook hetzelfde als &lt;code&gt;join&lt;/code&gt; alleen voert het een inner join uit ipv een left join.<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = BugQuery::table()-&gt;innerJoin('Persoon');<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;fullJoin&lt;/code&gt; ===<br /> De &lt;code&gt;fullJoin&lt;/code&gt; werkt ook hetzelfde als &lt;code&gt;join&lt;/code&gt; alleen voert het een full join uit ipv een left join.<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = BugQuery::table()-&gt;fullJoin('Persoon');<br /> &lt;/syntaxhighlight&gt;<br /> <br /> == Where ==<br /> Uiteraard heeft een query ook where's nodig. Daarom heeft de QueryBuilder verschillende methoden om where toe te voegen.<br /> <br /> === &lt;code&gt;whereProp&lt;/code&gt; ===<br /> De belangrijkste where-methode is &lt;code&gt;whereProp&lt;/code&gt;. Met deze methode wordt de where automatisch uitgevoerd op een eigenschap van de objecten waarvan de tables in de query zitten (met from of dmv een join). Hiervoor is het ook nodig dat waarmee je wilt matchen in je where van het juiste type is. Zo is een ID een int en wil je daar dus geen string voor meegeven. De whereProp zoekt ook automatisch de table waarbij de property hoort. Als er meerdere mogelijkheden zijn kan je er altijd 'tablename.' voor zetten, net zoals met normale sql.<br /> <br /> Je kan &lt;code&gt;whereProp&lt;/code&gt; twee of drie argumenten meegeven. Als je twee argumenten meegeeft wordt er een match op gelijkheid aan je query toegevoegd. Hierbij is het eerste argument welke property je wilt matchen en je tweede argument waarmee gematcht wordt.<br /> Selecteer alle Bugs met melder $melder ($melder moet een Persoonobject zijn)<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $bugs = BugQuery::table()-&gt;whereProp('melder', $melder)-&gt;verzamel();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> Als je drie argumenten meegeeft is het eerste argument nog steeds welke property je wilt matchen, je tweede argument is je operator en je derde argument is waarmee gematcht wordt. De mogelijkheden voor de operatoren zijn <br /> Selecteer alle Bugs waarvan melder niet $melder is ($melder moet een Persoonobject zijn)<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $bugs = BugQuery::table()-&gt;whereProp('melder', '!=', $melder)-&gt;verzamel();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;whereProp&lt;/code&gt; varianten ===<br /> <br /> Met de standaard &lt;code&gt;whereProp&lt;/code&gt; kan je alleen een paar operatoren toevoegen aan je where. Daarom zijn er de methoden &lt;code&gt;whereNotProp&lt;/code&gt;, &lt;code&gt;whereLikeProp&lt;/code&gt;, &lt;code&gt;whereNotLikeProp&lt;/code&gt;, &lt;code&gt;whereInProp&lt;/code&gt; en &lt;code&gt;whereNotInProp&lt;/code&gt;. Wat deze methoden doen zit in de naam van de methoden. Voor de &lt;code&gt;whereLikeProp&lt;/code&gt; en &lt;code&gt;whereNotLikeProp&lt;/code&gt; heb je twee argumenten nodig, als eerste de property en als tweede de string. Voor de methoden &lt;code&gt;whereInProp&lt;/code&gt; en &lt;code&gt;whereNotInProp&lt;/code&gt; heb je ook twee argumenten nodig, de property en als tweede de array waar de property in moet zitten.<br /> Haal alle bugs op waarbij het email de string 'pepijno' bevat<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $bugs = BugQuery::table()-&gt;wherePropLike('melderEmail', '%pepijno%')-&gt;verzamel();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === OR ipv AND ===<br /> <br /> Als je meerdere &lt;code&gt;whereProp&lt;/code&gt;-methoden hebt worden ze in de WHERE automatisch aan elkaar geplakt met het AND keyword. Om ze met OR aan elkaar te plakken gebruik je de methode &lt;code&gt;orWhereProp&lt;/code&gt;. Voor alle andere soorten &lt;code&gt;whereProp&lt;/code&gt;-methode kan je op dezelfde manier de or voor de methodenaam plakken en dan worden de where-clausules met OR aan elkaar geplakt.<br /> <br /> === Overige &lt;code&gt;where&lt;/code&gt;-methoden ===<br /> <br /> Als je een WHERE-clausule wilt gebruiken kan je ipv &lt;code&gt;whereProp&lt;/code&gt; ook standaard &lt;code&gt;where&lt;/code&gt;-methoden gebruiken. Deze gebruik je op dezelfde manier als &lt;code&gt;whereProp&lt;/code&gt;-methoden, behalve dat je de Prop moet vervangen door het type van de value die je in je WHERE wilt gebruiken. Als je bv wilt kijken of een ID gelijk is aan een int, moet je &lt;code&gt;whereInt&lt;/code&gt; gebruiken.<br /> Haal alle Bugs op met melder_contactID gelijk aan 5794 (hier kan je als het lid-object van lidnr 5794 hebt ook whereProp gebruiken)<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $bugs = BugQuery::table()-&gt;whereInt('melder_contactID', 5794)-&gt;verzamel();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> Naast deze standaard &lt;code&gt;where&lt;/code&gt;-methode heb je ook de self explainatory methoden &lt;code&gt;whereNot&lt;/code&gt;, &lt;code&gt;whereIn&lt;/code&gt;, &lt;code&gt;whereNotIn&lt;/code&gt;, &lt;code&gt;whereLike&lt;/code&gt;, &lt;code&gt;whereNotLike&lt;/code&gt;, &lt;code&gt;whereNull&lt;/code&gt; en &lt;code&gt;whereNotNull&lt;/code&gt;. Let op dat je dus ook bij deze methoden het type van de value bij de methode naam moet zetten! Ook al deze methode kan je met een OR lijmen door or voor de methodenaam te zetten zoals bv bij &lt;code&gt;orWhereProp&lt;/code&gt;.<br /> <br /> === Nested where's &amp; Closures ===<br /> <br /> Stel, je wilt de volgende WHERE-clausule:<br /> WHERE (a = 0 OR a = 1) AND (a = 2 OR a = 3)<br /> Dit krijg je in de QueryBuilder dmv Closures in php. De bovenstaande where-prop krijg je als volgt<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> ...-&gt;where(function($q) use ($var1, $var2) {<br /> $q-&gt;whereInt('a', 0)<br /> -&gt;orWhereInt('a', 1);<br /> })-&gt;where(function($q) {<br /> $q-&gt;whereInt('a', 2)<br /> -&gt;orWhereInt('a', 3);<br /> })<br /> &lt;/syntaxhighlight&gt;<br /> <br /> In een where kan je dus een closure gebruiken om nested where's te krijgen.<br /> <br /> == Selects ==<br /> <br /> Om selects toe te voegen aan je query gebruik je de methode &lt;code&gt;select&lt;/code&gt;. Elk argument wat je aan de methode meegeeft wordt als select toegevoegd. Ipv de argumenten als strings mee te geven kan je ook een array toevoegen met een string als key en de select als value. Dan wordt de key de AS van de select.<br /> Om alle contactID's te selecteren van de Persoontable<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $ids = PersoonQuery::table()-&gt;select('contactID')-&gt;get();<br /> &lt;/syntaxhighlight&gt;<br /> Om alle contactID's als 'ID' en alle voornamen te selecteren van de Persoontable<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $ids = PersoonQuery::table()-&gt;select(array('ID' =&gt; 'contactID'), 'voornaam')-&gt;get();<br /> &lt;/syntaxhighlight&gt;<br /> Om selects distinct te maken kan je de methode &lt;code&gt;selectDistinct&lt;/code&gt; gebruiken.<br /> <br /> == Order by ==<br /> <br /> Order by's can de QueryBuilder ook aan. Er zijn twee methoden &lt;code&gt;orderByAsc&lt;/code&gt; en &lt;code&gt;orderByDesc&lt;/code&gt;. Allebei de methoden hebben slechts 1 argument nodig, de kolom om de order op uit te voeren.<br /> Selecteer alle Personen geordered op contactID<br /> <br /> <br /> [[Category:WebCie]]</div>

Pepijno https://mediawiki.a-eskwadraat.nl/wiki/index.php/QueryBuilder 2017-02-28T21:41:06Z

<p>Pepijno: </p> <hr /> <div>Om SQL-queries makkelijker te maken heeft de WebCie haar eigen sql-library geschreven, de QueryBuilder. De QueryBuilder maakt queries op dmv van een QueryBuilder-object waaraan properties veranderd worden. Op die manier wordt de query pas gebouwd als de query uitgevoerd moet worden. Hierdoor is er meer mogelijkheid voor controle en sanity checks.<br /> <br /> De QueryBuilder bestaat uit de Query-klasse, de QueryBuilder-klasse en alle uitbreidingen. De Query-klasse is een extensie van de QueryBuilder-klasse. Het verschil tussen de twee klasses is dat de QueryBuilder-klasse wordt gebruikt om de query op te bouwen en de Query-klasse wordt gebruikt om van het geheel een werkende query te maken, alsmede verschillende functies zoals het verzamelen van objecten te implementeren.<br /> <br /> == QueryBuilder starten ==<br /> Omdat je een query altijd wilt gebruiken voor WhosWho4-objecten heeft elk WhosWho4-object zijn eigen query-classe die een uitbreiding is van de Query-klasse. Zo heb je bv de PersoonQuery-klasse en de LidQuery-klasse. Deze extensies hebben niet hun eigen speciale constructor. in plaats daarvan heeft elk van deze klassen de methode table waarmee een Query-klasse wordt aangemaakt, het object als table bij de query wordt gezet en het ObjectQuery-object wordt gereturnd zodat er meteen methoden op kunnen worden toegepast. Voor uitgebreide klasse zoals Persoon en Lid worden automatisch de onderliggende klassen gejoind zodat je dit niet zelf hoeft te doen en bij deze data kan.<br /> Een voorbeeld:<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = PersoonQuery::table();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> == Query uitvoeren ==<br /> Een query kan je uitvoeren met de methode &lt;code&gt;get&lt;/code&gt;. &lt;code&gt;get&lt;/code&gt; heeft geen argumenten nodig. Als je verder niets aan je Query-object hebt toegevoegd selecteert de query automatisch alle objecten in de table. Met het volgende voorbeeld worden alle entries uit de Persoon-table opgevraagd:<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $personen = PersoonQuery::table()-&gt;get();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;first&lt;/code&gt; ===<br /> De methode &lt;code&gt;first&lt;/code&gt; voert de query uit zoals &lt;code&gt;get&lt;/code&gt; dat doet en geeft vervolgens alleen het eerste resultaat terug. Met het volgende voorbeeld wordt de eerste entry uit de Persoon-table opgehaald:<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $personen = PersoonQuery::table()-&gt;first();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;aggregate&lt;/code&gt; (TODO: in de php-code moet deze functie nog worden aangepast) ===<br /> De methode &lt;code&gt;aggregate&lt;/code&gt; voert een aggregator uit op de query. De toegestane aggregators zijn: &lt;code&gt;COUNT&lt;/code&gt;, &lt;code&gt;SUM&lt;/code&gt;, &lt;code&gt;MAX&lt;/code&gt;, &lt;code&gt;MIN&lt;/code&gt; en &lt;code&gt;YEAR&lt;/code&gt;. De aggregator pakt op dit moment nog alles ipv een specifieke kolom. &lt;code&gt;aggregate&lt;/code&gt; haalt ook de huidige selectie weg. Een voorbeeld om alle entries in de Persoon-table te tellen:<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $aantal_personen = PersoonQuery::table()-&gt;aggregate('COUNT');<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;count&lt;/code&gt; ===<br /> Om makkelijker entries te tellen is de speciale methode &lt;code&gt;count&lt;/code&gt;. Deze methode telt het aantal entries en haalt ook de orderBys, limits en offset van de query weg.<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $aantal_personen = PersoonQuery::table()-&gt;count();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;verzamel&lt;/code&gt; ===<br /> De methode die het vaakst gebruikt wordt is &lt;code&gt;verzamel&lt;/code&gt;. Net zoals &lt;code&gt;verzamel&lt;/code&gt; van elke Verzameling van een WhosWho4-object verzamelt deze query-methode alle WhosWho4-objecten die met de query opgehaald worden. Hierbij verdwijnen alle huidige selects van de query. De methode kan twee argumenten krijgen: de naam van de klasse om de objecten van te verzamelen as string en of de objecten distinct moeten zijn als bool. Zonder argumenten is distinct true en worden de objecten opgehaald van de klasse waarvan je het query-object gemaakt hebt. Als voorbeeld, haal alle Persoon-objecten op:<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $persoon_objecten = PersoonQuery::table()-&gt;verzamel();<br /> &lt;/syntaxhighlight&gt;<br /> Haal alle distinct bugmelders op (dit voorbeeld gebruikt ook &lt;code&gt;join&lt;/code&gt;):<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $persoon_objecten = BugQuery::table()<br /> -&gt;join('Persoon')<br /> -&gt;verzamel('Persoon', true);<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;geef&lt;/code&gt; ===<br /> Net zoals de methode &lt;code&gt;geef&lt;/code&gt; voor objecten heeft de QueryBuilder een soortgelijke methode. De methode geeft een object terug die wordt opgevraagd dmv de query. Net als bij &lt;code&gt;verzamel&lt;/code&gt; heeft de methode een argument voor het soort object wat je op wilt halen.<br /> Geef het lid-object met ID 5794<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $persoon = PersoonQuery::table()<br /> -&gt;whereInt('contactID', 5794)<br /> -&gt;geef();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> == Joins ==<br /> De QueryBuilder heeft uiteraard ook de mogelijkheid om joins uit te voeren op tables. Nieuwe tabellen worden automatisch op de juiste velden gejoind, dus dit hoef je niet meer zelf te doen. Mocht de QueryBuilder het toch niet zelf kunnen, dan hebben de join-methoden extra argumenten nodig voor het joinen.<br /> <br /> === (left) &lt;code&gt;join&lt;/code&gt; ===<br /> De standaard &lt;code&gt;join&lt;/code&gt; is een left join. Je hoeft als enige argument de table mee te geven om op te joinen. Zo kan je bv de table Persoon joinen met Bug<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = BugQuery::table()-&gt;join('Persoon');<br /> &lt;/syntaxhighlight&gt;<br /> Als het echt nodig is kan je zelf de twee namen van de kolommen meegeven waarop gejoined moet worden<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = BugQuery::table()-&gt;join('Persoon', 'Bug.melder_contactID', 'Persoon.contactID');<br /> &lt;/syntaxhighlight&gt;<br /> <br /> Je kan ook ipv een string als naam voor de table bij je join een array plaatsen met als key een string en als value je tablename. De key wordt dan de AS in de query. Dus om in bovenstaand voorbeelde de table Persoon AS p te joinen<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = BugQuery::table()-&gt;join(array('p' =&gt; 'Persoon'));<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;rightJoin&lt;/code&gt; ===<br /> De &lt;code&gt;rightJoin&lt;/code&gt; werkt hetzelfde als &lt;code&gt;join&lt;/code&gt; alleen voert het een right join uit ipv een left join.<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = BugQuery::table()-&gt;rightJoin('Persoon');<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;innerJoin&lt;/code&gt; ===<br /> De &lt;code&gt;innerJoin&lt;/code&gt; werkt ook hetzelfde als &lt;code&gt;join&lt;/code&gt; alleen voert het een inner join uit ipv een left join.<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = BugQuery::table()-&gt;innerJoin('Persoon');<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;fullJoin&lt;/code&gt; ===<br /> De &lt;code&gt;fullJoin&lt;/code&gt; werkt ook hetzelfde als &lt;code&gt;join&lt;/code&gt; alleen voert het een full join uit ipv een left join.<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = BugQuery::table()-&gt;fullJoin('Persoon');<br /> &lt;/syntaxhighlight&gt;<br /> <br /> == Where ==<br /> Uiteraard heeft een query ook where's nodig. Daarom heeft de QueryBuilder verschillende methoden om where toe te voegen.<br /> <br /> === &lt;code&gt;whereProp&lt;/code&gt; ===<br /> De belangrijkste where-methode is &lt;code&gt;whereProp&lt;/code&gt;. Met deze methode wordt de where automatisch uitgevoerd op een eigenschap van de objecten waarvan de tables in de query zitten (met from of dmv een join). Hiervoor is het ook nodig dat waarmee je wilt matchen in je where van het juiste type is. Zo is een ID een int en wil je daar dus geen string voor meegeven. De whereProp zoekt ook automatisch de table waarbij de property hoort. Als er meerdere mogelijkheden zijn kan je er altijd 'tablename.' voor zetten, net zoals met normale sql.<br /> <br /> Je kan &lt;code&gt;whereProp&lt;/code&gt; twee of drie argumenten meegeven. Als je twee argumenten meegeeft wordt er een match op gelijkheid aan je query toegevoegd. Hierbij is het eerste argument welke property je wilt matchen en je tweede argument waarmee gematcht wordt.<br /> Selecteer alle Bugs met melder $melder ($melder moet een Persoonobject zijn)<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $bugs = BugQuery::table()-&gt;whereProp('melder', $melder)-&gt;verzamel();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> Als je drie argumenten meegeeft is het eerste argument nog steeds welke property je wilt matchen, je tweede argument is je operator en je derde argument is waarmee gematcht wordt. De mogelijkheden voor de operatoren zijn <br /> Selecteer alle Bugs waarvan melder niet $melder is ($melder moet een Persoonobject zijn)<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $bugs = BugQuery::table()-&gt;whereProp('melder', '!=', $melder)-&gt;verzamel();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;whereProp&lt;/code&gt; varianten ===<br /> <br /> Met de standaard &lt;code&gt;whereProp&lt;/code&gt; kan je alleen een paar operatoren toevoegen aan je where. Daarom zijn er de methoden &lt;code&gt;whereNotProp&lt;/code&gt;, &lt;code&gt;whereLikeProp&lt;/code&gt;, &lt;code&gt;whereNotLikeProp&lt;/code&gt;, &lt;code&gt;whereInProp&lt;/code&gt; en &lt;code&gt;whereNotInProp&lt;/code&gt;. Wat deze methoden doen zit in de naam van de methoden. Voor de &lt;code&gt;whereLikeProp&lt;/code&gt; en &lt;code&gt;whereNotLikeProp&lt;/code&gt; heb je twee argumenten nodig, als eerste de property en als tweede de string. Voor de methoden &lt;code&gt;whereInProp&lt;/code&gt; en &lt;code&gt;whereNotInProp&lt;/code&gt; heb je ook twee argumenten nodig, de property en als tweede de array waar de property in moet zitten.<br /> Haal alle bugs op waarbij het email de string 'pepijno' bevat<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $bugs = BugQuery::table()-&gt;wherePropLike('melderEmail', '%pepijno%')-&gt;verzamel();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === OR ipv AND ===<br /> <br /> Als je meerdere &lt;code&gt;whereProp&lt;/code&gt;-methoden hebt worden ze in de WHERE automatisch aan elkaar geplakt met het AND keyword. Om ze met OR aan elkaar te plakken gebruik je de methode &lt;code&gt;orWhereProp&lt;/code&gt;. Voor alle andere soorten &lt;code&gt;whereProp&lt;/code&gt;-methode kan je op dezelfde manier de or voor de methodenaam plakken en dan worden de where-clausules met OR aan elkaar geplakt.<br /> <br /> === Overige &lt;code&gt;where&lt;/code&gt;-methoden ===<br /> <br /> Als je een WHERE-clausule wilt gebruiken kan je ipv &lt;code&gt;whereProp&lt;/code&gt; ook standaard &lt;code&gt;where&lt;/code&gt;-methoden gebruiken. Deze gebruik je op dezelfde manier als &lt;code&gt;whereProp&lt;/code&gt;-methoden, behalve dat je de Prop moet vervangen door het type van de value die je in je WHERE wilt gebruiken. Als je bv wilt kijken of een ID gelijk is aan een int, moet je &lt;code&gt;whereInt&lt;/code&gt; gebruiken.<br /> Haal alle Bugs op met melder_contactID gelijk aan 5794 (hier kan je als het lid-object van lidnr 5794 hebt ook whereProp gebruiken)<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $bugs = BugQuery::table()-&gt;whereInt('melder_contactID', 5794)-&gt;verzamel();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> Naast deze standaard &lt;code&gt;where&lt;/code&gt;-methode heb je ook de self explainatory methoden &lt;code&gt;whereNot&lt;/code&gt;, &lt;code&gt;whereIn&lt;/code&gt;, &lt;code&gt;whereNotIn&lt;/code&gt;, &lt;code&gt;whereLike&lt;/code&gt;, &lt;code&gt;whereNotLike&lt;/code&gt;, &lt;code&gt;whereNull&lt;/code&gt; en &lt;code&gt;whereNotNull&lt;/code&gt;. Let op dat je dus ook bij deze methoden het type van de value bij de methode naam moet zetten! Ook al deze methode kan je met een OR lijmen door or voor de methodenaam te zetten zoals bv bij &lt;code&gt;orWhereProp&lt;/code&gt;.<br /> <br /> === Nested where's &amp; Closures ===<br /> <br /> Stel, je wilt de volgende WHERE-clausule:<br /> WHERE (a = 0 OR a = 1) AND (a = 2 OR a = 3)<br /> Dit krijg je in de QueryBuilder dmv Closures in php. De bovenstaande where-prop krijg je als volgt<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> ...-&gt;where(function($q) use ($var1, $var2) {<br /> $q-&gt;whereInt('a', 0)<br /> -&gt;orWhereInt('a', 1);<br /> })-&gt;where(function($q) {<br /> $q-&gt;whereInt('a', 2)<br /> -&gt;orWhereInt('a', 3);<br /> })<br /> &lt;/syntaxhighlight&gt;<br /> <br /> In een where kan je dus een closure gebruiken om nested where's te krijgen.<br /> <br /> == Selects ==<br /> <br /> Om selects toe te voegen aan je query gebruik je de methode &lt;code&gt;select&lt;/code&gt;. Elk argument wat je aan de methode meegeeft wordt als select toegevoegd. Ipv de argumenten als strings mee te geven kan je ook een array toevoegen met een string als key en de select als value. Dan wordt de key de AS van de select.<br /> Om alle contactID's te selecteren van de Persoontable<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $ids = PersoonQuery::table()-&gt;select('contactID')-&gt;get();<br /> &lt;/syntaxhighlight&gt;<br /> Om alle contactID's als 'ID' en alle voornamen te selecteren van de Persoontable<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $ids = PersoonQuery::table()-&gt;select(array('ID' =&gt; 'contactID'), 'voornaam')-&gt;get();<br /> &lt;/syntaxhighlight&gt;<br /> Om selects distinct te maken kan je de methode &lt;code&gt;selectDistinct&lt;/code&gt; gebruiken.<br /> <br /> == Order by ==<br /> <br /> [[Category:WebCie]]</div>

Pepijno https://mediawiki.a-eskwadraat.nl/wiki/index.php/QueryBuilder 2017-02-28T21:33:47Z

<p>Pepijno: /* Selects */</p> <hr /> <div>Om SQL-queries makkelijker te maken heeft de WebCie haar eigen sql-library geschreven, de QueryBuilder. De QueryBuilder maakt queries op dmv van een QueryBuilder-object waaraan properties veranderd worden. Op die manier wordt de query pas gebouwd als de query uitgevoerd moet worden. Hierdoor is er meer mogelijkheid voor controle en sanity checks.<br /> <br /> De QueryBuilder bestaat uit de Query-klasse, de QueryBuilder-klasse en alle uitbreidingen. De Query-klasse is een extensie van de QueryBuilder-klasse. Het verschil tussen de twee klasses is dat de QueryBuilder-klasse wordt gebruikt om de query op te bouwen en de Query-klasse wordt gebruikt om van het geheel een werkende query te maken, alsmede verschillende functies zoals het verzamelen van objecten te implementeren.<br /> <br /> == QueryBuilder starten ==<br /> Omdat je een query altijd wilt gebruiken voor WhosWho4-objecten heeft elk WhosWho4-object zijn eigen query-classe die een uitbreiding is van de Query-klasse. Zo heb je bv de PersoonQuery-klasse en de LidQuery-klasse. Deze extensies hebben niet hun eigen speciale constructor. in plaats daarvan heeft elk van deze klassen de methode table waarmee een Query-klasse wordt aangemaakt, het object als table bij de query wordt gezet en het ObjectQuery-object wordt gereturnd zodat er meteen methoden op kunnen worden toegepast. Voor uitgebreide klasse zoals Persoon en Lid worden automatisch de onderliggende klassen gejoind zodat je dit niet zelf hoeft te doen en bij deze data kan.<br /> Een voorbeeld:<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = PersoonQuery::table();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> == Query uitvoeren ==<br /> Een query kan je uitvoeren met de methode &lt;code&gt;get&lt;/code&gt;. &lt;code&gt;get&lt;/code&gt; heeft geen argumenten nodig. Als je verder niets aan je Query-object hebt toegevoegd selecteert de query automatisch alle objecten in de table. Met het volgende voorbeeld worden alle entries uit de Persoon-table opgevraagd:<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $personen = PersoonQuery::table()-&gt;get();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;first&lt;/code&gt; ===<br /> De methode &lt;code&gt;first&lt;/code&gt; voert de query uit zoals &lt;code&gt;get&lt;/code&gt; dat doet en geeft vervolgens alleen het eerste resultaat terug. Met het volgende voorbeeld wordt de eerste entry uit de Persoon-table opgehaald:<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $personen = PersoonQuery::table()-&gt;first();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;aggregate&lt;/code&gt; (TODO: in de php-code moet deze functie nog worden aangepast) ===<br /> De methode &lt;code&gt;aggregate&lt;/code&gt; voert een aggregator uit op de query. De toegestane aggregators zijn: &lt;code&gt;COUNT&lt;/code&gt;, &lt;code&gt;SUM&lt;/code&gt;, &lt;code&gt;MAX&lt;/code&gt;, &lt;code&gt;MIN&lt;/code&gt; en &lt;code&gt;YEAR&lt;/code&gt;. De aggregator pakt op dit moment nog alles ipv een specifieke kolom. &lt;code&gt;aggregate&lt;/code&gt; haalt ook de huidige selectie weg. Een voorbeeld om alle entries in de Persoon-table te tellen:<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $aantal_personen = PersoonQuery::table()-&gt;aggregate('COUNT');<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;count&lt;/code&gt; ===<br /> Om makkelijker entries te tellen is de speciale methode &lt;code&gt;count&lt;/code&gt;. Deze methode telt het aantal entries en haalt ook de orderBys, limits en offset van de query weg.<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $aantal_personen = PersoonQuery::table()-&gt;count();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;verzamel&lt;/code&gt; ===<br /> De methode die het vaakst gebruikt wordt is &lt;code&gt;verzamel&lt;/code&gt;. Net zoals &lt;code&gt;verzamel&lt;/code&gt; van elke Verzameling van een WhosWho4-object verzamelt deze query-methode alle WhosWho4-objecten die met de query opgehaald worden. Hierbij verdwijnen alle huidige selects van de query. De methode kan twee argumenten krijgen: de naam van de klasse om de objecten van te verzamelen as string en of de objecten distinct moeten zijn als bool. Zonder argumenten is distinct true en worden de objecten opgehaald van de klasse waarvan je het query-object gemaakt hebt. Als voorbeeld, haal alle Persoon-objecten op:<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $persoon_objecten = PersoonQuery::table()-&gt;verzamel();<br /> &lt;/syntaxhighlight&gt;<br /> Haal alle distinct bugmelders op (dit voorbeeld gebruikt ook &lt;code&gt;join&lt;/code&gt;):<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $persoon_objecten = BugQuery::table()<br /> -&gt;join('Persoon')<br /> -&gt;verzamel('Persoon', true);<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;geef&lt;/code&gt; ===<br /> Net zoals de methode &lt;code&gt;geef&lt;/code&gt; voor objecten heeft de QueryBuilder een soortgelijke methode. De methode geeft een object terug die wordt opgevraagd dmv de query. Net als bij &lt;code&gt;verzamel&lt;/code&gt; heeft de methode een argument voor het soort object wat je op wilt halen.<br /> Geef het lid-object met ID 5794<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $persoon = PersoonQuery::table()<br /> -&gt;whereInt('contactID', 5794)<br /> -&gt;geef();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> == Joins ==<br /> De QueryBuilder heeft uiteraard ook de mogelijkheid om joins uit te voeren op tables. Nieuwe tabellen worden automatisch op de juiste velden gejoind, dus dit hoef je niet meer zelf te doen. Mocht de QueryBuilder het toch niet zelf kunnen, dan hebben de join-methoden extra argumenten nodig voor het joinen.<br /> <br /> === (left) &lt;code&gt;join&lt;/code&gt; ===<br /> De standaard &lt;code&gt;join&lt;/code&gt; is een left join. Je hoeft als enige argument de table mee te geven om op te joinen. Zo kan je bv de table Persoon joinen met Bug<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = BugQuery::table()-&gt;join('Persoon');<br /> &lt;/syntaxhighlight&gt;<br /> Als het echt nodig is kan je zelf de twee namen van de kolommen meegeven waarop gejoined moet worden<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = BugQuery::table()-&gt;join('Persoon', 'Bug.melder_contactID', 'Persoon.contactID');<br /> &lt;/syntaxhighlight&gt;<br /> <br /> Je kan ook ipv een string als naam voor de table bij je join een array plaatsen met als key een string en als value je tablename. De key wordt dan de AS in de query. Dus om in bovenstaand voorbeelde de table Persoon AS p te joinen<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = BugQuery::table()-&gt;join(array('p' =&gt; 'Persoon'));<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;rightJoin&lt;/code&gt; ===<br /> De &lt;code&gt;rightJoin&lt;/code&gt; werkt hetzelfde als &lt;code&gt;join&lt;/code&gt; alleen voert het een right join uit ipv een left join.<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = BugQuery::table()-&gt;rightJoin('Persoon');<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;innerJoin&lt;/code&gt; ===<br /> De &lt;code&gt;innerJoin&lt;/code&gt; werkt ook hetzelfde als &lt;code&gt;join&lt;/code&gt; alleen voert het een inner join uit ipv een left join.<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = BugQuery::table()-&gt;innerJoin('Persoon');<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;fullJoin&lt;/code&gt; ===<br /> De &lt;code&gt;fullJoin&lt;/code&gt; werkt ook hetzelfde als &lt;code&gt;join&lt;/code&gt; alleen voert het een full join uit ipv een left join.<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = BugQuery::table()-&gt;fullJoin('Persoon');<br /> &lt;/syntaxhighlight&gt;<br /> <br /> == Where ==<br /> Uiteraard heeft een query ook where's nodig. Daarom heeft de QueryBuilder verschillende methoden om where toe te voegen.<br /> <br /> === &lt;code&gt;whereProp&lt;/code&gt; ===<br /> De belangrijkste where-methode is &lt;code&gt;whereProp&lt;/code&gt;. Met deze methode wordt de where automatisch uitgevoerd op een eigenschap van de objecten waarvan de tables in de query zitten (met from of dmv een join). Hiervoor is het ook nodig dat waarmee je wilt matchen in je where van het juiste type is. Zo is een ID een int en wil je daar dus geen string voor meegeven. De whereProp zoekt ook automatisch de table waarbij de property hoort. Als er meerdere mogelijkheden zijn kan je er altijd 'tablename.' voor zetten, net zoals met normale sql.<br /> <br /> Je kan &lt;code&gt;whereProp&lt;/code&gt; twee of drie argumenten meegeven. Als je twee argumenten meegeeft wordt er een match op gelijkheid aan je query toegevoegd. Hierbij is het eerste argument welke property je wilt matchen en je tweede argument waarmee gematcht wordt.<br /> Selecteer alle Bugs met melder $melder ($melder moet een Persoonobject zijn)<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $bugs = BugQuery::table()-&gt;whereProp('melder', $melder)-&gt;verzamel();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> Als je drie argumenten meegeeft is het eerste argument nog steeds welke property je wilt matchen, je tweede argument is je operator en je derde argument is waarmee gematcht wordt. De mogelijkheden voor de operatoren zijn <br /> Selecteer alle Bugs waarvan melder niet $melder is ($melder moet een Persoonobject zijn)<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $bugs = BugQuery::table()-&gt;whereProp('melder', '!=', $melder)-&gt;verzamel();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;whereProp&lt;/code&gt; varianten ===<br /> <br /> Met de standaard &lt;code&gt;whereProp&lt;/code&gt; kan je alleen een paar operatoren toevoegen aan je where. Daarom zijn er de methoden &lt;code&gt;whereNotProp&lt;/code&gt;, &lt;code&gt;whereLikeProp&lt;/code&gt;, &lt;code&gt;whereNotLikeProp&lt;/code&gt;, &lt;code&gt;whereInProp&lt;/code&gt; en &lt;code&gt;whereNotInProp&lt;/code&gt;. Wat deze methoden doen zit in de naam van de methoden. Voor de &lt;code&gt;whereLikeProp&lt;/code&gt; en &lt;code&gt;whereNotLikeProp&lt;/code&gt; heb je twee argumenten nodig, als eerste de property en als tweede de string. Voor de methoden &lt;code&gt;whereInProp&lt;/code&gt; en &lt;code&gt;whereNotInProp&lt;/code&gt; heb je ook twee argumenten nodig, de property en als tweede de array waar de property in moet zitten.<br /> Haal alle bugs op waarbij het email de string 'pepijno' bevat<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $bugs = BugQuery::table()-&gt;wherePropLike('melderEmail', '%pepijno%')-&gt;verzamel();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === OR ipv AND ===<br /> <br /> Als je meerdere &lt;code&gt;whereProp&lt;/code&gt;-methoden hebt worden ze in de WHERE automatisch aan elkaar geplakt met het AND keyword. Om ze met OR aan elkaar te plakken gebruik je de methode &lt;code&gt;orWhereProp&lt;/code&gt;. Voor alle andere soorten &lt;code&gt;whereProp&lt;/code&gt;-methode kan je op dezelfde manier de or voor de methodenaam plakken en dan worden de where-clausules met OR aan elkaar geplakt.<br /> <br /> === Overige &lt;code&gt;where&lt;/code&gt;-methoden ===<br /> <br /> Als je een WHERE-clausule wilt gebruiken kan je ipv &lt;code&gt;whereProp&lt;/code&gt; ook standaard &lt;code&gt;where&lt;/code&gt;-methoden gebruiken. Deze gebruik je op dezelfde manier als &lt;code&gt;whereProp&lt;/code&gt;-methoden, behalve dat je de Prop moet vervangen door het type van de value die je in je WHERE wilt gebruiken. Als je bv wilt kijken of een ID gelijk is aan een int, moet je &lt;code&gt;whereInt&lt;/code&gt; gebruiken.<br /> Haal alle Bugs op met melder_contactID gelijk aan 5794 (hier kan je als het lid-object van lidnr 5794 hebt ook whereProp gebruiken)<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $bugs = BugQuery::table()-&gt;whereInt('melder_contactID', 5794)-&gt;verzamel();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> Naast deze standaard &lt;code&gt;where&lt;/code&gt;-methode heb je ook de self explainatory methoden &lt;code&gt;whereNot&lt;/code&gt;, &lt;code&gt;whereIn&lt;/code&gt;, &lt;code&gt;whereNotIn&lt;/code&gt;, &lt;code&gt;whereLike&lt;/code&gt;, &lt;code&gt;whereNotLike&lt;/code&gt;, &lt;code&gt;whereNull&lt;/code&gt; en &lt;code&gt;whereNotNull&lt;/code&gt;. Let op dat je dus ook bij deze methoden het type van de value bij de methode naam moet zetten! Ook al deze methode kan je met een OR lijmen door or voor de methodenaam te zetten zoals bv bij &lt;code&gt;orWhereProp&lt;/code&gt;.<br /> <br /> === Nested where's &amp; Closures ===<br /> <br /> Stel, je wilt de volgende WHERE-clausule:<br /> WHERE (a = 0 OR a = 1) AND (a = 2 OR a = 3)<br /> Dit krijg je in de QueryBuilder dmv Closures in php. De bovenstaande where-prop krijg je als volgt<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> ...-&gt;where(function($q) use ($var1, $var2) {<br /> $q-&gt;whereInt('a', 0)<br /> -&gt;orWhereInt('a', 1);<br /> })-&gt;where(function($q) {<br /> $q-&gt;whereInt('a', 2)<br /> -&gt;orWhereInt('a', 3);<br /> })<br /> &lt;/syntaxhighlight&gt;<br /> <br /> In een where kan je dus een closure gebruiken om nested where's te krijgen.<br /> <br /> == Selects ==<br /> <br /> Om selects toe te voegen aan je query gebruik je de methode &lt;code&gt;select&lt;/code&gt;. Elk argument wat je aan de methode meegeeft wordt als select toegevoegd. Ipv de argumenten als strings mee te geven kan je ook een array toevoegen met een string als key en de select als value. Dan wordt de key de AS van de select.<br /> Om alle contactID's te selecteren van de Persoontable<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $ids = PersoonQuery::table()-&gt;select('contactID')-&gt;get();<br /> &lt;/syntaxhighlight&gt;<br /> Om alle contactID's als 'ID' en alle voornamen te selecteren van de Persoontable<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $ids = PersoonQuery::table()-&gt;select(array('ID' =&gt; 'contactID'), 'voornaam')-&gt;get();<br /> &lt;/syntaxhighlight&gt;<br /> Om selects distinct te maken kan je de methode &lt;code&gt;selectDistinct&lt;/code&gt; gebruiken.<br /> <br /> [[Category:WebCie]]</div>

Pepijno https://mediawiki.a-eskwadraat.nl/wiki/index.php/QueryBuilder 2017-02-28T21:05:14Z

<p>Pepijno: </p> <hr /> <div>Om SQL-queries makkelijker te maken heeft de WebCie haar eigen sql-library geschreven, de QueryBuilder. De QueryBuilder maakt queries op dmv van een QueryBuilder-object waaraan properties veranderd worden. Op die manier wordt de query pas gebouwd als de query uitgevoerd moet worden. Hierdoor is er meer mogelijkheid voor controle en sanity checks.<br /> <br /> De QueryBuilder bestaat uit de Query-klasse, de QueryBuilder-klasse en alle uitbreidingen. De Query-klasse is een extensie van de QueryBuilder-klasse. Het verschil tussen de twee klasses is dat de QueryBuilder-klasse wordt gebruikt om de query op te bouwen en de Query-klasse wordt gebruikt om van het geheel een werkende query te maken, alsmede verschillende functies zoals het verzamelen van objecten te implementeren.<br /> <br /> == QueryBuilder starten ==<br /> Omdat je een query altijd wilt gebruiken voor WhosWho4-objecten heeft elk WhosWho4-object zijn eigen query-classe die een uitbreiding is van de Query-klasse. Zo heb je bv de PersoonQuery-klasse en de LidQuery-klasse. Deze extensies hebben niet hun eigen speciale constructor. in plaats daarvan heeft elk van deze klassen de methode table waarmee een Query-klasse wordt aangemaakt, het object als table bij de query wordt gezet en het ObjectQuery-object wordt gereturnd zodat er meteen methoden op kunnen worden toegepast. Voor uitgebreide klasse zoals Persoon en Lid worden automatisch de onderliggende klassen gejoind zodat je dit niet zelf hoeft te doen en bij deze data kan.<br /> Een voorbeeld:<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = PersoonQuery::table();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> == Query uitvoeren ==<br /> Een query kan je uitvoeren met de methode &lt;code&gt;get&lt;/code&gt;. &lt;code&gt;get&lt;/code&gt; heeft geen argumenten nodig. Als je verder niets aan je Query-object hebt toegevoegd selecteert de query automatisch alle objecten in de table. Met het volgende voorbeeld worden alle entries uit de Persoon-table opgevraagd:<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $personen = PersoonQuery::table()-&gt;get();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;first&lt;/code&gt; ===<br /> De methode &lt;code&gt;first&lt;/code&gt; voert de query uit zoals &lt;code&gt;get&lt;/code&gt; dat doet en geeft vervolgens alleen het eerste resultaat terug. Met het volgende voorbeeld wordt de eerste entry uit de Persoon-table opgehaald:<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $personen = PersoonQuery::table()-&gt;first();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;aggregate&lt;/code&gt; (TODO: in de php-code moet deze functie nog worden aangepast) ===<br /> De methode &lt;code&gt;aggregate&lt;/code&gt; voert een aggregator uit op de query. De toegestane aggregators zijn: &lt;code&gt;COUNT&lt;/code&gt;, &lt;code&gt;SUM&lt;/code&gt;, &lt;code&gt;MAX&lt;/code&gt;, &lt;code&gt;MIN&lt;/code&gt; en &lt;code&gt;YEAR&lt;/code&gt;. De aggregator pakt op dit moment nog alles ipv een specifieke kolom. &lt;code&gt;aggregate&lt;/code&gt; haalt ook de huidige selectie weg. Een voorbeeld om alle entries in de Persoon-table te tellen:<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $aantal_personen = PersoonQuery::table()-&gt;aggregate('COUNT');<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;count&lt;/code&gt; ===<br /> Om makkelijker entries te tellen is de speciale methode &lt;code&gt;count&lt;/code&gt;. Deze methode telt het aantal entries en haalt ook de orderBys, limits en offset van de query weg.<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $aantal_personen = PersoonQuery::table()-&gt;count();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;verzamel&lt;/code&gt; ===<br /> De methode die het vaakst gebruikt wordt is &lt;code&gt;verzamel&lt;/code&gt;. Net zoals &lt;code&gt;verzamel&lt;/code&gt; van elke Verzameling van een WhosWho4-object verzamelt deze query-methode alle WhosWho4-objecten die met de query opgehaald worden. Hierbij verdwijnen alle huidige selects van de query. De methode kan twee argumenten krijgen: de naam van de klasse om de objecten van te verzamelen as string en of de objecten distinct moeten zijn als bool. Zonder argumenten is distinct true en worden de objecten opgehaald van de klasse waarvan je het query-object gemaakt hebt. Als voorbeeld, haal alle Persoon-objecten op:<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $persoon_objecten = PersoonQuery::table()-&gt;verzamel();<br /> &lt;/syntaxhighlight&gt;<br /> Haal alle distinct bugmelders op (dit voorbeeld gebruikt ook &lt;code&gt;join&lt;/code&gt;):<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $persoon_objecten = BugQuery::table()<br /> -&gt;join('Persoon')<br /> -&gt;verzamel('Persoon', true);<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;geef&lt;/code&gt; ===<br /> Net zoals de methode &lt;code&gt;geef&lt;/code&gt; voor objecten heeft de QueryBuilder een soortgelijke methode. De methode geeft een object terug die wordt opgevraagd dmv de query. Net als bij &lt;code&gt;verzamel&lt;/code&gt; heeft de methode een argument voor het soort object wat je op wilt halen.<br /> Geef het lid-object met ID 5794<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $persoon = PersoonQuery::table()<br /> -&gt;whereInt('contactID', 5794)<br /> -&gt;geef();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> == Joins ==<br /> De QueryBuilder heeft uiteraard ook de mogelijkheid om joins uit te voeren op tables. Nieuwe tabellen worden automatisch op de juiste velden gejoind, dus dit hoef je niet meer zelf te doen. Mocht de QueryBuilder het toch niet zelf kunnen, dan hebben de join-methoden extra argumenten nodig voor het joinen.<br /> <br /> === (left) &lt;code&gt;join&lt;/code&gt; ===<br /> De standaard &lt;code&gt;join&lt;/code&gt; is een left join. Je hoeft als enige argument de table mee te geven om op te joinen. Zo kan je bv de table Persoon joinen met Bug<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = BugQuery::table()-&gt;join('Persoon');<br /> &lt;/syntaxhighlight&gt;<br /> Als het echt nodig is kan je zelf de twee namen van de kolommen meegeven waarop gejoined moet worden<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = BugQuery::table()-&gt;join('Persoon', 'Bug.melder_contactID', 'Persoon.contactID');<br /> &lt;/syntaxhighlight&gt;<br /> <br /> Je kan ook ipv een string als naam voor de table bij je join een array plaatsen met als key een string en als value je tablename. De key wordt dan de AS in de query. Dus om in bovenstaand voorbeelde de table Persoon AS p te joinen<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = BugQuery::table()-&gt;join(array('p' =&gt; 'Persoon'));<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;rightJoin&lt;/code&gt; ===<br /> De &lt;code&gt;rightJoin&lt;/code&gt; werkt hetzelfde als &lt;code&gt;join&lt;/code&gt; alleen voert het een right join uit ipv een left join.<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = BugQuery::table()-&gt;rightJoin('Persoon');<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;innerJoin&lt;/code&gt; ===<br /> De &lt;code&gt;innerJoin&lt;/code&gt; werkt ook hetzelfde als &lt;code&gt;join&lt;/code&gt; alleen voert het een inner join uit ipv een left join.<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = BugQuery::table()-&gt;innerJoin('Persoon');<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;fullJoin&lt;/code&gt; ===<br /> De &lt;code&gt;fullJoin&lt;/code&gt; werkt ook hetzelfde als &lt;code&gt;join&lt;/code&gt; alleen voert het een full join uit ipv een left join.<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = BugQuery::table()-&gt;fullJoin('Persoon');<br /> &lt;/syntaxhighlight&gt;<br /> <br /> == Where ==<br /> Uiteraard heeft een query ook where's nodig. Daarom heeft de QueryBuilder verschillende methoden om where toe te voegen.<br /> <br /> === &lt;code&gt;whereProp&lt;/code&gt; ===<br /> De belangrijkste where-methode is &lt;code&gt;whereProp&lt;/code&gt;. Met deze methode wordt de where automatisch uitgevoerd op een eigenschap van de objecten waarvan de tables in de query zitten (met from of dmv een join). Hiervoor is het ook nodig dat waarmee je wilt matchen in je where van het juiste type is. Zo is een ID een int en wil je daar dus geen string voor meegeven. De whereProp zoekt ook automatisch de table waarbij de property hoort. Als er meerdere mogelijkheden zijn kan je er altijd 'tablename.' voor zetten, net zoals met normale sql.<br /> <br /> Je kan &lt;code&gt;whereProp&lt;/code&gt; twee of drie argumenten meegeven. Als je twee argumenten meegeeft wordt er een match op gelijkheid aan je query toegevoegd. Hierbij is het eerste argument welke property je wilt matchen en je tweede argument waarmee gematcht wordt.<br /> Selecteer alle Bugs met melder $melder ($melder moet een Persoonobject zijn)<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $bugs = BugQuery::table()-&gt;whereProp('melder', $melder)-&gt;verzamel();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> Als je drie argumenten meegeeft is het eerste argument nog steeds welke property je wilt matchen, je tweede argument is je operator en je derde argument is waarmee gematcht wordt. De mogelijkheden voor de operatoren zijn <br /> Selecteer alle Bugs waarvan melder niet $melder is ($melder moet een Persoonobject zijn)<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $bugs = BugQuery::table()-&gt;whereProp('melder', '!=', $melder)-&gt;verzamel();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;whereProp&lt;/code&gt; varianten ===<br /> <br /> Met de standaard &lt;code&gt;whereProp&lt;/code&gt; kan je alleen een paar operatoren toevoegen aan je where. Daarom zijn er de methoden &lt;code&gt;whereNotProp&lt;/code&gt;, &lt;code&gt;whereLikeProp&lt;/code&gt;, &lt;code&gt;whereNotLikeProp&lt;/code&gt;, &lt;code&gt;whereInProp&lt;/code&gt; en &lt;code&gt;whereNotInProp&lt;/code&gt;. Wat deze methoden doen zit in de naam van de methoden. Voor de &lt;code&gt;whereLikeProp&lt;/code&gt; en &lt;code&gt;whereNotLikeProp&lt;/code&gt; heb je twee argumenten nodig, als eerste de property en als tweede de string. Voor de methoden &lt;code&gt;whereInProp&lt;/code&gt; en &lt;code&gt;whereNotInProp&lt;/code&gt; heb je ook twee argumenten nodig, de property en als tweede de array waar de property in moet zitten.<br /> Haal alle bugs op waarbij het email de string 'pepijno' bevat<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $bugs = BugQuery::table()-&gt;wherePropLike('melderEmail', '%pepijno%')-&gt;verzamel();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === OR ipv AND ===<br /> <br /> Als je meerdere &lt;code&gt;whereProp&lt;/code&gt;-methoden hebt worden ze in de WHERE automatisch aan elkaar geplakt met het AND keyword. Om ze met OR aan elkaar te plakken gebruik je de methode &lt;code&gt;orWhereProp&lt;/code&gt;. Voor alle andere soorten &lt;code&gt;whereProp&lt;/code&gt;-methode kan je op dezelfde manier de or voor de methodenaam plakken en dan worden de where-clausules met OR aan elkaar geplakt.<br /> <br /> === Overige &lt;code&gt;where&lt;/code&gt;-methoden ===<br /> <br /> Als je een WHERE-clausule wilt gebruiken kan je ipv &lt;code&gt;whereProp&lt;/code&gt; ook standaard &lt;code&gt;where&lt;/code&gt;-methoden gebruiken. Deze gebruik je op dezelfde manier als &lt;code&gt;whereProp&lt;/code&gt;-methoden, behalve dat je de Prop moet vervangen door het type van de value die je in je WHERE wilt gebruiken. Als je bv wilt kijken of een ID gelijk is aan een int, moet je &lt;code&gt;whereInt&lt;/code&gt; gebruiken.<br /> Haal alle Bugs op met melder_contactID gelijk aan 5794 (hier kan je als het lid-object van lidnr 5794 hebt ook whereProp gebruiken)<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $bugs = BugQuery::table()-&gt;whereInt('melder_contactID', 5794)-&gt;verzamel();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> Naast deze standaard &lt;code&gt;where&lt;/code&gt;-methode heb je ook de self explainatory methoden &lt;code&gt;whereNot&lt;/code&gt;, &lt;code&gt;whereIn&lt;/code&gt;, &lt;code&gt;whereNotIn&lt;/code&gt;, &lt;code&gt;whereLike&lt;/code&gt;, &lt;code&gt;whereNotLike&lt;/code&gt;, &lt;code&gt;whereNull&lt;/code&gt; en &lt;code&gt;whereNotNull&lt;/code&gt;. Let op dat je dus ook bij deze methoden het type van de value bij de methode naam moet zetten! Ook al deze methode kan je met een OR lijmen door or voor de methodenaam te zetten zoals bv bij &lt;code&gt;orWhereProp&lt;/code&gt;.<br /> <br /> === Nested where's &amp; Closures ===<br /> <br /> Stel, je wilt de volgende WHERE-clausule:<br /> WHERE (a = 0 OR a = 1) AND (a = 2 OR a = 3)<br /> Dit krijg je in de QueryBuilder dmv Closures in php. De bovenstaande where-prop krijg je als volgt<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> ...-&gt;where(function($q) use ($var1, $var2) {<br /> $q-&gt;whereInt('a', 0)<br /> -&gt;orWhereInt('a', 1);<br /> })-&gt;where(function($q) {<br /> $q-&gt;whereInt('a', 2)<br /> -&gt;orWhereInt('a', 3);<br /> })<br /> &lt;/syntaxhighlight&gt;<br /> <br /> In een where kan je dus een closure gebruiken om nested where's te krijgen.<br /> <br /> == Selects ==<br /> <br /> Om selects toe te voegen aan je query gebruik je de methode &lt;code&gt;select&lt;/code&gt;. Elk argument wat je aan de methode meegeeft wordt als select toegevoegd. Ipv de argumenten als strings mee te geven kan je ook een array toevoegen met een string als key en de select als value. Dan wordt de key de AS van de select.<br /> Om alle contactID's te selecteren van de Persoontable<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $ids = PersoonQuery::table()-&gt;select('contactID')-&gt;get();<br /> &lt;/syntaxhighlight&gt;<br /> Om alle contactID's als 'ID' en alle voornamen te selecteren van de Persoontable<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $ids = PersoonQuery::table()-&gt;select(array('ID' =&gt; 'contactID'), 'voornaam')-&gt;get();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> [[Category:WebCie]]</div>

Pepijno https://mediawiki.a-eskwadraat.nl/wiki/index.php/QueryBuilder 2017-02-28T20:54:52Z

<p>Pepijno: /* Joins */</p> <hr /> <div>Om SQL-queries makkelijker te maken heeft de WebCie haar eigen sql-library geschreven, de QueryBuilder. De QueryBuilder maakt queries op dmv van een QueryBuilder-object waaraan properties veranderd worden. Op die manier wordt de query pas gebouwd als de query uitgevoerd moet worden. Hierdoor is er meer mogelijkheid voor controle en sanity checks.<br /> <br /> De QueryBuilder bestaat uit de Query-klasse, de QueryBuilder-klasse en alle uitbreidingen. De Query-klasse is een extensie van de QueryBuilder-klasse. Het verschil tussen de twee klasses is dat de QueryBuilder-klasse wordt gebruikt om de query op te bouwen en de Query-klasse wordt gebruikt om van het geheel een werkende query te maken, alsmede verschillende functies zoals het verzamelen van objecten te implementeren.<br /> <br /> == QueryBuilder starten ==<br /> Omdat je een query altijd wilt gebruiken voor WhosWho4-objecten heeft elk WhosWho4-object zijn eigen query-classe die een uitbreiding is van de Query-klasse. Zo heb je bv de PersoonQuery-klasse en de LidQuery-klasse. Deze extensies hebben niet hun eigen speciale constructor. in plaats daarvan heeft elk van deze klassen de methode table waarmee een Query-klasse wordt aangemaakt, het object als table bij de query wordt gezet en het ObjectQuery-object wordt gereturnd zodat er meteen methoden op kunnen worden toegepast. Voor uitgebreide klasse zoals Persoon en Lid worden automatisch de onderliggende klassen gejoind zodat je dit niet zelf hoeft te doen en bij deze data kan.<br /> Een voorbeeld:<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = PersoonQuery::table();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> == Query uitvoeren ==<br /> Een query kan je uitvoeren met de methode &lt;code&gt;get&lt;/code&gt;. &lt;code&gt;get&lt;/code&gt; heeft geen argumenten nodig. Als je verder niets aan je Query-object hebt toegevoegd selecteert de query automatisch alle objecten in de table. Met het volgende voorbeeld worden alle entries uit de Persoon-table opgevraagd:<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $personen = PersoonQuery::table()-&gt;get();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;first&lt;/code&gt; ===<br /> De methode &lt;code&gt;first&lt;/code&gt; voert de query uit zoals &lt;code&gt;get&lt;/code&gt; dat doet en geeft vervolgens alleen het eerste resultaat terug. Met het volgende voorbeeld wordt de eerste entry uit de Persoon-table opgehaald:<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $personen = PersoonQuery::table()-&gt;first();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;aggregate&lt;/code&gt; (TODO: in de php-code moet deze functie nog worden aangepast) ===<br /> De methode &lt;code&gt;aggregate&lt;/code&gt; voert een aggregator uit op de query. De toegestane aggregators zijn: &lt;code&gt;COUNT&lt;/code&gt;, &lt;code&gt;SUM&lt;/code&gt;, &lt;code&gt;MAX&lt;/code&gt;, &lt;code&gt;MIN&lt;/code&gt; en &lt;code&gt;YEAR&lt;/code&gt;. De aggregator pakt op dit moment nog alles ipv een specifieke kolom. &lt;code&gt;aggregate&lt;/code&gt; haalt ook de huidige selectie weg. Een voorbeeld om alle entries in de Persoon-table te tellen:<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $aantal_personen = PersoonQuery::table()-&gt;aggregate('COUNT');<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;count&lt;/code&gt; ===<br /> Om makkelijker entries te tellen is de speciale methode &lt;code&gt;count&lt;/code&gt;. Deze methode telt het aantal entries en haalt ook de orderBys, limits en offset van de query weg.<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $aantal_personen = PersoonQuery::table()-&gt;count();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;verzamel&lt;/code&gt; ===<br /> De methode die het vaakst gebruikt wordt is &lt;code&gt;verzamel&lt;/code&gt;. Net zoals &lt;code&gt;verzamel&lt;/code&gt; van elke Verzameling van een WhosWho4-object verzamelt deze query-methode alle WhosWho4-objecten die met de query opgehaald worden. Hierbij verdwijnen alle huidige selects van de query. De methode kan twee argumenten krijgen: de naam van de klasse om de objecten van te verzamelen as string en of de objecten distinct moeten zijn als bool. Zonder argumenten is distinct true en worden de objecten opgehaald van de klasse waarvan je het query-object gemaakt hebt. Als voorbeeld, haal alle Persoon-objecten op:<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $persoon_objecten = PersoonQuery::table()-&gt;verzamel();<br /> &lt;/syntaxhighlight&gt;<br /> Haal alle distinct bugmelders op (dit voorbeeld gebruikt ook &lt;code&gt;join&lt;/code&gt;):<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $persoon_objecten = BugQuery::table()<br /> -&gt;join('Persoon')<br /> -&gt;verzamel('Persoon', true);<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;geef&lt;/code&gt; ===<br /> Net zoals de methode &lt;code&gt;geef&lt;/code&gt; voor objecten heeft de QueryBuilder een soortgelijke methode. De methode geeft een object terug die wordt opgevraagd dmv de query. Net als bij &lt;code&gt;verzamel&lt;/code&gt; heeft de methode een argument voor het soort object wat je op wilt halen.<br /> Geef het lid-object met ID 5794<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $persoon = PersoonQuery::table()<br /> -&gt;whereInt('contactID', 5794)<br /> -&gt;geef();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> == Joins ==<br /> De QueryBuilder heeft uiteraard ook de mogelijkheid om joins uit te voeren op tables. Nieuwe tabellen worden automatisch op de juiste velden gejoind, dus dit hoef je niet meer zelf te doen. Mocht de QueryBuilder het toch niet zelf kunnen, dan hebben de join-methoden extra argumenten nodig voor het joinen.<br /> <br /> === (left) &lt;code&gt;join&lt;/code&gt; ===<br /> De standaard &lt;code&gt;join&lt;/code&gt; is een left join. Je hoeft als enige argument de table mee te geven om op te joinen. Zo kan je bv de table Persoon joinen met Bug<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = BugQuery::table()-&gt;join('Persoon');<br /> &lt;/syntaxhighlight&gt;<br /> Als het echt nodig is kan je zelf de twee namen van de kolommen meegeven waarop gejoined moet worden<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = BugQuery::table()-&gt;join('Persoon', 'Bug.melder_contactID', 'Persoon.contactID');<br /> &lt;/syntaxhighlight&gt;<br /> <br /> Je kan ook ipv een string als naam voor de table bij je join een array plaatsen met als key een string en als value je tablename. De key wordt dan de AS in de query. Dus om in bovenstaand voorbeelde de table Persoon AS p te joinen<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = BugQuery::table()-&gt;join(array('p' =&gt; 'Persoon'));<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;rightJoin&lt;/code&gt; ===<br /> De &lt;code&gt;rightJoin&lt;/code&gt; werkt hetzelfde als &lt;code&gt;join&lt;/code&gt; alleen voert het een right join uit ipv een left join.<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = BugQuery::table()-&gt;rightJoin('Persoon');<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;innerJoin&lt;/code&gt; ===<br /> De &lt;code&gt;innerJoin&lt;/code&gt; werkt ook hetzelfde als &lt;code&gt;join&lt;/code&gt; alleen voert het een inner join uit ipv een left join.<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = BugQuery::table()-&gt;innerJoin('Persoon');<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;fullJoin&lt;/code&gt; ===<br /> De &lt;code&gt;fullJoin&lt;/code&gt; werkt ook hetzelfde als &lt;code&gt;join&lt;/code&gt; alleen voert het een full join uit ipv een left join.<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = BugQuery::table()-&gt;fullJoin('Persoon');<br /> &lt;/syntaxhighlight&gt;<br /> <br /> == Where ==<br /> Uiteraard heeft een query ook where's nodig. Daarom heeft de QueryBuilder verschillende methoden om where toe te voegen.<br /> <br /> === &lt;code&gt;whereProp&lt;/code&gt; ===<br /> De belangrijkste where-methode is &lt;code&gt;whereProp&lt;/code&gt;. Met deze methode wordt de where automatisch uitgevoerd op een eigenschap van de objecten waarvan de tables in de query zitten (met from of dmv een join). Hiervoor is het ook nodig dat waarmee je wilt matchen in je where van het juiste type is. Zo is een ID een int en wil je daar dus geen string voor meegeven. De whereProp zoekt ook automatisch de table waarbij de property hoort. Als er meerdere mogelijkheden zijn kan je er altijd 'tablename.' voor zetten, net zoals met normale sql.<br /> <br /> Je kan &lt;code&gt;whereProp&lt;/code&gt; twee of drie argumenten meegeven. Als je twee argumenten meegeeft wordt er een match op gelijkheid aan je query toegevoegd. Hierbij is het eerste argument welke property je wilt matchen en je tweede argument waarmee gematcht wordt.<br /> Selecteer alle Bugs met melder $melder ($melder moet een Persoonobject zijn)<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $bugs = BugQuery::table()-&gt;whereProp('melder', $melder)-&gt;verzamel();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> Als je drie argumenten meegeeft is het eerste argument nog steeds welke property je wilt matchen, je tweede argument is je operator en je derde argument is waarmee gematcht wordt. De mogelijkheden voor de operatoren zijn <br /> Selecteer alle Bugs waarvan melder niet $melder is ($melder moet een Persoonobject zijn)<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $bugs = BugQuery::table()-&gt;whereProp('melder', '!=', $melder)-&gt;verzamel();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;whereProp&lt;/code&gt; varianten ===<br /> <br /> Met de standaard &lt;code&gt;whereProp&lt;/code&gt; kan je alleen een paar operatoren toevoegen aan je where. Daarom zijn er de methoden &lt;code&gt;whereNotProp&lt;/code&gt;, &lt;code&gt;whereLikeProp&lt;/code&gt;, &lt;code&gt;whereNotLikeProp&lt;/code&gt;, &lt;code&gt;whereInProp&lt;/code&gt; en &lt;code&gt;whereNotInProp&lt;/code&gt;. Wat deze methoden doen zit in de naam van de methoden. Voor de &lt;code&gt;whereLikeProp&lt;/code&gt; en &lt;code&gt;whereNotLikeProp&lt;/code&gt; heb je twee argumenten nodig, als eerste de property en als tweede de string. Voor de methoden &lt;code&gt;whereInProp&lt;/code&gt; en &lt;code&gt;whereNotInProp&lt;/code&gt; heb je ook twee argumenten nodig, de property en als tweede de array waar de property in moet zitten.<br /> Haal alle bugs op waarbij het email de string 'pepijno' bevat<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $bugs = BugQuery::table()-&gt;wherePropLike('melderEmail', '%pepijno%')-&gt;verzamel();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === OR ipv AND ===<br /> <br /> Als je meerdere &lt;code&gt;whereProp&lt;/code&gt;-methoden hebt worden ze in de WHERE automatisch aan elkaar geplakt met het AND keyword. Om ze met OR aan elkaar te plakken gebruik je de methode &lt;code&gt;orWhereProp&lt;/code&gt;. Voor alle andere soorten &lt;code&gt;whereProp&lt;/code&gt;-methode kan je op dezelfde manier de or voor de methodenaam plakken en dan worden de where-clausules met OR aan elkaar geplakt.<br /> <br /> === Overige &lt;code&gt;where&lt;/code&gt;-methoden ===<br /> <br /> Als je een WHERE-clausule wilt gebruiken kan je ipv &lt;code&gt;whereProp&lt;/code&gt; ook standaard &lt;code&gt;where&lt;/code&gt;-methoden gebruiken. Deze gebruik je op dezelfde manier als &lt;code&gt;whereProp&lt;/code&gt;-methoden, behalve dat je de Prop moet vervangen door het type van de value die je in je WHERE wilt gebruiken. Als je bv wilt kijken of een ID gelijk is aan een int, moet je &lt;code&gt;whereInt&lt;/code&gt; gebruiken.<br /> Haal alle Bugs op met melder_contactID gelijk aan 5794 (hier kan je als het lid-object van lidnr 5794 hebt ook whereProp gebruiken)<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $bugs = BugQuery::table()-&gt;whereInt('melder_contactID', 5794)-&gt;verzamel();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> Naast deze standaard &lt;code&gt;where&lt;/code&gt;-methode heb je ook de self explainatory methoden &lt;code&gt;whereNot&lt;/code&gt;, &lt;code&gt;whereIn&lt;/code&gt;, &lt;code&gt;whereNotIn&lt;/code&gt;, &lt;code&gt;whereLike&lt;/code&gt;, &lt;code&gt;whereNotLike&lt;/code&gt;, &lt;code&gt;whereNull&lt;/code&gt; en &lt;code&gt;whereNotNull&lt;/code&gt;. Let op dat je dus ook bij deze methoden het type van de value bij de methode naam moet zetten! Ook al deze methode kan je met een OR lijmen door or voor de methodenaam te zetten zoals bv bij &lt;code&gt;orWhereProp&lt;/code&gt;.<br /> <br /> === Nested where's &amp; Closures ===<br /> <br /> Stel, je wilt de volgende WHERE-clausule:<br /> WHERE (a = 0 OR a = 1) AND (a = 2 OR a = 3)<br /> Dit krijg je in de QueryBuilder dmv Closures in php. De bovenstaande where-prop krijg je als volgt<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> ...-&gt;where(function($q) use ($var1, $var2) {<br /> $q-&gt;whereInt('a', 0)<br /> -&gt;orWhereInt('a', 1);<br /> })-&gt;where(function($q) {<br /> $q-&gt;whereInt('a', 2)<br /> -&gt;orWhereInt('a', 3);<br /> })<br /> &lt;/syntaxhighlight&gt;<br /> <br /> In een where kan je dus een closure gebruiken om nested where's te krijgen.<br /> <br /> == Selects ==<br /> <br /> Om selects toe te voegen aan je query kan <br /> <br /> [[Category:WebCie]]</div>

Pepijno https://mediawiki.a-eskwadraat.nl/wiki/index.php/QueryBuilder 2017-02-28T20:52:18Z

<p>Pepijno: </p> <hr /> <div>Om SQL-queries makkelijker te maken heeft de WebCie haar eigen sql-library geschreven, de QueryBuilder. De QueryBuilder maakt queries op dmv van een QueryBuilder-object waaraan properties veranderd worden. Op die manier wordt de query pas gebouwd als de query uitgevoerd moet worden. Hierdoor is er meer mogelijkheid voor controle en sanity checks.<br /> <br /> De QueryBuilder bestaat uit de Query-klasse, de QueryBuilder-klasse en alle uitbreidingen. De Query-klasse is een extensie van de QueryBuilder-klasse. Het verschil tussen de twee klasses is dat de QueryBuilder-klasse wordt gebruikt om de query op te bouwen en de Query-klasse wordt gebruikt om van het geheel een werkende query te maken, alsmede verschillende functies zoals het verzamelen van objecten te implementeren.<br /> <br /> == QueryBuilder starten ==<br /> Omdat je een query altijd wilt gebruiken voor WhosWho4-objecten heeft elk WhosWho4-object zijn eigen query-classe die een uitbreiding is van de Query-klasse. Zo heb je bv de PersoonQuery-klasse en de LidQuery-klasse. Deze extensies hebben niet hun eigen speciale constructor. in plaats daarvan heeft elk van deze klassen de methode table waarmee een Query-klasse wordt aangemaakt, het object als table bij de query wordt gezet en het ObjectQuery-object wordt gereturnd zodat er meteen methoden op kunnen worden toegepast. Voor uitgebreide klasse zoals Persoon en Lid worden automatisch de onderliggende klassen gejoind zodat je dit niet zelf hoeft te doen en bij deze data kan.<br /> Een voorbeeld:<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = PersoonQuery::table();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> == Query uitvoeren ==<br /> Een query kan je uitvoeren met de methode &lt;code&gt;get&lt;/code&gt;. &lt;code&gt;get&lt;/code&gt; heeft geen argumenten nodig. Als je verder niets aan je Query-object hebt toegevoegd selecteert de query automatisch alle objecten in de table. Met het volgende voorbeeld worden alle entries uit de Persoon-table opgevraagd:<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $personen = PersoonQuery::table()-&gt;get();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;first&lt;/code&gt; ===<br /> De methode &lt;code&gt;first&lt;/code&gt; voert de query uit zoals &lt;code&gt;get&lt;/code&gt; dat doet en geeft vervolgens alleen het eerste resultaat terug. Met het volgende voorbeeld wordt de eerste entry uit de Persoon-table opgehaald:<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $personen = PersoonQuery::table()-&gt;first();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;aggregate&lt;/code&gt; (TODO: in de php-code moet deze functie nog worden aangepast) ===<br /> De methode &lt;code&gt;aggregate&lt;/code&gt; voert een aggregator uit op de query. De toegestane aggregators zijn: &lt;code&gt;COUNT&lt;/code&gt;, &lt;code&gt;SUM&lt;/code&gt;, &lt;code&gt;MAX&lt;/code&gt;, &lt;code&gt;MIN&lt;/code&gt; en &lt;code&gt;YEAR&lt;/code&gt;. De aggregator pakt op dit moment nog alles ipv een specifieke kolom. &lt;code&gt;aggregate&lt;/code&gt; haalt ook de huidige selectie weg. Een voorbeeld om alle entries in de Persoon-table te tellen:<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $aantal_personen = PersoonQuery::table()-&gt;aggregate('COUNT');<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;count&lt;/code&gt; ===<br /> Om makkelijker entries te tellen is de speciale methode &lt;code&gt;count&lt;/code&gt;. Deze methode telt het aantal entries en haalt ook de orderBys, limits en offset van de query weg.<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $aantal_personen = PersoonQuery::table()-&gt;count();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;verzamel&lt;/code&gt; ===<br /> De methode die het vaakst gebruikt wordt is &lt;code&gt;verzamel&lt;/code&gt;. Net zoals &lt;code&gt;verzamel&lt;/code&gt; van elke Verzameling van een WhosWho4-object verzamelt deze query-methode alle WhosWho4-objecten die met de query opgehaald worden. Hierbij verdwijnen alle huidige selects van de query. De methode kan twee argumenten krijgen: de naam van de klasse om de objecten van te verzamelen as string en of de objecten distinct moeten zijn als bool. Zonder argumenten is distinct true en worden de objecten opgehaald van de klasse waarvan je het query-object gemaakt hebt. Als voorbeeld, haal alle Persoon-objecten op:<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $persoon_objecten = PersoonQuery::table()-&gt;verzamel();<br /> &lt;/syntaxhighlight&gt;<br /> Haal alle distinct bugmelders op (dit voorbeeld gebruikt ook &lt;code&gt;join&lt;/code&gt;):<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $persoon_objecten = BugQuery::table()<br /> -&gt;join('Persoon')<br /> -&gt;verzamel('Persoon', true);<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;geef&lt;/code&gt; ===<br /> Net zoals de methode &lt;code&gt;geef&lt;/code&gt; voor objecten heeft de QueryBuilder een soortgelijke methode. De methode geeft een object terug die wordt opgevraagd dmv de query. Net als bij &lt;code&gt;verzamel&lt;/code&gt; heeft de methode een argument voor het soort object wat je op wilt halen.<br /> Geef het lid-object met ID 5794<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $persoon = PersoonQuery::table()<br /> -&gt;whereInt('contactID', 5794)<br /> -&gt;geef();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> == Joins ==<br /> De QueryBuilder heeft uiteraard ook de mogelijkheid om joins uit te voeren op tables. Nieuwe tabellen worden automatisch op de juiste velden gejoind, dus dit hoef je niet meer zelf te doen. Mocht de QueryBuilder het toch niet zelf kunnen, dan hebben de join-methoden extra argumenten nodig voor het joinen.<br /> <br /> === (left) &lt;code&gt;join&lt;/code&gt; ===<br /> De standaard &lt;code&gt;join&lt;/code&gt; is een left join. Je hoeft als enige argument de table mee te geven om op te joinen. Zo kan je bv de table Persoon joinen met Bug<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = BugQuery::table()-&gt;join('Persoon');<br /> &lt;/syntaxhighlight&gt;<br /> Als het echt nodig is kan je zelf de twee namen van de kolommen meegeven waarop gejoined moet worden<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = BugQuery::table()-&gt;join('Persoon', 'Bug.melder_contactID', 'Persoon.contactID');<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;rightJoin&lt;/code&gt; ===<br /> De &lt;code&gt;rightJoin&lt;/code&gt; werkt hetzelfde als &lt;code&gt;join&lt;/code&gt; alleen voert het een right join uit ipv een left join.<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = BugQuery::table()-&gt;rightJoin('Persoon');<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;innerJoin&lt;/code&gt; ===<br /> De &lt;code&gt;innerJoin&lt;/code&gt; werkt ook hetzelfde als &lt;code&gt;join&lt;/code&gt; alleen voert het een inner join uit ipv een left join.<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = BugQuery::table()-&gt;innerJoin('Persoon');<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;fullJoin&lt;/code&gt; ===<br /> De &lt;code&gt;fullJoin&lt;/code&gt; werkt ook hetzelfde als &lt;code&gt;join&lt;/code&gt; alleen voert het een full join uit ipv een left join.<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = BugQuery::table()-&gt;fullJoin('Persoon');<br /> &lt;/syntaxhighlight&gt;<br /> <br /> == Where ==<br /> Uiteraard heeft een query ook where's nodig. Daarom heeft de QueryBuilder verschillende methoden om where toe te voegen.<br /> <br /> === &lt;code&gt;whereProp&lt;/code&gt; ===<br /> De belangrijkste where-methode is &lt;code&gt;whereProp&lt;/code&gt;. Met deze methode wordt de where automatisch uitgevoerd op een eigenschap van de objecten waarvan de tables in de query zitten (met from of dmv een join). Hiervoor is het ook nodig dat waarmee je wilt matchen in je where van het juiste type is. Zo is een ID een int en wil je daar dus geen string voor meegeven. De whereProp zoekt ook automatisch de table waarbij de property hoort. Als er meerdere mogelijkheden zijn kan je er altijd 'tablename.' voor zetten, net zoals met normale sql.<br /> <br /> Je kan &lt;code&gt;whereProp&lt;/code&gt; twee of drie argumenten meegeven. Als je twee argumenten meegeeft wordt er een match op gelijkheid aan je query toegevoegd. Hierbij is het eerste argument welke property je wilt matchen en je tweede argument waarmee gematcht wordt.<br /> Selecteer alle Bugs met melder $melder ($melder moet een Persoonobject zijn)<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $bugs = BugQuery::table()-&gt;whereProp('melder', $melder)-&gt;verzamel();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> Als je drie argumenten meegeeft is het eerste argument nog steeds welke property je wilt matchen, je tweede argument is je operator en je derde argument is waarmee gematcht wordt. De mogelijkheden voor de operatoren zijn <br /> Selecteer alle Bugs waarvan melder niet $melder is ($melder moet een Persoonobject zijn)<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $bugs = BugQuery::table()-&gt;whereProp('melder', '!=', $melder)-&gt;verzamel();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;whereProp&lt;/code&gt; varianten ===<br /> <br /> Met de standaard &lt;code&gt;whereProp&lt;/code&gt; kan je alleen een paar operatoren toevoegen aan je where. Daarom zijn er de methoden &lt;code&gt;whereNotProp&lt;/code&gt;, &lt;code&gt;whereLikeProp&lt;/code&gt;, &lt;code&gt;whereNotLikeProp&lt;/code&gt;, &lt;code&gt;whereInProp&lt;/code&gt; en &lt;code&gt;whereNotInProp&lt;/code&gt;. Wat deze methoden doen zit in de naam van de methoden. Voor de &lt;code&gt;whereLikeProp&lt;/code&gt; en &lt;code&gt;whereNotLikeProp&lt;/code&gt; heb je twee argumenten nodig, als eerste de property en als tweede de string. Voor de methoden &lt;code&gt;whereInProp&lt;/code&gt; en &lt;code&gt;whereNotInProp&lt;/code&gt; heb je ook twee argumenten nodig, de property en als tweede de array waar de property in moet zitten.<br /> Haal alle bugs op waarbij het email de string 'pepijno' bevat<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $bugs = BugQuery::table()-&gt;wherePropLike('melderEmail', '%pepijno%')-&gt;verzamel();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === OR ipv AND ===<br /> <br /> Als je meerdere &lt;code&gt;whereProp&lt;/code&gt;-methoden hebt worden ze in de WHERE automatisch aan elkaar geplakt met het AND keyword. Om ze met OR aan elkaar te plakken gebruik je de methode &lt;code&gt;orWhereProp&lt;/code&gt;. Voor alle andere soorten &lt;code&gt;whereProp&lt;/code&gt;-methode kan je op dezelfde manier de or voor de methodenaam plakken en dan worden de where-clausules met OR aan elkaar geplakt.<br /> <br /> === Overige &lt;code&gt;where&lt;/code&gt;-methoden ===<br /> <br /> Als je een WHERE-clausule wilt gebruiken kan je ipv &lt;code&gt;whereProp&lt;/code&gt; ook standaard &lt;code&gt;where&lt;/code&gt;-methoden gebruiken. Deze gebruik je op dezelfde manier als &lt;code&gt;whereProp&lt;/code&gt;-methoden, behalve dat je de Prop moet vervangen door het type van de value die je in je WHERE wilt gebruiken. Als je bv wilt kijken of een ID gelijk is aan een int, moet je &lt;code&gt;whereInt&lt;/code&gt; gebruiken.<br /> Haal alle Bugs op met melder_contactID gelijk aan 5794 (hier kan je als het lid-object van lidnr 5794 hebt ook whereProp gebruiken)<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $bugs = BugQuery::table()-&gt;whereInt('melder_contactID', 5794)-&gt;verzamel();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> Naast deze standaard &lt;code&gt;where&lt;/code&gt;-methode heb je ook de self explainatory methoden &lt;code&gt;whereNot&lt;/code&gt;, &lt;code&gt;whereIn&lt;/code&gt;, &lt;code&gt;whereNotIn&lt;/code&gt;, &lt;code&gt;whereLike&lt;/code&gt;, &lt;code&gt;whereNotLike&lt;/code&gt;, &lt;code&gt;whereNull&lt;/code&gt; en &lt;code&gt;whereNotNull&lt;/code&gt;. Let op dat je dus ook bij deze methoden het type van de value bij de methode naam moet zetten! Ook al deze methode kan je met een OR lijmen door or voor de methodenaam te zetten zoals bv bij &lt;code&gt;orWhereProp&lt;/code&gt;.<br /> <br /> === Nested where's &amp; Closures ===<br /> <br /> Stel, je wilt de volgende WHERE-clausule:<br /> WHERE (a = 0 OR a = 1) AND (a = 2 OR a = 3)<br /> Dit krijg je in de QueryBuilder dmv Closures in php. De bovenstaande where-prop krijg je als volgt<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> ...-&gt;where(function($q) use ($var1, $var2) {<br /> $q-&gt;whereInt('a', 0)<br /> -&gt;orWhereInt('a', 1);<br /> })-&gt;where(function($q) {<br /> $q-&gt;whereInt('a', 2)<br /> -&gt;orWhereInt('a', 3);<br /> })<br /> &lt;/syntaxhighlight&gt;<br /> <br /> In een where kan je dus een closure gebruiken om nested where's te krijgen.<br /> <br /> == Selects ==<br /> <br /> Om selects toe te voegen aan je query kan <br /> <br /> [[Category:WebCie]]</div>

Pepijno https://mediawiki.a-eskwadraat.nl/wiki/index.php/QueryBuilder 2017-02-28T20:50:14Z

<p>Pepijno: /* Nested where's &amp; Closures */</p> <hr /> <div>Om SQL-queries makkelijker te maken heeft de WebCie haar eigen sql-library geschreven, de QueryBuilder. De QueryBuilder maakt queries op dmv van een QueryBuilder-object waaraan properties veranderd worden. Op die manier wordt de query pas gebouwd als de query uitgevoerd moet worden. Hierdoor is er meer mogelijkheid voor controle en sanity checks.<br /> <br /> De QueryBuilder bestaat uit de Query-klasse, de QueryBuilder-klasse en alle uitbreidingen. De Query-klasse is een extensie van de QueryBuilder-klasse. Het verschil tussen de twee klasses is dat de QueryBuilder-klasse wordt gebruikt om de query op te bouwen en de Query-klasse wordt gebruikt om van het geheel een werkende query te maken, alsmede verschillende functies zoals het verzamelen van objecten te implementeren.<br /> <br /> == QueryBuilder starten ==<br /> Omdat je een query altijd wilt gebruiken voor WhosWho4-objecten heeft elk WhosWho4-object zijn eigen query-classe die een uitbreiding is van de Query-klasse. Zo heb je bv de PersoonQuery-klasse en de LidQuery-klasse. Deze extensies hebben niet hun eigen speciale constructor. in plaats daarvan heeft elk van deze klassen de methode table waarmee een Query-klasse wordt aangemaakt, het object als table bij de query wordt gezet en het ObjectQuery-object wordt gereturnd zodat er meteen methoden op kunnen worden toegepast. Voor uitgebreide klasse zoals Persoon en Lid worden automatisch de onderliggende klassen gejoind zodat je dit niet zelf hoeft te doen en bij deze data kan.<br /> Een voorbeeld:<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = PersoonQuery::table();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> == Query uitvoeren ==<br /> Een query kan je uitvoeren met de methode &lt;code&gt;get&lt;/code&gt;. &lt;code&gt;get&lt;/code&gt; heeft geen argumenten nodig. Als je verder niets aan je Query-object hebt toegevoegd selecteert de query automatisch alle objecten in de table. Met het volgende voorbeeld worden alle entries uit de Persoon-table opgevraagd:<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $personen = PersoonQuery::table()-&gt;get();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;first&lt;/code&gt; ===<br /> De methode &lt;code&gt;first&lt;/code&gt; voert de query uit zoals &lt;code&gt;get&lt;/code&gt; dat doet en geeft vervolgens alleen het eerste resultaat terug. Met het volgende voorbeeld wordt de eerste entry uit de Persoon-table opgehaald:<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $personen = PersoonQuery::table()-&gt;first();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;aggregate&lt;/code&gt; (TODO: in de php-code moet deze functie nog worden aangepast) ===<br /> De methode &lt;code&gt;aggregate&lt;/code&gt; voert een aggregator uit op de query. De toegestane aggregators zijn: &lt;code&gt;COUNT&lt;/code&gt;, &lt;code&gt;SUM&lt;/code&gt;, &lt;code&gt;MAX&lt;/code&gt;, &lt;code&gt;MIN&lt;/code&gt; en &lt;code&gt;YEAR&lt;/code&gt;. De aggregator pakt op dit moment nog alles ipv een specifieke kolom. &lt;code&gt;aggregate&lt;/code&gt; haalt ook de huidige selectie weg. Een voorbeeld om alle entries in de Persoon-table te tellen:<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $aantal_personen = PersoonQuery::table()-&gt;aggregate('COUNT');<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;count&lt;/code&gt; ===<br /> Om makkelijker entries te tellen is de speciale methode &lt;code&gt;count&lt;/code&gt;. Deze methode telt het aantal entries en haalt ook de orderBys, limits en offset van de query weg.<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $aantal_personen = PersoonQuery::table()-&gt;count();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;verzamel&lt;/code&gt; ===<br /> De methode die het vaakst gebruikt wordt is &lt;code&gt;verzamel&lt;/code&gt;. Net zoals &lt;code&gt;verzamel&lt;/code&gt; van elke Verzameling van een WhosWho4-object verzamelt deze query-methode alle WhosWho4-objecten die met de query opgehaald worden. Hierbij verdwijnen alle huidige selects van de query. De methode kan twee argumenten krijgen: de naam van de klasse om de objecten van te verzamelen as string en of de objecten distinct moeten zijn als bool. Zonder argumenten is distinct true en worden de objecten opgehaald van de klasse waarvan je het query-object gemaakt hebt. Als voorbeeld, haal alle Persoon-objecten op:<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $persoon_objecten = PersoonQuery::table()-&gt;verzamel();<br /> &lt;/syntaxhighlight&gt;<br /> Haal alle distinct bugmelders op (dit voorbeeld gebruikt ook &lt;code&gt;join&lt;/code&gt;):<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $persoon_objecten = BugQuery::table()<br /> -&gt;join('Persoon')<br /> -&gt;verzamel('Persoon', true);<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;geef&lt;/code&gt; ===<br /> Net zoals de methode &lt;code&gt;geef&lt;/code&gt; voor objecten heeft de QueryBuilder een soortgelijke methode. De methode geeft een object terug die wordt opgevraagd dmv de query. Net als bij &lt;code&gt;verzamel&lt;/code&gt; heeft de methode een argument voor het soort object wat je op wilt halen.<br /> Geef het lid-object met ID 5794<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $persoon = PersoonQuery::table()<br /> -&gt;whereInt('contactID', 5794)<br /> -&gt;geef();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> == Joins ==<br /> De QueryBuilder heeft uiteraard ook de mogelijkheid om joins uit te voeren op tables. Nieuwe tabellen worden automatisch op de juiste velden gejoind, dus dit hoef je niet meer zelf te doen. Mocht de QueryBuilder het toch niet zelf kunnen, dan hebben de join-methoden extra argumenten nodig voor het joinen.<br /> <br /> === (left) &lt;code&gt;join&lt;/code&gt; ===<br /> De standaard &lt;code&gt;join&lt;/code&gt; is een left join. Je hoeft als enige argument de table mee te geven om op te joinen. Zo kan je bv de table Persoon joinen met Bug<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = BugQuery::table()-&gt;join('Persoon');<br /> &lt;/syntaxhighlight&gt;<br /> Als het echt nodig is kan je zelf de twee namen van de kolommen meegeven waarop gejoined moet worden<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = BugQuery::table()-&gt;join('Persoon', 'Bug.melder_contactID', 'Persoon.contactID');<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;rightJoin&lt;/code&gt; ===<br /> De &lt;code&gt;rightJoin&lt;/code&gt; werkt hetzelfde als &lt;code&gt;join&lt;/code&gt; alleen voert het een right join uit ipv een left join.<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = BugQuery::table()-&gt;rightJoin('Persoon');<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;innerJoin&lt;/code&gt; ===<br /> De &lt;code&gt;innerJoin&lt;/code&gt; werkt ook hetzelfde als &lt;code&gt;join&lt;/code&gt; alleen voert het een inner join uit ipv een left join.<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = BugQuery::table()-&gt;innerJoin('Persoon');<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;fullJoin&lt;/code&gt; ===<br /> De &lt;code&gt;fullJoin&lt;/code&gt; werkt ook hetzelfde als &lt;code&gt;join&lt;/code&gt; alleen voert het een full join uit ipv een left join.<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = BugQuery::table()-&gt;fullJoin('Persoon');<br /> &lt;/syntaxhighlight&gt;<br /> <br /> == Where ==<br /> Uiteraard heeft een query ook where's nodig. Daarom heeft de QueryBuilder verschillende methoden om where toe te voegen.<br /> <br /> === &lt;code&gt;whereProp&lt;/code&gt; ===<br /> De belangrijkste where-methode is &lt;code&gt;whereProp&lt;/code&gt;. Met deze methode wordt de where automatisch uitgevoerd op een eigenschap van de objecten waarvan de tables in de query zitten (met from of dmv een join). Hiervoor is het ook nodig dat waarmee je wilt matchen in je where van het juiste type is. Zo is een ID een int en wil je daar dus geen string voor meegeven. De whereProp zoekt ook automatisch de table waarbij de property hoort. Als er meerdere mogelijkheden zijn kan je er altijd 'tablename.' voor zetten, net zoals met normale sql.<br /> <br /> Je kan &lt;code&gt;whereProp&lt;/code&gt; twee of drie argumenten meegeven. Als je twee argumenten meegeeft wordt er een match op gelijkheid aan je query toegevoegd. Hierbij is het eerste argument welke property je wilt matchen en je tweede argument waarmee gematcht wordt.<br /> Selecteer alle Bugs met melder $melder ($melder moet een Persoonobject zijn)<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $bugs = BugQuery::table()-&gt;whereProp('melder', $melder)-&gt;verzamel();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> Als je drie argumenten meegeeft is het eerste argument nog steeds welke property je wilt matchen, je tweede argument is je operator en je derde argument is waarmee gematcht wordt. De mogelijkheden voor de operatoren zijn <br /> Selecteer alle Bugs waarvan melder niet $melder is ($melder moet een Persoonobject zijn)<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $bugs = BugQuery::table()-&gt;whereProp('melder', '!=', $melder)-&gt;verzamel();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;whereProp&lt;/code&gt; varianten ===<br /> <br /> Met de standaard &lt;code&gt;whereProp&lt;/code&gt; kan je alleen een paar operatoren toevoegen aan je where. Daarom zijn er de methoden &lt;code&gt;whereNotProp&lt;/code&gt;, &lt;code&gt;whereLikeProp&lt;/code&gt;, &lt;code&gt;whereNotLikeProp&lt;/code&gt;, &lt;code&gt;whereInProp&lt;/code&gt; en &lt;code&gt;whereNotInProp&lt;/code&gt;. Wat deze methoden doen zit in de naam van de methoden. Voor de &lt;code&gt;whereLikeProp&lt;/code&gt; en &lt;code&gt;whereNotLikeProp&lt;/code&gt; heb je twee argumenten nodig, als eerste de property en als tweede de string. Voor de methoden &lt;code&gt;whereInProp&lt;/code&gt; en &lt;code&gt;whereNotInProp&lt;/code&gt; heb je ook twee argumenten nodig, de property en als tweede de array waar de property in moet zitten.<br /> Haal alle bugs op waarbij het email de string 'pepijno' bevat<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $bugs = BugQuery::table()-&gt;wherePropLike('melderEmail', '%pepijno%')-&gt;verzamel();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === OR ipv AND ===<br /> <br /> Als je meerdere &lt;code&gt;whereProp&lt;/code&gt;-methoden hebt worden ze in de WHERE automatisch aan elkaar geplakt met het AND keyword. Om ze met OR aan elkaar te plakken gebruik je de methode &lt;code&gt;orWhereProp&lt;/code&gt;. Voor alle andere soorten &lt;code&gt;whereProp&lt;/code&gt;-methode kan je op dezelfde manier de or voor de methodenaam plakken en dan worden de where-clausules met OR aan elkaar geplakt.<br /> <br /> === Overige &lt;code&gt;where&lt;/code&gt;-methoden ===<br /> <br /> Als je een WHERE-clausule wilt gebruiken kan je ipv &lt;code&gt;whereProp&lt;/code&gt; ook standaard &lt;code&gt;where&lt;/code&gt;-methoden gebruiken. Deze gebruik je op dezelfde manier als &lt;code&gt;whereProp&lt;/code&gt;-methoden, behalve dat je de Prop moet vervangen door het type van de value die je in je WHERE wilt gebruiken. Als je bv wilt kijken of een ID gelijk is aan een int, moet je &lt;code&gt;whereInt&lt;/code&gt; gebruiken.<br /> Haal alle Bugs op met melder_contactID gelijk aan 5794 (hier kan je als het lid-object van lidnr 5794 hebt ook whereProp gebruiken)<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $bugs = BugQuery::table()-&gt;whereInt('melder_contactID', 5794)-&gt;verzamel();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> Naast deze standaard &lt;code&gt;where&lt;/code&gt;-methode heb je ook de self explainatory methoden &lt;code&gt;whereNot&lt;/code&gt;, &lt;code&gt;whereIn&lt;/code&gt;, &lt;code&gt;whereNotIn&lt;/code&gt;, &lt;code&gt;whereLike&lt;/code&gt;, &lt;code&gt;whereNotLike&lt;/code&gt;, &lt;code&gt;whereNull&lt;/code&gt; en &lt;code&gt;whereNotNull&lt;/code&gt;. Let op dat je dus ook bij deze methoden het type van de value bij de methode naam moet zetten! Ook al deze methode kan je met een OR lijmen door or voor de methodenaam te zetten zoals bv bij &lt;code&gt;orWhereProp&lt;/code&gt;.<br /> <br /> === Nested where's &amp; Closures ===<br /> <br /> Stel, je wilt de volgende WHERE-clausule:<br /> WHERE (a = 0 OR a = 1) AND (a = 2 OR a = 3)<br /> Dit krijg je in de QueryBuilder dmv Closures in php. De bovenstaande where-prop krijg je als volgt<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> ...-&gt;where(function($q) use ($var1, $var2) {<br /> $q-&gt;whereInt('a', 0)<br /> -&gt;orWhereInt('a', 1);<br /> })-&gt;where(function($q) {<br /> $q-&gt;whereInt('a', 2)<br /> -&gt;orWhereInt('a', 3);<br /> })<br /> &lt;/syntaxhighlight&gt;<br /> <br /> In een where kan je dus een closure gebruiken om nested where's te krijgen.<br /> <br /> [[Category:WebCie]]</div>

Pepijno https://mediawiki.a-eskwadraat.nl/wiki/index.php/QueryBuilder 2017-02-28T20:34:10Z

<p>Pepijno: /* Where */</p> <hr /> <div>Om SQL-queries makkelijker te maken heeft de WebCie haar eigen sql-library geschreven, de QueryBuilder. De QueryBuilder maakt queries op dmv van een QueryBuilder-object waaraan properties veranderd worden. Op die manier wordt de query pas gebouwd als de query uitgevoerd moet worden. Hierdoor is er meer mogelijkheid voor controle en sanity checks.<br /> <br /> De QueryBuilder bestaat uit de Query-klasse, de QueryBuilder-klasse en alle uitbreidingen. De Query-klasse is een extensie van de QueryBuilder-klasse. Het verschil tussen de twee klasses is dat de QueryBuilder-klasse wordt gebruikt om de query op te bouwen en de Query-klasse wordt gebruikt om van het geheel een werkende query te maken, alsmede verschillende functies zoals het verzamelen van objecten te implementeren.<br /> <br /> == QueryBuilder starten ==<br /> Omdat je een query altijd wilt gebruiken voor WhosWho4-objecten heeft elk WhosWho4-object zijn eigen query-classe die een uitbreiding is van de Query-klasse. Zo heb je bv de PersoonQuery-klasse en de LidQuery-klasse. Deze extensies hebben niet hun eigen speciale constructor. in plaats daarvan heeft elk van deze klassen de methode table waarmee een Query-klasse wordt aangemaakt, het object als table bij de query wordt gezet en het ObjectQuery-object wordt gereturnd zodat er meteen methoden op kunnen worden toegepast. Voor uitgebreide klasse zoals Persoon en Lid worden automatisch de onderliggende klassen gejoind zodat je dit niet zelf hoeft te doen en bij deze data kan.<br /> Een voorbeeld:<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = PersoonQuery::table();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> == Query uitvoeren ==<br /> Een query kan je uitvoeren met de methode &lt;code&gt;get&lt;/code&gt;. &lt;code&gt;get&lt;/code&gt; heeft geen argumenten nodig. Als je verder niets aan je Query-object hebt toegevoegd selecteert de query automatisch alle objecten in de table. Met het volgende voorbeeld worden alle entries uit de Persoon-table opgevraagd:<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $personen = PersoonQuery::table()-&gt;get();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;first&lt;/code&gt; ===<br /> De methode &lt;code&gt;first&lt;/code&gt; voert de query uit zoals &lt;code&gt;get&lt;/code&gt; dat doet en geeft vervolgens alleen het eerste resultaat terug. Met het volgende voorbeeld wordt de eerste entry uit de Persoon-table opgehaald:<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $personen = PersoonQuery::table()-&gt;first();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;aggregate&lt;/code&gt; (TODO: in de php-code moet deze functie nog worden aangepast) ===<br /> De methode &lt;code&gt;aggregate&lt;/code&gt; voert een aggregator uit op de query. De toegestane aggregators zijn: &lt;code&gt;COUNT&lt;/code&gt;, &lt;code&gt;SUM&lt;/code&gt;, &lt;code&gt;MAX&lt;/code&gt;, &lt;code&gt;MIN&lt;/code&gt; en &lt;code&gt;YEAR&lt;/code&gt;. De aggregator pakt op dit moment nog alles ipv een specifieke kolom. &lt;code&gt;aggregate&lt;/code&gt; haalt ook de huidige selectie weg. Een voorbeeld om alle entries in de Persoon-table te tellen:<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $aantal_personen = PersoonQuery::table()-&gt;aggregate('COUNT');<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;count&lt;/code&gt; ===<br /> Om makkelijker entries te tellen is de speciale methode &lt;code&gt;count&lt;/code&gt;. Deze methode telt het aantal entries en haalt ook de orderBys, limits en offset van de query weg.<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $aantal_personen = PersoonQuery::table()-&gt;count();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;verzamel&lt;/code&gt; ===<br /> De methode die het vaakst gebruikt wordt is &lt;code&gt;verzamel&lt;/code&gt;. Net zoals &lt;code&gt;verzamel&lt;/code&gt; van elke Verzameling van een WhosWho4-object verzamelt deze query-methode alle WhosWho4-objecten die met de query opgehaald worden. Hierbij verdwijnen alle huidige selects van de query. De methode kan twee argumenten krijgen: de naam van de klasse om de objecten van te verzamelen as string en of de objecten distinct moeten zijn als bool. Zonder argumenten is distinct true en worden de objecten opgehaald van de klasse waarvan je het query-object gemaakt hebt. Als voorbeeld, haal alle Persoon-objecten op:<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $persoon_objecten = PersoonQuery::table()-&gt;verzamel();<br /> &lt;/syntaxhighlight&gt;<br /> Haal alle distinct bugmelders op (dit voorbeeld gebruikt ook &lt;code&gt;join&lt;/code&gt;):<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $persoon_objecten = BugQuery::table()<br /> -&gt;join('Persoon')<br /> -&gt;verzamel('Persoon', true);<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;geef&lt;/code&gt; ===<br /> Net zoals de methode &lt;code&gt;geef&lt;/code&gt; voor objecten heeft de QueryBuilder een soortgelijke methode. De methode geeft een object terug die wordt opgevraagd dmv de query. Net als bij &lt;code&gt;verzamel&lt;/code&gt; heeft de methode een argument voor het soort object wat je op wilt halen.<br /> Geef het lid-object met ID 5794<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $persoon = PersoonQuery::table()<br /> -&gt;whereInt('contactID', 5794)<br /> -&gt;geef();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> == Joins ==<br /> De QueryBuilder heeft uiteraard ook de mogelijkheid om joins uit te voeren op tables. Nieuwe tabellen worden automatisch op de juiste velden gejoind, dus dit hoef je niet meer zelf te doen. Mocht de QueryBuilder het toch niet zelf kunnen, dan hebben de join-methoden extra argumenten nodig voor het joinen.<br /> <br /> === (left) &lt;code&gt;join&lt;/code&gt; ===<br /> De standaard &lt;code&gt;join&lt;/code&gt; is een left join. Je hoeft als enige argument de table mee te geven om op te joinen. Zo kan je bv de table Persoon joinen met Bug<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = BugQuery::table()-&gt;join('Persoon');<br /> &lt;/syntaxhighlight&gt;<br /> Als het echt nodig is kan je zelf de twee namen van de kolommen meegeven waarop gejoined moet worden<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = BugQuery::table()-&gt;join('Persoon', 'Bug.melder_contactID', 'Persoon.contactID');<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;rightJoin&lt;/code&gt; ===<br /> De &lt;code&gt;rightJoin&lt;/code&gt; werkt hetzelfde als &lt;code&gt;join&lt;/code&gt; alleen voert het een right join uit ipv een left join.<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = BugQuery::table()-&gt;rightJoin('Persoon');<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;innerJoin&lt;/code&gt; ===<br /> De &lt;code&gt;innerJoin&lt;/code&gt; werkt ook hetzelfde als &lt;code&gt;join&lt;/code&gt; alleen voert het een inner join uit ipv een left join.<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = BugQuery::table()-&gt;innerJoin('Persoon');<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;fullJoin&lt;/code&gt; ===<br /> De &lt;code&gt;fullJoin&lt;/code&gt; werkt ook hetzelfde als &lt;code&gt;join&lt;/code&gt; alleen voert het een full join uit ipv een left join.<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = BugQuery::table()-&gt;fullJoin('Persoon');<br /> &lt;/syntaxhighlight&gt;<br /> <br /> == Where ==<br /> Uiteraard heeft een query ook where's nodig. Daarom heeft de QueryBuilder verschillende methoden om where toe te voegen.<br /> <br /> === &lt;code&gt;whereProp&lt;/code&gt; ===<br /> De belangrijkste where-methode is &lt;code&gt;whereProp&lt;/code&gt;. Met deze methode wordt de where automatisch uitgevoerd op een eigenschap van de objecten waarvan de tables in de query zitten (met from of dmv een join). Hiervoor is het ook nodig dat waarmee je wilt matchen in je where van het juiste type is. Zo is een ID een int en wil je daar dus geen string voor meegeven. De whereProp zoekt ook automatisch de table waarbij de property hoort. Als er meerdere mogelijkheden zijn kan je er altijd 'tablename.' voor zetten, net zoals met normale sql.<br /> <br /> Je kan &lt;code&gt;whereProp&lt;/code&gt; twee of drie argumenten meegeven. Als je twee argumenten meegeeft wordt er een match op gelijkheid aan je query toegevoegd. Hierbij is het eerste argument welke property je wilt matchen en je tweede argument waarmee gematcht wordt.<br /> Selecteer alle Bugs met melder $melder ($melder moet een Persoonobject zijn)<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $bugs = BugQuery::table()-&gt;whereProp('melder', $melder)-&gt;verzamel();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> Als je drie argumenten meegeeft is het eerste argument nog steeds welke property je wilt matchen, je tweede argument is je operator en je derde argument is waarmee gematcht wordt. De mogelijkheden voor de operatoren zijn <br /> Selecteer alle Bugs waarvan melder niet $melder is ($melder moet een Persoonobject zijn)<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $bugs = BugQuery::table()-&gt;whereProp('melder', '!=', $melder)-&gt;verzamel();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;whereProp&lt;/code&gt; varianten ===<br /> <br /> Met de standaard &lt;code&gt;whereProp&lt;/code&gt; kan je alleen een paar operatoren toevoegen aan je where. Daarom zijn er de methoden &lt;code&gt;whereNotProp&lt;/code&gt;, &lt;code&gt;whereLikeProp&lt;/code&gt;, &lt;code&gt;whereNotLikeProp&lt;/code&gt;, &lt;code&gt;whereInProp&lt;/code&gt; en &lt;code&gt;whereNotInProp&lt;/code&gt;. Wat deze methoden doen zit in de naam van de methoden. Voor de &lt;code&gt;whereLikeProp&lt;/code&gt; en &lt;code&gt;whereNotLikeProp&lt;/code&gt; heb je twee argumenten nodig, als eerste de property en als tweede de string. Voor de methoden &lt;code&gt;whereInProp&lt;/code&gt; en &lt;code&gt;whereNotInProp&lt;/code&gt; heb je ook twee argumenten nodig, de property en als tweede de array waar de property in moet zitten.<br /> Haal alle bugs op waarbij het email de string 'pepijno' bevat<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $bugs = BugQuery::table()-&gt;wherePropLike('melderEmail', '%pepijno%')-&gt;verzamel();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === OR ipv AND ===<br /> <br /> Als je meerdere &lt;code&gt;whereProp&lt;/code&gt;-methoden hebt worden ze in de WHERE automatisch aan elkaar geplakt met het AND keyword. Om ze met OR aan elkaar te plakken gebruik je de methode &lt;code&gt;orWhereProp&lt;/code&gt;. Voor alle andere soorten &lt;code&gt;whereProp&lt;/code&gt;-methode kan je op dezelfde manier de or voor de methodenaam plakken en dan worden de where-clausules met OR aan elkaar geplakt.<br /> <br /> === Overige &lt;code&gt;where&lt;/code&gt;-methoden ===<br /> <br /> Als je een WHERE-clausule wilt gebruiken kan je ipv &lt;code&gt;whereProp&lt;/code&gt; ook standaard &lt;code&gt;where&lt;/code&gt;-methoden gebruiken. Deze gebruik je op dezelfde manier als &lt;code&gt;whereProp&lt;/code&gt;-methoden, behalve dat je de Prop moet vervangen door het type van de value die je in je WHERE wilt gebruiken. Als je bv wilt kijken of een ID gelijk is aan een int, moet je &lt;code&gt;whereInt&lt;/code&gt; gebruiken.<br /> Haal alle Bugs op met melder_contactID gelijk aan 5794 (hier kan je als het lid-object van lidnr 5794 hebt ook whereProp gebruiken)<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $bugs = BugQuery::table()-&gt;whereInt('melder_contactID', 5794)-&gt;verzamel();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> Naast deze standaard &lt;code&gt;where&lt;/code&gt;-methode heb je ook de self explainatory methoden &lt;code&gt;whereNot&lt;/code&gt;, &lt;code&gt;whereIn&lt;/code&gt;, &lt;code&gt;whereNotIn&lt;/code&gt;, &lt;code&gt;whereLike&lt;/code&gt;, &lt;code&gt;whereNotLike&lt;/code&gt;, &lt;code&gt;whereNull&lt;/code&gt; en &lt;code&gt;whereNotNull&lt;/code&gt;. Let op dat je dus ook bij deze methoden het type van de value bij de methode naam moet zetten! Ook al deze methode kan je met een OR lijmen door or voor de methodenaam te zetten zoals bv bij &lt;code&gt;orWhereProp&lt;/code&gt;.<br /> <br /> === Nested where's &amp; Closures ===<br /> <br /> Stel, je wilt de volgende WHERE-clausule:<br /> WHERE (a = 0 OR a = 1) AND (a = 2 OR a = 3)<br /> Dit krijg je in de QueryBuilder dmv Closures in php. De bovenstaande where-prop krijg je als volgt<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> ...-&gt;where(function($q) use ($var1, $var2) {<br /> $q-&gt;whereInt('a', 0)<br /> -&gt;orWhereInt('a', 1);<br /> })-&gt;where(function($q) {<br /> $q-&gt;whereInt('a', 2)<br /> -&gt;orWhereInt('a', 3);<br /> })<br /> &lt;/syntaxhighlight&gt;<br /> <br /> [[Category:WebCie]]</div>

Pepijno https://mediawiki.a-eskwadraat.nl/wiki/index.php/QueryBuilder 2017-02-28T20:23:18Z

<p>Pepijno: </p> <hr /> <div>Om SQL-queries makkelijker te maken heeft de WebCie haar eigen sql-library geschreven, de QueryBuilder. De QueryBuilder maakt queries op dmv van een QueryBuilder-object waaraan properties veranderd worden. Op die manier wordt de query pas gebouwd als de query uitgevoerd moet worden. Hierdoor is er meer mogelijkheid voor controle en sanity checks.<br /> <br /> De QueryBuilder bestaat uit de Query-klasse, de QueryBuilder-klasse en alle uitbreidingen. De Query-klasse is een extensie van de QueryBuilder-klasse. Het verschil tussen de twee klasses is dat de QueryBuilder-klasse wordt gebruikt om de query op te bouwen en de Query-klasse wordt gebruikt om van het geheel een werkende query te maken, alsmede verschillende functies zoals het verzamelen van objecten te implementeren.<br /> <br /> == QueryBuilder starten ==<br /> Omdat je een query altijd wilt gebruiken voor WhosWho4-objecten heeft elk WhosWho4-object zijn eigen query-classe die een uitbreiding is van de Query-klasse. Zo heb je bv de PersoonQuery-klasse en de LidQuery-klasse. Deze extensies hebben niet hun eigen speciale constructor. in plaats daarvan heeft elk van deze klassen de methode table waarmee een Query-klasse wordt aangemaakt, het object als table bij de query wordt gezet en het ObjectQuery-object wordt gereturnd zodat er meteen methoden op kunnen worden toegepast. Voor uitgebreide klasse zoals Persoon en Lid worden automatisch de onderliggende klassen gejoind zodat je dit niet zelf hoeft te doen en bij deze data kan.<br /> Een voorbeeld:<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = PersoonQuery::table();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> == Query uitvoeren ==<br /> Een query kan je uitvoeren met de methode &lt;code&gt;get&lt;/code&gt;. &lt;code&gt;get&lt;/code&gt; heeft geen argumenten nodig. Als je verder niets aan je Query-object hebt toegevoegd selecteert de query automatisch alle objecten in de table. Met het volgende voorbeeld worden alle entries uit de Persoon-table opgevraagd:<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $personen = PersoonQuery::table()-&gt;get();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;first&lt;/code&gt; ===<br /> De methode &lt;code&gt;first&lt;/code&gt; voert de query uit zoals &lt;code&gt;get&lt;/code&gt; dat doet en geeft vervolgens alleen het eerste resultaat terug. Met het volgende voorbeeld wordt de eerste entry uit de Persoon-table opgehaald:<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $personen = PersoonQuery::table()-&gt;first();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;aggregate&lt;/code&gt; (TODO: in de php-code moet deze functie nog worden aangepast) ===<br /> De methode &lt;code&gt;aggregate&lt;/code&gt; voert een aggregator uit op de query. De toegestane aggregators zijn: &lt;code&gt;COUNT&lt;/code&gt;, &lt;code&gt;SUM&lt;/code&gt;, &lt;code&gt;MAX&lt;/code&gt;, &lt;code&gt;MIN&lt;/code&gt; en &lt;code&gt;YEAR&lt;/code&gt;. De aggregator pakt op dit moment nog alles ipv een specifieke kolom. &lt;code&gt;aggregate&lt;/code&gt; haalt ook de huidige selectie weg. Een voorbeeld om alle entries in de Persoon-table te tellen:<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $aantal_personen = PersoonQuery::table()-&gt;aggregate('COUNT');<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;count&lt;/code&gt; ===<br /> Om makkelijker entries te tellen is de speciale methode &lt;code&gt;count&lt;/code&gt;. Deze methode telt het aantal entries en haalt ook de orderBys, limits en offset van de query weg.<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $aantal_personen = PersoonQuery::table()-&gt;count();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;verzamel&lt;/code&gt; ===<br /> De methode die het vaakst gebruikt wordt is &lt;code&gt;verzamel&lt;/code&gt;. Net zoals &lt;code&gt;verzamel&lt;/code&gt; van elke Verzameling van een WhosWho4-object verzamelt deze query-methode alle WhosWho4-objecten die met de query opgehaald worden. Hierbij verdwijnen alle huidige selects van de query. De methode kan twee argumenten krijgen: de naam van de klasse om de objecten van te verzamelen as string en of de objecten distinct moeten zijn als bool. Zonder argumenten is distinct true en worden de objecten opgehaald van de klasse waarvan je het query-object gemaakt hebt. Als voorbeeld, haal alle Persoon-objecten op:<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $persoon_objecten = PersoonQuery::table()-&gt;verzamel();<br /> &lt;/syntaxhighlight&gt;<br /> Haal alle distinct bugmelders op (dit voorbeeld gebruikt ook &lt;code&gt;join&lt;/code&gt;):<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $persoon_objecten = BugQuery::table()<br /> -&gt;join('Persoon')<br /> -&gt;verzamel('Persoon', true);<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;geef&lt;/code&gt; ===<br /> Net zoals de methode &lt;code&gt;geef&lt;/code&gt; voor objecten heeft de QueryBuilder een soortgelijke methode. De methode geeft een object terug die wordt opgevraagd dmv de query. Net als bij &lt;code&gt;verzamel&lt;/code&gt; heeft de methode een argument voor het soort object wat je op wilt halen.<br /> Geef het lid-object met ID 5794<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $persoon = PersoonQuery::table()<br /> -&gt;whereInt('contactID', 5794)<br /> -&gt;geef();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> == Joins ==<br /> De QueryBuilder heeft uiteraard ook de mogelijkheid om joins uit te voeren op tables. Nieuwe tabellen worden automatisch op de juiste velden gejoind, dus dit hoef je niet meer zelf te doen. Mocht de QueryBuilder het toch niet zelf kunnen, dan hebben de join-methoden extra argumenten nodig voor het joinen.<br /> <br /> === (left) &lt;code&gt;join&lt;/code&gt; ===<br /> De standaard &lt;code&gt;join&lt;/code&gt; is een left join. Je hoeft als enige argument de table mee te geven om op te joinen. Zo kan je bv de table Persoon joinen met Bug<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = BugQuery::table()-&gt;join('Persoon');<br /> &lt;/syntaxhighlight&gt;<br /> Als het echt nodig is kan je zelf de twee namen van de kolommen meegeven waarop gejoined moet worden<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = BugQuery::table()-&gt;join('Persoon', 'Bug.melder_contactID', 'Persoon.contactID');<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;rightJoin&lt;/code&gt; ===<br /> De &lt;code&gt;rightJoin&lt;/code&gt; werkt hetzelfde als &lt;code&gt;join&lt;/code&gt; alleen voert het een right join uit ipv een left join.<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = BugQuery::table()-&gt;rightJoin('Persoon');<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;innerJoin&lt;/code&gt; ===<br /> De &lt;code&gt;innerJoin&lt;/code&gt; werkt ook hetzelfde als &lt;code&gt;join&lt;/code&gt; alleen voert het een inner join uit ipv een left join.<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = BugQuery::table()-&gt;innerJoin('Persoon');<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;fullJoin&lt;/code&gt; ===<br /> De &lt;code&gt;fullJoin&lt;/code&gt; werkt ook hetzelfde als &lt;code&gt;join&lt;/code&gt; alleen voert het een full join uit ipv een left join.<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = BugQuery::table()-&gt;fullJoin('Persoon');<br /> &lt;/syntaxhighlight&gt;<br /> <br /> == Where ==<br /> Uiteraard heeft een query ook where's nodig. Daarom heeft de QueryBuilder verschillende methoden om where toe te voegen.<br /> <br /> === &lt;code&gt;whereProp&lt;/code&gt; ===<br /> De belangrijkste where-methode is &lt;code&gt;whereProp&lt;/code&gt;. Met deze methode wordt de where automatisch uitgevoerd op een eigenschap van de objecten waarvan de tables in de query zitten (met from of dmv een join). Hiervoor is het ook nodig dat waarmee je wilt matchen in je where van het juiste type is. Zo is een ID een int en wil je daar dus geen string voor meegeven. De whereProp zoekt ook automatisch de table waarbij de property hoort. Als er meerdere mogelijkheden zijn kan je er altijd 'tablename.' voor zetten, net zoals met normale sql.<br /> <br /> Je kan &lt;code&gt;whereProp&lt;/code&gt; twee of drie argumenten meegeven. Als je twee argumenten meegeeft wordt er een match op gelijkheid aan je query toegevoegd. Hierbij is het eerste argument welke property je wilt matchen en je tweede argument waarmee gematcht wordt.<br /> Selecteer alle Bugs met melder $melder ($melder moet een Persoonobject zijn)<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $bugs = BugQuery::table()-&gt;whereProp('melder', $melder)-&gt;verzamel();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> Als je drie argumenten meegeeft is het eerste argument nog steeds welke property je wilt matchen, je tweede argument is je operator en je derde argument is waarmee gematcht wordt. De mogelijkheden voor de operatoren zijn <br /> Selecteer alle Bugs waarvan melder niet $melder is ($melder moet een Persoonobject zijn)<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $bugs = BugQuery::table()-&gt;whereProp('melder', '!=', $melder)-&gt;verzamel();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;whereProp&lt;/code&gt; varianten ===<br /> <br /> Met de standaard &lt;code&gt;whereProp&lt;/code&gt; kan je alleen een paar operatoren toevoegen aan je where. Daarom zijn er de methoden &lt;code&gt;whereNotProp&lt;/code&gt;, &lt;code&gt;whereLikeProp&lt;/code&gt;, &lt;code&gt;whereNotLikeProp&lt;/code&gt;, &lt;code&gt;whereInProp&lt;/code&gt; en &lt;code&gt;whereNotInProp&lt;/code&gt;. Wat deze methoden doen zit in de naam van de methoden. Voor de &lt;code&gt;whereLikeProp&lt;/code&gt; en &lt;code&gt;whereNotLikeProp&lt;/code&gt; heb je twee argumenten nodig, als eerste de property en als tweede de string. Voor de methoden &lt;code&gt;whereInProp&lt;/code&gt; en &lt;code&gt;whereNotInProp&lt;/code&gt; heb je ook twee argumenten nodig, de property en als tweede de array waar de property in moet zitten.<br /> Haal alle bugs op waarbij het email de string 'pepijno' bevat<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $bugs = BugQuery::table()-&gt;wherePropLike('melderEmail', '%pepijno%')-&gt;verzamel();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === OR ipv AND ===<br /> <br /> Als je meerdere &lt;code&gt;whereProp&lt;/code&gt;-methoden hebt worden ze in de WHERE automatisch aan elkaar geplakt met het AND keyword. Om ze met OR aan elkaar te plakken gebruik je de methode &lt;code&gt;orWhereProp&lt;/code&gt;. Voor alle andere soorten &lt;code&gt;whereProp&lt;/code&gt;-methode kan je op dezelfde manier de or voor de methodenaam plakken en dan worden de where-clausules met OR aan elkaar geplakt.<br /> <br /> === Overige &lt;code&gt;where&lt;/code&gt;-methoden ===<br /> Als je een WHERE-clausule wilt gebruiken kan je ipv &lt;code&gt;whereProp&lt;/code&gt; ook standaard &lt;code&gt;where&lt;/code&gt;-methoden gebruiken. Deze gebruik je op dezelfde manier als &lt;code&gt;whereProp&lt;/code&gt;-methoden, behalve dat je de Prop moet vervangen door het type van de value die je in je WHERE wilt gebruiken. Als je bv wilt kijken of een ID gelijk is aan een int, moet je &lt;code&gt;whereInt&lt;/code&gt; gebruiken.<br /> Haal alle Bugs op met melder_contactID gelijk aan 5794 (hier kan je als het lid-object van lidnr 5794 hebt ook whereProp gebruiken)<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $bugs = BugQuery::table()-&gt;whereInt('melder_contactID', 5794)-&gt;verzamel();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> Naast deze standaard &lt;code&gt;where&lt;/code&gt;-methode heb je ook de self explainatory methoden &lt;code&gt;whereNot&lt;/code&gt;, &lt;code&gt;whereIn&lt;/code&gt;, &lt;code&gt;whereNotIn&lt;/code&gt;, &lt;code&gt;whereLike&lt;/code&gt;, &lt;code&gt;whereNotLike&lt;/code&gt;, &lt;code&gt;whereNull&lt;/code&gt; en &lt;code&gt;whereNotNull&lt;/code&gt;. Let op dat je dus ook bij deze methoden het type van de value bij de methode naam moet zetten! Ook al deze methode kan je met een OR lijmen door or voor de methodenaam te zetten zoals bv bij &lt;code&gt;orWhereProp&lt;/code&gt;.<br /> <br /> [[Category:WebCie]]</div>

Pepijno https://mediawiki.a-eskwadraat.nl/wiki/index.php/QueryBuilder 2017-02-28T20:14:30Z

<p>Pepijno: /* Where */</p> <hr /> <div>Om SQL-queries makkelijker te maken heeft de WebCie haar eigen sql-library geschreven, de QueryBuilder. De QueryBuilder maakt queries op dmv van een QueryBuilder-object waaraan properties veranderd worden. Op die manier wordt de query pas gebouwd als de query uitgevoerd moet worden. Hierdoor is er meer mogelijkheid voor controle en sanity checks.<br /> <br /> De QueryBuilder bestaat uit de Query-klasse, de QueryBuilder-klasse en alle uitbreidingen. De Query-klasse is een extensie van de QueryBuilder-klasse. Het verschil tussen de twee klasses is dat de QueryBuilder-klasse wordt gebruikt om de query op te bouwen en de Query-klasse wordt gebruikt om van het geheel een werkende query te maken, alsmede verschillende functies zoals het verzamelen van objecten te implementeren.<br /> <br /> == QueryBuilder starten ==<br /> Omdat je een query altijd wilt gebruiken voor WhosWho4-objecten heeft elk WhosWho4-object zijn eigen query-classe die een uitbreiding is van de Query-klasse. Zo heb je bv de PersoonQuery-klasse en de LidQuery-klasse. Deze extensies hebben niet hun eigen speciale constructor. in plaats daarvan heeft elk van deze klassen de methode table waarmee een Query-klasse wordt aangemaakt, het object als table bij de query wordt gezet en het ObjectQuery-object wordt gereturnd zodat er meteen methoden op kunnen worden toegepast. Voor uitgebreide klasse zoals Persoon en Lid worden automatisch de onderliggende klassen gejoind zodat je dit niet zelf hoeft te doen en bij deze data kan.<br /> Een voorbeeld:<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = PersoonQuery::table();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> == Query uitvoeren ==<br /> Een query kan je uitvoeren met de methode &lt;code&gt;get&lt;/code&gt;. &lt;code&gt;get&lt;/code&gt; heeft geen argumenten nodig. Als je verder niets aan je Query-object hebt toegevoegd selecteert de query automatisch alle objecten in de table. Met het volgende voorbeeld worden alle entries uit de Persoon-table opgevraagd:<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $personen = PersoonQuery::table()-&gt;get();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;first&lt;/code&gt; ===<br /> De methode &lt;code&gt;first&lt;/code&gt; voert de query uit zoals &lt;code&gt;get&lt;/code&gt; dat doet en geeft vervolgens alleen het eerste resultaat terug. Met het volgende voorbeeld wordt de eerste entry uit de Persoon-table opgehaald:<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $personen = PersoonQuery::table()-&gt;first();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;aggregate&lt;/code&gt; (TODO: in de php-code moet deze functie nog worden aangepast) ===<br /> De methode &lt;code&gt;aggregate&lt;/code&gt; voert een aggregator uit op de query. De toegestane aggregators zijn: &lt;code&gt;COUNT&lt;/code&gt;, &lt;code&gt;SUM&lt;/code&gt;, &lt;code&gt;MAX&lt;/code&gt;, &lt;code&gt;MIN&lt;/code&gt; en &lt;code&gt;YEAR&lt;/code&gt;. De aggregator pakt op dit moment nog alles ipv een specifieke kolom. &lt;code&gt;aggregate&lt;/code&gt; haalt ook de huidige selectie weg. Een voorbeeld om alle entries in de Persoon-table te tellen:<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $aantal_personen = PersoonQuery::table()-&gt;aggregate('COUNT');<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;count&lt;/code&gt; ===<br /> Om makkelijker entries te tellen is de speciale methode &lt;code&gt;count&lt;/code&gt;. Deze methode telt het aantal entries en haalt ook de orderBys, limits en offset van de query weg.<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $aantal_personen = PersoonQuery::table()-&gt;count();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;verzamel&lt;/code&gt; ===<br /> De methode die het vaakst gebruikt wordt is &lt;code&gt;verzamel&lt;/code&gt;. Net zoals &lt;code&gt;verzamel&lt;/code&gt; van elke Verzameling van een WhosWho4-object verzamelt deze query-methode alle WhosWho4-objecten die met de query opgehaald worden. Hierbij verdwijnen alle huidige selects van de query. De methode kan twee argumenten krijgen: de naam van de klasse om de objecten van te verzamelen as string en of de objecten distinct moeten zijn als bool. Zonder argumenten is distinct true en worden de objecten opgehaald van de klasse waarvan je het query-object gemaakt hebt. Als voorbeeld, haal alle Persoon-objecten op:<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $persoon_objecten = PersoonQuery::table()-&gt;verzamel();<br /> &lt;/syntaxhighlight&gt;<br /> Haal alle distinct bugmelders op (dit voorbeeld gebruikt ook &lt;code&gt;join&lt;/code&gt;):<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $persoon_objecten = BugQuery::table()<br /> -&gt;join('Persoon')<br /> -&gt;verzamel('Persoon', true);<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;geef&lt;/code&gt; ===<br /> Net zoals de methode &lt;code&gt;geef&lt;/code&gt; voor objecten heeft de QueryBuilder een soortgelijke methode. De methode geeft een object terug die wordt opgevraagd dmv de query. Net als bij &lt;code&gt;verzamel&lt;/code&gt; heeft de methode een argument voor het soort object wat je op wilt halen.<br /> Geef het lid-object met ID 5794<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $persoon = PersoonQuery::table()<br /> -&gt;whereInt('contactID', 5794)<br /> -&gt;geef();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> == Joins ==<br /> De QueryBuilder heeft uiteraard ook de mogelijkheid om joins uit te voeren op tables. Nieuwe tabellen worden automatisch op de juiste velden gejoind, dus dit hoef je niet meer zelf te doen. Mocht de QueryBuilder het toch niet zelf kunnen, dan hebben de join-methoden extra argumenten nodig voor het joinen.<br /> <br /> === (left) &lt;code&gt;join&lt;/code&gt; ===<br /> De standaard &lt;code&gt;join&lt;/code&gt; is een left join. Je hoeft als enige argument de table mee te geven om op te joinen. Zo kan je bv de table Persoon joinen met Bug<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = BugQuery::table()-&gt;join('Persoon');<br /> &lt;/syntaxhighlight&gt;<br /> Als het echt nodig is kan je zelf de twee namen van de kolommen meegeven waarop gejoined moet worden<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = BugQuery::table()-&gt;join('Persoon', 'Bug.melder_contactID', 'Persoon.contactID');<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;rightJoin&lt;/code&gt; ===<br /> De &lt;code&gt;rightJoin&lt;/code&gt; werkt hetzelfde als &lt;code&gt;join&lt;/code&gt; alleen voert het een right join uit ipv een left join.<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = BugQuery::table()-&gt;rightJoin('Persoon');<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;innerJoin&lt;/code&gt; ===<br /> De &lt;code&gt;innerJoin&lt;/code&gt; werkt ook hetzelfde als &lt;code&gt;join&lt;/code&gt; alleen voert het een inner join uit ipv een left join.<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = BugQuery::table()-&gt;innerJoin('Persoon');<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;fullJoin&lt;/code&gt; ===<br /> De &lt;code&gt;fullJoin&lt;/code&gt; werkt ook hetzelfde als &lt;code&gt;join&lt;/code&gt; alleen voert het een full join uit ipv een left join.<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = BugQuery::table()-&gt;fullJoin('Persoon');<br /> &lt;/syntaxhighlight&gt;<br /> <br /> == Where ==<br /> Uiteraard heeft een query ook where's nodig. Daarom heeft de QueryBuilder verschillende methoden om where toe te voegen.<br /> <br /> === &lt;code&gt;whereProp&lt;/code&gt; ===<br /> De belangrijkste where-methode is &lt;code&gt;whereProp&lt;/code&gt;. Met deze methode wordt de where automatisch uitgevoerd op een eigenschap van de objecten waarvan de tables in de query zitten (met from of dmv een join). Hiervoor is het ook nodig dat waarmee je wilt matchen in je where van het juiste type is. Zo is een ID een int en wil je daar dus geen string voor meegeven. De whereProp zoekt ook automatisch de table waarbij de property hoort. Als er meerdere mogelijkheden zijn kan je er altijd 'tablename.' voor zetten, net zoals met normale sql.<br /> <br /> Je kan &lt;code&gt;whereProp&lt;/code&gt; twee of drie argumenten meegeven. Als je twee argumenten meegeeft wordt er een match op gelijkheid aan je query toegevoegd. Hierbij is het eerste argument welke property je wilt matchen en je tweede argument waarmee gematcht wordt.<br /> Selecteer alle Bugs met melder $melder ($melder moet een Persoonobject zijn)<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $bugs = BugQuery::table()-&gt;whereProp('melder', $melder)-&gt;verzamel();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> Als je drie argumenten meegeeft is het eerste argument nog steeds welke property je wilt matchen, je tweede argument is je operator en je derde argument is waarmee gematcht wordt. De mogelijkheden voor de operatoren zijn <br /> Selecteer alle Bugs waarvan melder niet $melder is ($melder moet een Persoonobject zijn)<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $bugs = BugQuery::table()-&gt;whereProp('melder', '!=', $melder)-&gt;verzamel();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;whereProp&lt;/code&gt; varianten ===<br /> <br /> Met de standaard &lt;code&gt;whereProp&lt;/code&gt; kan je alleen een paar operatoren toevoegen aan je where. Daarom zijn er de methoden &lt;code&gt;whereNotProp&lt;/code&gt;, &lt;code&gt;whereLikeProp&lt;/code&gt;, &lt;code&gt;whereNotLikeProp&lt;/code&gt;, &lt;code&gt;whereInProp&lt;/code&gt; en &lt;code&gt;whereNotInProp&lt;/code&gt;. Wat deze methoden doen zit in de naam van de methoden. Voor de &lt;code&gt;whereLikeProp&lt;/code&gt; en &lt;code&gt;whereNotLikeProp&lt;/code&gt; heb je twee argumenten nodig, als eerste de property en als tweede de string. Voor de methoden &lt;code&gt;whereInProp&lt;/code&gt; en &lt;code&gt;whereNotInProp&lt;/code&gt; heb je ook twee argumenten nodig, de property en als tweede de array waar de property in moet zitten.<br /> Haal alle bugs op waarbij het email de string 'pepijno' bevat<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $bugs = BugQuery::table()-&gt;wherePropLike('melderEmail', '%pepijno%')-&gt;verzamel();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === OR ipv AND ===<br /> <br /> Als je meerdere &lt;code&gt;whereProp&lt;/code&gt;-methoden hebt worden ze in de WHERE automatisch aan elkaar geplakt met het AND keyword. Om ze met OR aan elkaar te plakken gebruik je de methode &lt;code&gt;orWhereProp&lt;/code&gt;. Voor alle andere soorten &lt;code&gt;whereProp&lt;/code&gt;-methode kan je op dezelfde manier de or voor de methodenaam plakken en dan worden de where-clausules met OR aan elkaar geplakt.<br /> <br /> === Overige &lt;code&gt;where&lt;/code&gt;-methoden ===<br /> Als je een WHERE-clausule wilt gebruiken kan je ipv &lt;code&gt;whereProp&lt;/code&gt; ook standaard &lt;code&gt;where&lt;/code&gt;-methoden gebruiken. Deze gebruik je op dezelfde manier als &lt;code&gt;whereProp&lt;/code&gt;-methoden, behalve dat je de Prop moet vervangen door het type van de value die je in je WHERE wilt gebruiken. Als je bv wilt kijken of een ID gelijk is aan een int, moet je &lt;code&gt;whereInt&lt;/code&gt; gebruiken.<br /> Haal alle Bugs op met melder_contactID gelijk aan 5794 (hier kan je als het lid-object van lidnr 5794 hebt ook whereProp gebruiken)<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $bugs = BugQuery::table()-&gt;whereInt('melder_contactID', 5794)-&gt;verzamel();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> [[Category:WebCie]]</div>

Pepijno https://mediawiki.a-eskwadraat.nl/wiki/index.php/QueryBuilder 2017-02-28T20:07:00Z

<p>Pepijno: </p> <hr /> <div>Om SQL-queries makkelijker te maken heeft de WebCie haar eigen sql-library geschreven, de QueryBuilder. De QueryBuilder maakt queries op dmv van een QueryBuilder-object waaraan properties veranderd worden. Op die manier wordt de query pas gebouwd als de query uitgevoerd moet worden. Hierdoor is er meer mogelijkheid voor controle en sanity checks.<br /> <br /> De QueryBuilder bestaat uit de Query-klasse, de QueryBuilder-klasse en alle uitbreidingen. De Query-klasse is een extensie van de QueryBuilder-klasse. Het verschil tussen de twee klasses is dat de QueryBuilder-klasse wordt gebruikt om de query op te bouwen en de Query-klasse wordt gebruikt om van het geheel een werkende query te maken, alsmede verschillende functies zoals het verzamelen van objecten te implementeren.<br /> <br /> == QueryBuilder starten ==<br /> Omdat je een query altijd wilt gebruiken voor WhosWho4-objecten heeft elk WhosWho4-object zijn eigen query-classe die een uitbreiding is van de Query-klasse. Zo heb je bv de PersoonQuery-klasse en de LidQuery-klasse. Deze extensies hebben niet hun eigen speciale constructor. in plaats daarvan heeft elk van deze klassen de methode table waarmee een Query-klasse wordt aangemaakt, het object als table bij de query wordt gezet en het ObjectQuery-object wordt gereturnd zodat er meteen methoden op kunnen worden toegepast. Voor uitgebreide klasse zoals Persoon en Lid worden automatisch de onderliggende klassen gejoind zodat je dit niet zelf hoeft te doen en bij deze data kan.<br /> Een voorbeeld:<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = PersoonQuery::table();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> == Query uitvoeren ==<br /> Een query kan je uitvoeren met de methode &lt;code&gt;get&lt;/code&gt;. &lt;code&gt;get&lt;/code&gt; heeft geen argumenten nodig. Als je verder niets aan je Query-object hebt toegevoegd selecteert de query automatisch alle objecten in de table. Met het volgende voorbeeld worden alle entries uit de Persoon-table opgevraagd:<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $personen = PersoonQuery::table()-&gt;get();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;first&lt;/code&gt; ===<br /> De methode &lt;code&gt;first&lt;/code&gt; voert de query uit zoals &lt;code&gt;get&lt;/code&gt; dat doet en geeft vervolgens alleen het eerste resultaat terug. Met het volgende voorbeeld wordt de eerste entry uit de Persoon-table opgehaald:<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $personen = PersoonQuery::table()-&gt;first();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;aggregate&lt;/code&gt; (TODO: in de php-code moet deze functie nog worden aangepast) ===<br /> De methode &lt;code&gt;aggregate&lt;/code&gt; voert een aggregator uit op de query. De toegestane aggregators zijn: &lt;code&gt;COUNT&lt;/code&gt;, &lt;code&gt;SUM&lt;/code&gt;, &lt;code&gt;MAX&lt;/code&gt;, &lt;code&gt;MIN&lt;/code&gt; en &lt;code&gt;YEAR&lt;/code&gt;. De aggregator pakt op dit moment nog alles ipv een specifieke kolom. &lt;code&gt;aggregate&lt;/code&gt; haalt ook de huidige selectie weg. Een voorbeeld om alle entries in de Persoon-table te tellen:<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $aantal_personen = PersoonQuery::table()-&gt;aggregate('COUNT');<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;count&lt;/code&gt; ===<br /> Om makkelijker entries te tellen is de speciale methode &lt;code&gt;count&lt;/code&gt;. Deze methode telt het aantal entries en haalt ook de orderBys, limits en offset van de query weg.<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $aantal_personen = PersoonQuery::table()-&gt;count();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;verzamel&lt;/code&gt; ===<br /> De methode die het vaakst gebruikt wordt is &lt;code&gt;verzamel&lt;/code&gt;. Net zoals &lt;code&gt;verzamel&lt;/code&gt; van elke Verzameling van een WhosWho4-object verzamelt deze query-methode alle WhosWho4-objecten die met de query opgehaald worden. Hierbij verdwijnen alle huidige selects van de query. De methode kan twee argumenten krijgen: de naam van de klasse om de objecten van te verzamelen as string en of de objecten distinct moeten zijn als bool. Zonder argumenten is distinct true en worden de objecten opgehaald van de klasse waarvan je het query-object gemaakt hebt. Als voorbeeld, haal alle Persoon-objecten op:<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $persoon_objecten = PersoonQuery::table()-&gt;verzamel();<br /> &lt;/syntaxhighlight&gt;<br /> Haal alle distinct bugmelders op (dit voorbeeld gebruikt ook &lt;code&gt;join&lt;/code&gt;):<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $persoon_objecten = BugQuery::table()<br /> -&gt;join('Persoon')<br /> -&gt;verzamel('Persoon', true);<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;geef&lt;/code&gt; ===<br /> Net zoals de methode &lt;code&gt;geef&lt;/code&gt; voor objecten heeft de QueryBuilder een soortgelijke methode. De methode geeft een object terug die wordt opgevraagd dmv de query. Net als bij &lt;code&gt;verzamel&lt;/code&gt; heeft de methode een argument voor het soort object wat je op wilt halen.<br /> Geef het lid-object met ID 5794<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $persoon = PersoonQuery::table()<br /> -&gt;whereInt('contactID', 5794)<br /> -&gt;geef();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> == Joins ==<br /> De QueryBuilder heeft uiteraard ook de mogelijkheid om joins uit te voeren op tables. Nieuwe tabellen worden automatisch op de juiste velden gejoind, dus dit hoef je niet meer zelf te doen. Mocht de QueryBuilder het toch niet zelf kunnen, dan hebben de join-methoden extra argumenten nodig voor het joinen.<br /> <br /> === (left) &lt;code&gt;join&lt;/code&gt; ===<br /> De standaard &lt;code&gt;join&lt;/code&gt; is een left join. Je hoeft als enige argument de table mee te geven om op te joinen. Zo kan je bv de table Persoon joinen met Bug<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = BugQuery::table()-&gt;join('Persoon');<br /> &lt;/syntaxhighlight&gt;<br /> Als het echt nodig is kan je zelf de twee namen van de kolommen meegeven waarop gejoined moet worden<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = BugQuery::table()-&gt;join('Persoon', 'Bug.melder_contactID', 'Persoon.contactID');<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;rightJoin&lt;/code&gt; ===<br /> De &lt;code&gt;rightJoin&lt;/code&gt; werkt hetzelfde als &lt;code&gt;join&lt;/code&gt; alleen voert het een right join uit ipv een left join.<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = BugQuery::table()-&gt;rightJoin('Persoon');<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;innerJoin&lt;/code&gt; ===<br /> De &lt;code&gt;innerJoin&lt;/code&gt; werkt ook hetzelfde als &lt;code&gt;join&lt;/code&gt; alleen voert het een inner join uit ipv een left join.<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = BugQuery::table()-&gt;innerJoin('Persoon');<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;fullJoin&lt;/code&gt; ===<br /> De &lt;code&gt;fullJoin&lt;/code&gt; werkt ook hetzelfde als &lt;code&gt;join&lt;/code&gt; alleen voert het een full join uit ipv een left join.<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = BugQuery::table()-&gt;fullJoin('Persoon');<br /> &lt;/syntaxhighlight&gt;<br /> <br /> == Where ==<br /> Uiteraard heeft een query ook where's nodig. Daarom heeft de QueryBuilder verschillende methoden om where toe te voegen.<br /> <br /> === &lt;code&gt;whereProp&lt;/code&gt; ===<br /> De belangrijkste where-methode is &lt;code&gt;whereProp&lt;/code&gt;. Met deze methode wordt de where automatisch uitgevoerd op een eigenschap van de objecten waarvan de tables in de query zitten (met from of dmv een join). Hiervoor is het ook nodig dat waarmee je wilt matchen in je where van het juiste type is. Zo is een ID een int en wil je daar dus geen string voor meegeven. De whereProp zoekt ook automatisch de table waarbij de property hoort. Als er meerdere mogelijkheden zijn kan je er altijd 'tablename.' voor zetten, net zoals met normale sql.<br /> <br /> Je kan &lt;code&gt;whereProp&lt;/code&gt; twee of drie argumenten meegeven. Als je twee argumenten meegeeft wordt er een match op gelijkheid aan je query toegevoegd. Hierbij is het eerste argument welke property je wilt matchen en je tweede argument waarmee gematcht wordt.<br /> Selecteer alle Bugs met melder $melder ($melder moet een Persoonobject zijn)<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = BugQuery::table()-&gt;whereProp('melder', $melder);<br /> &lt;/syntaxhighlight&gt;<br /> <br /> Als je drie argumenten meegeeft is het eerste argument nog steeds welke property je wilt matchen, je tweede argument is je operator en je derde argument is waarmee gematcht wordt. De mogelijkheden voor de operatoren zijn <br /> Selecteer alle Bugs waarvan melder niet $melder is ($melder moet een Persoonobject zijn)<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = BugQuery::table()-&gt;whereProp('melder', '!=', $melder);<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;whereProp&lt;/code&gt; varianten ===<br /> <br /> Met de standaard &lt;code&gt;whereProp&lt;/code&gt; kan je alleen een paar operatoren toevoegen aan je where. Daarom zijn er de methoden &lt;code&gt;whereNotProp&lt;/code&gt;, &lt;code&gt;whereLikeProp&lt;/code&gt;, &lt;code&gt;whereNotLikeProp&lt;/code&gt;, &lt;code&gt;whereInProp&lt;/code&gt; en &lt;code&gt;whereNotInProp&lt;/code&gt;. Wat deze methoden doen zit in de naam van de methoden. Voor de &lt;code&gt;whereLikeProp&lt;/code&gt; en &lt;code&gt;whereNotLikeProp&lt;/code&gt; heb je twee argumenten nodig, als eerste de property en als tweede de string. Voor de methoden &lt;code&gt;whereInProp&lt;/code&gt; en &lt;code&gt;whereNotInProp&lt;/code&gt; heb je ook twee argumenten nodig, de property en als tweede de array waar de property in moet zitten.<br /> <br /> === OR ipv AND ===<br /> <br /> Als je meerdere &lt;code&gt;whereProp&lt;/code&gt;-methoden hebt worden ze in de WHERE automatisch aan elkaar geplakt met het AND keyword. Om ze met OR aan elkaar te plakken gebruik je de methode &lt;code&gt;orWhereProp&lt;/code&gt;. Voor alle andere soorten &lt;code&gt;whereProp&lt;/code&gt;-methode kan je op dezelfde manier de or voor de methodenaam plakken en dan worden de where-clausules met OR aan elkaar geplakt.<br /> <br /> [[Category:WebCie]]</div>

Pepijno https://mediawiki.a-eskwadraat.nl/wiki/index.php/QueryBuilder 2017-02-28T20:05:22Z

<p>Pepijno: </p> <hr /> <div>Om SQL-queries makkelijker te maken heeft de WebCie haar eigen sql-library geschreven, de QueryBuilder. De QueryBuilder maakt queries op dmv van een QueryBuilder-object waaraan properties veranderd worden. Op die manier wordt de query pas gebouwd als de query uitgevoerd moet worden. Hierdoor is er meer mogelijkheid voor controle en sanity checks.<br /> <br /> De QueryBuilder bestaat uit de Query-klasse, de QueryBuilder-klasse en alle uitbreidingen. De Query-klasse is een extensie van de QueryBuilder-klasse. Het verschil tussen de twee klasses is dat de QueryBuilder-klasse wordt gebruikt om de query op te bouwen en de Query-klasse wordt gebruikt om van het geheel een werkende query te maken, alsmede verschillende functies zoals het verzamelen van objecten te implementeren.<br /> <br /> == QueryBuilder starten ==<br /> Omdat je een query altijd wilt gebruiken voor WhosWho4-objecten heeft elk WhosWho4-object zijn eigen query-classe die een uitbreiding is van de Query-klasse. Zo heb je bv de PersoonQuery-klasse en de LidQuery-klasse. Deze extensies hebben niet hun eigen speciale constructor. in plaats daarvan heeft elk van deze klassen de methode table waarmee een Query-klasse wordt aangemaakt, het object als table bij de query wordt gezet en het ObjectQuery-object wordt gereturnd zodat er meteen methoden op kunnen worden toegepast. Voor uitgebreide klasse zoals Persoon en Lid worden automatisch de onderliggende klassen gejoind zodat je dit niet zelf hoeft te doen en bij deze data kan.<br /> Een voorbeeld:<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = PersoonQuery::table();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> == Query uitvoeren ==<br /> Een query kan je uitvoeren met de methode &lt;code&gt;get&lt;/code&gt;. &lt;code&gt;get&lt;/code&gt; heeft geen argumenten nodig. Als je verder niets aan je Query-object hebt toegevoegd selecteert de query automatisch alle objecten in de table. Met het volgende voorbeeld worden alle entries uit de Persoon-table opgevraagd:<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $personen = PersoonQuery::table()-&gt;get();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;first&lt;/code&gt; ===<br /> De methode &lt;code&gt;first&lt;/code&gt; voert de query uit zoals &lt;code&gt;get&lt;/code&gt; dat doet en geeft vervolgens alleen het eerste resultaat terug. Met het volgende voorbeeld wordt de eerste entry uit de Persoon-table opgehaald:<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $personen = PersoonQuery::table()-&gt;first();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;aggregate&lt;/code&gt; (TODO: in de php-code moet deze functie nog worden aangepast) ===<br /> De methode &lt;code&gt;aggregate&lt;/code&gt; voert een aggregator uit op de query. De toegestane aggregators zijn: &lt;code&gt;COUNT&lt;/code&gt;, &lt;code&gt;SUM&lt;/code&gt;, &lt;code&gt;MAX&lt;/code&gt;, &lt;code&gt;MIN&lt;/code&gt; en &lt;code&gt;YEAR&lt;/code&gt;. De aggregator pakt op dit moment nog alles ipv een specifieke kolom. &lt;code&gt;aggregate&lt;/code&gt; haalt ook de huidige selectie weg. Een voorbeeld om alle entries in de Persoon-table te tellen:<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $aantal_personen = PersoonQuery::table()-&gt;aggregate('COUNT');<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;count&lt;/code&gt; ===<br /> Om makkelijker entries te tellen is de speciale methode &lt;code&gt;count&lt;/code&gt;. Deze methode telt het aantal entries en haalt ook de orderBys, limits en offset van de query weg.<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $aantal_personen = PersoonQuery::table()-&gt;count();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;verzamel&lt;/code&gt; ===<br /> De methode die het vaakst gebruikt wordt is &lt;code&gt;verzamel&lt;/code&gt;. Net zoals &lt;code&gt;verzamel&lt;/code&gt; van elke Verzameling van een WhosWho4-object verzamelt deze query-methode alle WhosWho4-objecten die met de query opgehaald worden. Hierbij verdwijnen alle huidige selects van de query. De methode kan twee argumenten krijgen: de naam van de klasse om de objecten van te verzamelen as string en of de objecten distinct moeten zijn als bool. Zonder argumenten is distinct true en worden de objecten opgehaald van de klasse waarvan je het query-object gemaakt hebt. Als voorbeeld, haal alle Persoon-objecten op:<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $persoon_objecten = PersoonQuery::table()-&gt;verzamel();<br /> &lt;/syntaxhighlight&gt;<br /> Haal alle distinct bugmelders op (dit voorbeeld gebruikt ook &lt;code&gt;join&lt;/code&gt;):<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $persoon_objecten = BugQuery::table()<br /> -&gt;join('Persoon')<br /> -&gt;verzamel('Persoon', true);<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;geef&lt;/code&gt; ===<br /> Net zoals de methode &lt;code&gt;geef&lt;/code&gt; voor objecten heeft de QueryBuilder een soortgelijke methode. De methode geeft een object terug die wordt opgevraagd dmv de query. Net als bij &lt;code&gt;verzamel&lt;/code&gt; heeft de methode een argument voor het soort object wat je op wilt halen.<br /> Geef het lid-object met ID 5794<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $persoon = PersoonQuery::table()<br /> -&gt;whereInt('contactID', 5794)<br /> -&gt;geef();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> == Joins ==<br /> De QueryBuilder heeft uiteraard ook de mogelijkheid om joins uit te voeren op tables. Nieuwe tabellen worden automatisch op de juiste velden gejoind, dus dit hoef je niet meer zelf te doen. Mocht de QueryBuilder het toch niet zelf kunnen, dan hebben de join-methoden extra argumenten nodig voor het joinen.<br /> <br /> === (left) &lt;code&gt;join&lt;/code&gt; ===<br /> De standaard &lt;code&gt;join&lt;/code&gt; is een left join. Je hoeft als enige argument de table mee te geven om op te joinen. Zo kan je bv de table Persoon joinen met Bug<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = BugQuery::table()-&gt;join('Persoon');<br /> &lt;/syntaxhighlight&gt;<br /> Als het echt nodig is kan je zelf de twee namen van de kolommen meegeven waarop gejoined moet worden<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = BugQuery::table()-&gt;join('Persoon', 'Bug.melder_contactID', 'Persoon.contactID');<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;rightJoin&lt;/code&gt; ===<br /> De &lt;code&gt;rightJoin&lt;/code&gt; werkt hetzelfde als &lt;code&gt;join&lt;/code&gt; alleen voert het een right join uit ipv een left join.<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = BugQuery::table()-&gt;rightJoin('Persoon');<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;innerJoin&lt;/code&gt; ===<br /> De &lt;code&gt;innerJoin&lt;/code&gt; werkt ook hetzelfde als &lt;code&gt;join&lt;/code&gt; alleen voert het een inner join uit ipv een left join.<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = BugQuery::table()-&gt;innerJoin('Persoon');<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;fullJoin&lt;/code&gt; ===<br /> De &lt;code&gt;fullJoin&lt;/code&gt; werkt ook hetzelfde als &lt;code&gt;join&lt;/code&gt; alleen voert het een full join uit ipv een left join.<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = BugQuery::table()-&gt;fullJoin('Persoon');<br /> &lt;/syntaxhighlight&gt;<br /> <br /> == Where ==<br /> Uiteraard heeft een query ook where's nodig. Daarom heeft de QueryBuilder verschillende methoden om where toe te voegen.<br /> <br /> === &lt;code&gt;whereProp&lt;/code&gt; ===<br /> De belangrijkste where-methode is &lt;code&gt;whereProp&lt;/code&gt;. Met deze methode wordt de where automatisch uitgevoerd op een eigenschap van de objecten waarvan de tables in de query zitten (met from of dmv een join). Hiervoor is het ook nodig dat waarmee je wilt matchen in je where van het juiste type is. Zo is een ID een int en wil je daar dus geen string voor meegeven. De whereProp zoekt ook automatisch de table waarbij de property hoort. Als er meerdere mogelijkheden zijn kan je er altijd 'tablename.' voor zetten, net zoals met normale sql.<br /> <br /> Je kan &lt;code&gt;whereProp&lt;/code&gt; twee of drie argumenten meegeven. Als je twee argumenten meegeeft wordt er een match op gelijkheid aan je query toegevoegd. Hierbij is het eerste argument welke property je wilt matchen en je tweede argument waarmee gematcht wordt.<br /> Selecteer alle Bugs met melder $melder ($melder moet een Persoonobject zijn)<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = BugQuery::table()-&gt;whereProp('melder', $melder);<br /> &lt;/syntaxhighlight&gt;<br /> <br /> Als je drie argumenten meegeeft is het eerste argument nog steeds welke property je wilt matchen, je tweede argument is je operator en je derde argument is waarmee gematcht wordt. De mogelijkheden voor de operatoren zijn <br /> Selecteer alle Bugs waarvan melder niet $melder is ($melder moet een Persoonobject zijn)<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = BugQuery::table()-&gt;whereProp('melder', '!=', $melder);<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;whereProp&lt;/code&gt; varianten ===<br /> <br /> Met de standaard &lt;code&gt;whereProp&lt;/code&gt; kan je alleen een paar operatoren toevoegen aan je where. Daarom zijn er de methoden &lt;code&gt;whereNotProp&lt;/code&gt;, &lt;code&gt;whereLikeProp&lt;/code&gt;, &lt;code&gt;whereNotLikeProp&lt;/code&gt;, &lt;code&gt;whereInProp&lt;/code&gt; en &lt;code&gt;whereNotInProp&lt;/code&gt;. Wat deze methoden doen zit in de naam van de methoden. Voor de &lt;code&gt;whereLikeProp&lt;/code&gt; en &lt;code&gt;whereNotLikeProp&lt;/code&gt; heb je twee argumenten nodig, als eerste de property en als tweede de string. Voor de methoden &lt;code&gt;whereInProp&lt;/code&gt; en &lt;code&gt;whereNotInProp&lt;/code&gt; heb je ook twee argumenten nodig, de property en als tweede de array waar de property in moet zitten.<br /> <br /> === OR ipv AND ===<br /> <br /> Als je meerdere &lt;code&gt;whereProp&lt;/code&gt;-methoden hebt worden ze in de WHERE automatisch aan elkaar geplakt met het AND keyword. Om ze met OR aan elkaar te plakken gebruik je de methode &lt;code&gt;orWhereProp&lt;/code&gt; die voor de rest hetzelfde werkt <br /> <br /> [[Category:WebCie]]</div>

Pepijno https://mediawiki.a-eskwadraat.nl/wiki/index.php/QueryBuilder 2017-02-28T20:01:13Z

<p>Pepijno: </p> <hr /> <div>Om SQL-queries makkelijker te maken heeft de WebCie haar eigen sql-library geschreven, de QueryBuilder. De QueryBuilder maakt queries op dmv van een QueryBuilder-object waaraan properties veranderd worden. Op die manier wordt de query pas gebouwd als de query uitgevoerd moet worden. Hierdoor is er meer mogelijkheid voor controle en sanity checks.<br /> <br /> De QueryBuilder bestaat uit de Query-klasse, de QueryBuilder-klasse en alle uitbreidingen. De Query-klasse is een extensie van de QueryBuilder-klasse. Het verschil tussen de twee klasses is dat de QueryBuilder-klasse wordt gebruikt om de query op te bouwen en de Query-klasse wordt gebruikt om van het geheel een werkende query te maken, alsmede verschillende functies zoals het verzamelen van objecten te implementeren.<br /> <br /> == QueryBuilder starten ==<br /> Omdat je een query altijd wilt gebruiken voor WhosWho4-objecten heeft elk WhosWho4-object zijn eigen query-classe die een uitbreiding is van de Query-klasse. Zo heb je bv de PersoonQuery-klasse en de LidQuery-klasse. Deze extensies hebben niet hun eigen speciale constructor. in plaats daarvan heeft elk van deze klassen de methode table waarmee een Query-klasse wordt aangemaakt, het object als table bij de query wordt gezet en het ObjectQuery-object wordt gereturnd zodat er meteen methoden op kunnen worden toegepast. Voor uitgebreide klasse zoals Persoon en Lid worden automatisch de onderliggende klassen gejoind zodat je dit niet zelf hoeft te doen en bij deze data kan.<br /> Een voorbeeld:<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = PersoonQuery::table();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> == Query uitvoeren ==<br /> Een query kan je uitvoeren met de methode &lt;code&gt;get&lt;/code&gt;. &lt;code&gt;get&lt;/code&gt; heeft geen argumenten nodig. Als je verder niets aan je Query-object hebt toegevoegd selecteert de query automatisch alle objecten in de table. Met het volgende voorbeeld worden alle entries uit de Persoon-table opgevraagd:<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $personen = PersoonQuery::table()-&gt;get();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;first&lt;/code&gt; ===<br /> De methode &lt;code&gt;first&lt;/code&gt; voert de query uit zoals &lt;code&gt;get&lt;/code&gt; dat doet en geeft vervolgens alleen het eerste resultaat terug. Met het volgende voorbeeld wordt de eerste entry uit de Persoon-table opgehaald:<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $personen = PersoonQuery::table()-&gt;first();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;aggregate&lt;/code&gt; (TODO: in de php-code moet deze functie nog worden aangepast) ===<br /> De methode &lt;code&gt;aggregate&lt;/code&gt; voert een aggregator uit op de query. De toegestane aggregators zijn: &lt;code&gt;COUNT&lt;/code&gt;, &lt;code&gt;SUM&lt;/code&gt;, &lt;code&gt;MAX&lt;/code&gt;, &lt;code&gt;MIN&lt;/code&gt; en &lt;code&gt;YEAR&lt;/code&gt;. De aggregator pakt op dit moment nog alles ipv een specifieke kolom. &lt;code&gt;aggregate&lt;/code&gt; haalt ook de huidige selectie weg. Een voorbeeld om alle entries in de Persoon-table te tellen:<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $aantal_personen = PersoonQuery::table()-&gt;aggregate('COUNT');<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;count&lt;/code&gt; ===<br /> Om makkelijker entries te tellen is de speciale methode &lt;code&gt;count&lt;/code&gt;. Deze methode telt het aantal entries en haalt ook de orderBys, limits en offset van de query weg.<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $aantal_personen = PersoonQuery::table()-&gt;count();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;verzamel&lt;/code&gt; ===<br /> De methode die het vaakst gebruikt wordt is &lt;code&gt;verzamel&lt;/code&gt;. Net zoals &lt;code&gt;verzamel&lt;/code&gt; van elke Verzameling van een WhosWho4-object verzamelt deze query-methode alle WhosWho4-objecten die met de query opgehaald worden. Hierbij verdwijnen alle huidige selects van de query. De methode kan twee argumenten krijgen: de naam van de klasse om de objecten van te verzamelen as string en of de objecten distinct moeten zijn als bool. Zonder argumenten is distinct true en worden de objecten opgehaald van de klasse waarvan je het query-object gemaakt hebt. Als voorbeeld, haal alle Persoon-objecten op:<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $persoon_objecten = PersoonQuery::table()-&gt;verzamel();<br /> &lt;/syntaxhighlight&gt;<br /> Haal alle distinct bugmelders op (dit voorbeeld gebruikt ook &lt;code&gt;join&lt;/code&gt;):<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $persoon_objecten = BugQuery::table()<br /> -&gt;join('Persoon')<br /> -&gt;verzamel('Persoon', true);<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;geef&lt;/code&gt; ===<br /> Net zoals de methode &lt;code&gt;geef&lt;/code&gt; voor objecten heeft de QueryBuilder een soortgelijke methode. De methode geeft een object terug die wordt opgevraagd dmv de query. Net als bij &lt;code&gt;verzamel&lt;/code&gt; heeft de methode een argument voor het soort object wat je op wilt halen.<br /> Geef het lid-object met ID 5794<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $persoon = PersoonQuery::table()<br /> -&gt;whereInt('contactID', 5794)<br /> -&gt;geef();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> == Joins ==<br /> De QueryBuilder heeft uiteraard ook de mogelijkheid om joins uit te voeren op tables. Nieuwe tabellen worden automatisch op de juiste velden gejoind, dus dit hoef je niet meer zelf te doen. Mocht de QueryBuilder het toch niet zelf kunnen, dan hebben de join-methoden extra argumenten nodig voor het joinen.<br /> <br /> === (left) &lt;code&gt;join&lt;/code&gt; ===<br /> De standaard &lt;code&gt;join&lt;/code&gt; is een left join. Je hoeft als enige argument de table mee te geven om op te joinen. Zo kan je bv de table Persoon joinen met Bug<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = BugQuery::table()-&gt;join('Persoon');<br /> &lt;/syntaxhighlight&gt;<br /> Als het echt nodig is kan je zelf de twee namen van de kolommen meegeven waarop gejoined moet worden<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = BugQuery::table()-&gt;join('Persoon', 'Bug.melder_contactID', 'Persoon.contactID');<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;rightJoin&lt;/code&gt; ===<br /> De &lt;code&gt;rightJoin&lt;/code&gt; werkt hetzelfde als &lt;code&gt;join&lt;/code&gt; alleen voert het een right join uit ipv een left join.<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = BugQuery::table()-&gt;rightJoin('Persoon');<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;innerJoin&lt;/code&gt; ===<br /> De &lt;code&gt;innerJoin&lt;/code&gt; werkt ook hetzelfde als &lt;code&gt;join&lt;/code&gt; alleen voert het een inner join uit ipv een left join.<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = BugQuery::table()-&gt;innerJoin('Persoon');<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;fullJoin&lt;/code&gt; ===<br /> De &lt;code&gt;fullJoin&lt;/code&gt; werkt ook hetzelfde als &lt;code&gt;join&lt;/code&gt; alleen voert het een full join uit ipv een left join.<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = BugQuery::table()-&gt;fullJoin('Persoon');<br /> &lt;/syntaxhighlight&gt;<br /> <br /> == Where ==<br /> Uiteraard heeft een query ook where's nodig. Daarom heeft de QueryBuilder verschillende methoden om where toe te voegen.<br /> <br /> === &lt;code&gt;whereProp&lt;/code&gt; ===<br /> De belangrijkste where-methode is &lt;code&gt;whereProp&lt;/code&gt;. Met deze methode wordt de where automatisch uitgevoerd op een eigenschap van de objecten waarvan de tables in de query zitten (met from of dmv een join). Hiervoor is het ook nodig dat waarmee je wilt matchen in je where van het juiste type is. Zo is een ID een int en wil je daar dus geen string voor meegeven. De whereProp zoekt ook automatisch de table waarbij de property hoort. Als er meerdere mogelijkheden zijn kan je er altijd 'tablename.' voor zetten, net zoals met normale sql.<br /> <br /> Je kan &lt;code&gt;whereProp&lt;/code&gt; twee of drie argumenten meegeven. Als je twee argumenten meegeeft wordt er een match op gelijkheid aan je query toegevoegd. Hierbij is het eerste argument welke property je wilt matchen en je tweede argument waarmee gematcht wordt.<br /> Selecteer alle Bugs met melder $melder ($melder moet een Persoonobject zijn)<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = BugQuery::table()-&gt;whereProp('melder', $melder);<br /> &lt;/syntaxhighlight&gt;<br /> <br /> Als je drie argumenten meegeeft is het eerste argument nog steeds welke property je wilt matchen, je tweede argument is je operator en je derde argument is waarmee gematcht wordt. De mogelijkheden voor de operatoren zijn <br /> Selecteer alle Bugs waarvan melder niet $melder is ($melder moet een Persoonobject zijn)<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = BugQuery::table()-&gt;whereProp('melder', '!=', $melder);<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;whereProp&lt;/code&gt; varianten ===<br /> <br /> Met de standaard &lt;code&gt;whereProp&lt;/code&gt; kan je alleen een paar operatoren toevoegen aan je where. Daarom zijn er de methoden &lt;code&gt;whereLike&lt;/code&gt;, &lt;code&gt;whereNotLike&lt;/code&gt;, &lt;code&gt;whereIn&lt;/code&gt;, &lt;code&gt;whereNotIn&lt;/code&gt;, &lt;code&gt;whereNull&lt;/code&gt; en &lt;code&gt;whereNotNull&lt;/code&gt;.<br /> <br /> === OR ipv AND ===<br /> <br /> Als je meerdere &lt;code&gt;whereProp&lt;/code&gt;-methoden hebt worden ze in de WHERE automatisch aan elkaar geplakt met het AND keyword. Om ze met OR aan elkaar te plakken gebruik je de methode &lt;code&gt;orWhereProp&lt;/code&gt; die voor de rest hetzelfde werkt <br /> <br /> [[Category:WebCie]]</div>

Pepijno https://mediawiki.a-eskwadraat.nl/wiki/index.php/QueryBuilder 2017-02-28T17:47:48Z

<p>Pepijno: /* Where */</p> <hr /> <div>Om SQL-queries makkelijker te maken heeft de WebCie haar eigen sql-library geschreven, de QueryBuilder. De QueryBuilder maakt queries op dmv van een QueryBuilder-object waaraan properties veranderd worden. Op die manier wordt de query pas gebouwd als de query uitgevoerd moet worden. Hierdoor is er meer mogelijkheid voor controle en sanity checks.<br /> <br /> De QueryBuilder bestaat uit de Query-klasse, de QueryBuilder-klasse en alle uitbreidingen. De Query-klasse is een extensie van de QueryBuilder-klasse. Het verschil tussen de twee klasses is dat de QueryBuilder-klasse wordt gebruikt om de query op te bouwen en de Query-klasse wordt gebruikt om van het geheel een werkende query te maken, alsmede verschillende functies zoals het verzamelen van objecten te implementeren.<br /> <br /> == QueryBuilder starten ==<br /> Omdat je een query altijd wilt gebruiken voor WhosWho4-objecten heeft elk WhosWho4-object zijn eigen query-classe die een uitbreiding is van de Query-klasse. Zo heb je bv de PersoonQuery-klasse en de LidQuery-klasse. Deze extensies hebben niet hun eigen speciale constructor. in plaats daarvan heeft elk van deze klassen de methode table waarmee een Query-klasse wordt aangemaakt, het object als table bij de query wordt gezet en het ObjectQuery-object wordt gereturnd zodat er meteen methoden op kunnen worden toegepast. Voor uitgebreide klasse zoals Persoon en Lid worden automatisch de onderliggende klassen gejoind zodat je dit niet zelf hoeft te doen en bij deze data kan.<br /> Een voorbeeld:<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = PersoonQuery::table();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> == Query uitvoeren ==<br /> Een query kan je uitvoeren met de methode &lt;code&gt;get&lt;/code&gt;. &lt;code&gt;get&lt;/code&gt; heeft geen argumenten nodig. Als je verder niets aan je Query-object hebt toegevoegd selecteert de query automatisch alle objecten in de table. Met het volgende voorbeeld worden alle entries uit de Persoon-table opgevraagd:<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $personen = PersoonQuery::table()-&gt;get();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;first&lt;/code&gt; ===<br /> De methode &lt;code&gt;first&lt;/code&gt; voert de query uit zoals &lt;code&gt;get&lt;/code&gt; dat doet en geeft vervolgens alleen het eerste resultaat terug. Met het volgende voorbeeld wordt de eerste entry uit de Persoon-table opgehaald:<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $personen = PersoonQuery::table()-&gt;first();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;aggregate&lt;/code&gt; (TODO: in de php-code moet deze functie nog worden aangepast) ===<br /> De methode &lt;code&gt;aggregate&lt;/code&gt; voert een aggregator uit op de query. De toegestane aggregators zijn: &lt;code&gt;COUNT&lt;/code&gt;, &lt;code&gt;SUM&lt;/code&gt;, &lt;code&gt;MAX&lt;/code&gt;, &lt;code&gt;MIN&lt;/code&gt; en &lt;code&gt;YEAR&lt;/code&gt;. De aggregator pakt op dit moment nog alles ipv een specifieke kolom. &lt;code&gt;aggregate&lt;/code&gt; haalt ook de huidige selectie weg. Een voorbeeld om alle entries in de Persoon-table te tellen:<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $aantal_personen = PersoonQuery::table()-&gt;aggregate('COUNT');<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;count&lt;/code&gt; ===<br /> Om makkelijker entries te tellen is de speciale methode &lt;code&gt;count&lt;/code&gt;. Deze methode telt het aantal entries en haalt ook de orderBys, limits en offset van de query weg.<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $aantal_personen = PersoonQuery::table()-&gt;count();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;verzamel&lt;/code&gt; ===<br /> De methode die het vaakst gebruikt wordt is &lt;code&gt;verzamel&lt;/code&gt;. Net zoals &lt;code&gt;verzamel&lt;/code&gt; van elke Verzameling van een WhosWho4-object verzamelt deze query-methode alle WhosWho4-objecten die met de query opgehaald worden. Hierbij verdwijnen alle huidige selects van de query. De methode kan twee argumenten krijgen: de naam van de klasse om de objecten van te verzamelen as string en of de objecten distinct moeten zijn als bool. Zonder argumenten is distinct true en worden de objecten opgehaald van de klasse waarvan je het query-object gemaakt hebt. Als voorbeeld, haal alle Persoon-objecten op:<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $persoon_objecten = PersoonQuery::table()-&gt;verzamel();<br /> &lt;/syntaxhighlight&gt;<br /> Haal alle distinct bugmelders op (dit voorbeeld gebruikt ook &lt;code&gt;join&lt;/code&gt;):<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $persoon_objecten = BugQuery::table()<br /> -&gt;join('Persoon')<br /> -&gt;verzamel('Persoon', true);<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;geef&lt;/code&gt; ===<br /> Net zoals de methode &lt;code&gt;geef&lt;/code&gt; voor objecten heeft de QueryBuilder een soortgelijke methode. De methode geeft een object terug die wordt opgevraagd dmv de query. Net als bij &lt;code&gt;verzamel&lt;/code&gt; heeft de methode een argument voor het soort object wat je op wilt halen.<br /> Geef het lid-object met ID 5794<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $persoon = PersoonQuery::table()<br /> -&gt;whereInt('contactID', 5794)<br /> -&gt;geef();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> == Joins ==<br /> De QueryBuilder heeft uiteraard ook de mogelijkheid om joins uit te voeren op tables. Nieuwe tabellen worden automatisch op de juiste velden gejoind, dus dit hoef je niet meer zelf te doen. Mocht de QueryBuilder het toch niet zelf kunnen, dan hebben de join-methoden extra argumenten nodig voor het joinen.<br /> <br /> === (left) &lt;code&gt;join&lt;/code&gt; ===<br /> De standaard &lt;code&gt;join&lt;/code&gt; is een left join. Je hoeft als enige argument de table mee te geven om op te joinen. Zo kan je bv de table Persoon joinen met Bug<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = BugQuery::table()-&gt;join('Persoon');<br /> &lt;/syntaxhighlight&gt;<br /> Als het echt nodig is kan je zelf de twee namen van de kolommen meegeven waarop gejoined moet worden<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = BugQuery::table()-&gt;join('Persoon', 'Bug.melder_contactID', 'Persoon.contactID');<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;rightJoin&lt;/code&gt; ===<br /> De &lt;code&gt;rightJoin&lt;/code&gt; werkt hetzelfde als &lt;code&gt;join&lt;/code&gt; alleen voert het een right join uit ipv een left join.<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = BugQuery::table()-&gt;rightJoin('Persoon');<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;innerJoin&lt;/code&gt; ===<br /> De &lt;code&gt;innerJoin&lt;/code&gt; werkt ook hetzelfde als &lt;code&gt;join&lt;/code&gt; alleen voert het een inner join uit ipv een left join.<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = BugQuery::table()-&gt;innerJoin('Persoon');<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;fullJoin&lt;/code&gt; ===<br /> De &lt;code&gt;fullJoin&lt;/code&gt; werkt ook hetzelfde als &lt;code&gt;join&lt;/code&gt; alleen voert het een full join uit ipv een left join.<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = BugQuery::table()-&gt;fullJoin('Persoon');<br /> &lt;/syntaxhighlight&gt;<br /> <br /> == Where ==<br /> Uiteraard heeft een query ook where's nodig. Daarom heeft de QueryBuilder verschillende methoden om where toe te voegen.<br /> <br /> === &lt;code&gt;whereProp&lt;/code&gt; ===<br /> De belangrijkste where-methode is &lt;code&gt;whereProp&lt;/code&gt;. Met deze methode wordt de where automatisch uitgevoerd op een eigenschap van de objecten waarvan de tables in de query zitten (met from of dmv een join). Hiervoor is het ook nodig dat waarmee je wilt matchen in je where van het juiste type is. Zo is een ID een int en wil je daar dus geen string voor meegeven. De whereProp zoekt ook automatisch de table waarbij de property hoort. Als er meerdere mogelijkheden zijn kan je er altijd 'tablename.' voor zetten, net zoals met normale sql.<br /> <br /> Je kan &lt;code&gt;whereProp&lt;/code&gt; twee of drie argumenten meegeven. Als je twee argumenten meegeeft wordt er een match op gelijkheid aan je query toegevoegd. Hierbij is het eerste argument welke property je wilt matchen en je tweede argument waarmee gematcht wordt.<br /> Selecteer alle Bugs met melder $melder ($melder moet een Persoonobject zijn)<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = BugQuery::table()-&gt;whereProp('melder', $melder);<br /> &lt;/syntaxhighlight&gt;<br /> <br /> Als je drie argumenten meegeeft is het eerste argument nog steeds welke property je wilt matchen, je tweede argument is je operator en je derde argument is waarmee gematcht wordt.<br /> Selecteer alle Bugs waarvan melder niet $melder is ($melder moet een Persoonobject zijn)<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = BugQuery::table()-&gt;whereProp('melder', '!=', $melder);<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;whereProp&lt;/code&gt; varianten ===<br /> <br /> === OR ipv AND ===<br /> <br /> Als je meerdere &lt;code&gt;whereProp&lt;/code&gt;-methoden hebt worden ze in de WHERE automatisch aan elkaar geplakt met het AND keyword. Om ze met OR aan elkaar te plakken gebruik je de methode &lt;code&gt;orWhereProp&lt;/code&gt; die voor de rest hetzelfde werkt <br /> <br /> [[Category:WebCie]]</div>

Pepijno https://mediawiki.a-eskwadraat.nl/wiki/index.php/QueryBuilder 2017-02-28T17:44:29Z

<p>Pepijno: /* Where */</p> <hr /> <div>Om SQL-queries makkelijker te maken heeft de WebCie haar eigen sql-library geschreven, de QueryBuilder. De QueryBuilder maakt queries op dmv van een QueryBuilder-object waaraan properties veranderd worden. Op die manier wordt de query pas gebouwd als de query uitgevoerd moet worden. Hierdoor is er meer mogelijkheid voor controle en sanity checks.<br /> <br /> De QueryBuilder bestaat uit de Query-klasse, de QueryBuilder-klasse en alle uitbreidingen. De Query-klasse is een extensie van de QueryBuilder-klasse. Het verschil tussen de twee klasses is dat de QueryBuilder-klasse wordt gebruikt om de query op te bouwen en de Query-klasse wordt gebruikt om van het geheel een werkende query te maken, alsmede verschillende functies zoals het verzamelen van objecten te implementeren.<br /> <br /> == QueryBuilder starten ==<br /> Omdat je een query altijd wilt gebruiken voor WhosWho4-objecten heeft elk WhosWho4-object zijn eigen query-classe die een uitbreiding is van de Query-klasse. Zo heb je bv de PersoonQuery-klasse en de LidQuery-klasse. Deze extensies hebben niet hun eigen speciale constructor. in plaats daarvan heeft elk van deze klassen de methode table waarmee een Query-klasse wordt aangemaakt, het object als table bij de query wordt gezet en het ObjectQuery-object wordt gereturnd zodat er meteen methoden op kunnen worden toegepast. Voor uitgebreide klasse zoals Persoon en Lid worden automatisch de onderliggende klassen gejoind zodat je dit niet zelf hoeft te doen en bij deze data kan.<br /> Een voorbeeld:<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = PersoonQuery::table();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> == Query uitvoeren ==<br /> Een query kan je uitvoeren met de methode &lt;code&gt;get&lt;/code&gt;. &lt;code&gt;get&lt;/code&gt; heeft geen argumenten nodig. Als je verder niets aan je Query-object hebt toegevoegd selecteert de query automatisch alle objecten in de table. Met het volgende voorbeeld worden alle entries uit de Persoon-table opgevraagd:<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $personen = PersoonQuery::table()-&gt;get();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;first&lt;/code&gt; ===<br /> De methode &lt;code&gt;first&lt;/code&gt; voert de query uit zoals &lt;code&gt;get&lt;/code&gt; dat doet en geeft vervolgens alleen het eerste resultaat terug. Met het volgende voorbeeld wordt de eerste entry uit de Persoon-table opgehaald:<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $personen = PersoonQuery::table()-&gt;first();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;aggregate&lt;/code&gt; (TODO: in de php-code moet deze functie nog worden aangepast) ===<br /> De methode &lt;code&gt;aggregate&lt;/code&gt; voert een aggregator uit op de query. De toegestane aggregators zijn: &lt;code&gt;COUNT&lt;/code&gt;, &lt;code&gt;SUM&lt;/code&gt;, &lt;code&gt;MAX&lt;/code&gt;, &lt;code&gt;MIN&lt;/code&gt; en &lt;code&gt;YEAR&lt;/code&gt;. De aggregator pakt op dit moment nog alles ipv een specifieke kolom. &lt;code&gt;aggregate&lt;/code&gt; haalt ook de huidige selectie weg. Een voorbeeld om alle entries in de Persoon-table te tellen:<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $aantal_personen = PersoonQuery::table()-&gt;aggregate('COUNT');<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;count&lt;/code&gt; ===<br /> Om makkelijker entries te tellen is de speciale methode &lt;code&gt;count&lt;/code&gt;. Deze methode telt het aantal entries en haalt ook de orderBys, limits en offset van de query weg.<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $aantal_personen = PersoonQuery::table()-&gt;count();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;verzamel&lt;/code&gt; ===<br /> De methode die het vaakst gebruikt wordt is &lt;code&gt;verzamel&lt;/code&gt;. Net zoals &lt;code&gt;verzamel&lt;/code&gt; van elke Verzameling van een WhosWho4-object verzamelt deze query-methode alle WhosWho4-objecten die met de query opgehaald worden. Hierbij verdwijnen alle huidige selects van de query. De methode kan twee argumenten krijgen: de naam van de klasse om de objecten van te verzamelen as string en of de objecten distinct moeten zijn als bool. Zonder argumenten is distinct true en worden de objecten opgehaald van de klasse waarvan je het query-object gemaakt hebt. Als voorbeeld, haal alle Persoon-objecten op:<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $persoon_objecten = PersoonQuery::table()-&gt;verzamel();<br /> &lt;/syntaxhighlight&gt;<br /> Haal alle distinct bugmelders op (dit voorbeeld gebruikt ook &lt;code&gt;join&lt;/code&gt;):<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $persoon_objecten = BugQuery::table()<br /> -&gt;join('Persoon')<br /> -&gt;verzamel('Persoon', true);<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;geef&lt;/code&gt; ===<br /> Net zoals de methode &lt;code&gt;geef&lt;/code&gt; voor objecten heeft de QueryBuilder een soortgelijke methode. De methode geeft een object terug die wordt opgevraagd dmv de query. Net als bij &lt;code&gt;verzamel&lt;/code&gt; heeft de methode een argument voor het soort object wat je op wilt halen.<br /> Geef het lid-object met ID 5794<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $persoon = PersoonQuery::table()<br /> -&gt;whereInt('contactID', 5794)<br /> -&gt;geef();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> == Joins ==<br /> De QueryBuilder heeft uiteraard ook de mogelijkheid om joins uit te voeren op tables. Nieuwe tabellen worden automatisch op de juiste velden gejoind, dus dit hoef je niet meer zelf te doen. Mocht de QueryBuilder het toch niet zelf kunnen, dan hebben de join-methoden extra argumenten nodig voor het joinen.<br /> <br /> === (left) &lt;code&gt;join&lt;/code&gt; ===<br /> De standaard &lt;code&gt;join&lt;/code&gt; is een left join. Je hoeft als enige argument de table mee te geven om op te joinen. Zo kan je bv de table Persoon joinen met Bug<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = BugQuery::table()-&gt;join('Persoon');<br /> &lt;/syntaxhighlight&gt;<br /> Als het echt nodig is kan je zelf de twee namen van de kolommen meegeven waarop gejoined moet worden<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = BugQuery::table()-&gt;join('Persoon', 'Bug.melder_contactID', 'Persoon.contactID');<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;rightJoin&lt;/code&gt; ===<br /> De &lt;code&gt;rightJoin&lt;/code&gt; werkt hetzelfde als &lt;code&gt;join&lt;/code&gt; alleen voert het een right join uit ipv een left join.<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = BugQuery::table()-&gt;rightJoin('Persoon');<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;innerJoin&lt;/code&gt; ===<br /> De &lt;code&gt;innerJoin&lt;/code&gt; werkt ook hetzelfde als &lt;code&gt;join&lt;/code&gt; alleen voert het een inner join uit ipv een left join.<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = BugQuery::table()-&gt;innerJoin('Persoon');<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;fullJoin&lt;/code&gt; ===<br /> De &lt;code&gt;fullJoin&lt;/code&gt; werkt ook hetzelfde als &lt;code&gt;join&lt;/code&gt; alleen voert het een full join uit ipv een left join.<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = BugQuery::table()-&gt;fullJoin('Persoon');<br /> &lt;/syntaxhighlight&gt;<br /> <br /> == Where ==<br /> Uiteraard heeft een query ook where's nodig. Daarom heeft de QueryBuilder verschillende methoden om where toe te voegen.<br /> <br /> === &lt;code&gt;whereProp&lt;/code&gt; ===<br /> De belangrijkste where-methode is &lt;code&gt;whereProp&lt;/code&gt;. Met deze methode wordt de where automatisch uitgevoerd op een eigenschap van de objecten waarvan de tables in de query zitten (met from of dmv een join). Hiervoor is het ook nodig dat waarmee je wilt matchen in je where van het juiste type is. Zo is een ID een int en wil je daar dus geen string voor meegeven. De whereProp zoekt ook automatisch de table waarbij de property hoort. Als er meerdere mogelijkheden zijn kan je er altijd 'tablename.' voor zetten, net zoals met normale sql.<br /> <br /> Je kan &lt;code&gt;whereProp&lt;/code&gt; twee of drie argumenten meegeven. Als je twee argumenten meegeeft wordt er een match op gelijkheid aan je query toegevoegd. Hierbij is het eerste argument welke property je wilt matchen en je tweede argument waarmee gematcht wordt.<br /> Selecteer alle Bugs met melder $melder ($melder moet een Persoonobject zijn)<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = BugQuery::table()-&gt;whereProp('melder', $melder);<br /> &lt;/syntaxhighlight&gt;<br /> <br /> Als je drie argumenten meegeeft is het eerste argument nog steeds welke property je wilt matchen, je tweede argument is je operator en je derde argument is waarmee gematcht wordt.<br /> Selecteer alle Bugs waarvan melder niet $melder is ($melder moet een Persoonobject zijn)<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = BugQuery::table()-&gt;whereProp('melder', '!=', $melder);<br /> &lt;/syntaxhighlight&gt;<br /> <br /> [[Category:WebCie]]</div>

Pepijno https://mediawiki.a-eskwadraat.nl/wiki/index.php/QueryBuilder 2017-02-28T17:43:22Z

<p>Pepijno: /* Where */</p> <hr /> <div>Om SQL-queries makkelijker te maken heeft de WebCie haar eigen sql-library geschreven, de QueryBuilder. De QueryBuilder maakt queries op dmv van een QueryBuilder-object waaraan properties veranderd worden. Op die manier wordt de query pas gebouwd als de query uitgevoerd moet worden. Hierdoor is er meer mogelijkheid voor controle en sanity checks.<br /> <br /> De QueryBuilder bestaat uit de Query-klasse, de QueryBuilder-klasse en alle uitbreidingen. De Query-klasse is een extensie van de QueryBuilder-klasse. Het verschil tussen de twee klasses is dat de QueryBuilder-klasse wordt gebruikt om de query op te bouwen en de Query-klasse wordt gebruikt om van het geheel een werkende query te maken, alsmede verschillende functies zoals het verzamelen van objecten te implementeren.<br /> <br /> == QueryBuilder starten ==<br /> Omdat je een query altijd wilt gebruiken voor WhosWho4-objecten heeft elk WhosWho4-object zijn eigen query-classe die een uitbreiding is van de Query-klasse. Zo heb je bv de PersoonQuery-klasse en de LidQuery-klasse. Deze extensies hebben niet hun eigen speciale constructor. in plaats daarvan heeft elk van deze klassen de methode table waarmee een Query-klasse wordt aangemaakt, het object als table bij de query wordt gezet en het ObjectQuery-object wordt gereturnd zodat er meteen methoden op kunnen worden toegepast. Voor uitgebreide klasse zoals Persoon en Lid worden automatisch de onderliggende klassen gejoind zodat je dit niet zelf hoeft te doen en bij deze data kan.<br /> Een voorbeeld:<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = PersoonQuery::table();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> == Query uitvoeren ==<br /> Een query kan je uitvoeren met de methode &lt;code&gt;get&lt;/code&gt;. &lt;code&gt;get&lt;/code&gt; heeft geen argumenten nodig. Als je verder niets aan je Query-object hebt toegevoegd selecteert de query automatisch alle objecten in de table. Met het volgende voorbeeld worden alle entries uit de Persoon-table opgevraagd:<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $personen = PersoonQuery::table()-&gt;get();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;first&lt;/code&gt; ===<br /> De methode &lt;code&gt;first&lt;/code&gt; voert de query uit zoals &lt;code&gt;get&lt;/code&gt; dat doet en geeft vervolgens alleen het eerste resultaat terug. Met het volgende voorbeeld wordt de eerste entry uit de Persoon-table opgehaald:<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $personen = PersoonQuery::table()-&gt;first();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;aggregate&lt;/code&gt; (TODO: in de php-code moet deze functie nog worden aangepast) ===<br /> De methode &lt;code&gt;aggregate&lt;/code&gt; voert een aggregator uit op de query. De toegestane aggregators zijn: &lt;code&gt;COUNT&lt;/code&gt;, &lt;code&gt;SUM&lt;/code&gt;, &lt;code&gt;MAX&lt;/code&gt;, &lt;code&gt;MIN&lt;/code&gt; en &lt;code&gt;YEAR&lt;/code&gt;. De aggregator pakt op dit moment nog alles ipv een specifieke kolom. &lt;code&gt;aggregate&lt;/code&gt; haalt ook de huidige selectie weg. Een voorbeeld om alle entries in de Persoon-table te tellen:<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $aantal_personen = PersoonQuery::table()-&gt;aggregate('COUNT');<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;count&lt;/code&gt; ===<br /> Om makkelijker entries te tellen is de speciale methode &lt;code&gt;count&lt;/code&gt;. Deze methode telt het aantal entries en haalt ook de orderBys, limits en offset van de query weg.<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $aantal_personen = PersoonQuery::table()-&gt;count();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;verzamel&lt;/code&gt; ===<br /> De methode die het vaakst gebruikt wordt is &lt;code&gt;verzamel&lt;/code&gt;. Net zoals &lt;code&gt;verzamel&lt;/code&gt; van elke Verzameling van een WhosWho4-object verzamelt deze query-methode alle WhosWho4-objecten die met de query opgehaald worden. Hierbij verdwijnen alle huidige selects van de query. De methode kan twee argumenten krijgen: de naam van de klasse om de objecten van te verzamelen as string en of de objecten distinct moeten zijn als bool. Zonder argumenten is distinct true en worden de objecten opgehaald van de klasse waarvan je het query-object gemaakt hebt. Als voorbeeld, haal alle Persoon-objecten op:<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $persoon_objecten = PersoonQuery::table()-&gt;verzamel();<br /> &lt;/syntaxhighlight&gt;<br /> Haal alle distinct bugmelders op (dit voorbeeld gebruikt ook &lt;code&gt;join&lt;/code&gt;):<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $persoon_objecten = BugQuery::table()<br /> -&gt;join('Persoon')<br /> -&gt;verzamel('Persoon', true);<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;geef&lt;/code&gt; ===<br /> Net zoals de methode &lt;code&gt;geef&lt;/code&gt; voor objecten heeft de QueryBuilder een soortgelijke methode. De methode geeft een object terug die wordt opgevraagd dmv de query. Net als bij &lt;code&gt;verzamel&lt;/code&gt; heeft de methode een argument voor het soort object wat je op wilt halen.<br /> Geef het lid-object met ID 5794<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $persoon = PersoonQuery::table()<br /> -&gt;whereInt('contactID', 5794)<br /> -&gt;geef();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> == Joins ==<br /> De QueryBuilder heeft uiteraard ook de mogelijkheid om joins uit te voeren op tables. Nieuwe tabellen worden automatisch op de juiste velden gejoind, dus dit hoef je niet meer zelf te doen. Mocht de QueryBuilder het toch niet zelf kunnen, dan hebben de join-methoden extra argumenten nodig voor het joinen.<br /> <br /> === (left) &lt;code&gt;join&lt;/code&gt; ===<br /> De standaard &lt;code&gt;join&lt;/code&gt; is een left join. Je hoeft als enige argument de table mee te geven om op te joinen. Zo kan je bv de table Persoon joinen met Bug<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = BugQuery::table()-&gt;join('Persoon');<br /> &lt;/syntaxhighlight&gt;<br /> Als het echt nodig is kan je zelf de twee namen van de kolommen meegeven waarop gejoined moet worden<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = BugQuery::table()-&gt;join('Persoon', 'Bug.melder_contactID', 'Persoon.contactID');<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;rightJoin&lt;/code&gt; ===<br /> De &lt;code&gt;rightJoin&lt;/code&gt; werkt hetzelfde als &lt;code&gt;join&lt;/code&gt; alleen voert het een right join uit ipv een left join.<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = BugQuery::table()-&gt;rightJoin('Persoon');<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;innerJoin&lt;/code&gt; ===<br /> De &lt;code&gt;innerJoin&lt;/code&gt; werkt ook hetzelfde als &lt;code&gt;join&lt;/code&gt; alleen voert het een inner join uit ipv een left join.<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = BugQuery::table()-&gt;innerJoin('Persoon');<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;fullJoin&lt;/code&gt; ===<br /> De &lt;code&gt;fullJoin&lt;/code&gt; werkt ook hetzelfde als &lt;code&gt;join&lt;/code&gt; alleen voert het een full join uit ipv een left join.<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = BugQuery::table()-&gt;fullJoin('Persoon');<br /> &lt;/syntaxhighlight&gt;<br /> <br /> == Where ==<br /> Uiteraard heeft een query ook where's nodig. Daarom heeft de QueryBuilder verschillende methoden om where toe te voegen.<br /> <br /> === &lt;code&gt;whereProp&lt;/code&gt; ===<br /> De belangrijkste where-methode is &lt;code&gt;whereProp&lt;/code&gt;. Met deze methode wordt de where automatisch uitgevoerd op een eigenschap van de objecten waarvan de tables in de query zitten (met from of dmv een join). Hiervoor is het ook nodig dat waarmee je wilt matchen in je where van het juiste type is. Zo is een ID een int en wil je daar dus geen string voor meegeven.<br /> <br /> Je kan &lt;code&gt;whereProp&lt;/code&gt; twee of drie argumenten meegeven. Als je twee argumenten meegeeft wordt er een match op gelijkheid aan je query toegevoegd. Hierbij is het eerste argument welke property je wilt matchen en je tweede argument waarmee gematcht wordt.<br /> Selecteer alle Bugs met melder $melder ($melder moet een Persoonobject zijn)<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = BugQuery::table()-&gt;whereProp('melder', $melder);<br /> &lt;/syntaxhighlight&gt;<br /> <br /> Als je drie argumenten meegeeft is het eerste argument nog steeds welke property je wilt matchen, je tweede argument is je operator en je derde argument is waarmee gematcht wordt.<br /> Selecteer alle Bugs waarvan melder niet $melder is ($melder moet een Persoonobject zijn)<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = BugQuery::table()-&gt;whereProp('melder', '!=', $melder);<br /> &lt;/syntaxhighlight&gt;<br /> <br /> [[Category:WebCie]]</div>

Pepijno https://mediawiki.a-eskwadraat.nl/wiki/index.php/QueryBuilder 2017-02-28T17:32:02Z

<p>Pepijno: </p> <hr /> <div>Om SQL-queries makkelijker te maken heeft de WebCie haar eigen sql-library geschreven, de QueryBuilder. De QueryBuilder maakt queries op dmv van een QueryBuilder-object waaraan properties veranderd worden. Op die manier wordt de query pas gebouwd als de query uitgevoerd moet worden. Hierdoor is er meer mogelijkheid voor controle en sanity checks.<br /> <br /> De QueryBuilder bestaat uit de Query-klasse, de QueryBuilder-klasse en alle uitbreidingen. De Query-klasse is een extensie van de QueryBuilder-klasse. Het verschil tussen de twee klasses is dat de QueryBuilder-klasse wordt gebruikt om de query op te bouwen en de Query-klasse wordt gebruikt om van het geheel een werkende query te maken, alsmede verschillende functies zoals het verzamelen van objecten te implementeren.<br /> <br /> == QueryBuilder starten ==<br /> Omdat je een query altijd wilt gebruiken voor WhosWho4-objecten heeft elk WhosWho4-object zijn eigen query-classe die een uitbreiding is van de Query-klasse. Zo heb je bv de PersoonQuery-klasse en de LidQuery-klasse. Deze extensies hebben niet hun eigen speciale constructor. in plaats daarvan heeft elk van deze klassen de methode table waarmee een Query-klasse wordt aangemaakt, het object als table bij de query wordt gezet en het ObjectQuery-object wordt gereturnd zodat er meteen methoden op kunnen worden toegepast. Voor uitgebreide klasse zoals Persoon en Lid worden automatisch de onderliggende klassen gejoind zodat je dit niet zelf hoeft te doen en bij deze data kan.<br /> Een voorbeeld:<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = PersoonQuery::table();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> == Query uitvoeren ==<br /> Een query kan je uitvoeren met de methode &lt;code&gt;get&lt;/code&gt;. &lt;code&gt;get&lt;/code&gt; heeft geen argumenten nodig. Als je verder niets aan je Query-object hebt toegevoegd selecteert de query automatisch alle objecten in de table. Met het volgende voorbeeld worden alle entries uit de Persoon-table opgevraagd:<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $personen = PersoonQuery::table()-&gt;get();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;first&lt;/code&gt; ===<br /> De methode &lt;code&gt;first&lt;/code&gt; voert de query uit zoals &lt;code&gt;get&lt;/code&gt; dat doet en geeft vervolgens alleen het eerste resultaat terug. Met het volgende voorbeeld wordt de eerste entry uit de Persoon-table opgehaald:<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $personen = PersoonQuery::table()-&gt;first();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;aggregate&lt;/code&gt; (TODO: in de php-code moet deze functie nog worden aangepast) ===<br /> De methode &lt;code&gt;aggregate&lt;/code&gt; voert een aggregator uit op de query. De toegestane aggregators zijn: &lt;code&gt;COUNT&lt;/code&gt;, &lt;code&gt;SUM&lt;/code&gt;, &lt;code&gt;MAX&lt;/code&gt;, &lt;code&gt;MIN&lt;/code&gt; en &lt;code&gt;YEAR&lt;/code&gt;. De aggregator pakt op dit moment nog alles ipv een specifieke kolom. &lt;code&gt;aggregate&lt;/code&gt; haalt ook de huidige selectie weg. Een voorbeeld om alle entries in de Persoon-table te tellen:<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $aantal_personen = PersoonQuery::table()-&gt;aggregate('COUNT');<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;count&lt;/code&gt; ===<br /> Om makkelijker entries te tellen is de speciale methode &lt;code&gt;count&lt;/code&gt;. Deze methode telt het aantal entries en haalt ook de orderBys, limits en offset van de query weg.<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $aantal_personen = PersoonQuery::table()-&gt;count();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;verzamel&lt;/code&gt; ===<br /> De methode die het vaakst gebruikt wordt is &lt;code&gt;verzamel&lt;/code&gt;. Net zoals &lt;code&gt;verzamel&lt;/code&gt; van elke Verzameling van een WhosWho4-object verzamelt deze query-methode alle WhosWho4-objecten die met de query opgehaald worden. Hierbij verdwijnen alle huidige selects van de query. De methode kan twee argumenten krijgen: de naam van de klasse om de objecten van te verzamelen as string en of de objecten distinct moeten zijn als bool. Zonder argumenten is distinct true en worden de objecten opgehaald van de klasse waarvan je het query-object gemaakt hebt. Als voorbeeld, haal alle Persoon-objecten op:<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $persoon_objecten = PersoonQuery::table()-&gt;verzamel();<br /> &lt;/syntaxhighlight&gt;<br /> Haal alle distinct bugmelders op (dit voorbeeld gebruikt ook &lt;code&gt;join&lt;/code&gt;):<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $persoon_objecten = BugQuery::table()<br /> -&gt;join('Persoon')<br /> -&gt;verzamel('Persoon', true);<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;geef&lt;/code&gt; ===<br /> Net zoals de methode &lt;code&gt;geef&lt;/code&gt; voor objecten heeft de QueryBuilder een soortgelijke methode. De methode geeft een object terug die wordt opgevraagd dmv de query. Net als bij &lt;code&gt;verzamel&lt;/code&gt; heeft de methode een argument voor het soort object wat je op wilt halen.<br /> Geef het lid-object met ID 5794<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $persoon = PersoonQuery::table()<br /> -&gt;whereInt('contactID', 5794)<br /> -&gt;geef();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> == Joins ==<br /> De QueryBuilder heeft uiteraard ook de mogelijkheid om joins uit te voeren op tables. Nieuwe tabellen worden automatisch op de juiste velden gejoind, dus dit hoef je niet meer zelf te doen. Mocht de QueryBuilder het toch niet zelf kunnen, dan hebben de join-methoden extra argumenten nodig voor het joinen.<br /> <br /> === (left) &lt;code&gt;join&lt;/code&gt; ===<br /> De standaard &lt;code&gt;join&lt;/code&gt; is een left join. Je hoeft als enige argument de table mee te geven om op te joinen. Zo kan je bv de table Persoon joinen met Bug<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = BugQuery::table()-&gt;join('Persoon');<br /> &lt;/syntaxhighlight&gt;<br /> Als het echt nodig is kan je zelf de twee namen van de kolommen meegeven waarop gejoined moet worden<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = BugQuery::table()-&gt;join('Persoon', 'Bug.melder_contactID', 'Persoon.contactID');<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;rightJoin&lt;/code&gt; ===<br /> De &lt;code&gt;rightJoin&lt;/code&gt; werkt hetzelfde als &lt;code&gt;join&lt;/code&gt; alleen voert het een right join uit ipv een left join.<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = BugQuery::table()-&gt;rightJoin('Persoon');<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;innerJoin&lt;/code&gt; ===<br /> De &lt;code&gt;innerJoin&lt;/code&gt; werkt ook hetzelfde als &lt;code&gt;join&lt;/code&gt; alleen voert het een inner join uit ipv een left join.<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = BugQuery::table()-&gt;innerJoin('Persoon');<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;fullJoin&lt;/code&gt; ===<br /> De &lt;code&gt;fullJoin&lt;/code&gt; werkt ook hetzelfde als &lt;code&gt;join&lt;/code&gt; alleen voert het een full join uit ipv een left join.<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = BugQuery::table()-&gt;fullJoin('Persoon');<br /> &lt;/syntaxhighlight&gt;<br /> <br /> == Where ==<br /> Uiteraard heeft een query ook where's nodig. Daarom heeft de QueryBuilder verschillende methoden om where toe te voegen.<br /> <br /> === &lt;code&gt;whereProp&lt;/code&gt; ===<br /> De belangrijkste where-methode is &lt;code&gt;whereProp&lt;/code&gt;. Met deze methode wordt de where automatisch uitgevoerd op een eigenschap van de objecten waarvan de tables in de query zitten (met from of dmv een join). Hiervoor is het ook nodig dat waarmee je wilt matchen in je where van het juiste type is. Zo is een ID een int en wil je daar dus geen string voor meegeven.<br /> <br /> Je kan &lt;code&gt;whereProp&lt;/code&gt; twee of drie argumenten meegeven. Als je twee argumenten meegeeft wordt er een match op gelijkheid aan je query toegevoegd. Hierbij is het eerste argument welke property je wilt matchen en je tweede argument waarmee gematcht wordt.<br /> Selecteer alle Bugs met melder $melder (melder moet een Persoonobject zijn)<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = BugQuery::table()-&gt;whereProp('melder', $melder);<br /> &lt;/syntaxhighlight&gt;<br /> <br /> [[Category:WebCie]]</div>

Pepijno https://mediawiki.a-eskwadraat.nl/wiki/index.php/QueryBuilder 2017-02-28T16:52:35Z

<p>Pepijno: </p> <hr /> <div>Om SQL-queries makkelijker te maken heeft de WebCie haar eigen sql-library geschreven, de QueryBuilder. De QueryBuilder maakt queries op dmv van een QueryBuilder-object waaraan properties veranderd worden. Op die manier wordt de query pas gebouwd als de query uitgevoerd moet worden. Hierdoor is er meer mogelijkheid voor controle en sanity checks.<br /> <br /> De QueryBuilder bestaat uit de Query-klasse, de QueryBuilder-klasse en alle uitbreidingen. De Query-klasse is een extensie van de QueryBuilder-klasse. Het verschil tussen de twee klasses is dat de QueryBuilder-klasse wordt gebruikt om de query op te bouwen en de Query-klasse wordt gebruikt om van het geheel een werkende query te maken, alsmede verschillende functies zoals het verzamelen van objecten te implementeren.<br /> <br /> == QueryBuilder starten ==<br /> Omdat je een query altijd wilt gebruiken voor WhosWho4-objecten heeft elk WhosWho4-object zijn eigen query-classe die een uitbreiding is van de Query-klasse. Zo heb je bv de PersoonQuery-klasse en de LidQuery-klasse. Deze extensies hebben niet hun eigen speciale constructor. in plaats daarvan heeft elk van deze klassen de methode table waarmee een Query-klasse wordt aangemaakt, het object als table bij de query wordt gezet en het ObjectQuery-object wordt gereturnd zodat er meteen methoden op kunnen worden toegepast. Voor uitgebreide klasse zoals Persoon en Lid worden automatisch de onderliggende klassen gejoind zodat je dit niet zelf hoeft te doen en bij deze data kan.<br /> Een voorbeeld:<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = PersoonQuery::table();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> == Query uitvoeren ==<br /> Een query kan je uitvoeren met de methode &lt;code&gt;get&lt;/code&gt;. &lt;code&gt;get&lt;/code&gt; heeft geen argumenten nodig. Als je verder niets aan je Query-object hebt toegevoegd selecteert de query automatisch alle objecten in de table. Met het volgende voorbeeld worden alle entries uit de Persoon-table opgevraagd:<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $personen = PersoonQuery::table()-&gt;get();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;first&lt;/code&gt; ===<br /> De methode &lt;code&gt;first&lt;/code&gt; voert de query uit zoals &lt;code&gt;get&lt;/code&gt; dat doet en geeft vervolgens alleen het eerste resultaat terug. Met het volgende voorbeeld wordt de eerste entry uit de Persoon-table opgehaald:<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $personen = PersoonQuery::table()-&gt;first();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;aggregate&lt;/code&gt; (TODO: in de php-code moet deze functie nog worden aangepast) ===<br /> De methode &lt;code&gt;aggregate&lt;/code&gt; voert een aggregator uit op de query. De toegestane aggregators zijn: &lt;code&gt;COUNT&lt;/code&gt;, &lt;code&gt;SUM&lt;/code&gt;, &lt;code&gt;MAX&lt;/code&gt;, &lt;code&gt;MIN&lt;/code&gt; en &lt;code&gt;YEAR&lt;/code&gt;. De aggregator pakt op dit moment nog alles ipv een specifieke kolom. &lt;code&gt;aggregate&lt;/code&gt; haalt ook de huidige selectie weg. Een voorbeeld om alle entries in de Persoon-table te tellen:<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $aantal_personen = PersoonQuery::table()-&gt;aggregate('COUNT');<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;count&lt;/code&gt; ===<br /> Om makkelijker entries te tellen is de speciale methode &lt;code&gt;count&lt;/code&gt;. Deze methode telt het aantal entries en haalt ook de orderBys, limits en offset van de query weg.<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $aantal_personen = PersoonQuery::table()-&gt;count();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;verzamel&lt;/code&gt; ===<br /> De methode die het vaakst gebruikt wordt is &lt;code&gt;verzamel&lt;/code&gt;. Net zoals &lt;code&gt;verzamel&lt;/code&gt; van elke Verzameling van een WhosWho4-object verzamelt deze query-methode alle WhosWho4-objecten die met de query opgehaald worden. Hierbij verdwijnen alle huidige selects van de query. De methode kan twee argumenten krijgen: de naam van de klasse om de objecten van te verzamelen as string en of de objecten distinct moeten zijn als bool. Zonder argumenten is distinct true en worden de objecten opgehaald van de klasse waarvan je het query-object gemaakt hebt. Als voorbeeld, haal alle Persoon-objecten op:<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $persoon_objecten = PersoonQuery::table()-&gt;verzamel();<br /> &lt;/syntaxhighlight&gt;<br /> Haal alle distinct bugmelders op (dit voorbeeld gebruikt ook &lt;code&gt;join&lt;/code&gt;):<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $persoon_objecten = BugQuery::table()<br /> -&gt;join('Persoon')<br /> -&gt;verzamel('Persoon', true);<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;geef&lt;/code&gt; ===<br /> Net zoals de methode &lt;code&gt;geef&lt;/code&gt; voor objecten heeft de QueryBuilder een soortgelijke methode. De methode geeft een object terug die wordt opgevraagd dmv de query. Net als bij &lt;code&gt;verzamel&lt;/code&gt; heeft de methode een argument voor het soort object wat je op wilt halen.<br /> Geef het lid-object met ID 5794<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $persoon = PersoonQuery::table()<br /> -&gt;whereInt('contactID', 5794)<br /> -&gt;geef();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> == Joins ==<br /> De QueryBuilder heeft uiteraard ook de mogelijkheid om joins uit te voeren op tables. Nieuwe tabellen worden automatisch op de juiste velden gejoind, dus dit hoef je niet meer zelf te doen. Mocht de QueryBuilder het toch niet zelf kunnen, dan hebben de join-methoden extra argumenten nodig voor het joinen.<br /> <br /> === (left) &lt;code&gt;join&lt;/code&gt; ===<br /> De standaard &lt;code&gt;join&lt;/code&gt; is een left join. Je hoeft als enige argument de table mee te geven om op te joinen. Zo kan je bv de table Persoon joinen met Bug<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = BugQuery::table()-&gt;join('Persoon');<br /> &lt;/syntaxhighlight&gt;<br /> Als het echt nodig is kan je zelf de twee namen van de kolommen meegeven waarop gejoined moet worden<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = BugQuery::table()-&gt;join('Persoon', 'Bug.melder_contactID', 'Persoon.contactID');<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;rightJoin&lt;/code&gt; ===<br /> De &lt;code&gt;rightJoin&lt;/code&gt; werkt hetzelfde als &lt;code&gt;join&lt;/code&gt; alleen voert het een right join uit ipv een left join.<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = BugQuery::table()-&gt;rightJoin('Persoon');<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;innerJoin&lt;/code&gt; ===<br /> De &lt;code&gt;innerJoin&lt;/code&gt; werkt ook hetzelfde als &lt;code&gt;join&lt;/code&gt; alleen voert het een inner join uit ipv een left join.<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = BugQuery::table()-&gt;innerJoin('Persoon');<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;fullJoin&lt;/code&gt; ===<br /> De &lt;code&gt;fullJoin&lt;/code&gt; werkt ook hetzelfde als &lt;code&gt;join&lt;/code&gt; alleen voert het een full join uit ipv een left join.<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = BugQuery::table()-&gt;fullJoin('Persoon');<br /> &lt;/syntaxhighlight&gt;<br /> <br /> [[Category:WebCie]]</div>

Pepijno https://mediawiki.a-eskwadraat.nl/wiki/index.php/QueryBuilder 2017-02-28T16:51:58Z

<p>Pepijno: </p> <hr /> <div>Om SQL-queries makkelijker te maken heeft de WebCie haar eigen sql-library geschreven, de QueryBuilder. De QueryBuilder maakt queries op dmv van een QueryBuilder-object waaraan properties veranderd worden. Op die manier wordt de query pas gebouwd als de query uitgevoerd moet worden. Hierdoor is er meer mogelijkheid voor controle en sanity checks.<br /> <br /> De QueryBuilder bestaat uit de Query-klasse, de QueryBuilder-klasse en alle uitbreidingen. De Query-klasse is een extensie van de QueryBuilder-klasse. Het verschil tussen de twee klasses is dat de QueryBuilder-klasse wordt gebruikt om de query op te bouwen en de Query-klasse wordt gebruikt om van het geheel een werkende query te maken, alsmede verschillende functies zoals het verzamelen van objecten te implementeren.<br /> <br /> == QueryBuilder starten ==<br /> Omdat je een query altijd wilt gebruiken voor WhosWho4-objecten heeft elk WhosWho4-object zijn eigen query-classe die een uitbreiding is van de Query-klasse. Zo heb je bv de PersoonQuery-klasse en de LidQuery-klasse. Deze extensies hebben niet hun eigen speciale constructor. in plaats daarvan heeft elk van deze klassen de methode table waarmee een Query-klasse wordt aangemaakt, het object als table bij de query wordt gezet en het ObjectQuery-object wordt gereturnd zodat er meteen methoden op kunnen worden toegepast. Voor uitgebreide klasse zoals Persoon en Lid worden automatisch de onderliggende klassen gejoind zodat je dit niet zelf hoeft te doen en bij deze data kan.<br /> Een voorbeeld:<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = PersoonQuery::table();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> == Query uitvoeren ==<br /> Een query kan je uitvoeren met de methode &lt;code&gt;get&lt;/code&gt;. &lt;code&gt;get&lt;/code&gt; heeft geen argumenten nodig. Als je verder niets aan je Query-object hebt toegevoegd selecteert de query automatisch alle objecten in de table. Met het volgende voorbeeld worden alle entries uit de Persoon-table opgevraagd:<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $personen = PersoonQuery::table()-&gt;get();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;first&lt;/code&gt; ===<br /> De methode &lt;code&gt;first&lt;/code&gt; voert de query uit zoals &lt;code&gt;get&lt;/code&gt; dat doet en geeft vervolgens alleen het eerste resultaat terug. Met het volgende voorbeeld wordt de eerste entry uit de Persoon-table opgehaald:<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $personen = PersoonQuery::table()-&gt;first();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;aggregate&lt;/code&gt; (TODO: in de php-code moet deze functie nog worden aangepast) ===<br /> De methode &lt;code&gt;aggregate&lt;/code&gt; voert een aggregator uit op de query. De toegestane aggregators zijn: &lt;code&gt;COUNT&lt;/code&gt;, &lt;code&gt;SUM&lt;/code&gt;, &lt;code&gt;MAX&lt;/code&gt;, &lt;code&gt;MIN&lt;/code&gt; en &lt;code&gt;YEAR&lt;/code&gt;. De aggregator pakt op dit moment nog alles ipv een specifieke kolom. &lt;code&gt;aggregate&lt;/code&gt; haalt ook de huidige selectie weg. Een voorbeeld om alle entries in de Persoon-table te tellen:<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $aantal_personen = PersoonQuery::table()-&gt;aggregate('COUNT');<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;count&lt;/code&gt; ===<br /> Om makkelijker entries te tellen is de speciale methode &lt;code&gt;count&lt;/code&gt;. Deze methode telt het aantal entries en haalt ook de orderBys, limits en offset van de query weg.<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $aantal_personen = PersoonQuery::table()-&gt;count();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;verzamel&lt;/code&gt; ===<br /> De methode die het vaakst gebruikt wordt is &lt;code&gt;verzamel&lt;/code&gt;. Net zoals &lt;code&gt;verzamel&lt;/code&gt; van elke Verzameling van een WhosWho4-object verzamelt deze query-methode alle WhosWho4-objecten die met de query opgehaald worden. Hierbij verdwijnen alle huidige selects van de query. De methode kan twee argumenten krijgen: de naam van de klasse om de objecten van te verzamelen as string en of de objecten distinct moeten zijn als bool. Zonder argumenten is distinct true en worden de objecten opgehaald van de klasse waarvan je het query-object gemaakt hebt. Als voorbeeld, haal alle Persoon-objecten op:<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $persoon_objecten = PersoonQuery::table()-&gt;verzamel();<br /> &lt;/syntaxhighlight&gt;<br /> Haal alle distinct bugmelders op (dit voorbeeld gebruikt ook &lt;code&gt;join&lt;/code&gt;):<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $persoon_objecten = BugQuery::table()<br /> -&gt;join('Persoon')<br /> -&gt;verzamel('Persoon', true);<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;geef&lt;/code&gt; ===<br /> Net zoals de methode &lt;code&gt;geef&lt;/code&gt; voor objecten heeft de QueryBuilder een soortgelijke methode. De methode geeft een object terug die wordt opgevraagd dmv de query. Net als bij &lt;code&gt;verzamel&lt;/code&gt; heeft de methode een argument voor het soort object wat je op wilt halen.<br /> Geef het lid-object met ID 5794<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $persoon = PersoonQuery::table()<br /> -&gt;whereInt('contactID', 5794)<br /> -&gt;geef();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> == Joins ==<br /> De QueryBuilder heeft uiteraard ook de mogelijkheid om joins uit te voeren op tables. Nieuwe tabellen worden automatisch op de juiste velden gejoind, dus dit hoef je niet meer zelf te doen. Mocht de QueryBuilder het toch niet zelf kunnen, dan hebben de join-methoden extra argumenten nodig voor het joinen.<br /> <br /> === (left) &lt;code&gt;join&lt;/code&gt; ===<br /> De standaard &lt;code&gt;join&lt;/code&gt; is een left join. Je hoeft als enige argument de table mee te geven om op te joinen. Zo kan je bv de table Persoon joinen met Bug<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = BugQuery::table()-&gt;join('Persoon');<br /> &lt;/syntaxhighlight&gt;<br /> Als het echt nodig is kan je zelf de twee namen van de kolommen meegeven waarop gejoined moet worden<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = BugQuery::table()-&gt;join('Persoon', 'Bug.melder_contactID', 'Persoon.contactID');<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;rightJoin&lt;/code&gt; ===<br /> De &lt;code&gt;rightJoin&lt;/code&gt; werkt hetzelfde als &lt;code&gt;join&lt;/code&gt; alleen voert het een right join uit ipv een left join.<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = BugQuery::table()-&gt;rightJoin('Persoon');<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;innerJoin&lt;/code&gt; ===<br /> De &lt;code&gt;innerJoin&lt;/code&gt; werkt ook hetzelfde als &lt;code&gt;join&lt;/code&gt; alleen voert het een inner join uit ipv een left join.<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = BugQuery::table()-&gt;innerJoin('Persoon');<br /> &lt;/syntaxhighlight&gt;<br /> <br /> [[Category:WebCie]]</div>

Pepijno https://mediawiki.a-eskwadraat.nl/wiki/index.php/QueryBuilder 2017-02-28T16:47:50Z

<p>Pepijno: </p> <hr /> <div>Om SQL-queries makkelijker te maken heeft de WebCie haar eigen sql-library geschreven, de QueryBuilder. De QueryBuilder maakt queries op dmv van een QueryBuilder-object waaraan properties veranderd worden. Op die manier wordt de query pas gebouwd als de query uitgevoerd moet worden. Hierdoor is er meer mogelijkheid voor controle en sanity checks.<br /> <br /> De QueryBuilder bestaat uit de Query-klasse, de QueryBuilder-klasse en alle uitbreidingen. De Query-klasse is een extensie van de QueryBuilder-klasse. Het verschil tussen de twee klasses is dat de QueryBuilder-klasse wordt gebruikt om de query op te bouwen en de Query-klasse wordt gebruikt om van het geheel een werkende query te maken, alsmede verschillende functies zoals het verzamelen van objecten te implementeren.<br /> <br /> == QueryBuilder starten ==<br /> Omdat je een query altijd wilt gebruiken voor WhosWho4-objecten heeft elk WhosWho4-object zijn eigen query-classe die een uitbreiding is van de Query-klasse. Zo heb je bv de PersoonQuery-klasse en de LidQuery-klasse. Deze extensies hebben niet hun eigen speciale constructor. in plaats daarvan heeft elk van deze klassen de methode table waarmee een Query-klasse wordt aangemaakt, het object als table bij de query wordt gezet en het ObjectQuery-object wordt gereturnd zodat er meteen methoden op kunnen worden toegepast. Een voorbeeld:<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = PersoonQuery::table();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> == Query uitvoeren ==<br /> Een query kan je uitvoeren met de methode &lt;code&gt;get&lt;/code&gt;. &lt;code&gt;get&lt;/code&gt; heeft geen argumenten nodig. Als je verder niets aan je Query-object hebt toegevoegd selecteert de query automatisch alle objecten in de table. Met het volgende voorbeeld worden alle entries uit de Persoon-table opgevraagd:<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $personen = PersoonQuery::table()-&gt;get();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;first&lt;/code&gt; ===<br /> De methode &lt;code&gt;first&lt;/code&gt; voert de query uit zoals &lt;code&gt;get&lt;/code&gt; dat doet en geeft vervolgens alleen het eerste resultaat terug. Met het volgende voorbeeld wordt de eerste entry uit de Persoon-table opgehaald:<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $personen = PersoonQuery::table()-&gt;first();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;aggregate&lt;/code&gt; (TODO: in de php-code moet deze functie nog worden aangepast) ===<br /> De methode &lt;code&gt;aggregate&lt;/code&gt; voert een aggregator uit op de query. De toegestane aggregators zijn: &lt;code&gt;COUNT&lt;/code&gt;, &lt;code&gt;SUM&lt;/code&gt;, &lt;code&gt;MAX&lt;/code&gt;, &lt;code&gt;MIN&lt;/code&gt; en &lt;code&gt;YEAR&lt;/code&gt;. De aggregator pakt op dit moment nog alles ipv een specifieke kolom. &lt;code&gt;aggregate&lt;/code&gt; haalt ook de huidige selectie weg. Een voorbeeld om alle entries in de Persoon-table te tellen:<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $aantal_personen = PersoonQuery::table()-&gt;aggregate('COUNT');<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;count&lt;/code&gt; ===<br /> Om makkelijker entries te tellen is de speciale methode &lt;code&gt;count&lt;/code&gt;. Deze methode telt het aantal entries en haalt ook de orderBys, limits en offset van de query weg.<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $aantal_personen = PersoonQuery::table()-&gt;count();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;verzamel&lt;/code&gt; ===<br /> De methode die het vaakst gebruikt wordt is &lt;code&gt;verzamel&lt;/code&gt;. Net zoals &lt;code&gt;verzamel&lt;/code&gt; van elke Verzameling van een WhosWho4-object verzamelt deze query-methode alle WhosWho4-objecten die met de query opgehaald worden. Hierbij verdwijnen alle huidige selects van de query. De methode kan twee argumenten krijgen: de naam van de klasse om de objecten van te verzamelen as string en of de objecten distinct moeten zijn als bool. Zonder argumenten is distinct true en worden de objecten opgehaald van de klasse waarvan je het query-object gemaakt hebt. Als voorbeeld, haal alle Persoon-objecten op:<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $persoon_objecten = PersoonQuery::table()-&gt;verzamel();<br /> &lt;/syntaxhighlight&gt;<br /> Haal alle distinct bugmelders op (dit voorbeeld gebruikt ook &lt;code&gt;join&lt;/code&gt;):<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $persoon_objecten = BugQuery::table()<br /> -&gt;join('Persoon')<br /> -&gt;verzamel('Persoon', true);<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;geef&lt;/code&gt; ===<br /> Net zoals de methode &lt;code&gt;geef&lt;/code&gt; voor objecten heeft de QueryBuilder een soortgelijke methode. De methode geeft een object terug die wordt opgevraagd dmv de query. Net als bij &lt;code&gt;verzamel&lt;/code&gt; heeft de methode een argument voor het soort object wat je op wilt halen.<br /> Geef het lid-object met ID 5794<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $persoon = PersoonQuery::table()<br /> -&gt;whereInt('contactID', 5794)<br /> -&gt;geef();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> == Joins ==<br /> De QueryBuilder heeft uiteraard ook de mogelijkheid om joins uit te voeren op tables. Nieuwe tabellen worden automatisch op de juiste velden gejoind, dus dit hoef je niet meer zelf te doen. Mocht de QueryBuilder het toch niet zelf kunnen, dan hebben de join-methoden extra argumenten nodig voor het joinen.<br /> <br /> === (left) &lt;code&gt;join&lt;/code&gt; ===<br /> De standaard &lt;code&gt;join&lt;/code&gt; is een left join. Je hoeft als enige argument de table mee te geven om op te joinen. Zo kan je bv de table Persoon joinen met Bug<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = BugQuery::table()-&gt;join('Persoon');<br /> &lt;/syntaxhighlight&gt;<br /> Als het echt nodig is kan je zelf de twee namen van de kolommen meegeven waarop gejoined moet worden<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = BugQuery::table()-&gt;join('Persoon', 'Bug.melder_contactID', 'Persoon.contactID');<br /> &lt;/syntaxhighlight&gt;<br /> <br /> [[Category:WebCie]]</div>

Pepijno https://mediawiki.a-eskwadraat.nl/wiki/index.php/QueryBuilder 2017-02-28T16:45:58Z

<p>Pepijno: </p> <hr /> <div>Om SQL-queries makkelijker te maken heeft de WebCie haar eigen sql-library geschreven, de QueryBuilder. De QueryBuilder maakt queries op dmv van een QueryBuilder-object waaraan properties veranderd worden. Op die manier wordt de query pas gebouwd als de query uitgevoerd moet worden. Hierdoor is er meer mogelijkheid voor controle en sanity checks.<br /> <br /> De QueryBuilder bestaat uit de Query-klasse, de QueryBuilder-klasse en alle uitbreidingen. De Query-klasse is een extensie van de QueryBuilder-klasse. Het verschil tussen de twee klasses is dat de QueryBuilder-klasse wordt gebruikt om de query op te bouwen en de Query-klasse wordt gebruikt om van het geheel een werkende query te maken, alsmede verschillende functies zoals het verzamelen van objecten te implementeren.<br /> <br /> == QueryBuilder starten ==<br /> Omdat je een query altijd wilt gebruiken voor WhosWho4-objecten heeft elk WhosWho4-object zijn eigen query-classe die een uitbreiding is van de Query-klasse. Zo heb je bv de PersoonQuery-klasse en de LidQuery-klasse. Deze extensies hebben niet hun eigen speciale constructor. in plaats daarvan heeft elk van deze klassen de methode table waarmee een Query-klasse wordt aangemaakt, het object als table bij de query wordt gezet en het ObjectQuery-object wordt gereturnd zodat er meteen methoden op kunnen worden toegepast. Een voorbeeld:<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = PersoonQuery::table();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> == Query uitvoeren ==<br /> Een query kan je uitvoeren met de methode &lt;code&gt;get&lt;/code&gt;. &lt;code&gt;get&lt;/code&gt; heeft geen argumenten nodig. Als je verder niets aan je Query-object hebt toegevoegd selecteert de query automatisch alle objecten in de table. Met het volgende voorbeeld worden alle entries uit de Persoon-table opgevraagd:<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $personen = PersoonQuery::table()-&gt;get();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;first&lt;/code&gt; ===<br /> De methode &lt;code&gt;first&lt;/code&gt; voert de query uit zoals &lt;code&gt;get&lt;/code&gt; dat doet en geeft vervolgens alleen het eerste resultaat terug. Met het volgende voorbeeld wordt de eerste entry uit de Persoon-table opgehaald:<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $personen = PersoonQuery::table()-&gt;first();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;aggregate&lt;/code&gt; (TODO: in de php-code moet deze functie nog worden aangepast) ===<br /> De methode &lt;code&gt;aggregate&lt;/code&gt; voert een aggregator uit op de query. De toegestane aggregators zijn: &lt;code&gt;COUNT&lt;/code&gt;, &lt;code&gt;SUM&lt;/code&gt;, &lt;code&gt;MAX&lt;/code&gt;, &lt;code&gt;MIN&lt;/code&gt; en &lt;code&gt;YEAR&lt;/code&gt;. De aggregator pakt op dit moment nog alles ipv een specifieke kolom. &lt;code&gt;aggregate&lt;/code&gt; haalt ook de huidige selectie weg. Een voorbeeld om alle entries in de Persoon-table te tellen:<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $aantal_personen = PersoonQuery::table()-&gt;aggregate('COUNT');<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;count&lt;/code&gt; ===<br /> Om makkelijker entries te tellen is de speciale methode &lt;code&gt;count&lt;/code&gt;. Deze methode telt het aantal entries en haalt ook de orderBys, limits en offset van de query weg.<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $aantal_personen = PersoonQuery::table()-&gt;count();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;verzamel&lt;/code&gt; ===<br /> De methode die het vaakst gebruikt wordt is &lt;code&gt;verzamel&lt;/code&gt;. Net zoals &lt;code&gt;verzamel&lt;/code&gt; van elke Verzameling van een WhosWho4-object verzamelt deze query-methode alle WhosWho4-objecten die met de query opgehaald worden. Hierbij verdwijnen alle huidige selects van de query. De methode kan twee argumenten krijgen: de naam van de klasse om de objecten van te verzamelen as string en of de objecten distinct moeten zijn als bool. Zonder argumenten is distinct true en worden de objecten opgehaald van de klasse waarvan je het query-object gemaakt hebt. Als voorbeeld, haal alle Persoon-objecten op:<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $persoon_objecten = PersoonQuery::table()-&gt;verzamel();<br /> &lt;/syntaxhighlight&gt;<br /> Haal alle distinct bugmelders op (dit voorbeeld gebruikt ook &lt;code&gt;join&lt;/code&gt;):<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $persoon_objecten = BugQuery::table()<br /> -&gt;join('Persoon')<br /> -&gt;verzamel('Persoon', true);<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;geef&lt;/code&gt; ===<br /> Net zoals de methode &lt;code&gt;geef&lt;/code&gt; voor objecten heeft de QueryBuilder een soortgelijke methode. De methode geeft een object terug die wordt opgevraagd dmv de query. Net als bij &lt;code&gt;verzamel&lt;/code&gt; heeft de methode een argument voor het soort object wat je op wilt halen.<br /> Geef het lid met ID 5794<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $persoon = PersoonQuery::table()<br /> -&gt;whereInt('persoonId', 5794)<br /> -&gt;geef();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> == Joins ==<br /> De QueryBuilder heeft uiteraard ook de mogelijkheid om joins uit te voeren op tables. Nieuwe tabellen worden automatisch op de juiste velden gejoind, dus dit hoef je niet meer zelf te doen. Mocht de QueryBuilder het toch niet zelf kunnen, dan hebben de join-methoden extra argumenten nodig voor het joinen. De standaard &lt;code&gt;join&lt;/code&gt; is een left join. Je hoeft als enige argument de table mee te geven om op te joinen. Zo kan je bv de table Persoon joinen met Bug<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = BugQuery::table()-&gt;join('Persoon');<br /> &lt;/syntaxhighlight&gt;<br /> <br /> [[Category:WebCie]]</div>

Pepijno https://mediawiki.a-eskwadraat.nl/wiki/index.php/QueryBuilder 2017-02-28T16:07:48Z

<p>Pepijno: </p> <hr /> <div>Om SQL-queries makkelijker te maken heeft de WebCie haar eigen sql-library geschreven, de QueryBuilder. De QueryBuilder maakt queries op dmv van een QueryBuilder-object waaraan properties veranderd worden. Op die manier wordt de query pas gebouwd als de query uitgevoerd moet worden. Hierdoor is er meer mogelijkheid voor controle en sanity checks.<br /> <br /> De QueryBuilder bestaat uit de Query-klasse, de QueryBuilder-klasse en alle uitbreidingen. De Query-klasse is een extensie van de QueryBuilder-klasse. Het verschil tussen de twee klasses is dat de QueryBuilder-klasse wordt gebruikt om de query op te bouwen en de Query-klasse wordt gebruikt om van het geheel een werkende query te maken, alsmede verschillende functies zoals het verzamelen van objecten te implementeren.<br /> <br /> == QueryBuilder starten ==<br /> Omdat je een query altijd wilt gebruiken voor WhosWho4-objecten heeft elk WhosWho4-object zijn eigen query-classe die een uitbreiding is van de Query-klasse. Zo heb je bv de PersoonQuery-klasse en de LidQuery-klasse. Deze extensies hebben niet hun eigen speciale constructor. in plaats daarvan heeft elk van deze klassen de methode table waarmee een Query-klasse wordt aangemaakt, het object als table bij de query wordt gezet en het ObjectQuery-object wordt gereturnd zodat er meteen methoden op kunnen worden toegepast. Een voorbeeld:<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = PersoonQuery::table();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> == Query uitvoeren ==<br /> Een query kan je uitvoeren met de methode &lt;code&gt;get&lt;/code&gt;. &lt;code&gt;get&lt;/code&gt; heeft geen argumenten nodig. Als je verder niets aan je Query-object hebt toegevoegd selecteert de query automatisch alle objecten in de table. Met het volgende voorbeeld worden alle entries uit de Persoon-table opgevraagd:<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $personen = PersoonQuery::table()-&gt;get();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;first&lt;/code&gt; ===<br /> De methode &lt;code&gt;first&lt;/code&gt; voert de query uit zoals &lt;code&gt;get&lt;/code&gt; dat doet en geeft vervolgens alleen het eerste resultaat terug. Met het volgende voorbeeld wordt de eerste entry uit de Persoon-table opgehaald:<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $personen = PersoonQuery::table()-&gt;first();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;aggregate&lt;/code&gt; (TODO: in de php-code moet deze functie nog worden aangepast) ===<br /> De methode &lt;code&gt;aggregate&lt;/code&gt; voert een aggregator uit op de query. De toegestane aggregators zijn: &lt;code&gt;COUNT&lt;/code&gt;, &lt;code&gt;SUM&lt;/code&gt;, &lt;code&gt;MAX&lt;/code&gt;, &lt;code&gt;MIN&lt;/code&gt; en &lt;code&gt;YEAR&lt;/code&gt;. De aggregator pakt op dit moment nog alles ipv een specifieke kolom. &lt;code&gt;aggregate&lt;/code&gt; haalt ook de huidige selectie weg. Een voorbeeld om alle entries in de Persoon-table te tellen:<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $aantal_personen = PersoonQuery::table()-&gt;aggregate('COUNT');<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;count&lt;/code&gt; ===<br /> Om makkelijker entries te tellen is de speciale methode &lt;code&gt;count&lt;/code&gt;. Deze methode telt het aantal entries en haalt ook de orderBys, limits en offset van de query weg.<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $aantal_personen = PersoonQuery::table()-&gt;count();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;verzamel&lt;/code&gt; ===<br /> De methode die het vaakst gebruikt wordt is &lt;code&gt;verzamel&lt;/code&gt;. Net zoals &lt;code&gt;verzamel&lt;/code&gt; van elke Verzameling van een WhosWho4-object verzamelt deze query-methode alle WhosWho4-objecten die met de query opgehaald worden. Hierbij verdwijnen alle huidige selects van de query. De methode kan twee argumenten krijgen: de naam van de klasse om de objecten van te verzamelen as string en of de objecten distinct moeten zijn als bool. Zonder argumenten is distinct true en worden de objecten opgehaald van de klasse waarvan je het query-object gemaakt hebt. Als voorbeeld, haal alle Persoon-objecten op:<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $persoon_objecten = PersoonQuery::table()-&gt;verzamel();<br /> &lt;/syntaxhighlight&gt;<br /> Haal alle distinct bugmelders op (dit voorbeeld gebruikt ook &lt;code&gt;join&lt;/code&gt;):<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $persoon_objecten = BugQuery::table()<br /> -&gt;join('Persoon')<br /> -&gt;verzamel('Persoon', true);<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;geef&lt;/code&gt; ===<br /> Net zoals de methode &lt;code&gt;geef&lt;/code&gt; voor objecten heeft de QueryBuilder een soortgelijke methode. De methode geeft een object terug die wordt opgevraagd dmv de query. Net als bij &lt;code&gt;verzamel&lt;/code&gt; heeft de methode een argument voor het soort object wat je op wilt halen.<br /> Geef het lid met ID 5794<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $persoon = PersoonQuery::table()<br /> -&gt;whereInt('id', 5794)<br /> -&gt;geef();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> [[Category:WebCie]]</div>

Pepijno https://mediawiki.a-eskwadraat.nl/wiki/index.php/QueryBuilder 2017-02-28T14:06:53Z

<p>Pepijno: </p> <hr /> <div>Om SQL-queries makkelijker te maken heeft de WebCie haar eigen sql-library geschreven, de QueryBuilder. De QueryBuilder maakt queries op dmv van een QueryBuilder-object waaraan properties veranderd worden. Op die manier wordt de query pas gebouwd als de query uitgevoerd moet worden. Hierdoor is er meer mogelijkheid voor controle en sanity checks.<br /> <br /> De QueryBuilder bestaat uit de Query-klasse, de QueryBuilder-klasse en alle uitbreidingen. De Query-klasse is een extensie van de QueryBuilder-klasse. Het verschil tussen de twee klasses is dat de QueryBuilder-klasse wordt gebruikt om de query op te bouwen en de Query-klasse wordt gebruikt om van het geheel een werkende query te maken, alsmede verschillende functies zoals het verzamelen van objecten te implementeren.<br /> <br /> == QueryBuilder starten ==<br /> Omdat je een query altijd wilt gebruiken voor WhosWho4-objecten heeft elk WhosWho4-object zijn eigen query-classe die een uitbreiding is van de Query-klasse. Zo heb je bv de PersoonQuery-klasse en de LidQuery-klasse. Deze extensies hebben niet hun eigen speciale constructor. in plaats daarvan heeft elk van deze klassen de methode table waarmee een Query-klasse wordt aangemaakt, het object als table bij de query wordt gezet en het ObjectQuery-object wordt gereturnd zodat er meteen methoden op kunnen worden toegepast. Een voorbeeld:<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = PersoonQuery::table();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> == Query uitvoeren ==<br /> Een query kan je uitvoeren met de methode &lt;code&gt;get&lt;/code&gt;. &lt;code&gt;get&lt;/code&gt; heeft geen argumenten nodig. Als je verder niets aan je Query-object hebt toegevoegd selecteert de query automatisch alle objecten in de table. Met het volgende voorbeeld worden alle entries uit de Persoon-table opgevraagd:<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $personen = PersoonQuery::table()-&gt;get();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;first&lt;/code&gt; ===<br /> De methode &lt;code&gt;first&lt;/code&gt; voert de query uit zoals &lt;code&gt;get&lt;/code&gt; dat doet en geeft vervolgens alleen het eerste resultaat terug. Met het volgende voorbeeld wordt de eerste entry uit de Persoon-table opgehaald:<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $personen = PersoonQuery::table()-&gt;first();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;aggregate&lt;/code&gt; (TODO: in de php-code moet deze functie nog worden aangepast) ===<br /> De methode &lt;code&gt;aggregate&lt;/code&gt; voert een aggregator uit op de query. De toegestane aggregators zijn: &lt;code&gt;COUNT&lt;/code&gt;, &lt;code&gt;SUM&lt;/code&gt;, &lt;code&gt;MAX&lt;/code&gt;, &lt;code&gt;MIN&lt;/code&gt; en &lt;code&gt;YEAR&lt;/code&gt;. De aggregator pakt op dit moment nog alles ipv een specifieke kolom. &lt;code&gt;aggregate&lt;/code&gt; haalt ook de huidige selectie weg. Een voorbeeld om alle entries in de Persoon-table te tellen:<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $aantal_personen = PersoonQuery::table()-&gt;aggregate('COUNT');<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;count&lt;/code&gt; ===<br /> Om makkelijker entries te tellen is de speciale methode &lt;code&gt;count&lt;/code&gt;. Deze methode telt het aantal entries en haalt ook de orderBys, limits en offset van de query weg.<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $aantal_personen = PersoonQuery::table()-&gt;count();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;verzamel&lt;/code&gt; ===<br /> De methode die het vaakst gebruikt wordt is &lt;code&gt;verzamel&lt;/code&gt;. Net zoals &lt;code&gt;verzamel&lt;/code&gt; van elke Verzameling van een WhosWho4-object verzamelt deze query-methode alle WhosWho4-objecten die met de query opgehaald worden. Hierbij verdwijnen alle huidige selects van de query. De methode kan twee argumenten krijgen: de naam van de klasse om de objecten van te verzamelen as string en of de objecten distinct moeten zijn als bool. Zonder argumenten is distinct true en worden de objecten opgehaald van de klasse waarvan je het query-object gemaakt hebt. Als voorbeeld, haal alle Persoon-objecten op:<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $persoon_objecten = PersoonQuery::table()-&gt;verzamel();<br /> &lt;/syntaxhighlight&gt;<br /> Haal alle distinct bugmelders op (dit voorbeeld gebruikt ook &lt;code&gt;join&lt;/code&gt;):<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $persoon_objecten = BugQuery::table()<br /> -&gt;join('Persoon')<br /> -&gt;verzamel('Persoon', true);<br /> &lt;/syntaxhighlight&gt;<br /> <br /> [[Category:WebCie]]</div>

Pepijno https://mediawiki.a-eskwadraat.nl/wiki/index.php/QueryBuilder 2017-02-28T14:05:56Z

<p>Pepijno: </p> <hr /> <div>Om SQL-queries makkelijker te maken heeft de WebCie haar eigen sql-library geschreven, de QueryBuilder. De QueryBuilder maakt queries op dmv van een QueryBuilder-object waaraan properties veranderd worden. Op die manier wordt de query pas gebouwd als de query uitgevoerd moet worden. Hierdoor is er meer mogelijkheid voor controle en sanity checks.<br /> <br /> De QueryBuilder bestaat uit de Query-klasse, de QueryBuilder-klasse en alle uitbreidingen. De Query-klasse is een extensie van de QueryBuilder-klasse. Het verschil tussen de twee klasses is dat de QueryBuilder-klasse wordt gebruikt om de query op te bouwen en de Query-klasse wordt gebruikt om van het geheel een werkende query te maken, alsmede verschillende functies zoals het verzamelen van objecten te implementeren.<br /> <br /> == QueryBuilder starten ==<br /> Omdat je een query altijd wilt gebruiken voor WhosWho4-objecten heeft elk WhosWho4-object zijn eigen query-classe die een uitbreiding is van de Query-klasse. Zo heb je bv de PersoonQuery-klasse en de LidQuery-klasse. Deze extensies hebben niet hun eigen speciale constructor. in plaats daarvan heeft elk van deze klassen de methode table waarmee een Query-klasse wordt aangemaakt, het object als table bij de query wordt gezet en het ObjectQuery-object wordt gereturnd zodat er meteen methoden op kunnen worden toegepast. Een voorbeeld:<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $query = PersoonQuery::table();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> == Query uitvoeren ==<br /> Een query kan je uitvoeren met de methode &lt;code&gt;get&lt;/code&gt;. &lt;code&gt;get&lt;/code&gt; heeft geen argumenten nodig. Als je verder niets aan je Query-object hebt toegevoegd selecteert de query automatisch alle objecten in de table. Met het volgende voorbeeld worden alle entries uit de Persoon-table opgevraagd:<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $personen = PersoonQuery::table()-&gt;get();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;first&lt;/code&gt; ===<br /> De methode &lt;code&gt;first&lt;/code&gt; voert de query uit zoals &lt;code&gt;get&lt;/code&gt; dat doet en geeft vervolgens alleen het eerste resultaat terug. Met het volgende voorbeeld wordt de eerste entry uit de Persoon-table opgehaald:<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $personen = PersoonQuery::table()-&gt;first();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;aggregate&lt;/code&gt; (TODO: in de php-code moet deze functie nog worden aangepast) ===<br /> De methode &lt;code&gt;aggregate&lt;/code&gt; voert een aggregator uit op de query. De toegestane aggregators zijn: &lt;code&gt;COUNT&lt;/code&gt;, &lt;code&gt;SUM&lt;/code&gt;, &lt;code&gt;MAX&lt;/code&gt;, &lt;code&gt;MIN&lt;/code&gt; en &lt;code&gt;YEAR&lt;/code&gt;. De aggregator pakt op dit moment nog alles ipv een specifieke kolom. &lt;code&gt;aggregate&lt;/code&gt; haalt ook de huidige selectie weg. Een voorbeeld om alle entries in de Persoon-table te tellen:<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $aantal_personen = PersoonQuery::table()-&gt;aggregate('COUNT');<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;count&lt;/code&gt; ===<br /> Om makkelijker entries te tellen is de speciale methode &lt;code&gt;count&lt;/code&gt;. Deze methode telt het aantal entries en haalt ook de orderBys, limits en offset van de query weg.<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $aantal_personen = PersoonQuery::table()-&gt;count();<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === &lt;code&gt;verzamel&lt;/code&gt; ===<br /> De methode die het vaakst gebruikt wordt is &lt;code&gt;verzamel&lt;/code&gt;. Net zoals &lt;code&gt;verzamel&lt;/code&gt; van elke Verzameling van een WhosWho4-object verzamelt deze query-methode alle WhosWho4-objecten die met de query opgehaald worden. Hierbij verdwijnen alle huidige selects van de query. De methode kan twee argumenten krijgen: de naam van de klasse om de objecten van te verzamelen as string en of de objecten distinct moeten zijn als bool. Zonder argumenten is distinct true en worden de objecten opgehaald van de klasse waarvan je het query-object gemaakt hebt. Als voorbeeld, haal alle Persoon-objecten op:<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $persoon_objecten = PersoonQuery::table()-&gt;verzamel();<br /> &lt;/syntaxhighlight&gt;<br /> Haal alle bugmelders op (dit voorbeeld gebruikt ook &lt;code&gt;join&lt;/code&gt;):<br /> &lt;syntaxhighlight lang=&quot;php&quot; line='line'&gt;<br /> $persoon_objecten = BugQuery::table()<br /> -&gt;join('Persoon')<br /> -&gt;verzamel('Persoon');<br /> &lt;/syntaxhighlight&gt;<br /> <br /> [[Category:WebCie]]</div>

Pepijno