Начало Каталог Помощ
Регистрация Вход
scaniatm
/
TorrentFlux-b4rt-PHP7
1
0
Разклонения 0
Файлове Задачи 0 Заявки за сливане 0
Клон: master
Клонове Маркери
TorrentFlux-b4r...
/
html
/
inc
/
lib
/
adodb
/
docs
/
docs-adodb.htm

docs-adodb.htm 327 KB
Постоянна връзка История Директен файл

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201120212031204120512061207120812091210121112121213121412151216121712181219122012211222122312241225122612271228122912301231123212331234123512361237123812391240124112421243124412451246124712481249125012511252125312541255125612571258125912601261126212631264126512661267126812691270127112721273127412751276127712781279128012811282128312841285128612871288128912901291129212931294129512961297129812991300130113021303130413051306130713081309131013111312131313141315131613171318131913201321132213231324132513261327132813291330133113321333133413351336133713381339134013411342134313441345134613471348134913501351135213531354135513561357135813591360136113621363136413651366136713681369137013711372137313741375137613771378137913801381138213831384138513861387138813891390139113921393139413951396139713981399140014011402140314041405140614071408140914101411141214131414141514161417141814191420142114221423142414251426142714281429143014311432143314341435143614371438143914401441144214431444144514461447144814491450145114521453145414551456145714581459146014611462146314641465146614671468146914701471147214731474147514761477147814791480148114821483148414851486148714881489149014911492149314941495149614971498149915001501150215031504150515061507150815091510151115121513151415151516151715181519152015211522152315241525152615271528152915301531153215331534153515361537153815391540154115421543154415451546154715481549155015511552155315541555155615571558155915601561156215631564156515661567156815691570157115721573157415751576157715781579158015811582158315841585158615871588158915901591159215931594159515961597159815991600160116021603160416051606160716081609161016111612161316141615161616171618161916201621162216231624162516261627162816291630163116321633163416351636163716381639164016411642164316441645164616471648164916501651165216531654165516561657165816591660166116621663166416651666166716681669167016711672167316741675167616771678167916801681168216831684168516861687168816891690169116921693169416951696169716981699170017011702170317041705170617071708170917101711171217131714171517161717171817191720172117221723172417251726172717281729173017311732173317341735173617371738173917401741174217431744174517461747174817491750175117521753175417551756175717581759176017611762176317641765176617671768176917701771177217731774177517761777177817791780178117821783178417851786178717881789179017911792179317941795179617971798179918001801180218031804180518061807180818091810181118121813181418151816181718181819182018211822182318241825182618271828182918301831183218331834183518361837183818391840184118421843184418451846184718481849185018511852185318541855185618571858185918601861186218631864186518661867186818691870187118721873187418751876187718781879188018811882188318841885188618871888188918901891189218931894189518961897189818991900190119021903190419051906190719081909191019111912191319141915191619171918191919201921192219231924192519261927192819291930193119321933193419351936193719381939194019411942194319441945194619471948194919501951195219531954195519561957195819591960196119621963196419651966196719681969197019711972197319741975197619771978197919801981198219831984198519861987198819891990199119921993199419951996199719981999200020012002200320042005200620072008200920102011201220132014201520162017201820192020202120222023202420252026202720282029203020312032203320342035203620372038203920402041204220432044204520462047204820492050205120522053205420552056205720582059206020612062206320642065206620672068206920702071207220732074207520762077207820792080208120822083208420852086208720882089209020912092209320942095209620972098209921002101210221032104210521062107210821092110211121122113211421152116211721182119212021212122212321242125212621272128212921302131213221332134213521362137213821392140214121422143214421452146214721482149215021512152215321542155215621572158215921602161216221632164216521662167216821692170217121722173217421752176217721782179218021812182218321842185218621872188218921902191219221932194219521962197219821992200220122022203220422052206220722082209221022112212221322142215221622172218221922202221222222232224222522262227222822292230223122322233223422352236223722382239224022412242224322442245224622472248224922502251225222532254225522562257225822592260226122622263226422652266226722682269227022712272227322742275227622772278227922802281228222832284228522862287228822892290229122922293229422952296229722982299230023012302230323042305230623072308230923102311231223132314231523162317231823192320232123222323232423252326232723282329233023312332233323342335233623372338233923402341234223432344234523462347234823492350235123522353235423552356235723582359236023612362236323642365236623672368236923702371237223732374237523762377237823792380238123822383238423852386238723882389239023912392239323942395239623972398239924002401240224032404240524062407240824092410241124122413241424152416241724182419242024212422242324242425242624272428242924302431243224332434243524362437243824392440244124422443244424452446244724482449245024512452245324542455245624572458245924602461246224632464246524662467246824692470247124722473247424752476247724782479248024812482248324842485248624872488248924902491249224932494249524962497249824992500250125022503250425052506250725082509251025112512251325142515251625172518251925202521252225232524252525262527252825292530253125322533253425352536253725382539254025412542254325442545254625472548254925502551255225532554255525562557255825592560256125622563256425652566256725682569257025712572257325742575257625772578257925802581258225832584258525862587258825892590259125922593259425952596259725982599260026012602260326042605260626072608260926102611261226132614261526162617261826192620262126222623262426252626262726282629263026312632263326342635263626372638263926402641264226432644264526462647264826492650265126522653265426552656265726582659266026612662266326642665266626672668266926702671267226732674267526762677267826792680268126822683268426852686268726882689269026912692269326942695269626972698269927002701270227032704270527062707270827092710271127122713271427152716271727182719272027212722272327242725272627272728272927302731273227332734273527362737273827392740274127422743274427452746274727482749275027512752275327542755275627572758275927602761276227632764276527662767276827692770277127722773277427752776277727782779278027812782278327842785278627872788278927902791279227932794279527962797279827992800280128022803280428052806280728082809281028112812281328142815281628172818281928202821282228232824282528262827282828292830283128322833283428352836283728382839284028412842284328442845284628472848284928502851285228532854285528562857285828592860286128622863286428652866286728682869287028712872287328742875287628772878287928802881288228832884288528862887288828892890289128922893289428952896289728982899290029012902290329042905290629072908290929102911291229132914291529162917291829192920292129222923292429252926292729282929293029312932293329342935293629372938293929402941294229432944294529462947294829492950295129522953295429552956295729582959296029612962296329642965296629672968296929702971297229732974297529762977297829792980298129822983298429852986298729882989299029912992299329942995299629972998299930003001300230033004300530063007300830093010301130123013301430153016301730183019302030213022302330243025302630273028302930303031303230333034303530363037303830393040304130423043304430453046304730483049305030513052305330543055305630573058305930603061306230633064306530663067306830693070307130723073307430753076307730783079308030813082308330843085308630873088308930903091309230933094309530963097309830993100310131023103310431053106310731083109311031113112311331143115311631173118311931203121312231233124312531263127312831293130313131323133313431353136313731383139314031413142314331443145314631473148314931503151315231533154315531563157315831593160316131623163316431653166316731683169317031713172317331743175317631773178317931803181318231833184318531863187318831893190319131923193319431953196319731983199320032013202320332043205320632073208320932103211321232133214321532163217321832193220322132223223322432253226322732283229323032313232323332343235323632373238323932403241324232433244324532463247324832493250325132523253325432553256325732583259326032613262326332643265326632673268326932703271327232733274327532763277327832793280328132823283328432853286328732883289329032913292329332943295329632973298329933003301330233033304330533063307330833093310331133123313331433153316331733183319332033213322332333243325332633273328332933303331333233333334333533363337333833393340334133423343334433453346334733483349335033513352335333543355335633573358335933603361336233633364336533663367336833693370337133723373337433753376337733783379338033813382338333843385338633873388338933903391339233933394339533963397339833993400340134023403340434053406340734083409341034113412341334143415341634173418341934203421342234233424342534263427342834293430343134323433343434353436343734383439344034413442344334443445344634473448344934503451345234533454345534563457345834593460346134623463346434653466346734683469347034713472347334743475347634773478347934803481348234833484348534863487348834893490349134923493349434953496349734983499350035013502350335043505350635073508350935103511351235133514351535163517351835193520352135223523352435253526352735283529353035313532353335343535353635373538353935403541354235433544354535463547354835493550355135523553355435553556355735583559356035613562356335643565356635673568356935703571357235733574357535763577357835793580358135823583358435853586358735883589359035913592359335943595359635973598359936003601360236033604360536063607360836093610361136123613361436153616361736183619362036213622362336243625362636273628362936303631363236333634363536363637363836393640364136423643364436453646364736483649365036513652365336543655365636573658365936603661366236633664366536663667366836693670367136723673367436753676367736783679368036813682368336843685368636873688368936903691369236933694369536963697369836993700370137023703370437053706370737083709371037113712371337143715371637173718371937203721372237233724372537263727372837293730373137323733373437353736373737383739374037413742374337443745374637473748374937503751375237533754375537563757375837593760376137623763376437653766376737683769377037713772377337743775377637773778377937803781378237833784378537863787378837893790379137923793379437953796379737983799380038013802380338043805380638073808380938103811381238133814381538163817381838193820382138223823382438253826382738283829383038313832383338343835383638373838383938403841384238433844384538463847384838493850385138523853385438553856385738583859386038613862386338643865386638673868386938703871387238733874387538763877387838793880388138823883388438853886388738883889389038913892389338943895389638973898389939003901390239033904390539063907390839093910391139123913391439153916391739183919392039213922392339243925392639273928392939303931393239333934393539363937393839393940394139423943394439453946394739483949395039513952395339543955395639573958395939603961396239633964396539663967396839693970397139723973397439753976397739783979398039813982398339843985398639873988398939903991399239933994399539963997399839994000400140024003400440054006400740084009401040114012401340144015401640174018401940204021402240234024402540264027402840294030403140324033403440354036403740384039404040414042404340444045404640474048404940504051405240534054405540564057405840594060406140624063406440654066406740684069407040714072407340744075407640774078407940804081408240834084408540864087408840894090409140924093409440954096409740984099410041014102410341044105410641074108410941104111411241134114411541164117411841194120412141224123412441254126412741284129413041314132413341344135413641374138413941404141414241434144414541464147414841494150415141524153415441554156415741584159416041614162416341644165416641674168416941704171417241734174417541764177417841794180418141824183418441854186418741884189419041914192419341944195419641974198419942004201420242034204420542064207420842094210421142124213421442154216421742184219422042214222422342244225422642274228422942304231423242334234423542364237423842394240424142424243424442454246424742484249425042514252425342544255425642574258425942604261426242634264426542664267426842694270427142724273427442754276427742784279428042814282428342844285428642874288428942904291429242934294429542964297429842994300430143024303430443054306430743084309431043114312431343144315431643174318431943204321432243234324432543264327432843294330433143324333433443354336433743384339434043414342434343444345434643474348434943504351435243534354435543564357435843594360436143624363436443654366436743684369437043714372437343744375437643774378437943804381438243834384438543864387438843894390439143924393439443954396439743984399440044014402440344044405440644074408440944104411441244134414441544164417441844194420442144224423442444254426442744284429443044314432443344344435443644374438443944404441444244434444444544464447444844494450445144524453445444554456445744584459446044614462446344644465446644674468446944704471447244734474447544764477447844794480448144824483448444854486448744884489449044914492449344944495449644974498449945004501450245034504450545064507450845094510451145124513451445154516451745184519452045214522452345244525452645274528452945304531453245334534453545364537453845394540454145424543454445454546454745484549455045514552455345544555455645574558455945604561456245634564456545664567456845694570457145724573457445754576457745784579458045814582458345844585458645874588458945904591459245934594459545964597459845994600460146024603460446054606460746084609461046114612461346144615461646174618461946204621462246234624462546264627462846294630463146324633463446354636463746384639464046414642464346444645464646474648464946504651465246534654465546564657465846594660466146624663466446654666466746684669467046714672467346744675467646774678467946804681468246834684468546864687468846894690469146924693469446954696469746984699470047014702470347044705470647074708470947104711471247134714471547164717471847194720472147224723472447254726472747284729473047314732473347344735473647374738473947404741474247434744474547464747474847494750475147524753475447554756475747584759476047614762476347644765476647674768476947704771477247734774477547764777477847794780478147824783478447854786478747884789479047914792479347944795479647974798479948004801480248034804480548064807480848094810481148124813481448154816481748184819482048214822482348244825482648274828482948304831483248334834483548364837483848394840484148424843484448454846484748484849485048514852485348544855485648574858485948604861486248634864486548664867486848694870487148724873487448754876487748784879488048814882488348844885488648874888488948904891489248934894489548964897489848994900490149024903490449054906490749084909491049114912491349144915491649174918491949204921492249234924492549264927492849294930493149324933493449354936493749384939494049414942494349444945494649474948494949504951495249534954495549564957495849594960496149624963496449654966496749684969497049714972497349744975497649774978497949804981498249834984498549864987498849894990499149924993499449954996499749984999500050015002500350045005500650075008500950105011501250135014501550165017501850195020502150225023502450255026502750285029503050315032503350345035503650375038503950405041504250435044504550465047504850495050505150525053505450555056505750585059506050615062506350645065506650675068506950705071507250735074507550765077507850795080508150825083508450855086508750885089509050915092509350945095509650975098509951005101510251035104510551065107510851095110511151125113511451155116511751185119512051215122512351245125512651275128512951305131513251335134513551365137513851395140514151425143514451455146514751485149515051515152515351545155515651575158515951605161516251635164516551665167516851695170517151725173517451755176517751785179518051815182518351845185518651875188518951905191519251935194519551965197519851995200520152025203520452055206520752085209521052115212521352145215521652175218521952205221522252235224522552265227522852295230523152325233523452355236523752385239524052415242524352445245524652475248524952505251525252535254525552565257525852595260526152625263526452655266526752685269527052715272527352745275527652775278527952805281528252835284528552865287528852895290529152925293529452955296529752985299530053015302530353045305530653075308530953105311531253135314531553165317531853195320532153225323532453255326532753285329533053315332533353345335533653375338533953405341534253435344534553465347534853495350535153525353535453555356535753585359536053615362536353645365536653675368536953705371537253735374537553765377537853795380538153825383538453855386538753885389539053915392539353945395539653975398539954005401540254035404540554065407540854095410541154125413541454155416541754185419542054215422542354245425542654275428542954305431543254335434543554365437543854395440544154425443544454455446544754485449545054515452545354545455545654575458545954605461546254635464546554665467546854695470547154725473547454755476547754785479548054815482548354845485548654875488548954905491549254935494549554965497549854995500550155025503550455055506550755085509551055115512551355145515551655175518551955205521552255235524552555265527552855295530553155325533553455355536553755385539554055415542554355445545554655475548554955505551555255535554555555565557555855595560556155625563556455655566556755685569557055715572557355745575557655775578557955805581558255835584558555865587558855895590559155925593559455955596559755985599560056015602560356045605560656075608560956105611561256135614561556165617561856195620562156225623562456255626562756285629563056315632563356345635563656375638563956405641564256435644564556465647564856495650565156525653565456555656565756585659566056615662566356645665566656675668566956705671567256735674567556765677567856795680568156825683568456855686568756885689569056915692569356945695569656975698569957005701570257035704570557065707570857095710571157125713571457155716571757185719572057215722572357245725572657275728572957305731573257335734573557365737573857395740574157425743574457455746574757485749575057515752575357545755575657575758575957605761576257635764576557665767576857695770577157725773577457755776577757785779578057815782578357845785578657875788578957905791579257935794579557965797579857995800580158025803580458055806580758085809581058115812581358145815581658175818581958205821582258235824582558265827582858295830583158325833583458355836583758385839584058415842584358445845584658475848584958505851585258535854585558565857585858595860586158625863586458655866586758685869587058715872587358745875587658775878587958805881588258835884588558865887588858895890589158925893589458955896589758985899590059015902590359045905590659075908590959105911591259135914591559165917591859195920592159225923592459255926592759285929593059315932593359345935593659375938593959405941594259435944594559465947594859495950595159525953595459555956595759585959596059615962596359645965596659675968596959705971597259735974597559765977597859795980598159825983598459855986598759885989599059915992599359945995599659975998599960006001600260036004600560066007600860096010601160126013601460156016601760186019602060216022602360246025602660276028602960306031603260336034603560366037603860396040604160426043604460456046604760486049605060516052605360546055605660576058605960606061606260636064606560666067606860696070607160726073607460756076607760786079608060816082608360846085608660876088608960906091609260936094609560966097609860996100610161026103610461056106610761086109611061116112611361146115611661176118611961206121612261236124612561266127612861296130613161326133613461356136613761386139614061416142614361446145614661476148614961506151615261536154615561566157615861596160616161626163616461656166616761686169617061716172617361746175617661776178 
  1. <html xmlns:v="urn:schemas-microsoft-com:vml"
    2. 

  2. xmlns:o="urn:schemas-microsoft-com:office:office"
    3. 

  3. xmlns:w="urn:schemas-microsoft-com:office:word"
    4. 

  4. xmlns:st1="urn:schemas-microsoft-com:office:smarttags"
    5. 

  5. xmlns="http://www.w3.org/TR/REC-html40">
    6. 

  6. 

  7. <head>
    8. 

  8. <meta http-equiv=Content-Type content="text/html; charset=iso-8859-1">
    9. 

  9. <meta name=ProgId content=Word.Document>
    10. 

  10. <meta name=Generator content="Microsoft Word 11">
    11. 

  11. <meta name=Originator content="Microsoft Word 11">
    12. 

  12. <link rel=File-List href="docs-adodb_files/filelist.xml">
    13. 

  13. <link rel=Edit-Time-Data href="docs-adodb_files/editdata.mso">
    14. 

  14. <!--[if !mso]>
    15. 

  15. <style>
    16. 

  16. v\:* {behavior:url(#default#VML);}
    17. 

  17. o\:* {behavior:url(#default#VML);}
    18. 

  18. w\:* {behavior:url(#default#VML);}
    19. 

  19. .shape {behavior:url(#default#VML);}
    20. 

  20. </style>
    21. 

  21. <![endif]-->
    22. 

  22. <title>ADODB Manual</title>
    23. 

  23. <o:SmartTagType namespaceuri="urn:schemas-microsoft-com:office:smarttags"
    24. 

  24.  name="State"/>
    25. 

  25. <o:SmartTagType namespaceuri="urn:schemas-microsoft-com:office:smarttags"
    26. 

  26.  name="PlaceType"/>
    27. 

  27. <o:SmartTagType namespaceuri="urn:schemas-microsoft-com:office:smarttags"
    28. 

  28.  name="PlaceName"/>
    29. 

  29. <o:SmartTagType namespaceuri="urn:schemas-microsoft-com:office:smarttags"
    30. 

  30.  name="country-region"/>
    31. 

  31. <o:SmartTagType namespaceuri="urn:schemas-microsoft-com:office:smarttags"
    32. 

  32.  name="City"/>
    33. 

  33. <o:SmartTagType namespaceuri="urn:schemas-microsoft-com:office:smarttags"
    34. 

  34.  name="place"/>
    35. 

  35. <!--[if gte mso 9]><xml>
    36. 

  36.  <o:DocumentProperties>
    37. 

  37.   <o:Author>John</o:Author>
    38. 

  38.   <o:LastAuthor>John</o:LastAuthor>
    39. 

  39.   <o:Revision>3</o:Revision>
    40. 

  40.   <o:TotalTime>3</o:TotalTime>
    41. 

  41.   <o:Created>2008-12-24T10:43:00Z</o:Created>
    42. 

  42.   <o:LastSaved>2008-12-24T10:46:00Z</o:LastSaved>
    43. 

  43.   <o:Pages>73</o:Pages>
    44. 

  44.   <o:Words>30239</o:Words>
    45. 

  45.   <o:Characters>172366</o:Characters>
    46. 

  46.   <o:Company> </o:Company>
    47. 

  47.   <o:Lines>1436</o:Lines>
    48. 

  48.   <o:Paragraphs>404</o:Paragraphs>
    49. 

  49.   <o:CharactersWithSpaces>202201</o:CharactersWithSpaces>
    50. 

  50.   <o:Version>11.9999</o:Version>
    51. 

  51.  </o:DocumentProperties>
    52. 

  52. </xml><![endif]--><!--[if gte mso 9]><xml>
    53. 

  53.  <w:WordDocument>
    54. 

  54.   <w:Zoom>140</w:Zoom>
    55. 

  55.   <w:FormsDesign/>
    56. 

  56.   <w:ValidateAgainstSchemas/>
    57. 

  57.   <w:SaveIfXMLInvalid>false</w:SaveIfXMLInvalid>
    58. 

  58.   <w:IgnoreMixedContent>false</w:IgnoreMixedContent>
    59. 

  59.   <w:AlwaysShowPlaceholderText>false</w:AlwaysShowPlaceholderText>
    60. 

  60.   <w:BrowserLevel>MicrosoftInternetExplorer4</w:BrowserLevel>
    61. 

  61.  </w:WordDocument>
    62. 

  62. </xml><![endif]--><!--[if gte mso 9]><xml>
    63. 

  63.  <w:LatentStyles DefLockedState="false" LatentStyleCount="156">
    64. 

  64.  </w:LatentStyles>
    65. 

  65. </xml><![endif]--><!--[if !mso]><object
    66. 

  66.  classid="clsid:38481807-CA0E-42D2-BF39-B33AF135CC4D" id=ieooui></object>
    67. 

  67. <style>
    68. 

  68. st1\:*{behavior:url(#ieooui) }
    69. 

  69. </style>
    70. 

  70. <![endif]-->
    71. 

  71. <style>
    72. 

  72. <!--
    73. 

  73. f
    74. 

  74. 

  75. 

  76.  /* Font Definitions */
    77. 

  77.  @font-face
    78. 

  78. 	{font-family:Helvetica;
    79. 

  79. 	panose-1:2 11 6 4 2 2 2 2 2 4;
    80. 

  80. 	mso-font-charset:0;
    81. 

  81. 	mso-generic-font-family:swiss;
    82. 

  82. 	mso-font-format:other;
    83. 

  83. 	mso-font-pitch:variable;
    84. 

  84. 	mso-font-signature:3 0 0 0 1 0;}
    85. 

  85. @font-face
    86. 

  86. 	{font-family:Courier;
    87. 

  87. 	panose-1:2 7 4 9 2 2 5 2 4 4;
    88. 

  88. 	mso-font-charset:0;
    89. 

  89. 	mso-generic-font-family:modern;
    90. 

  90. 	mso-font-format:other;
    91. 

  91. 	mso-font-pitch:fixed;
    92. 

  92. 	mso-font-signature:3 0 0 0 1 0;}
    93. 

  93. @font-face
    94. 

  94. 	{font-family:"Tms Rmn";
    95. 

  95. 	panose-1:2 2 6 3 4 5 5 2 3 4;
    96. 

  96. 	mso-font-charset:0;
    97. 

  97. 	mso-generic-font-family:roman;
    98. 

  98. 	mso-font-format:other;
    99. 

  99. 	mso-font-pitch:variable;
    100. 

  100. 	mso-font-signature:3 0 0 0 1 0;}
    101. 

  101. @font-face
    102. 

  102. 	{font-family:Helv;
    103. 

  103. 	panose-1:2 11 6 4 2 2 2 3 2 4;
    104. 

  104. 	mso-font-charset:0;
    105. 

  105. 	mso-generic-font-family:swiss;
    106. 

  106. 	mso-font-format:other;
    107. 

  107. 	mso-font-pitch:variable;
    108. 

  108. 	mso-font-signature:3 0 0 0 1 0;}
    109. 

  109. @font-face
    110. 

  110. 	{font-family:"New York";
    111. 

  111. 	panose-1:2 4 5 3 6 5 6 2 3 4;
    112. 

  112. 	mso-font-charset:0;
    113. 

  113. 	mso-generic-font-family:roman;
    114. 

  114. 	mso-font-format:other;
    115. 

  115. 	mso-font-pitch:variable;
    116. 

  116. 	mso-font-signature:3 0 0 0 1 0;}
    117. 

  117. @font-face
    118. 

  118. 	{font-family:System;
    119. 

  119. 	panose-1:0 0 0 0 0 0 0 0 0 0;
    120. 

  120. 	mso-font-charset:0;
    121. 

  121. 	mso-generic-font-family:swiss;
    122. 

  122. 	mso-font-format:other;
    123. 

  123. 	mso-font-pitch:variable;
    124. 

  124. 	mso-font-signature:3 0 0 0 1 0;}
    125. 

  125. @font-face
    126. 

  126. 	{font-family:Wingdings;
    127. 

  127. 	panose-1:5 0 0 0 0 0 0 0 0 0;
    128. 

  128. 	mso-font-charset:2;
    129. 

  129. 	mso-generic-font-family:auto;
    130. 

  130. 	mso-font-pitch:variable;
    131. 

  131. 	mso-font-signature:0 268435456 0 0 -2147483648 0;}
    132. 

  132. @font-face
    133. 

  133. 	{font-family:"MS Mincho";
    134. 

  134. 	panose-1:2 2 6 9 4 2 5 8 3 4;
    135. 

  135. 	mso-font-alt:"\FF2D\FF33 \660E\671D";
    136. 

  136. 	mso-font-charset:128;
    137. 

  137. 	mso-generic-font-family:roman;
    138. 

  138. 	mso-font-format:other;
    139. 

  139. 	mso-font-pitch:fixed;
    140. 

  140. 	mso-font-signature:1 134676480 16 0 131072 0;}
    141. 

  141. @font-face
    142. 

  142. 	{font-family:Batang;
    143. 

  143. 	panose-1:2 3 6 0 0 1 1 1 1 1;
    144. 

  144. 	mso-font-alt:\BC14\D0D5;
    145. 

  145. 	mso-font-charset:129;
    146. 

  146. 	mso-generic-font-family:auto;
    147. 

  147. 	mso-font-format:other;
    148. 

  148. 	mso-font-pitch:fixed;
    149. 

  149. 	mso-font-signature:1 151388160 16 0 524288 0;}
    150. 

  150. @font-face
    151. 

  151. 	{font-family:SimSun;
    152. 

  152. 	panose-1:2 1 6 0 3 1 1 1 1 1;
    153. 

  153. 	mso-font-alt:\5B8B\4F53;
    154. 

  154. 	mso-font-charset:134;
    155. 

  155. 	mso-generic-font-family:auto;
    156. 

  156. 	mso-font-format:other;
    157. 

  157. 	mso-font-pitch:variable;
    158. 

  158. 	mso-font-signature:1 135135232 16 0 262144 0;}
    159. 

  159. @font-face
    160. 

  160. 	{font-family:PMingLiU;
    161. 

  161. 	panose-1:2 2 3 0 0 0 0 0 0 0;
    162. 

  162. 	mso-font-alt:\65B0\7D30\660E\9AD4;
    163. 

  163. 	mso-font-charset:136;
    164. 

  164. 	mso-generic-font-family:auto;
    165. 

  165. 	mso-font-format:other;
    166. 

  166. 	mso-font-pitch:variable;
    167. 

  167. 	mso-font-signature:1 134742016 16 0 1048576 0;}
    168. 

  168. @font-face
    169. 

  169. 	{font-family:"MS Gothic";
    170. 

  170. 	panose-1:2 11 6 9 7 2 5 8 2 4;
    171. 

  171. 	mso-font-alt:"\FF2D\FF33 \30B4\30B7\30C3\30AF";
    172. 

  172. 	mso-font-charset:128;
    173. 

  173. 	mso-generic-font-family:modern;
    174. 

  174. 	mso-font-format:other;
    175. 

  175. 	mso-font-pitch:fixed;
    176. 

  176. 	mso-font-signature:1 134676480 16 0 131072 0;}
    177. 

  177. @font-face
    178. 

  178. 	{font-family:Dotum;
    179. 

  179. 	panose-1:2 11 6 0 0 1 1 1 1 1;
    180. 

  180. 	mso-font-alt:\B3CB\C6C0;
    181. 

  181. 	mso-font-charset:129;
    182. 

  182. 	mso-generic-font-family:modern;
    183. 

  183. 	mso-font-format:other;
    184. 

  184. 	mso-font-pitch:fixed;
    185. 

  185. 	mso-font-signature:1 151388160 16 0 524288 0;}
    186. 

  186. @font-face
    187. 

  187. 	{font-family:SimHei;
    188. 

  188. 	panose-1:2 1 6 0 3 1 1 1 1 1;
    189. 

  189. 	mso-font-alt:\9ED1\4F53;
    190. 

  190. 	mso-font-charset:134;
    191. 

  191. 	mso-generic-font-family:modern;
    192. 

  192. 	mso-font-format:other;
    193. 

  193. 	mso-font-pitch:fixed;
    194. 

  194. 	mso-font-signature:1 135135232 16 0 262144 0;}
    195. 

  195. @font-face
    196. 

  196. 	{font-family:MingLiU;
    197. 

  197. 	panose-1:2 2 3 9 0 0 0 0 0 0;
    198. 

  198. 	mso-font-alt:\7D30\660E\9AD4;
    199. 

  199. 	mso-font-charset:136;
    200. 

  200. 	mso-generic-font-family:modern;
    201. 

  201. 	mso-font-format:other;
    202. 

  202. 	mso-font-pitch:fixed;
    203. 

  203. 	mso-font-signature:1 134742016 16 0 1048576 0;}
    204. 

  204. @font-face
    205. 

  205. 	{font-family:Mincho;
    206. 

  206. 	panose-1:2 2 6 9 4 3 5 8 3 5;
    207. 

  207. 	mso-font-alt:\660E\671D;
    208. 

  208. 	mso-font-charset:128;
    209. 

  209. 	mso-generic-font-family:roman;
    210. 

  210. 	mso-font-format:other;
    211. 

  211. 	mso-font-pitch:fixed;
    212. 

  212. 	mso-font-signature:1 134676480 16 0 131072 0;}
    213. 

  213. @font-face
    214. 

  214. 	{font-family:Gulim;
    215. 

  215. 	panose-1:2 11 6 0 0 1 1 1 1 1;
    216. 

  216. 	mso-font-alt:\AD74\B9BC;
    217. 

  217. 	mso-font-charset:129;
    218. 

  218. 	mso-generic-font-family:roman;
    219. 

  219. 	mso-font-format:other;
    220. 

  220. 	mso-font-pitch:fixed;
    221. 

  221. 	mso-font-signature:1 151388160 16 0 524288 0;}
    222. 

  222. @font-face
    223. 

  223. 	{font-family:Century;
    224. 

  224. 	panose-1:2 4 6 4 5 5 5 2 3 4;
    225. 

  225. 	mso-font-charset:0;
    226. 

  226. 	mso-generic-font-family:roman;
    227. 

  227. 	mso-font-format:other;
    228. 

  228. 	mso-font-pitch:variable;
    229. 

  229. 	mso-font-signature:3 0 0 0 1 0;}
    230. 

  230. @font-face
    231. 

  231. 	{font-family:"Angsana New";
    232. 

  232. 	panose-1:2 2 6 3 5 4 5 2 3 4;
    233. 

  233. 	mso-font-charset:222;
    234. 

  234. 	mso-generic-font-family:roman;
    235. 

  235. 	mso-font-format:other;
    236. 

  236. 	mso-font-pitch:variable;
    237. 

  237. 	mso-font-signature:16777217 0 0 0 65536 0;}
    238. 

  238. @font-face
    239. 

  239. 	{font-family:"Cordia New";
    240. 

  240. 	panose-1:2 11 3 4 2 2 2 2 2 4;
    241. 

  241. 	mso-font-charset:222;
    242. 

  242. 	mso-generic-font-family:roman;
    243. 

  243. 	mso-font-format:other;
    244. 

  244. 	mso-font-pitch:variable;
    245. 

  245. 	mso-font-signature:16777217 0 0 0 65536 0;}
    246. 

  246. @font-face
    247. 

  247. 	{font-family:Mangal;
    248. 

  248. 	panose-1:0 0 4 0 0 0 0 0 0 0;
    249. 

  249. 	mso-font-charset:1;
    250. 

  250. 	mso-generic-font-family:roman;
    251. 

  251. 	mso-font-format:other;
    252. 

  252. 	mso-font-pitch:variable;
    253. 

  253. 	mso-font-signature:32768 0 0 0 0 0;}
    254. 

  254. @font-face
    255. 

  255. 	{font-family:Latha;
    256. 

  256. 	panose-1:2 0 4 0 0 0 0 0 0 0;
    257. 

  257. 	mso-font-charset:1;
    258. 

  258. 	mso-generic-font-family:roman;
    259. 

  259. 	mso-font-format:other;
    260. 

  260. 	mso-font-pitch:variable;
    261. 

  261. 	mso-font-signature:1048576 0 0 0 0 0;}
    262. 

  262. @font-face
    263. 

  263. 	{font-family:Sylfaen;
    264. 

  264. 	panose-1:1 10 5 2 5 3 6 3 3 3;
    265. 

  265. 	mso-font-charset:0;
    266. 

  266. 	mso-generic-font-family:roman;
    267. 

  267. 	mso-font-format:other;
    268. 

  268. 	mso-font-pitch:variable;
    269. 

  269. 	mso-font-signature:16778883 0 512 0 13 0;}
    270. 

  270. @font-face
    271. 

  271. 	{font-family:Vrinda;
    272. 

  272. 	panose-1:0 0 4 0 0 0 0 0 0 0;
    273. 

  273. 	mso-font-charset:1;
    274. 

  274. 	mso-generic-font-family:roman;
    275. 

  275. 	mso-font-format:other;
    276. 

  276. 	mso-font-pitch:variable;
    277. 

  277. 	mso-font-signature:0 0 0 0 0 0;}
    278. 

  278. @font-face
    279. 

  279. 	{font-family:Raavi;
    280. 

  280. 	panose-1:2 0 5 0 0 0 0 0 0 0;
    281. 

  281. 	mso-font-charset:1;
    282. 

  282. 	mso-generic-font-family:roman;
    283. 

  283. 	mso-font-format:other;
    284. 

  284. 	mso-font-pitch:variable;
    285. 

  285. 	mso-font-signature:0 0 0 0 0 0;}
    286. 

  286. @font-face
    287. 

  287. 	{font-family:Shruti;
    288. 

  288. 	panose-1:2 0 5 0 0 0 0 0 0 0;
    289. 

  289. 	mso-font-charset:1;
    290. 

  290. 	mso-generic-font-family:roman;
    291. 

  291. 	mso-font-format:other;
    292. 

  292. 	mso-font-pitch:variable;
    293. 

  293. 	mso-font-signature:0 0 0 0 0 0;}
    294. 

  294. @font-face
    295. 

  295. 	{font-family:Sendnya;
    296. 

  296. 	panose-1:0 0 4 0 0 0 0 0 0 0;
    297. 

  297. 	mso-font-charset:1;
    298. 

  298. 	mso-generic-font-family:roman;
    299. 

  299. 	mso-font-format:other;
    300. 

  300. 	mso-font-pitch:variable;
    301. 

  301. 	mso-font-signature:0 0 0 0 0 0;}
    302. 

  302. @font-face
    303. 

  303. 	{font-family:Gautami;
    304. 

  304. 	panose-1:2 0 5 0 0 0 0 0 0 0;
    305. 

  305. 	mso-font-charset:1;
    306. 

  306. 	mso-generic-font-family:roman;
    307. 

  307. 	mso-font-format:other;
    308. 

  308. 	mso-font-pitch:variable;
    309. 

  309. 	mso-font-signature:0 0 0 0 0 0;}
    310. 

  310. @font-face
    311. 

  311. 	{font-family:Tunga;
    312. 

  312. 	panose-1:0 0 4 0 0 0 0 0 0 0;
    313. 

  313. 	mso-font-charset:1;
    314. 

  314. 	mso-generic-font-family:roman;
    315. 

  315. 	mso-font-format:other;
    316. 

  316. 	mso-font-pitch:variable;
    317. 

  317. 	mso-font-signature:0 0 0 0 0 0;}
    318. 

  318. @font-face
    319. 

  319. 	{font-family:"Estrangelo Edessa";
    320. 

  320. 	panose-1:0 0 0 0 0 0 0 0 0 0;
    321. 

  321. 	mso-font-charset:1;
    322. 

  322. 	mso-generic-font-family:roman;
    323. 

  323. 	mso-font-format:other;
    324. 

  324. 	mso-font-pitch:variable;
    325. 

  325. 	mso-font-signature:0 0 0 0 0 0;}
    326. 

  326. @font-face
    327. 

  327. 	{font-family:Kartika;
    328. 

  328. 	panose-1:1 1 1 0 1 1 1 1 1 1;
    329. 

  329. 	mso-font-charset:1;
    330. 

  330. 	mso-generic-font-family:roman;
    331. 

  331. 	mso-font-format:other;
    332. 

  332. 	mso-font-pitch:variable;
    333. 

  333. 	mso-font-signature:0 0 0 0 0 0;}
    334. 

  334. @font-face
    335. 

  335. 	{font-family:"Arial Unicode MS";
    336. 

  336. 	panose-1:2 11 6 4 2 2 2 2 2 4;
    337. 

  337. 	mso-font-charset:0;
    338. 

  338. 	mso-generic-font-family:roman;
    339. 

  339. 	mso-font-format:other;
    340. 

  340. 	mso-font-pitch:variable;
    341. 

  341. 	mso-font-signature:3 0 0 0 1 0;}
    342. 

  342. @font-face
    343. 

  343. 	{font-family:Tahoma;
    344. 

  344. 	panose-1:2 11 6 4 3 5 4 4 2 4;
    345. 

  345. 	mso-font-charset:0;
    346. 

  346. 	mso-generic-font-family:swiss;
    347. 

  347. 	mso-font-format:other;
    348. 

  348. 	mso-font-pitch:variable;
    349. 

  349. 	mso-font-signature:3 0 0 0 1 0;}
    350. 

  350.  /* Style Definitions */
    351. 

  351.  p.MsoNormal, li.MsoNormal, div.MsoNormal
    352. 

  352. 	{mso-style-parent:"";
    353. 

  353. 	margin:0cm;
    354. 

  354. 	margin-bottom:.0001pt;
    355. 

  355. 	mso-pagination:widow-orphan;
    356. 

  356. 	font-size:12.0pt;
    357. 

  357. 	font-family:"Times New Roman";
    358. 

  358. 	mso-fareast-font-family:"Times New Roman";
    359. 

  359. 	color:black;}
    360. 

  360. h1
    361. 

  361. 	{mso-margin-top-alt:auto;
    362. 

  362. 	margin-right:0cm;
    363. 

  363. 	mso-margin-bottom-alt:auto;
    364. 

  364. 	margin-left:0cm;
    365. 

  365. 	mso-pagination:widow-orphan;
    366. 

  366. 	mso-outline-level:1;
    367. 

  367. 	font-size:24.0pt;
    368. 

  368. 	font-family:"Times New Roman";
    369. 

  369. 	color:black;
    370. 

  370. 	font-weight:bold;}
    371. 

  371. h2
    372. 

  372. 	{mso-margin-top-alt:auto;
    373. 

  373. 	margin-right:0cm;
    374. 

  374. 	mso-margin-bottom-alt:auto;
    375. 

  375. 	margin-left:0cm;
    376. 

  376. 	mso-pagination:widow-orphan;
    377. 

  377. 	mso-outline-level:2;
    378. 

  378. 	font-size:18.0pt;
    379. 

  379. 	font-family:"Times New Roman";
    380. 

  380. 	color:black;
    381. 

  381. 	font-weight:bold;}
    382. 

  382. h3
    383. 

  383. 	{mso-margin-top-alt:auto;
    384. 

  384. 	margin-right:0cm;
    385. 

  385. 	mso-margin-bottom-alt:auto;
    386. 

  386. 	margin-left:0cm;
    387. 

  387. 	mso-pagination:widow-orphan;
    388. 

  388. 	mso-outline-level:3;
    389. 

  389. 	font-size:13.5pt;
    390. 

  390. 	font-family:"Times New Roman";
    391. 

  391. 	color:black;
    392. 

  392. 	font-weight:bold;}
    393. 

  393. h4
    394. 

  394. 	{mso-margin-top-alt:auto;
    395. 

  395. 	margin-right:0cm;
    396. 

  396. 	mso-margin-bottom-alt:auto;
    397. 

  397. 	margin-left:0cm;
    398. 

  398. 	mso-pagination:widow-orphan;
    399. 

  399. 	mso-outline-level:4;
    400. 

  400. 	font-size:12.0pt;
    401. 

  401. 	font-family:"Times New Roman";
    402. 

  402. 	color:black;
    403. 

  403. 	font-weight:bold;}
    404. 

  404. a:link, span.MsoHyperlink
    405. 

  405. 	{color:blue;
    406. 

  406. 	text-decoration:underline;
    407. 

  407. 	text-underline:single;}
    408. 

  408. a:visited, span.MsoHyperlinkFollowed
    409. 

  409. 	{color:blue;
    410. 

  410. 	text-decoration:underline;
    411. 

  411. 	text-underline:single;}
    412. 

  412. p
    413. 

  413. 	{font-size:12.0pt;
    414. 

  414. 	font-family:"Times New Roman";
    415. 

  415. 	mso-fareast-font-family:"Times New Roman";
    416. 

  416. 	color:black;}
    417. 

  417. code
    418. 

  418. 	{font-family:"Courier New";
    419. 

  419. 	mso-ascii-font-family:"Courier New";
    420. 

  420. 	mso-fareast-font-family:"Times New Roman";
    421. 

  421. 	mso-hansi-font-family:"Courier New";
    422. 

  422. 	mso-bidi-font-family:"Courier New";}
    423. 

  423. pre
    424. 

  424. 	{margin:0cm;
    425. 

  425. 	margin-bottom:.0001pt;
    426. 

  426. 	mso-pagination:widow-orphan;
    427. 

  427. 	tab-stops:45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt;
    428. 

  428. 	background:#EEEEEE;
    429. 

  429. 	border:none;
    430. 

  430. 	mso-border-alt:solid #DDDDDD .75pt;
    431. 

  431. 	padding:0cm;
    432. 

  432. 	mso-padding-alt:9.0pt 18.0pt 9.0pt 18.0pt;
    433. 

  433. 	font-size:9.0pt;
    434. 

  434. 	font-family:"Courier New";
    435. 

  435. 	mso-fareast-font-family:"Times New Roman";
    436. 

  436. 	color:black;}
    437. 

  437. span.msoIns
    438. 

  438. 	{mso-style-type:export-only;
    439. 

  439. 	mso-style-name:"";
    440. 

  440. 	text-decoration:underline;
    441. 

  441. 	text-underline:single;
    442. 

  442. 	color:teal;}
    443. 

  443. span.msoDel
    444. 

  444. 	{mso-style-type:export-only;
    445. 

  445. 	mso-style-name:"";
    446. 

  446. 	text-decoration:line-through;
    447. 

  447. 	color:red;}
    448. 

  448. span.msoChangeProp
    449. 

  449. 	{mso-style-type:export-only;
    450. 

  450. 	mso-style-name:"";}
    451. 

  451. @page Section1
    452. 

  452. 	{size:612.0pt 792.0pt;
    453. 

  453. 	margin:72.0pt 90.0pt 72.0pt 90.0pt;
    454. 

  454. 	mso-header-margin:35.4pt;
    455. 

  455. 	mso-footer-margin:35.4pt;
    456. 

  456. 	mso-paper-source:0;}
    457. 

  457. div.Section1
    458. 

  458. 	{page:Section1;}
    459. 

  459.  /* List Definitions */
    460. 

  460.  @list l0
    461. 

  461. 	{mso-list-id:3098366;
    462. 

  462. 	mso-list-template-ids:-1654113918;}
    463. 

  463. @list l0:level1
    464. 

  464. 	{mso-level-number-format:bullet;
    465. 

  465. 	mso-level-text:\F0B7;
    466. 

  466. 	mso-level-tab-stop:36.0pt;
    467. 

  467. 	mso-level-number-position:left;
    468. 

  468. 	text-indent:-18.0pt;
    469. 

  469. 	mso-ansi-font-size:10.0pt;
    470. 

  470. 	font-family:Symbol;}
    471. 

  471. @list l1
    472. 

  472. 	{mso-list-id:118686534;
    473. 

  473. 	mso-list-template-ids:1789952844;}
    474. 

  474. @list l1:level1
    475. 

  475. 	{mso-level-number-format:bullet;
    476. 

  476. 	mso-level-text:\F0B7;
    477. 

  477. 	mso-level-tab-stop:36.0pt;
    478. 

  478. 	mso-level-number-position:left;
    479. 

  479. 	text-indent:-18.0pt;
    480. 

  480. 	mso-ansi-font-size:10.0pt;
    481. 

  481. 	font-family:Symbol;}
    482. 

  482. @list l2
    483. 

  483. 	{mso-list-id:325595838;
    484. 

  484. 	mso-list-template-ids:-924547596;}
    485. 

  485. @list l2:level1
    486. 

  486. 	{mso-level-number-format:bullet;
    487. 

  487. 	mso-level-text:\F0B7;
    488. 

  488. 	mso-level-tab-stop:36.0pt;
    489. 

  489. 	mso-level-number-position:left;
    490. 

  490. 	text-indent:-18.0pt;
    491. 

  491. 	mso-ansi-font-size:10.0pt;
    492. 

  492. 	font-family:Symbol;}
    493. 

  493. @list l3
    494. 

  494. 	{mso-list-id:577053254;
    495. 

  495. 	mso-list-template-ids:1006266472;}
    496. 

  496. @list l3:level1
    497. 

  497. 	{mso-level-number-format:bullet;
    498. 

  498. 	mso-level-text:\F0B7;
    499. 

  499. 	mso-level-tab-stop:36.0pt;
    500. 

  500. 	mso-level-number-position:left;
    501. 

  501. 	text-indent:-18.0pt;
    502. 

  502. 	mso-ansi-font-size:10.0pt;
    503. 

  503. 	font-family:Symbol;}
    504. 

  504. @list l4
    505. 

  505. 	{mso-list-id:584261941;
    506. 

  506. 	mso-list-template-ids:1672376844;}
    507. 

  507. @list l4:level1
    508. 

  508. 	{mso-level-number-format:bullet;
    509. 

  509. 	mso-level-text:\F0B7;
    510. 

  510. 	mso-level-tab-stop:36.0pt;
    511. 

  511. 	mso-level-number-position:left;
    512. 

  512. 	text-indent:-18.0pt;
    513. 

  513. 	mso-ansi-font-size:10.0pt;
    514. 

  514. 	font-family:Symbol;}
    515. 

  515. @list l5
    516. 

  516. 	{mso-list-id:678311197;
    517. 

  517. 	mso-list-template-ids:-1025849406;}
    518. 

  518. @list l5:level1
    519. 

  519. 	{mso-level-number-format:bullet;
    520. 

  520. 	mso-level-text:\F0B7;
    521. 

  521. 	mso-level-tab-stop:36.0pt;
    522. 

  522. 	mso-level-number-position:left;
    523. 

  523. 	text-indent:-18.0pt;
    524. 

  524. 	mso-ansi-font-size:10.0pt;
    525. 

  525. 	font-family:Symbol;}
    526. 

  526. @list l6
    527. 

  527. 	{mso-list-id:993068284;
    528. 

  528. 	mso-list-template-ids:-1149100626;}
    529. 

  529. @list l6:level1
    530. 

  530. 	{mso-level-number-format:bullet;
    531. 

  531. 	mso-level-text:\F0B7;
    532. 

  532. 	mso-level-tab-stop:36.0pt;
    533. 

  533. 	mso-level-number-position:left;
    534. 

  534. 	text-indent:-18.0pt;
    535. 

  535. 	mso-ansi-font-size:10.0pt;
    536. 

  536. 	font-family:Symbol;}
    537. 

  537. @list l7
    538. 

  538. 	{mso-list-id:1120344907;
    539. 

  539. 	mso-list-template-ids:-1732590280;}
    540. 

  540. @list l7:level1
    541. 

  541. 	{mso-level-number-format:bullet;
    542. 

  542. 	mso-level-text:\F0B7;
    543. 

  543. 	mso-level-tab-stop:36.0pt;
    544. 

  544. 	mso-level-number-position:left;
    545. 

  545. 	text-indent:-18.0pt;
    546. 

  546. 	mso-ansi-font-size:10.0pt;
    547. 

  547. 	font-family:Symbol;}
    548. 

  548. @list l8
    549. 

  549. 	{mso-list-id:1134718884;
    550. 

  550. 	mso-list-template-ids:-1854392276;}
    551. 

  551. @list l8:level1
    552. 

  552. 	{mso-level-number-format:bullet;
    553. 

  553. 	mso-level-text:\F0B7;
    554. 

  554. 	mso-level-tab-stop:36.0pt;
    555. 

  555. 	mso-level-number-position:left;
    556. 

  556. 	text-indent:-18.0pt;
    557. 

  557. 	mso-ansi-font-size:10.0pt;
    558. 

  558. 	font-family:Symbol;}
    559. 

  559. @list l9
    560. 

  560. 	{mso-list-id:1289897560;
    561. 

  561. 	mso-list-template-ids:-1284101662;}
    562. 

  562. @list l9:level1
    563. 

  563. 	{mso-level-number-format:bullet;
    564. 

  564. 	mso-level-text:\F0B7;
    565. 

  565. 	mso-level-tab-stop:36.0pt;
    566. 

  566. 	mso-level-number-position:left;
    567. 

  567. 	text-indent:-18.0pt;
    568. 

  568. 	mso-ansi-font-size:10.0pt;
    569. 

  569. 	font-family:Symbol;}
    570. 

  570. @list l10
    571. 

  571. 	{mso-list-id:1461026030;
    572. 

  572. 	mso-list-template-ids:65944450;}
    573. 

  573. @list l11
    574. 

  574. 	{mso-list-id:1566380536;
    575. 

  575. 	mso-list-template-ids:395727058;}
    576. 

  576. @list l11:level1
    577. 

  577. 	{mso-level-number-format:bullet;
    578. 

  578. 	mso-level-text:\F0B7;
    579. 

  579. 	mso-level-tab-stop:36.0pt;
    580. 

  580. 	mso-level-number-position:left;
    581. 

  581. 	text-indent:-18.0pt;
    582. 

  582. 	mso-ansi-font-size:10.0pt;
    583. 

  583. 	font-family:Symbol;}
    584. 

  584. ol
    585. 

  585. 	{margin-bottom:0cm;}
    586. 

  586. ul
    587. 

  587. 	{margin-bottom:0cm;}
    588. 

  588. -->
    589. 

  589. </style>
    590. 

  590. <!--[if gte mso 10]>
    591. 

  591. <style>
    592. 

  592.  /* Style Definitions */
    593. 

  593.  table.MsoNormalTable
    594. 

  594. 	{mso-style-name:"Table Normal";
    595. 

  595. 	mso-tstyle-rowband-size:0;
    596. 

  596. 	mso-tstyle-colband-size:0;
    597. 

  597. 	mso-style-noshow:yes;
    598. 

  598. 	mso-style-parent:"";
    599. 

  599. 	mso-padding-alt:0cm 5.4pt 0cm 5.4pt;
    600. 

  600. 	mso-para-margin:0cm;
    601. 

  601. 	mso-para-margin-bottom:.0001pt;
    602. 

  602. 	mso-pagination:widow-orphan;
    603. 

  603. 	font-size:10.0pt;
    604. 

  604. 	font-family:"Times New Roman";
    605. 

  605. 	mso-ansi-language:#0400;
    606. 

  606. 	mso-fareast-language:#0400;
    607. 

  607. 	mso-bidi-language:#0400;}
    608. 

  608. </style>
    609. 

  609. <![endif]--><!--[if gte mso 9]><xml>
    610. 

  610.  <o:shapedefaults v:ext="edit" spidmax="1026"/>
    611. 

  611. </xml><![endif]--><!--[if gte mso 9]><xml>
    612. 

  612.  <o:shapelayout v:ext="edit">
    613. 

  613.   <o:idmap v:ext="edit" data="1"/>
    614. 

  614.  </o:shapelayout></xml><![endif]-->
    615. 

  615. </head>
    616. 

  616. 

  617. <body bgcolor=white lang=EN-US link=blue vlink=blue style='tab-interval:36.0pt'>
    618. 

  618. 

  619. <div class=Section1>
    620. 

  620. 

  621. <h2>ADOdb Library for PHP</h2>
    622. 

  622. 

  623. <p>v5.20.3  01-Jan-2016<br>
    624. 

  624. &copy; 2000-2013 John Lim (jlim#natsoft.com)<br>
    625. 

  625. &copy; 2014 Damien Regad, Mark Newnham and the ADOdb community</p>
    626. 

  626. 

  627. <p><span style='font-size:7.5pt'>This software is dual licensed using BSD-Style
    628. 

  628. and LGPL. This means you can use it in compiled proprietary and commercial
    629. 

  629. products.</span></p>
    630. 

  630. 

  631. <p>Useful ADOdb links: <a href="http://adodb.sourceforge.net/#download">Download</a>
    632. 

  632. &nbsp; <a href="http://adodb.sourceforge.net/#docs">Other Docs</a> </p>
    633. 

  633. 

  634. <p><a href="#intro"><b>Introduction</b></a><b><br>
    635. 

  635. <a href="#features">Unique Features</a><br>
    636. 

  636. <a href="#users">How People are using ADOdb</a><br>
    637. 

  637. <a href="#bugs">Feature Requests and Bug Reports</a><br>
    638. 

  638. <a href="#install">Installation</a><br>
    639. 

  639. <a href="#mininstall">Minimum Install</a><br>
    640. 

  640. <a href="#coding">Initializing Code and Connectioning to Databases</a><br>
    641. 

  641. </b><span style='font-size:10.0pt'>&nbsp; <a href="#dsnsupport">Data Source
    642. 

  642. Name (DSN) Support</a></span> &nbsp; <a href="#connect_ex">Connection Examples</a>
    643. 

  643. <br>
    644. 

  644. <b><a href="#speed">High Speed ADOdb - tuning tips</a></b><br>
    645. 

  645. <b><a href="#hack">Hacking and Modifying ADOdb Safely</a><br>
    646. 

  646. <a href="#php5">PHP5 Features</a></b><br>
    647. 

  647. <span style='font-size:10.0pt'><a href="#php5iterators">foreach iterators</a> <a
    648. 

  648. href="#php5exceptions">exceptions</a></span><br>
    649. 

  649. <b><a href="#drivers">Supported Databases</a></b><br>
    650. 

  650. <b><a href="#quickstart">Tutorials</a></b><br>
    651. 

  651. <a href="#ex1">Example 1: Select</a><br>
    652. 

  652. <a href="#ex2">Example 2: Advanced Select</a><br>
    653. 

  653. <a href="#ex3">Example 3: Insert</a><br>
    654. 

  654. <a href="#ex4">Example 4: Debugging</a> &nbsp;<a href="#exrs2html">rs2html
    655. 

  655. example</a><br>
    656. 

  656. <a href="#ex5">Example 5: MySQL and Menus</a><br>
    657. 

  657. <a href="#ex6">Example 6: Connecting to Multiple Databases at once</a> <br>
    658. 

  658. <a href="#ex7">Example 7: Generating Update and Insert SQL</a> <br>
    659. 

  659. <a href="#ex8">Example 8: Implementing Scrolling with Next and Previous</a><br>
    660. 

  660. <a href="#ex9">Example 9: Exporting in CSV or Tab-Delimited Format</a> <br>
    661. 

  661. <a href="#ex10">Example 10: Custom filters</a><br>
    662. 

  662. <a href="#ex11">Example 11: Smart Transactions</a><br>
    663. 

  663. <br>
    664. 

  664. <b><a href="#errorhandling">Using Custom Error Handlers and PEAR_Error</a><br>
    665. 

  665. <a href="#DSN">Data Source Names</a><br>
    666. 

  666. <a href="#caching">Caching</a></b><br>
    667. 

  667. &nbsp; &nbsp; <a href="#memcache">MemCache</a><br>
    668. 

  668. &nbsp; &nbsp; <a href="#cacheapi">Caching API</a><br>
    669. 

  669. <b><a href="#pivot">Pivot Tables</a></b> </p>
    670. 

  670. 

  671. <p><a href="#ref"><b>REFERENCE</b></a> </p>
    672. 

  672. 

  673. <p><span style='font-size:10.0pt'>Variables: <a href="#adodb_countrecs">$ADODB_COUNTRECS</a>
    674. 

  674. <a href="#adodb_ansi_padding_off">$ADODB_ANSI_PADDING_OFF</a> <a
    675. 

  675. href="#adodb_cache_dir">$ADODB_CACHE_DIR</a> <br>
    676. 

  676. &nbsp; &nbsp; &nbsp; &nbsp; <a href="#force_type">$ADODB_FORCE_TYPE</a> <a
    677. 

  677. href="#adodb_fetch_mode">$ADODB_FETCH_MODE</a> <a href="#adodb_lang">$ADODB_LANG</a>
    678. 

  678. <a href="#adodb_auto_quote">ADODB_QUOTE_FIELDNAMES</a> <br>
    679. 

  679. Constants: <a href="#adodb_assoc_case">ADODB_ASSOC_CASE</a> </span><br>
    680. 

  680. <a href="#ADOConnection"><b>ADOConnection</b></a><br>
    681. 

  681. <span style='font-size:10.0pt'>Connections: <a href="#connect">Connect</a> <a
    682. 

  682. href="#pconnect">PConnect</a> <a href="#nconnect">NConnect</a> <a
    683. 

  683. href="#isconnected">IsConnected</a><br>
    684. 

  684. Executing SQL: <a href="#execute">Execute</a> <a href="#cacheexecute"><i>CacheExecute</i></a>
    685. 

  685. <a href="#selectlimit">SelectLimit</a> <a href="#cacheSelectLimit"><i>CacheSelectLimit</i></a>
    686. 

  686. <a href="#param">Param</a> <a href="#prepare">Prepare</a> <a href="#preparesp">PrepareSP</a>
    687. 

  687. <a href="#inparameter">InParameter</a> <a href="#outparameter">OutParameter</a>
    688. 

  688. <a href="#autoexecute">AutoExecute</a> <br>
    689. 

  689. &nbsp; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; <a
    690. 

  690. href="#getone">GetOne</a> <a href="#cachegetone"><i>CacheGetOne</i></a> <a
    691. 

  691. href="#getrow">GetRow</a> <a href="#cachegetrow"><i>CacheGetRow</i></a> <a
    692. 

  692. href="#getall">GetAll</a> <a href="#cachegetall"><i>CacheGetAll</i></a> <a
    693. 

  693. href="#getcol">GetCol</a> <a href="#cachegetcol"><i>CacheGetCol</i></a> <a
    694. 

  694. href="#getassoc1">GetAssoc</a> <a href="#cachegetassoc"><i>CacheGetAssoc</i></a>
    695. 

  695. <a href="#replace">Replace</a> <a href="#getmedian">GetMedian</a> <br>
    696. 

  696. &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp; <a
    697. 

  697. href="#executecursor">ExecuteCursor</a> (oci8 only)<br>
    698. 

  698. Generates SQL strings: <a href="#getupdatesql">GetUpdateSQL</a> <a
    699. 

  699. href="#getinsertsql">GetInsertSQL</a> <a href="#concat">Concat</a> <a
    700. 

  700. href="#ifnull">IfNull</a> <a href="#length">length</a> <a href="#random">random</a>
    701. 

  701. <a href="#substr">substr</a> <a href="#qstr">qstr</a> <a href="#param">Param</a>
    702. 

  702. <a href="#OffsetDate">OffsetDate</a> <a href="#sqldate">SQLDate</a> <a
    703. 

  703. href="#dbdate">DBDate</a> <a href="#dbtimestamp">DBTimeStamp</a> <a
    704. 

  704. href="#binddate">BindDate</a> <a href="#bindtimestamp">BindTimeStamp</a> <br>
    705. 

  705. Blobs: <a href="#updateblob">UpdateBlob</a> <a href="#updateclob">UpdateClob</a>
    706. 

  706. <a href="#updateblobfile">UpdateBlobFile</a> <a href="#blobencode">BlobEncode</a>
    707. 

  707. <a href="#blobdecode">BlobDecode</a><br>
    708. 

  708. Paging/Scrolling: <a href="#pageexecute">PageExecute</a> <a
    709. 

  709. href="#cachepageexecute">CachePageExecute</a><br>
    710. 

  710. Cleanup: <a href="#cacheflush">CacheFlush</a> <a href="#Close">Close</a><br>
    711. 

  711. Transactions: <a href="#starttrans">StartTrans</a> <a href="#completetrans">CompleteTrans</a>
    712. 

  712. <a href="#failtrans">FailTrans</a> <a href="#hasfailedtrans">HasFailedTrans</a>
    713. 

  713. <a href="#begintrans">BeginTrans</a> <a href="#committrans">CommitTrans</a> <a
    714. 

  714. href="#rollbacktrans">RollbackTrans</a> <a href="#SetTransactionMode">SetTransactionMode</a><br>
    715. 

  715. Fetching Data: <a href="#setfetchmode">SetFetchMode</a><br>
    716. 

  716. Strings: <a href="#concat">concat</a> <a href="#length">length</a> <a
    717. 

  717. href="#qstr">qstr</a> <a href="#quote">quote</a> <a href="#substr">substr</a><br>
    718. 

  718. Dates: <a href="#dbdate">DBDate</a> <a href="#dbtimestamp">DBTimeStamp</a> <a
    719. 

  719. href="#unixdate">UnixDate</a> <a href="#binddate">BindDate</a> <a
    720. 

  720. href="#bindtimestamp">BindTimeStamp</a> <a href="#unixtimestamp">UnixTimeStamp</a>
    721. 

  721. <a href="#OffsetDate">OffsetDate</a> <a href="#SQLDate">SQLDate</a> <br>
    722. 

  722. Row Management: <a href="#affected_rows">Affected_Rows</a> <a
    723. 

  723. href="#inserted_id">Insert_ID</a> <a href="#rowlock">RowLock</a> <a
    724. 

  724. href="#genid">GenID</a> <a href="#createseq">CreateSequence</a> <a
    725. 

  725. href="#dropseq">DropSequence</a> <br>
    726. 

  726. Error Handling: <a href="#errormsg">ErrorMsg</a> <a href="#errorno">ErrorNo</a>
    727. 

  727. <a href="#metaerror">MetaError</a> <a href="#metaerrormsg">MetaErrorMsg</a> <a
    728. 

  728. href="#ignoreerrors">IgnoreErrors</a><br>
    729. 

  729. Data Dictionary (metadata): <a href="#metadatabases">MetaDatabases</a> <a
    730. 

  730. href="#metatables">MetaTables</a> <a href="#metacolumns">MetaColumns</a> <a
    731. 

  731. href="#metacolumnames">MetaColumnNames</a> <a href="#metaprimarykeys">MetaPrimaryKeys</a>
    732. 

  732. <a href="#metaforeignkeys">MetaForeignKeys</a> <a href="#serverinfo">ServerInfo</a> <a href="#setcharset">SetCharSet</a>
    733. 

  733. <br>
    734. 

  734. Statistics and Query-Rewriting: <a href="#logsql">LogSQL</a> <a
    735. 

  735. href="#fnexecute">fnExecute and fnCacheExecute</a><br>
    736. 

  736. Deprecated: <a href="#bind">Bind</a> <a href="#blankrecordset">BlankRecordSet</a>
    737. 

  737. <a href="#parameter">Parameter</a></span> <a href="#adorecordSet"><b><br>
    738. 

  738. ADORecordSet</b></a><br>
    739. 

  739. <span style='font-size:10.0pt'>Returns one field: <a href="#fields">Fields</a><br>
    740. 

  740. Returns one row:<a href="#fetchrow">FetchRow</a> <a href="#fetchinto">FetchInto</a>
    741. 

  741. <a href="#fetchobject">FetchObject</a> <a href="#fetchnextobject">FetchNextObject</a>
    742. 

  742. <a href="#fetchobj">FetchObj</a> <a href="#fetchnextobj">FetchNextObj</a> <a
    743. 

  743. href="#getrowassoc">GetRowAssoc</a> <br>
    744. 

  744. Returns all rows:<a href="#getarray">GetArray</a> <a href="#getrows">GetRows</a>
    745. 

  745. <a href="#getassoc">GetAssoc</a><br>
    746. 

  746. Scrolling:<a href="#move">Move</a> <a href="#movenext">MoveNext</a> <a
    747. 

  747. href="#movefirst">MoveFirst</a> <a href="#movelast">MoveLast</a> <a
    748. 

  748. href="#abspos">AbsolutePosition</a> <a href="#currentrow">CurrentRow</a> <a
    749. 

  749. href="#atfirstpage">AtFirstPage</a> <a href="#atlastpage">AtLastPage</a> <a
    750. 

  750. href="#absolutepage">AbsolutePage</a> <br>
    751. 

  751. Menu generation:<a href="#getmenu">GetMenu</a> <a href="#getmenu2">GetMenu2</a><br>
    752. 

  752. Dates:<a href="#userdate">UserDate</a> <a href="#usertimestamp">UserTimeStamp</a>
    753. 

  753. <a href="#unixdate">UnixDate</a> <a href="#unixtimestamp">UnixTimeStamp<br>
    754. 

  754. </a>Recordset Info:<a href="#recordcount">RecordCount</a> <a
    755. 

  755. href="#po_recordcount">PO_RecordCount</a> <a href="#nextrecordset">NextRecordSet</a><br>
    756. 

  756. Field Info:<a href="#fieldcount">FieldCount</a> <a href="#fetchfield">FetchField</a>
    757. 

  757. <a href="#metatype">MetaType</a><br>
    758. 

  758. Cleanup: <a href="#rsclose">Close</a></span> </p>
    759. 

  759. 

  760. <p><span style='font-size:10.0pt'><a href="#rs2html"><b>rs2html</b></a>&nbsp; <a
    761. 

  761. href="#exrs2html">example</a></span><br>
    762. 

  762. <a href="#adodiff">Differences between ADOdb and ADO</a><br>
    763. 

  763. <a href="#driverguide"><b>Database Driver Guide<br>
    764. 

  764. </b></a><b><a href="#changes">Change Log</a></b></p>
    765. 

  765. 

  766. <h2>Introduction<a name=intro></a></h2>
    767. 

  767. 

  768. <p>PHP's database access functions are not standardised. This creates a need
    769. 

  769. for a database class library to hide the differences between the different
    770. 

  770. database API's (encapsulate the differences) so we can easily switch databases.
    771. 

  771. PHP 4.0.5 or later is now required (because we use array-based str_replace).</p>
    772. 

  772. 

  773. <p>We currently support MySQL, Oracle, Microsoft SQL Server, Sybase, Sybase SQL
    774. 

  774. Anywhere, Informix, PostgreSQL, FrontBase, SQLite, Interbase (Firebird and
    775. 

  775. Borland variants), Foxpro, Access, <st1:City w:st="on"><st1:place w:st="on">ADO</st1:place></st1:City>,
    776. 

  776. DB2, SAP DB and ODBC. We have had successful reports of connecting to Progress
    777. 

  777. and CacheLite via ODBC. We hope more people will contribute drivers to support
    778. 

  778. other databases.</p>
    779. 

  779. 

  780. <p>PHP4 supports session variables. You can store your session information
    781. 

  781. using ADOdb for true portability and scalability. See adodb-session.php for
    782. 

  782. more information.</p>
    783. 

  783. 

  784. <p>Also read <a href="http://adodb.sourceforge.net/tips_portable_sql.htm">tips_portable_sql.htm</a>
    785. 

  785. for tips on writing portable SQL.</p>
    786. 

  786. 

  787. <h2>Unique Features of ADOdb<a name=features></a></h2>
    788. 

  788. 

  789. <ul type=disc>
    790. 

  790.  <li class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
    791. 

  791.      mso-list:l2 level1 lfo1;tab-stops:list 36.0pt'><b>Easy for Windows
    792. 

  792.      programmers</b> to adapt to because many of the conventions are similar to
    793. 

  793.      Microsoft's <st1:City w:st="on"><st1:place w:st="on">ADO</st1:place></st1:City>.</li>
    794. 

  794.  <li class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
    795. 

  795.      mso-list:l2 level1 lfo1;tab-stops:list 36.0pt'>Unlike other PHP database
    796. 

  796.      classes which focus only on select statements, <b>we provide support code
    797. 

  797.      to handle inserts and updates which can be adapted to multiple databases
    798. 

  798.      quickly.</b> Methods are provided for date handling, string concatenation
    799. 

  799.      and string quoting characters for differing databases.</li>
    800. 

  800.  <li class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
    801. 

  801.      mso-list:l2 level1 lfo1;tab-stops:list 36.0pt'>A<b> metatype system </b>is
    802. 

  802.      built in so that we can figure out that types such as CHAR, TEXT and
    803. 

  803.      STRING are equivalent in different databases.</li>
    804. 

  804.  <li class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
    805. 

  805.      mso-list:l2 level1 lfo1;tab-stops:list 36.0pt'><b>Easy to port</b> because
    806. 

  806.      all the database dependant code are stored in stub functions. You do not
    807. 

  807.      need to port the core logic of the classes.</li>
    808. 

  808.  <li class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
    809. 

  809.      mso-list:l2 level1 lfo1;tab-stops:list 36.0pt'><b>Portable table and index
    810. 

  810.      creation</b> with the <a href="docs-datadict.htm">datadict</a> classes. </li>
    811. 

  811.  <li class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
    812. 

  812.      mso-list:l2 level1 lfo1;tab-stops:list 36.0pt'><b>Database performance
    813. 

  813.      monitoring and SQL tuning</b> with the <a href="docs-perf.htm">performance
    814. 

  814.      monitoring</a> classes. </li>
    815. 

  815.  <li class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
    816. 

  816.      mso-list:l2 level1 lfo1;tab-stops:list 36.0pt'><b>Database-backed sessions</b>
    817. 

  817.      with the <a href="docs-session.htm">session management</a> classes.
    818. 

  818.      Supports session expiry notification. </li>
    819. 

  819.  <li class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
    820. 

  820.      mso-list:l2 level1 lfo1;tab-stops:list 36.0pt'><b>Object-Relational
    821. 

  821.      Mapping</b> using <a href="docs-active-record.htm">ADOdb_Active_Record</a>
    822. 

  822.      classes. </li>
    823. 

  823. </ul>
    824. 

  824. 

  825. <h2>How People are using ADOdb<a name=users></a></h2>
    826. 

  826. 

  827. <p class=MsoNormal>Here are some examples of how people are using ADOdb</p>
    828. 

  828. 

  829. <ul type=disc>
    830. 

  830.  <li class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
    831. 

  831.      mso-list:l4 level1 lfo2;tab-stops:list 36.0pt'><a
    832. 

  832.      href="http://phplens.com/">PhpLens</a> is a commercial data grid component
    833. 

  833.      that allows both cool Web designers and serious unshaved programmers to
    834. 

  834.      develop and maintain databases on the Web easily. Developed by the author
    835. 

  835.      of ADOdb.</li>
    836. 

  836.  <li class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
    837. 

  837.      mso-list:l4 level1 lfo2;tab-stops:list 36.0pt'><a
    838. 

  838.      href="http://www.interaktonline.com/Products/Free-Products/PHAkt/EOL/">PHAkt: PHP Extension for DreamWeaver
    839. 

  839.      Ultradev</a> allows you to script PHP in the popular Web page editor.
    840. 

  840.      Database handling provided by ADOdb.</li>
    841. 

  841.  <li class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
    842. 

  842.      mso-list:l4 level1 lfo2;tab-stops:list 36.0pt'><a
    843. 

  843.      href="http://www.andrew.cmu.edu/user/rdanyliw/snort/snortacid.html">Analysis
    844. 

  844.      Console for Intrusion Databases</a> (ACID): PHP-based analysis engine to
    845. 

  845.      search and process a database of security incidents generated by
    846. 

  846.      security-related software such as IDSes and firewalls (e.g. Snort,
    847. 

  847.      ipchains). By Roman Danyliw.</li>
    848. 

  848.  <li class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
    849. 

  849.      mso-list:l4 level1 lfo2;tab-stops:list 36.0pt'><a
    850. 

  850.      href="http://www.postnuke.com/">PostNuke</a> is a very popular free
    851. 

  851.      content management system and weblog system. It offers full CSS support,
    852. 

  852.      HTML 4.01 transitional compliance throughout, an advanced blocks system,
    853. 

  853.      and is fully multi-lingual enabled. </li>
    854. 

  854.  <li class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
    855. 

  855.      mso-list:l4 level1 lfo2;tab-stops:list 36.0pt'><a
    856. 

  856.      href="http://www.escio.no/index.php?page_id=3&lang_id=2">EasyPublish
    857. 

  857.      CMS</a> is another free content management system for managing information
    858. 

  858.      and integrated modules on your internet, intranet- and extranet-sites.
    859. 

  859.      From <st1:country-region w:st="on"><st1:place w:st="on">Norway</st1:place></st1:country-region>.</li>
    860. 

  860.  <li class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
    861. 

  861.      mso-list:l4 level1 lfo2;tab-stops:list 36.0pt'><a
    862. 

  862.      href="http://www.nolapro.com/nolapro.html">NOLA</a> is a full featured accounting,
    863. 

  863.      inventory, and job tracking application. It is licensed under the GPL, and
    864. 

  864.      developed by Noguska. </li>
    865. 

  865. </ul>
    866. 

  866. 

  867. <h2>Feature Requests and Bug Reports<a name=bugs></a></h2>
    868. 

  868. 

  869. <p>Feature requests and bug reports should be submitted on
    870. 

  870. <a href="https://github.com/ADOdb/ADOdb/issues">Github</a>.
    871. 

  871. </p>
    872. 

  872. 

  873. <p>Bug fixes and enhancements can be submitted as
    874. 

  874. <a href="https://github.com/ADOdb/ADOdb/pulls">Pull Requests</a>.
    875. 

  875. </p>
    876. 

  876. 

  877. <h2>Installation Guide<a name=install></a></h2>
    878. 

  878. 

  879. <p>Make sure you are running PHP 4.0.5 or later. Unpack all the files into a
    880. 

  880. directory accessible by your webserver.</p>
    881. 

  881. 

  882. <p>To test, try modifying some of the tutorial examples. Make sure you
    883. 

  883. customize the connection settings correctly. You can debug using <i>$db-&gt;debug
    884. 

  884. = true</i> as shown below:</p>
    885. 

  885. 

  886. <div style='mso-element:para-border-div;border:solid #DDDDDD 1.0pt;mso-border-alt:
    887. 

  887. solid #DDDDDD .75pt;padding:9.0pt 18.0pt 9.0pt 18.0pt;background:#EEEEEE'><pre
    888. 

  888. style='background:#EEEEEE'>&lt;?php<br>
    889. 

  889. <span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>include('adodb/adodb.inc.php');<br>
    890. 

  890. <span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$db = <a href="#adonewconnection">ADONewConnection</a>($dbdriver); # eg 'mysql' or 'postgres'<br>
    891. 

  891. <span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$db-&gt;debug = true;<br>
    892. 

  892. <span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$db-&gt;<a href="#connect">Connect</a>($server, $user, $password, $database);<br>
    893. 

  893. <span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$rs = $db-&gt;<a href="#execute">Execute</a>('select * from some_small_table');<br>
    894. 

  894. <span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>print &quot;&lt;pre&gt;&quot;;<br>
    895. 

  895. <span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>print_r($rs-&gt;<a href="#getrows">GetRows</a>());<br>
    896. 

  896. <span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>print &quot;&lt;/pre&gt;&quot;;<br>
    897. 

  897. ?&gt;</pre></div>
    898. 

  898. 

  899. <h3>Minimum Install<a name=mininstall></a></h3>
    900. 

  900. 

  901. <p>For developers who want to release a minimal install of ADOdb, you will
    902. 

  902. need: </p>
    903. 

  903. 

  904. <ul type=disc>
    905. 

  905.  <li class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
    906. 

  906.      mso-list:l9 level1 lfo3;tab-stops:list 36.0pt'>adodb.inc.php </li>
    907. 

  907.  <li class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
    908. 

  908.      mso-list:l9 level1 lfo3;tab-stops:list 36.0pt'>adodb-lib.inc.php </li>
    909. 

  909.  <li class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
    910. 

  910.      mso-list:l9 level1 lfo3;tab-stops:list 36.0pt'>adodb-time.inc.php </li>
    911. 

  911.  <li class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
    912. 

  912.      mso-list:l9 level1 lfo3;tab-stops:list 36.0pt'>drivers/adodb-$database.inc.php
    913. 

  913.      </li>
    914. 

  914.  <li class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
    915. 

  915.      mso-list:l9 level1 lfo3;tab-stops:list 36.0pt'>license.txt (for legal
    916. 

  916.      reasons) </li>
    917. 

  917.  <li class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
    918. 

  918.      mso-list:l9 level1 lfo3;tab-stops:list 36.0pt'>adodb-php4.inc.php </li>
    919. 

  919.  <li class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
    920. 

  920.      mso-list:l9 level1 lfo3;tab-stops:list 36.0pt'>adodb-iterator.inc.php
    921. 

  921.      (php5 functionality) </li>
    922. 

  922. </ul>
    923. 

  923. 

  924. <p class=MsoNormal>Optional: </p>
    925. 

  925. 

  926. <ul type=disc>
    927. 

  927.  <li class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
    928. 

  928.      mso-list:l3 level1 lfo4;tab-stops:list 36.0pt'>adodb-error.inc.php and
    929. 

  929.      lang/adodb-$lang.inc.php (if you use MetaError()) </li>
    930. 

  930.  <li class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
    931. 

  931.      mso-list:l3 level1 lfo4;tab-stops:list 36.0pt'>adodb-csvlib.inc.php (if
    932. 

  932.      you use cached recordsets - CacheExecute(), etc) </li>
    933. 

  933.  <li class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
    934. 

  934.      mso-list:l3 level1 lfo4;tab-stops:list 36.0pt'>adodb-exceptions.inc.php
    935. 

  935.      and adodb-errorhandler.inc.php (if you use adodb error handler or php5
    936. 

  936.      exceptions). </li>
    937. 

  937.  <li class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
    938. 

  938.      mso-list:l3 level1 lfo4;tab-stops:list 36.0pt'>adodb-active-record.inc.php
    939. 

  939.      if you use <a href="docs-active-record.htm">Active Records</a>. </li>
    940. 

  940. </ul>
    941. 

  941. 

  942. <h3>Code Initialization Examples<a name=coding></a></h3>
    943. 

  943. 

  944. <p>When running ADOdb, at least two files are loaded. First is
    945. 

  945. adodb/adodb.inc.php, which contains all functions used by all database classes.
    946. 

  946. The code specific to a particular database is in the
    947. 

  947. adodb/driver/adodb-????.inc.php file.</p>
    948. 

  948. 

  949. <p><a name=adonewconnection></a>For example, to connect to a mysql database:</p>
    950. 

  950. 

  951. <div style='mso-element:para-border-div;border:solid #DDDDDD 1.0pt;mso-border-alt:
    952. 

  952. solid #DDDDDD .75pt;padding:9.0pt 18.0pt 9.0pt 18.0pt;background:#EEEEEE'><pre
    953. 

  953. style='background:#EEEEEE'>include('/path/to/set/here/adodb.inc.php');<br>
    954. 

  954. $conn = &amp;ADONewConnection('mysql');</pre></div>
    955. 

  955. 

  956. <p>Whenever you need to connect to a database, you create a Connection object
    957. 

  957. using the <b>ADONewConnection</b>($driver) function. <b>NewADOConnection</b>($driver)
    958. 

  958. is an alternative name for the same function.</p>
    959. 

  959. 

  960. <p>At this point, you are not connected to the database (no longer true if you
    961. 

  961. pass in a <a href="#dsnsupport">dsn</a>). You will first need to decide whether
    962. 

  962. to use <i>persistent</i> or <i>non-persistent</i> connections. The advantage of
    963. 

  963. <i>persistent</i> connections is that they are faster, as the database
    964. 

  964. connection is never closed (even when you call Close()). <i>Non-persistent </i>connections
    965. 

  965. take up much fewer resources though, reducing the risk of your database and
    966. 

  966. your web-server becoming overloaded. </p>
    967. 

  967. 

  968. <p>For persistent connections, use $conn-&gt;<a href="#pconnect">PConnect()</a>,
    969. 

  969. or $conn-&gt;<a href="#connect">Connect()</a> for non-persistent connections.
    970. 

  970. Some database drivers also support <a href="#nconnect">NConnect()</a>, which
    971. 

  971. forces the creation of a new connection. <a name="connection_gotcha"></a></p>
    972. 

  972. 

  973. <p><b>Connection Gotcha</b>: If you create two connections, but both use the
    974. 

  974. same userid and password, PHP will share the same connection. This can cause
    975. 

  975. problems if the connections are meant to different databases. The solution is
    976. 

  976. to always use different userid's for different databases, or use NConnect(). <a
    977. 

  977. name=dsnsupport></a></p>
    978. 

  978. 

  979. <h3>Data Source Name (DSN) Support</h3>
    980. 

  980. 

  981. <p>Since ADOdb 4.51, you can connect to a database by passing a dsn to
    982. 

  982. NewADOConnection() (or ADONewConnection, which is the same function). The dsn
    983. 

  983. format is: </p>
    984. 

  984. 

  985. <div style='mso-element:para-border-div;border:solid #DDDDDD 1.0pt;mso-border-alt:
    986. 

  986. solid #DDDDDD .75pt;padding:9.0pt 18.0pt 9.0pt 18.0pt;background:#EEEEEE'><pre
    987. 

  987. style='background:#EEEEEE'><span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$driver://$username:$password@hostname/$database?options[=value]</pre></div>
    988. 

  988. 

  989. <p>NewADOConnection() calls Connect() or PConnect() internally for you. If the
    990. 

  990. connection fails, false is returned. </p>
    991. 

  991. 

  992. <div style='mso-element:para-border-div;border:solid #DDDDDD 1.0pt;mso-border-alt:
    993. 

  993. solid #DDDDDD .75pt;padding:9.0pt 18.0pt 9.0pt 18.0pt;background:#EEEEEE'><pre><span
    994. 

  994. style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span><span style='color:green'># non-persistent connection</span></pre><pre><span
    995. 

  995. style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$dsn = 'mysql://root:pwd@localhost/mydb'; </pre><pre><span
    996. 

  996. style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$db = NewADOConnection($dsn);</pre><pre><span
    997. 

  997. style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>if (!$db) die(&quot;Connection failed&quot;);<span style='mso-spacerun:yes'>&nbsp;&nbsp; </span></pre><pre><span
    998. 

  998. style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></pre><pre><span style='mso-tab-count:
    999. 

  999. 1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span><span style='color:green'># no need to call connect/pconnect!</span></pre><pre><span
    1000. 

  1000. style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$arr = $db-&gt;GetArray(&quot;select * from table&quot;);</pre><pre><span
    1001. 

  1001. style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></pre><pre><span style='mso-tab-count:
    1002. 

  1002. 1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span><span style='color:green'># persistent connection</span></pre>
    1003. 

  1003. <pre><span
    1004. 

  1004. style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$dsn2 = 'mysql://root:pwd@localhost/mydb?persist';
    1005. 

  1005. <span
    1006. 

  1006. style='mso-tab-count:1'></span></pre>
    1007. 

  1007. <pre><span style='mso-tab-count:
    1008. 

  1008. 1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span><span style='color:green'># non-persistent connection on port 3000</span></pre>
    1009. 

  1009. <pre><span
    1010. 

  1010. style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$dsn2 = 'mysqli://root:pwd@localhost/mydb?persist=0&amp;port=3000';</pre>
    1011. 

  1011. </div>
    1012. 

  1012. 

  1013. <p>If you have special characters such as /:?_ in your dsn, then you need to
    1014. 

  1014. rawurlencode them first: </p>
    1015. 

  1015. 

  1016. <div style='mso-element:para-border-div;border:solid #DDDDDD 1.0pt;mso-border-alt:
    1017. 

  1017. solid #DDDDDD .75pt;padding:9.0pt 18.0pt 9.0pt 18.0pt;background:#EEEEEE'><pre><span
    1018. 

  1018. style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$pwd = rawurlencode($pwd);<br>
    1019. 

  1019. <span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$dsn = &quot;mysql://root:$pwd@localhost/mydb&quot;;</pre><pre
    1020. 

  1020. style='background:#EEEEEE'><span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$dsn2=rawurlencode(&quot;sybase_ase&quot;).&quot;://user:pass@host/path?query&quot;;</pre></div>
    1021. 

  1021. 

  1022. <p>Legal options are: </p>
    1023. 

  1023. 

  1024. <div align=center>
    1025. 

  1025. 

  1026. <table class=MsoNormalTable border=1 cellpadding=0 style='mso-cellspacing:1.5pt'>
    1027. 

  1027.  <tr style='mso-yfti-irow:0;mso-yfti-firstrow:yes'>
    1028. 

  1028.   <td style='padding:.75pt .75pt .75pt .75pt'>
    1029. 

  1029.   <p class=MsoNormal>For all drivers</p>
    1030. 

  1030.   </td>
    1031. 

  1031.   <td style='padding:.75pt .75pt .75pt .75pt'>
    1032. 

  1032.   <p class=MsoNormal>'persist', 'persistent', 'debug', 'fetchmode', 'new' , 'cachesecs', 'memcache'</p>
    1033. 

  1033.   </td>
    1034. 

  1034.  </tr>
    1035. 

  1035.  <tr style='mso-yfti-irow:1'>
    1036. 

  1036.   <td style='padding:.75pt .75pt .75pt .75pt'>
    1037. 

  1037.   <p class=MsoNormal>Interbase/Firebird </p>
    1038. 

  1038.   </td>
    1039. 

  1039.   <td style='padding:.75pt .75pt .75pt .75pt'>
    1040. 

  1040.   <p class=MsoNormal>'dialect','charset','buffers','role' </p>
    1041. 

  1041.   </td>
    1042. 

  1042.  </tr>
    1043. 

  1043.  <tr style='mso-yfti-irow:2'>
    1044. 

  1044.   <td style='padding:.75pt .75pt .75pt .75pt'>
    1045. 

  1045.   <p class=MsoNormal>M'soft <st1:City w:st="on"><st1:place w:st="on">ADO</st1:place></st1:City></p>
    1046. 

  1046.   </td>
    1047. 

  1047.   <td style='padding:.75pt .75pt .75pt .75pt'>
    1048. 

  1048.   <p class=MsoNormal>'charpage' </p>
    1049. 

  1049.   </td>
    1050. 

  1050.  </tr>
    1051. 

  1051.  <tr style='mso-yfti-irow:3'>
    1052. 

  1052.   <td style='padding:.75pt .75pt .75pt .75pt'>
    1053. 

  1053.   <p class=MsoNormal>MySQL</p>
    1054. 

  1054.   </td>
    1055. 

  1055.   <td style='padding:.75pt .75pt .75pt .75pt'>
    1056. 

  1056.   <p class=MsoNormal>'clientflags' </p>
    1057. 

  1057.   </td>
    1058. 

  1058.  </tr>
    1059. 

  1059.  <tr style='mso-yfti-irow:4'>
    1060. 

  1060.   <td style='padding:.75pt .75pt .75pt .75pt'>
    1061. 

  1061.   <p class=MsoNormal>MySQLi</p>
    1062. 

  1062.   </td>
    1063. 

  1063.   <td style='padding:.75pt .75pt .75pt .75pt'>
    1064. 

  1064.   <p class=MsoNormal>'port', 'socket', 'clientflags' </p>
    1065. 

  1065.   </td>
    1066. 

  1066.  </tr>
    1067. 

  1067.  <tr style='mso-yfti-irow:5;mso-yfti-lastrow:yes'>
    1068. 

  1068.   <td style='padding:.75pt .75pt .75pt .75pt'>
    1069. 

  1069.   <p class=MsoNormal>Oci8</p>
    1070. 

  1070.   </td>
    1071. 

  1071.   <td style='padding:.75pt .75pt .75pt .75pt'>
    1072. 

  1072.   <p class=MsoNormal>'nls_date_format','charset' </p>
    1073. 

  1073.   </td>
    1074. 

  1074.  </tr>
    1075. 

  1075. </table>
    1076. 

  1076. 

  1077. </div>
    1078. 

  1078. 

  1079. <p>For all drivers, when the options <i>persist</i> or <i>persistent</i> are
    1080. 

  1080. set, a persistent connection is forced; similarly, when <i>new</i> is set, then
    1081. 

  1081. a new connection will be created using NConnect if the underlying driver
    1082. 

  1082. supports it. The <i>debug</i> option enables debugging. The <i>fetchmode</i>
    1083. 

  1083. calls <a href="#setfetchmode">SetFetchMode()</a>. If no value is defined for an
    1084. 

  1084. option, then the value is set to 1. </p>
    1085. 

  1085. 

  1086. <p>Since ADOdb 5.09, we added 2 new parameters:</p>
    1087. 

  1087. <ul>
    1088. 

  1088. <li class=MsoNormal><i>cachesecs</i> which globally determines how many seconds to cache recordsets (default is 3600 secs if not defined) when
    1089. 

  1089. CacheExecute() and CacheSelectLimit() are called and no cache-time parameter is passed into these functions.
    1090. 

  1090. <li class=MsoNormal><i>memcache</i> which defines the memcache host, port and whether to use compression. For example:
    1091. 

  1091. <pre>
    1092. 

  1092. 	# we have a memcache server at 10.1.1.22 using default port 11211, no compression
    1093. 

  1093. 	$dsn = 'mysql://user:pwd@localhost/mydb?memcache=10.1.1.22';
    1094. 

  1094. 

  1095. 	# we have a memcache server 10.1.1.22 port 8888, compression=on
    1096. 

  1096. 	$dsn = 'mysql://user:pwd@localhost/mydb?memcache=10.1.1.22:8888:1';
    1097. 

  1097. 

  1098. 	# we have a memcache servers mem1,mem2 on port 8888, compression=off
    1099. 

  1099. 	$dsn = 'mysql://user:pwd@localhost/mydb?memcache=mem1,mem2:8888:0';
    1100. 

  1100. 

  1101. 	# we have a memcache servers mem1,mem2 on port 8888, compression=off and cachesecs=120
    1102. 

  1102. 	$dsn = 'mysql://user:pwd@localhost/mydb?memcache=mem1,mem2:8888:0&cachesecs=120';
    1103. 

  1103. </pre>
    1104. 

  1104. </ul>
    1105. 

  1105. 

  1106. <p>ADOdb DSN's are compatible with version 1.0 of PEAR DB's DSN format. <a
    1107. 

  1107. name="connect_ex"></a></p>
    1108. 

  1108. 

  1109. <h3><span style='mso-bookmark:connect_ex'>Examples of Connecting to Databases</span></h3>
    1110. 

  1110. 

  1111. <h4><span style='mso-bookmark:connect_ex'>MySQL and Most Other Database Drivers</span></h4>
    1112. 

  1112. 

  1113. <p><span style='mso-bookmark:connect_ex'>MySQL connections are very
    1114. 

  1114. straightforward, and the parameters are identical to mysql_connect:</span></p>
    1115. 

  1115. 

  1116. <div style='mso-element:para-border-div;border:solid #DDDDDD 1.0pt;mso-border-alt:
    1117. 

  1117. solid #DDDDDD .75pt;padding:9.0pt 18.0pt 9.0pt 18.0pt;background:#EEEEEE'><pre><span
    1118. 

  1118. style='mso-bookmark:connect_ex'><span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$conn = &amp;ADONewConnection('mysql'); <br>
    1119. 

  1119. <span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$conn-&gt;PConnect('localhost','userid','password','database');<br>
    1120. 

  1120. <span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span><br>
    1121. 

  1121. <span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span><span style='mso-bookmark:
    1122. 

  1122. connect_ex'><span style='color:green'># or dsn </span></span></pre><pre><span
    1123. 

  1123. style='mso-bookmark:connect_ex'><span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$dsn = 'mysql://user:pwd@localhost/mydb'; </span></pre><pre><span
    1124. 

  1124. style='mso-bookmark:connect_ex'><span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$conn = ADONewConnection($dsn);<span style='mso-spacerun:yes'>&nbsp; </span># no need for Connect()</span></pre><pre><span
    1125. 

  1125. style='mso-bookmark:connect_ex'><span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></pre><pre><span
    1126. 

  1126. style='mso-bookmark:connect_ex'><span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span><span
    1127. 

  1127. style='mso-bookmark:connect_ex'><span style='color:green'># or persistent dsn</span></span></pre><pre><span
    1128. 

  1128. style='mso-bookmark:connect_ex'><span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$dsn = 'mysql://user:pwd@localhost/mydb?persist'; </span></pre><pre><span
    1129. 

  1129. style='mso-bookmark:connect_ex'><span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$conn = ADONewConnection($dsn);<span style='mso-spacerun:yes'>&nbsp; </span># no need for PConnect()</span></pre><pre><span
    1130. 

  1130. style='mso-bookmark:connect_ex'><span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></pre><pre><span
    1131. 

  1131. style='mso-bookmark:connect_ex'><span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span><span
    1132. 

  1132. style='mso-bookmark:connect_ex'><span style='color:green'># a more complex example:</span></span></pre><pre><span
    1133. 

  1133. style='mso-bookmark:connect_ex'><span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$pwd = urlencode($pwd);</span></pre><pre><span
    1134. 

  1134. style='mso-bookmark:connect_ex'><span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$flags =<span style='mso-spacerun:yes'>&nbsp; </span>MYSQL_CLIENT_COMPRESS;</span></pre><pre><span
    1135. 

  1135. style='mso-bookmark:connect_ex'><span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$dsn = &quot;mysql://user:$pwd@localhost/mydb?persist&amp;clientflags=$flags&quot;;</span></pre><pre><span
    1136. 

  1136. style='mso-bookmark:connect_ex'><span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$conn = ADONewConnection($dsn);<span style='mso-spacerun:yes'>&nbsp; </span># no need for PConnect()</span></pre><pre
    1137. 

  1137. style='background:#EEEEEE'><span style='mso-bookmark:connect_ex'> </span></pre></div>
    1138. 

  1138. 

  1139. <p><span style='mso-bookmark:connect_ex'>For most drivers, you can use the
    1140. 

  1140. standard function: Connect($server, $user, $password, $database), or a </span><a
    1141. 

  1141. href="dsnsupport">DSN</a> since ADOdb 4.51. Exceptions to this are listed
    1142. 

  1142. below. </p>
    1143. 

  1143. 

  1144. <h4><a name=pdo>PDO</a></h4>
    1145. 

  1145. 

  1146. <p><span style='mso-bookmark:pdo'>PDO, which only works with PHP5, accepts a
    1147. 

  1147. driver specific connection string: </span></p>
    1148. 

  1148. 

  1149. <div style='mso-element:para-border-div;border:solid #DDDDDD 1.0pt;mso-border-alt:
    1150. 

  1150. solid #DDDDDD .75pt;padding:9.0pt 18.0pt 9.0pt 18.0pt;background:#EEEEEE'><pre><span
    1151. 

  1151. style='mso-bookmark:pdo'><o:p>&nbsp;</o:p></span></pre><pre><span
    1152. 

  1152. style='mso-bookmark:pdo'><span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$conn =&amp; NewADConnection('pdo');</span></pre><pre><span
    1153. 

  1153. style='mso-bookmark:pdo'><span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$conn-&gt;Connect('mysql:host=localhost',$user,$pwd,$mydb);</span></pre><pre><span
    1154. 

  1154. style='mso-bookmark:pdo'><span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$conn-&gt;Connect('mysql:host=localhost;dbname=mydb',$user,$pwd);</span></pre><pre><span
    1155. 

  1155. style='mso-bookmark:pdo'><span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$conn-&gt;Connect(&quot;mysql:host=localhost;dbname=mydb;username=$user;password=$pwd&quot;);</span></pre></div>
    1156. 

  1156. 

  1157. <p><span style='mso-bookmark:pdo'>The DSN mechanism is also supported: </span></p>
    1158. 

  1158. 

  1159. <div style='mso-element:para-border-div;border:solid #DDDDDD 1.0pt;mso-border-alt:
    1160. 

  1160. solid #DDDDDD .75pt;padding:9.0pt 18.0pt 9.0pt 18.0pt;background:#EEEEEE'><pre><span
    1161. 

  1161. style='mso-bookmark:pdo'><o:p>&nbsp;</o:p></span></pre><pre><span
    1162. 

  1162. style='mso-bookmark:pdo'><span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$conn =&amp; NewADConnection(&quot;pdo_mysql://user:pwd@localhost/mydb?persist&quot;); # persist is optional</span></pre></div>
    1163. 

  1163. 

  1164. <h4><span style='mso-bookmark:pdo'>PostgreSQL</span></h4>
    1165. 

  1165. 

  1166. <p><span style='mso-bookmark:pdo'>PostgreSQL 7 and 8 accepts connections using:
    1167. 

  1167. </span></p>
    1168. 

  1168. 

  1169. <p><span style='mso-bookmark:pdo'>a. the standard connection string:</span></p>
    1170. 

  1170. 

  1171. <div style='mso-element:para-border-div;border:solid #DDDDDD 1.0pt;mso-border-alt:
    1172. 

  1172. solid #DDDDDD .75pt;padding:9.0pt 18.0pt 9.0pt 18.0pt;background:#EEEEEE'><pre
    1173. 

  1173. style='background:#EEEEEE'><span style='mso-bookmark:pdo'><span
    1174. 

  1174. style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$conn = &amp;ADONewConnection('postgres');<span style='mso-spacerun:yes'>&nbsp; </span><br>
    1175. 

  1175. <span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$conn-&gt;PConnect('host=localhost port=5432 dbname=mary');</span></pre></div>
    1176. 

  1176. 

  1177. <p><span style='mso-bookmark:pdo'>b. the classical 4 parameters:</span></p>
    1178. 

  1178. 

  1179. <div style='mso-element:para-border-div;border:solid #DDDDDD 1.0pt;mso-border-alt:
    1180. 

  1180. solid #DDDDDD .75pt;padding:9.0pt 18.0pt 9.0pt 18.0pt;background:#EEEEEE'><pre
    1181. 

  1181. style='background:#EEEEEE'><span style='mso-bookmark:pdo'><span
    1182. 

  1182. style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$conn-&gt;PConnect('localhost','userid','password','database');<br>
    1183. 

  1183. <span style='mso-spacerun:yes'>&nbsp;</span></span></pre></div>
    1184. 

  1184. 

  1185. <p><span style='mso-bookmark:pdo'>c. dsn: </span></p>
    1186. 

  1186. 

  1187. <div style='mso-element:para-border-div;border:solid #DDDDDD 1.0pt;mso-border-alt:
    1188. 

  1188. solid #DDDDDD .75pt;padding:9.0pt 18.0pt 9.0pt 18.0pt;background:#EEEEEE'><pre><span
    1189. 

  1189. style='mso-bookmark:pdo'><span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$dsn = 'postgres://user:pwd@localhost/mydb?persist';<span style='mso-spacerun:yes'>&nbsp; </span># persist is optional</span></pre><pre
    1190. 

  1190. style='background:#EEEEEE'><span style='mso-bookmark:pdo'><span
    1191. 

  1191. style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$conn = ADONewConnection($dsn);<span style='mso-spacerun:yes'>&nbsp; </span># no need for Connect/PConnect</span></pre></div>
    1192. 

  1192. 

  1193. <span style='mso-bookmark:pdo'></span>
    1194. 

  1194. 

  1195. <h4><a name=ldap></a>LDAP</h4>
    1196. 

  1196. 

  1197. <p>Here is an example of querying a LDAP server. Thanks to Josh Eldridge for
    1198. 

  1198. the driver and this example: </p>
    1199. 

  1199. 

  1200. <div style='mso-element:para-border-div;border:solid #DDDDDD 1.0pt;mso-border-alt:
    1201. 

  1201. solid #DDDDDD .75pt;padding:9.0pt 18.0pt 9.0pt 18.0pt;background:#EEEEEE'><pre><o:p>&nbsp;</o:p></pre><pre>require('/path/to/adodb.inc.php');</pre><pre><o:p>&nbsp;</o:p></pre><pre>/* Make sure to set this BEFORE calling Connect() */</pre><pre>$LDAP_CONNECT_OPTIONS = Array(</pre><pre><span
    1202. 

  1202. style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>Array (&quot;OPTION_NAME&quot;=&gt;LDAP_OPT_DEREF, &quot;OPTION_VALUE&quot;=&gt;2),</pre><pre><span
    1203. 

  1203. style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>Array (&quot;OPTION_NAME&quot;=&gt;LDAP_OPT_SIZELIMIT,&quot;OPTION_VALUE&quot;=&gt;100),</pre><pre><span
    1204. 

  1204. style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>Array (&quot;OPTION_NAME&quot;=&gt;LDAP_OPT_TIMELIMIT,&quot;OPTION_VALUE&quot;=&gt;30),</pre><pre><span
    1205. 

  1205. style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>Array (&quot;OPTION_NAME&quot;=&gt;LDAP_OPT_PROTOCOL_VERSION,&quot;OPTION_VALUE&quot;=&gt;3),</pre><pre><span
    1206. 

  1206. style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>Array (&quot;OPTION_NAME&quot;=&gt;LDAP_OPT_ERROR_NUMBER,&quot;OPTION_VALUE&quot;=&gt;13),</pre><pre><span
    1207. 

  1207. style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>Array (&quot;OPTION_NAME&quot;=&gt;LDAP_OPT_REFERRALS,&quot;OPTION_VALUE&quot;=&gt;FALSE),</pre><pre><span
    1208. 

  1208. style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>Array (&quot;OPTION_NAME&quot;=&gt;LDAP_OPT_RESTART,&quot;OPTION_VALUE&quot;=&gt;FALSE)</pre><pre>);</pre><pre>$host = 'ldap.baylor.edu';</pre><pre>$ldapbase = 'ou=People,o=<st1:place
    1209. 

  1209. w:st="on"><st1:PlaceName w:st="on">Baylor</st1:PlaceName> <st1:PlaceType w:st="on">University</st1:PlaceType></st1:place>,c=US';</pre><pre><o:p>&nbsp;</o:p></pre><pre>$ldap = NewADOConnection( 'ldap' );</pre><pre>$ldap-&gt;Connect( $host, $user_name='', $password='', $ldapbase );</pre><pre><o:p>&nbsp;</o:p></pre><pre>echo &quot;&lt;pre&gt;&quot;;</pre><pre><o:p>&nbsp;</o:p></pre><pre>print_r( $ldap-&gt;ServerInfo() );</pre><pre>$ldap-&gt;SetFetchMode(ADODB_FETCH_ASSOC);</pre><pre>$userName = 'eldridge';</pre><pre>$filter=&quot;(|(CN=$userName*)(sn=$userName*)(givenname=$userName*)(uid=$userName*))&quot;;</pre><pre><o:p>&nbsp;</o:p></pre><pre>$rs = $ldap-&gt;Execute( $filter );</pre><pre>if ($rs)</pre><pre><span
    1210. 

  1210. style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>while ($arr = $rs-&gt;FetchRow()) {</pre><pre><span
    1211. 

  1211. style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span><span style='mso-spacerun:yes'>&nbsp;&nbsp;&nbsp;&nbsp; </span>print_r($arr);<span
    1212. 

  1212. style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></pre><pre><span style='mso-tab-count:
    1213. 

  1213. 1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>}</pre><pre><o:p>&nbsp;</o:p></pre><pre>$rs = $ldap-&gt;Execute( $filter );</pre><pre>if ($rs) </pre><pre><span
    1214. 

  1214. style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>while (!$rs-&gt;EOF) {</pre><pre> <span
    1215. 

  1215. style='mso-tab-count:2'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>print_r($rs-&gt;fields);<span
    1216. 

  1216. style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp; </span></pre><pre><span style='mso-tab-count:2'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$rs-&gt;MoveNext();</pre><pre><span
    1217. 

  1217. style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>} </pre><pre><span style='mso-tab-count:
    1218. 

  1218. 1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></pre><pre>print_r( $ldap-&gt;GetArray( $filter ) );</pre><pre>print_r( $ldap-&gt;GetRow( $filter ) );</pre><pre><o:p>&nbsp;</o:p></pre><pre>$ldap-&gt;Close();</pre><pre>echo &quot;&lt;/pre&gt;&quot;;</pre></div>
    1219. 

  1219. 

  1220. <p>Using DSN: </p>
    1221. 

  1221. 

  1222. <div style='mso-element:para-border-div;border:solid #DDDDDD 1.0pt;mso-border-alt:
    1223. 

  1223. solid #DDDDDD .75pt;padding:9.0pt 18.0pt 9.0pt 18.0pt;background:#EEEEEE'><pre><o:p>&nbsp;</o:p></pre><pre>$dsn = &quot;ldap://ldap.baylor.edu/ou=People,o=<st1:place
    1224. 

  1224. w:st="on"><st1:PlaceName w:st="on">Baylor</st1:PlaceName> <st1:PlaceType w:st="on">University</st1:PlaceType></st1:place>,c=US&quot;;</pre><pre>$db = NewADOConnection($dsn);</pre></div>
    1225. 

  1225. 

  1226. <h4>Interbase/Firebird</h4>
    1227. 

  1227. 

  1228. <p class=MsoNormal>You define the database in the $host parameter: </p>
    1229. 

  1229. 

  1230. <div style='mso-element:para-border-div;border:solid #DDDDDD 1.0pt;mso-border-alt:
    1231. 

  1231. solid #DDDDDD .75pt;padding:9.0pt 18.0pt 9.0pt 18.0pt;background:#EEEEEE'><pre
    1232. 

  1232. style='background:#EEEEEE'><span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$conn = &amp;ADONewConnection('ibase'); <br>
    1233. 

  1233. <span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$conn-&gt;PConnect('localhost:c:\ibase\employee.gdb','sysdba','masterkey');</pre></div>
    1234. 

  1234. 

  1235. <p>Or dsn: </p>
    1236. 

  1236. 

  1237. <div style='mso-element:para-border-div;border:solid #DDDDDD 1.0pt;mso-border-alt:
    1238. 

  1238. solid #DDDDDD .75pt;padding:9.0pt 18.0pt 9.0pt 18.0pt;background:#EEEEEE'><pre
    1239. 

  1239. style='background:#EEEEEE'><span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$dsn = 'firebird://user:pwd@localhost/mydb?persist&amp;dialect=3';<span style='mso-spacerun:yes'>&nbsp; </span># persist is optional<br>
    1240. 

  1240. <span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$conn = ADONewConnection($dsn);<span style='mso-spacerun:yes'>&nbsp; </span># no need for Connect/PConnect</pre></div>
    1241. 

  1241. 

  1242. <h4>SQLite</h4>
    1243. 

  1243. 

  1244. <p class=MsoNormal>Sqlite will create the database file if it does not exist. </p>
    1245. 

  1245. 

  1246. <div style='mso-element:para-border-div;border:solid #DDDDDD 1.0pt;mso-border-alt:
    1247. 

  1247. solid #DDDDDD .75pt;padding:9.0pt 18.0pt 9.0pt 18.0pt;background:#EEEEEE'><pre><span
    1248. 

  1248. style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$conn = &amp;ADONewConnection('sqlite');</pre><pre
    1249. 

  1249. style='background:#EEEEEE'><span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$conn-&gt;PConnect('c:\path\to\sqlite.db'); # sqlite will create if does not exist</pre></div>
    1250. 

  1250. 

  1251. <p>Or dsn: </p>
    1252. 

  1252. 

  1253. <div style='mso-element:para-border-div;border:solid #DDDDDD 1.0pt;mso-border-alt:
    1254. 

  1254. solid #DDDDDD .75pt;padding:9.0pt 18.0pt 9.0pt 18.0pt;background:#EEEEEE'><pre><span
    1255. 

  1255. style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$path = urlencode('c:\path\to\sqlite.db');</pre><pre><span
    1256. 

  1256. style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$dsn = &quot;sqlite://$path/?persist&quot;;<span style='mso-spacerun:yes'>&nbsp; </span># persist is optional</pre><pre
    1257. 

  1257. style='background:#EEEEEE'><span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$conn = ADONewConnection($dsn);<span style='mso-spacerun:yes'>&nbsp; </span># no need for Connect/PConnect</pre></div>
    1258. 

  1258. 

  1259. <h4>Oracle (oci8)</h4>
    1260. 

  1260. 

  1261. <p>With oci8, you can connect in multiple ways. Note that oci8 works fine with
    1262. 

  1262. newer versions of the Oracle, eg. 9i and 10g.</p>
    1263. 

  1263. 

  1264. <p>a. PHP and Oracle reside on the same machine, use default SID.</p>
    1265. 

  1265. 

  1266. <div style='mso-element:para-border-div;border:solid #DDDDDD 1.0pt;mso-border-alt:
    1267. 

  1267. solid #DDDDDD .75pt;padding:9.0pt 18.0pt 9.0pt 18.0pt;background:#EEEEEE'><pre
    1268. 

  1268. style='background:#EEEEEE'><span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$conn-&gt;Connect(false, 'scott', 'tiger');</pre></div>
    1269. 

  1269. 

  1270. <p>b. TNS Name defined in tnsnames.ora (or ONAMES or HOSTNAMES), eg. 'myTNS'</p>
    1271. 

  1271. 

  1272. <div style='mso-element:para-border-div;border:solid #DDDDDD 1.0pt;mso-border-alt:
    1273. 

  1273. solid #DDDDDD .75pt;padding:9.0pt 18.0pt 9.0pt 18.0pt;background:#EEEEEE'><pre
    1274. 

  1274. style='background:#EEEEEE'><span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$conn-&gt;PConnect(false, 'scott', 'tiger', 'myTNS');</pre></div>
    1275. 

  1275. 

  1276. <p>or</p>
    1277. 

  1277. 

  1278. <div style='mso-element:para-border-div;border:solid #DDDDDD 1.0pt;mso-border-alt:
    1279. 

  1279. solid #DDDDDD .75pt;padding:9.0pt 18.0pt 9.0pt 18.0pt;background:#EEEEEE'><pre
    1280. 

  1280. style='background:#EEEEEE'><span style='mso-spacerun:yes'>&nbsp;</span><span
    1281. 

  1281. style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$conn-&gt;PConnect('myTNS', 'scott', 'tiger');</pre></div>
    1282. 

  1282. 

  1283. <p>c. Host Address and SID</p>
    1284. 

  1284. 

  1285. <div style='mso-element:para-border-div;border:solid #DDDDDD 1.0pt;mso-border-alt:
    1286. 

  1286. solid #DDDDDD .75pt;padding:9.0pt 18.0pt 9.0pt 18.0pt;background:#EEEEEE'><pre><o:p>&nbsp;</o:p></pre><pre><span
    1287. 

  1287. style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span># with adodb 5.06 or 4.991 and later</pre><pre><span
    1288. 

  1288. style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$conn-&gt;Connect('192.168.0.1', 'scott', 'tiger', &quot;SID=$SID&quot;);</pre><pre><span
    1289. 

  1289. style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></pre><pre><span style='mso-tab-count:
    1290. 

  1290. 1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span># OR with all versions of ADOdb</pre><pre><span
    1291. 

  1291. style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$conn-&gt;connectSID = true;</pre><pre><span
    1292. 

  1292. style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$conn-&gt;Connect('192.168.0.1', 'scott', 'tiger', $SID);</pre><pre
    1293. 

  1293. style='background:#EEEEEE'><span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></pre></div>
    1294. 

  1294. 

  1295. <p>d. Host Address and Service Name</p>
    1296. 

  1296. 

  1297. <div style='mso-element:para-border-div;border:solid #DDDDDD 1.0pt;mso-border-alt:
    1298. 

  1298. solid #DDDDDD .75pt;padding:9.0pt 18.0pt 9.0pt 18.0pt;background:#EEEEEE'><pre
    1299. 

  1299. style='background:#EEEEEE'><span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$conn-&gt;Connect('192.168.0.1', 'scott', 'tiger', 'servicename');</pre></div>
    1300. 

  1300. 

  1301. <p>e. Oracle connection string: </p>
    1302. 

  1302. 

  1303. <div style='mso-element:para-border-div;border:solid #DDDDDD 1.0pt;mso-border-alt:
    1304. 

  1304. solid #DDDDDD .75pt;padding:9.0pt 18.0pt 9.0pt 18.0pt;background:#EEEEEE'><pre
    1305. 

  1305. style='background:#EEEEEE'><span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$cstr = &quot;(DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=$host)(PORT=$port))<br>
    1306. 

  1306. <span style='mso-tab-count:3'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>(CONNECT_DATA=(SID=$sid)))&quot;;<br>
    1307. 

  1307. <span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$conn-&gt;Connect($cstr, 'scott', 'tiger');</pre></div>
    1308. 

  1308. 

  1309. <p>f. ADOdb dsn: </p>
    1310. 

  1310. 

  1311. <div style='mso-element:para-border-div;border:solid #DDDDDD 1.0pt;mso-border-alt:
    1312. 

  1312. solid #DDDDDD .75pt;padding:9.0pt 18.0pt 9.0pt 18.0pt;background:#EEEEEE'><pre
    1313. 

  1313. style='background:#EEEEEE'><span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$dsn = 'oci8://user:pwd@tnsname/?persist';<span style='mso-spacerun:yes'>&nbsp; </span># persist is optional<br>
    1314. 

  1314. <span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$conn = ADONewConnection($dsn);<span style='mso-spacerun:yes'>&nbsp; </span># no need for Connect/PConnect<br>
    1315. 

  1315. <span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span><br>
    1316. 

  1316. <span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$dsn = 'oci8://user:pwd@host/sid';<br>
    1317. 

  1317. <span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$conn = ADONewConnection($dsn);<br>
    1318. 

  1318. <span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span><br>
    1319. 

  1319. <span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$dsn = 'oci8://user:pwd@/';<span style='mso-spacerun:yes'>&nbsp;&nbsp; </span># oracle on local machine<br>
    1320. 

  1320. <span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$conn = ADONewConnection($dsn);</pre></div>
    1321. 

  1321. 

  1322. <p>You can also set the charSet for Oracle 9.2 and later, supported since PHP
    1323. 

  1323. 4.3.2, ADOdb 4.54: </p>
    1324. 

  1324. 

  1325. <div style='mso-element:para-border-div;border:solid #DDDDDD 1.0pt;mso-border-alt:
    1326. 

  1326. solid #DDDDDD .75pt;padding:9.0pt 18.0pt 9.0pt 18.0pt;background:#EEEEEE'><pre
    1327. 

  1327. style='background:#EEEEEE'><span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$conn-&gt;charSet = 'we8iso8859p1';<br>
    1328. 

  1328. <span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$conn-&gt;Connect(...);<br>
    1329. 

  1329. <span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span><br>
    1330. 

  1330. <span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span># or<br>
    1331. 

  1331. <span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$dsn = 'oci8://user:pwd@tnsname/?charset=WE8MSWIN1252';<br>
    1332. 

  1332. <span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$db = ADONewConnection($dsn);</pre></div>
    1333. 

  1333. 

  1334. <h4><a name=dsnless></a>DSN-less ODBC ( Access, MSSQL and DB2 examples)</h4>
    1335. 

  1335. 

  1336. <p>ODBC DSN's can be created in the ODBC control panel, or you can use a
    1337. 

  1337. DSN-less connection.To use DSN-less connections with ODBC you need PHP 4.3 or
    1338. 

  1338. later. </p>
    1339. 

  1339. 

  1340. <p>For Microsoft Access:</p>
    1341. 

  1341. 

  1342. <div style='mso-element:para-border-div;border:solid #DDDDDD 1.0pt;mso-border-alt:
    1343. 

  1343. solid #DDDDDD .75pt;padding:9.0pt 18.0pt 9.0pt 18.0pt;background:#EEEEEE'><pre><span
    1344. 

  1344. style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$db =&amp; ADONewConnection('access');<br>
    1345. 

  1345. <span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$dsn = <strong><span
    1346. 

  1346. style='font-family:"Courier New"'>&quot;Driver={Microsoft Access Driver (*.mdb)};Dbq=d:\\northwind.mdb;Uid=Admin;Pwd=;&quot;;</span></strong></pre><pre><span
    1347. 

  1347. style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$db-&gt;Connect($dsn);</pre></div>
    1348. 

  1348. 

  1349. <p class=MsoNormal>For Microsoft SQL Server: </p>
    1350. 

  1350. 

  1351. <div style='mso-element:para-border-div;border:solid #DDDDDD 1.0pt;mso-border-alt:
    1352. 

  1352. solid #DDDDDD .75pt;padding:9.0pt 18.0pt 9.0pt 18.0pt;background:#EEEEEE'><pre
    1353. 

  1353. style='background:#EEEEEE'><span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$db =&amp; ADONewConnection('odbc_mssql');<br>
    1354. 

  1354. <span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$dsn = <strong><span
    1355. 

  1355. style='font-family:"Courier New"'>&quot;Driver={SQL Server};Server=localhost;Database=northwind;&quot;</span></strong>;<br>
    1356. 

  1356. <span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$db-&gt;Connect($dsn,'userid','password');</pre></div>
    1357. 

  1357. 

  1358. <p class=MsoNormal>or if you prefer to use the mssql extension (which is
    1359. 

  1359. limited to mssql 6.5 functionality): </p>
    1360. 

  1360. 

  1361. <div style='mso-element:para-border-div;border:solid #DDDDDD 1.0pt;mso-border-alt:
    1362. 

  1362. solid #DDDDDD .75pt;padding:9.0pt 18.0pt 9.0pt 18.0pt;background:#EEEEEE'><pre
    1363. 

  1363. style='background:#EEEEEE'><span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$db =&amp; ADONewConnection('mssql');<br>
    1364. 

  1364. <span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$db-&gt;Execute('localhost', 'userid', 'password', 'northwind');</pre></div>
    1365. 

  1365. 

  1366. <p class=MsoNormal>For DB2: </p>
    1367. 

  1367. 

  1368. <div style='mso-element:para-border-div;border:solid #DDDDDD 1.0pt;mso-border-alt:
    1369. 

  1369. solid #DDDDDD .75pt;padding:9.0pt 18.0pt 9.0pt 18.0pt;background:#EEEEEE'><pre><o:p>&nbsp;</o:p></pre><pre><span
    1370. 

  1370. style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$dbms = 'db2'; # or 'odbc_db2' if db2 extension not available</pre><pre><span
    1371. 

  1371. style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$db =&amp; ADONewConnection($dbms);</pre><pre><span
    1372. 

  1372. style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$dsn = &quot;driver={IBM db2 odbc DRIVER};Database=sample;hostname=localhost;port=50000;protocol=TCPIP;&quot;.</pre><pre><span
    1373. 

  1373. style='mso-tab-count:4'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>&quot;uid=root; pwd=secret&quot;;<br>
    1374. 

  1374. <span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$db-&gt;Connect($dsn);<br>
    1375. 

  1375. 		  # or connect and set schema
    1376. 

  1376. 		  $db-&gt;Connect($dsn,null,null,$schema);</pre>
    1377. 

  1377. </div>
    1378. 

  1378. 

  1379. <p class=MsoNormal><b>DSN-less Connections with <st1:City w:st="on">ADO</st1:City></b><br>
    1380. 

  1380. If you are using versions of PHP earlier than PHP 4.3.0, DSN-less connections
    1381. 

  1381. only work with Microsoft's <st1:City w:st="on"><st1:place w:st="on">ADO</st1:place></st1:City>,
    1382. 

  1382. which is Microsoft's COM based API. An example using the ADOdb library and
    1383. 

  1383. Microsoft's <st1:City w:st="on"><st1:place w:st="on">ADO</st1:place></st1:City>:
    1384. 

  1384. </p>
    1385. 

  1385. 

  1386. <div style='mso-element:para-border-div;border:solid #DDDDDD 1.0pt;mso-border-alt:
    1387. 

  1387. solid #DDDDDD .75pt;padding:9.0pt 18.0pt 9.0pt 18.0pt;background:#EEEEEE'><pre>&lt;?php<br>
    1388. 

  1388. <span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>include('adodb.inc.php'); <br>
    1389. 

  1389. <span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$db = &amp;ADONewConnection(&quot;ado_mssql&quot;);<br>
    1390. 

  1390. <span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>print &quot;&lt;h1&gt;Connecting DSN-less $db-&gt;databaseType...&lt;/h1&gt;&quot;;<br>
    1391. 

  1391. <span style='mso-tab-count:2'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span><br>
    1392. 

  1392. <span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span><b>$myDSN=&quot;PROVIDER=MSDASQL;DRIVER={SQL Server};&quot;<br>
    1393. 

  1393. <span style='mso-tab-count:2'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>. &quot;SERVER=flipper;DATABASE=ai;UID=sa;PWD=;&quot;<span style='mso-spacerun:yes'>&nbsp; </span>;</b></pre><pre><span
    1394. 

  1394. style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$db-&gt;Connect($myDSN);</pre><pre><span
    1395. 

  1395. style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></pre><pre><span style='mso-tab-count:
    1396. 

  1396. 1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$rs = $db-&gt;Execute(&quot;select * from table&quot;);</pre><pre><span
    1397. 

  1397. style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$arr = $rs-&gt;GetArray();</pre><pre><span
    1398. 

  1398. style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>print_r($arr);</pre><pre>?&gt;</pre></div>
    1399. 

  1399. 

  1400. <h2><a name=speed></a>High Speed ADOdb - tuning tips</h2>
    1401. 

  1401. 

  1402. <p>ADOdb is a big class library, yet it <a href="http://phplens.com/lens/adodb/">consistently
    1403. 

  1403. beats</a> all other PHP class libraries in performance. This is because it is
    1404. 

  1404. designed in a layered fashion, like an onion, with the fastest functions in the
    1405. 

  1405. innermost layer. Stick to the following functions for best performance:</p>
    1406. 

  1406. 

  1407. <div align=center>
    1408. 

  1408. 

  1409. <table class=MsoNormalTable border=1 cellpadding=0 width="40%"
    1410. 

  1410.  style='width:40.0%;mso-cellspacing:1.5pt'>
    1411. 

  1411.  <tr style='mso-yfti-irow:0;mso-yfti-firstrow:yes'>
    1412. 

  1412.   <td style='padding:.75pt .75pt .75pt .75pt'>
    1413. 

  1413.   <p class=MsoNormal align=center style='text-align:center'><b>Innermost Layer</b></p>
    1414. 

  1414.   </td>
    1415. 

  1415.  </tr>
    1416. 

  1416.  <tr style='mso-yfti-irow:1;mso-yfti-lastrow:yes'>
    1417. 

  1417.   <td style='padding:.75pt .75pt .75pt .75pt'>
    1418. 

  1418.   <p align=center style='text-align:center'>Connect, PConnect, NConnect<br>
    1419. 

  1419.   Execute, CacheExecute<br>
    1420. 

  1420.   SelectLimit, CacheSelectLimit<br>
    1421. 

  1421.   MoveNext, Close <br>
    1422. 

  1422.   qstr, Affected_Rows, Insert_ID</p>
    1423. 

  1423.   </td>
    1424. 

  1424.  </tr>
    1425. 

  1425. </table>
    1426. 

  1426. 

  1427. </div>
    1428. 

  1428. 

  1429. <p>The fastest way to access the field data is by accessing the array
    1430. 

  1430. $recordset-&gt;fields directly. Also set the global variables <a
    1431. 

  1431. href="#adodb_fetch_mode">$ADODB_FETCH_MODE</a> = ADODB_FETCH_NUM, and (for
    1432. 

  1432. oci8, ibase/firebird and odbc) <a href="#adodb_countrecs">$ADODB_COUNTRECS</a>
    1433. 

  1433. = false before you connect to your database.</p>
    1434. 

  1434. 

  1435. <p>Consider using bind parameters if your database supports it, as it improves
    1436. 

  1436. query plan reuse. Use ADOdb's performance tuning system to identify bottlenecks
    1437. 

  1437. quickly. At the time of writing (Dec 2003), this means oci8 and odbc drivers.</p>
    1438. 

  1438. 

  1439. <p>Lastly make sure you have a PHP accelerator cache installed such as APC,
    1440. 

  1440. Turck MMCache, Zend Accelerator or ionCube.</p>
    1441. 

  1441. 

  1442. <p>Some examples:</p>
    1443. 

  1443. 

  1444. <div align=center>
    1445. 

  1445. 

  1446. <table class=MsoNormalTable border=1 cellpadding=0 style='mso-cellspacing:1.5pt'>
    1447. 

  1447.  <tr style='mso-yfti-irow:0;mso-yfti-firstrow:yes'>
    1448. 

  1448.   <td style='padding:.75pt .75pt .75pt .75pt'>
    1449. 

  1449.   <p class=MsoNormal><b>Fastest data retrieval using PHP</b></p>
    1450. 

  1450.   </td>
    1451. 

  1451.   <td style='padding:.75pt .75pt .75pt .75pt'>
    1452. 

  1452.   <p class=MsoNormal><b>Fastest data retrieval using ADOdb extension</b></p>
    1453. 

  1453.   </td>
    1454. 

  1454.  </tr>
    1455. 

  1455.  <tr style='mso-yfti-irow:1;mso-yfti-lastrow:yes'>
    1456. 

  1456.   <td style='padding:.75pt .75pt .75pt .75pt'>
    1457. 

  1457.   <div style='mso-element:para-border-div;border:solid #DDDDDD 1.0pt;
    1458. 

  1458.   mso-border-alt:solid #DDDDDD .75pt;padding:9.0pt 18.0pt 9.0pt 18.0pt;
    1459. 

  1459.   background:#EEEEEE'><pre style='background:#EEEEEE'>$rs =&amp; $rs-&gt;Execute($sql);<br>
    1460. 

  1460. while (!$rs-&gt;EOF) {<br>
    1461. 

  1461.   <span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>var_dump($rs-&gt;fields);<br>
    1462. 

  1462.   <span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$rs-&gt;MoveNext();<br>
    1463. 

  1463. }</pre></div>
    1464. 

  1464.   </td>
    1465. 

  1465.   <td style='padding:.75pt .75pt .75pt .75pt'>
    1466. 

  1466.   <div style='mso-element:para-border-div;border:solid #DDDDDD 1.0pt;
    1467. 

  1467.   mso-border-alt:solid #DDDDDD .75pt;padding:9.0pt 18.0pt 9.0pt 18.0pt;
    1468. 

  1468.   background:#EEEEEE'><pre style='margin-bottom:12.0pt;background:#EEEEEE'>$rs =&amp; $rs-&gt;Execute($sql);<br>
    1469. 

  1469. $array = adodb_getall($rs);<br>
    1470. 

  1470. var_dump($array);<br style='mso-special-character:line-break'>
    1471. 

  1471.   <![if !supportLineBreakNewLine]><br style='mso-special-character:line-break'>
    1472. 

  1472.   <![endif]></pre></div>
    1473. 

  1473.   </td>
    1474. 

  1474.  </tr>
    1475. 

  1475. </table>
    1476. 

  1476. 

  1477. </div>
    1478. 

  1478. 

  1479. <p><b>Advanced Tips</b> </p>
    1480. 

  1480. 

  1481. <p>If you have the <a href="http://adodb.sourceforge.net/#extension">ADOdb C
    1482. 

  1482. extension</a> installed, you can replace your calls to $rs-&gt;MoveNext() with
    1483. 

  1483. adodb_movenext($rs). This doubles the speed of this operation. For retrieving
    1484. 

  1484. entire recordsets at once, use GetArray(), which uses the high speed extension
    1485. 

  1485. function adodb_getall($rs) internally. </p>
    1486. 

  1486. 

  1487. <p>Execute() is the default way to run queries. You can use the low-level
    1488. 

  1488. functions _Execute() and _query() to reduce query overhead. Both these
    1489. 

  1489. functions share the same parameters as Execute(). </p>
    1490. 

  1490. 

  1491. <p>If you do not have any bind parameters or your database supports binding
    1492. 

  1492. (without emulation), then you can call _Execute() directly. Calling this
    1493. 

  1493. function bypasses bind emulation. Debugging is still supported in _Execute(). </p>
    1494. 

  1494. 

  1495. <p>If you do not require debugging facilities nor emulated binding, and do not
    1496. 

  1496. require a recordset to be returned, then you can call _query. This is great for
    1497. 

  1497. inserts, updates and deletes. Calling this function bypasses emulated binding,
    1498. 

  1498. debugging, and recordset handling. Either the resultid, true or false are
    1499. 

  1499. returned by _query(). </p>
    1500. 

  1500. 

  1501. <p>For Informix, you can disable scrollable cursors with $db-&gt;cursorType =
    1502. 

  1502. 0. </p>
    1503. 

  1503. 

  1504. <h2><a name=hack></a>Hacking ADOdb Safely</h2>
    1505. 

  1505. 

  1506. <p>You might want to modify ADOdb for your own purposes. Luckily you can still
    1507. 

  1507. maintain backward compatibility by sub-classing ADOdb and using the
    1508. 

  1508. $ADODB_NEWCONNECTION variable. $ADODB_NEWCONNECTION allows you to override the
    1509. 

  1509. behaviour of ADONewConnection(). ADOConnection() checks for this variable and
    1510. 

  1510. will call the function-name stored in this variable if it is defined. </p>
    1511. 

  1511. 

  1512. <p>In the following example, new functionality for the connection object is
    1513. 

  1513. placed in the <i>hack_mysql</i> and <i>hack_postgres7</i> classes. The
    1514. 

  1514. recordset class naming convention can be controlled using $rsPrefix. Here we
    1515. 

  1515. set it to 'hack_rs_', which will make ADOdb use <i>hack_rs_mysql</i> and <i>hack_rs_postgres7</i>
    1516. 

  1516. as the recordset classes. </p>
    1517. 

  1517. 

  1518. <div style='mso-element:para-border-div;border:solid #DDDDDD 1.0pt;mso-border-alt:
    1519. 

  1519. solid #DDDDDD .75pt;padding:9.0pt 18.0pt 9.0pt 18.0pt;background:#EEEEEE'><pre
    1520. 

  1520. style='background:#EEEEEE'>class hack_mysql extends adodb_mysql {<br>
    1521. 

  1521. var $rsPrefix = 'hack_rs_';<br>
    1522. 

  1522. <span style='mso-spacerun:yes'>&nbsp; </span>/* Your mods here */<br>
    1523. 

  1523. }<br>
    1524. 

  1524. <br>
    1525. 

  1525. class hack_rs_mysql extends ADORecordSet_mysql {<br>
    1526. 

  1526. <span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span><span style='mso-spacerun:yes'>&nbsp;</span>/* Your mods here */<br>
    1527. 

  1527. }<br>
    1528. 

  1528. <br>
    1529. 

  1529. class hack_postgres7 extends adodb_postgres7 {<br>
    1530. 

  1530. var $rsPrefix = 'hack_rs_';<br>
    1531. 

  1531. <span style='mso-spacerun:yes'>&nbsp; </span>/* Your mods here */<br>
    1532. 

  1532. }<br>
    1533. 

  1533. <br>
    1534. 

  1534. class hack_rs_postgres7 extends ADORecordSet_postgres7 {<br>
    1535. 

  1535. <span style='mso-spacerun:yes'>&nbsp;</span>/* Your mods here */<br>
    1536. 

  1536. }<br>
    1537. 

  1537. <br>
    1538. 

  1538. $ADODB_NEWCONNECTION = 'hack_factory';<br>
    1539. 

  1539. <br>
    1540. 

  1540. function&amp; hack_factory($driver)<br>
    1541. 

  1541. {<br>
    1542. 

  1542. <span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>if ($driver !== 'mysql' &amp;&amp; $driver !== 'postgres7') return false;<br>
    1543. 

  1543. <span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span><br>
    1544. 

  1544. <span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$driver = 'hack_'.$driver;<br>
    1545. 

  1545. <span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$obj = new $driver();<br>
    1546. 

  1546. <span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>return $obj;<br>
    1547. 

  1547. }<br>
    1548. 

  1548. <br>
    1549. 

  1549. include_once('adodb.inc.php');</pre></div>
    1550. 

  1550. 

  1551. <p>Don't forget to call the constructor of the parent class in your
    1552. 

  1552. constructor. If you want to use the default ADOdb drivers return false in the
    1553. 

  1553. above hack_factory() function. Also you can define your own
    1554. 

  1554. ADORecordSet_empty() class, by defining a class $$this-&gt;rsPrefix.'empty'
    1555. 

  1555. since 4.96/5.02. <a name=php5></a></p>
    1556. 

  1556. 

  1557. <h2>PHP5 Features</h2>
    1558. 

  1558. 

  1559. <p class=MsoNormal>ADOdb 4.02 or later will transparently determine which
    1560. 

  1560. version of PHP you are using. If PHP5 is detected, the following features become
    1561. 

  1561. available: </p>
    1562. 

  1562. 

  1563. <ul type=disc>
    1564. 

  1564.  <li class=MsoNormal style='mso-margin-top-alt:auto;margin-bottom:12.0pt;
    1565. 

  1565.      mso-list:l11 level1 lfo5;tab-stops:list 36.0pt'><b>PDO</b>: PDO drivers
    1566. 

  1566.      are available. See the <a href="#pdo">connection examples</a>. Currently
    1567. 

  1567.      PDO drivers are not as powerful as native drivers, and should be treated
    1568. 

  1568.      as experimental.<a name=php5iterators></a></li>
    1569. 

  1569.  <li class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
    1570. 

  1570.      mso-list:l11 level1 lfo5;tab-stops:list 36.0pt'><b>Foreach iterators</b>:
    1571. 

  1571.      This is a very natural way of going through a recordset: </li>
    1572. 

  1572. </ul>
    1573. 

  1573. 

  1574. <div style='mso-element:para-border-div;border:solid #DDDDDD 1.0pt;mso-border-alt:
    1575. 

  1575. solid #DDDDDD .75pt;padding:9.0pt 18.0pt 9.0pt 18.0pt;background:#EEEEEE;
    1576. 

  1576. margin-left:36.0pt;margin-right:0cm'><pre style='background:#EEEEEE'><span
    1577. 

  1577. style='mso-tab-count:1'>&nbsp; </span>$ADODB_FETCH_MODE = ADODB_FETCH_NUM;<br>
    1578. 

  1578. <span style='mso-tab-count:1'>&nbsp; </span>$rs = $db-&gt;Execute($sql);<br>
    1579. 

  1579. <span style='mso-tab-count:1'>&nbsp; </span>foreach($rs as $k =&gt; $row) {<br>
    1580. 

  1580. <span style='mso-tab-count:2'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>echo &quot;r1=&quot;.$row[0].&quot; r2=&quot;.$row[1].&quot;&lt;br&gt;&quot;;<br>
    1581. 

  1581. <span style='mso-tab-count:1'>&nbsp; </span>}</pre></div>
    1582. 

  1582. 

  1583. <ul type=disc>
    1584. 

  1584.  <li class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
    1585. 

  1585.      mso-list:l11 level1 lfo5;tab-stops:list 36.0pt'><a name=php5exceptions></a><b>Exceptions</b>:
    1586. 

  1586.      Just include <i>adodb-exceptions.inc.php</i> and you can now catch
    1587. 

  1587.      exceptions on errors as they occur. </li>
    1588. 

  1588. </ul>
    1589. 

  1589. 

  1590. <div style='mso-element:para-border-div;border:solid #DDDDDD 1.0pt;mso-border-alt:
    1591. 

  1591. solid #DDDDDD .75pt;padding:9.0pt 18.0pt 9.0pt 18.0pt;background:#EEEEEE;
    1592. 

  1592. margin-left:36.0pt;margin-right:0cm'><pre style='background:#EEEEEE'><span
    1593. 

  1593. style='mso-tab-count:1'>&nbsp; </span><b>include(&quot;../adodb-exceptions.inc.php&quot;);</b> <br>
    1594. 

  1594. <span style='mso-tab-count:1'>&nbsp; </span>include(&quot;../adodb.inc.php&quot;);<span
    1595. 

  1595. style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span> <br>
    1596. 

  1596. <span style='mso-tab-count:1'>&nbsp; </span>try { <br>
    1597. 

  1597. <span style='mso-tab-count:2'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$db = NewADOConnection(&quot;oci8&quot;); <br>
    1598. 

  1598. <span style='mso-tab-count:2'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$db-&gt;Connect('','scott','bad-password'); <br>
    1599. 

  1599. <span style='mso-tab-count:1'>&nbsp; </span>} catch (exception $e) { <br>
    1600. 

  1600. <span style='mso-tab-count:2'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>var_dump($e); <br>
    1601. 

  1601. <span style='mso-tab-count:2'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>adodb_backtrace($e-&gt;gettrace());<br>
    1602. 

  1602. <span style='mso-tab-count:1'>&nbsp; </span>} </pre></div>
    1603. 

  1603. 

  1604. <p style='margin-left:36.0pt'>Note that reaching EOF is <b>not</b> considered
    1605. 

  1605. an error nor an exception. </p>
    1606. 

  1606. 

  1607. <h3><a name=drivers></a>Databases Supported</h3>
    1608. 

  1608. 

  1609. <p class=MsoNormal>The <i>name</i> below is the value you pass to
    1610. 

  1610. NewADOConnection($name) to create a connection object for that database. </p>
    1611. 

  1611. 

  1612. <table class=MsoNormalTable border=1 cellpadding=0 width="100%"
    1613. 

  1613.  style='width:100.0%;mso-cellspacing:1.5pt'>
    1614. 

  1614.  <tr style='mso-yfti-irow:0;mso-yfti-firstrow:yes'>
    1615. 

  1615.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    1616. 

  1616.   <p class=MsoNormal><b>Name</b></p>
    1617. 

  1617.   </td>
    1618. 

  1618.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    1619. 

  1619.   <p class=MsoNormal><b>Tested</b></p>
    1620. 

  1620.   </td>
    1621. 

  1621.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    1622. 

  1622.   <p class=MsoNormal><b>Database</b></p>
    1623. 

  1623.   </td>
    1624. 

  1624.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    1625. 

  1625.   <p class=MsoNormal><b><span style='font-size:10.0pt'>RecordCount() usable</span></b></p>
    1626. 

  1626.   </td>
    1627. 

  1627.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    1628. 

  1628.   <p class=MsoNormal><b>Prerequisites</b></p>
    1629. 

  1629.   </td>
    1630. 

  1630.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    1631. 

  1631.   <p class=MsoNormal><b>Operating Systems</b></p>
    1632. 

  1632.   </td>
    1633. 

  1633.  </tr>
    1634. 

  1634.  <tr style='mso-yfti-irow:1'>
    1635. 

  1635.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    1636. 

  1636.   <p class=MsoNormal><b><span style='font-size:10.0pt'>access</span></b></p>
    1637. 

  1637.   </td>
    1638. 

  1638.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    1639. 

  1639.   <p class=MsoNormal><span style='font-size:10.0pt'>B</span></p>
    1640. 

  1640.   </td>
    1641. 

  1641.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    1642. 

  1642.   <p class=MsoNormal><span style='font-size:10.0pt'>Microsoft Access/Jet. You
    1643. 

  1643.   need to create an ODBC DSN.</span></p>
    1644. 

  1644.   </td>
    1645. 

  1645.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    1646. 

  1646.   <p class=MsoNormal><span style='font-size:10.0pt'>Y/N</span></p>
    1647. 

  1647.   </td>
    1648. 

  1648.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    1649. 

  1649.   <p class=MsoNormal><span style='font-size:10.0pt'>ODBC </span></p>
    1650. 

  1650.   </td>
    1651. 

  1651.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    1652. 

  1652.   <p class=MsoNormal><span style='font-size:10.0pt'>Windows only</span></p>
    1653. 

  1653.   </td>
    1654. 

  1654.  </tr>
    1655. 

  1655.  <tr style='mso-yfti-irow:2'>
    1656. 

  1656.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    1657. 

  1657.   <p class=MsoNormal><b><span style='font-size:10.0pt'>ado</span></b></p>
    1658. 

  1658.   </td>
    1659. 

  1659.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    1660. 

  1660.   <p class=MsoNormal><span style='font-size:10.0pt'>B</span></p>
    1661. 

  1661.   </td>
    1662. 

  1662.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    1663. 

  1663.   <p><span style='font-size:10.0pt'>Generic <st1:City w:st="on"><st1:place
    1664. 

  1664.    w:st="on">ADO</st1:place></st1:City>, not tuned for specific databases.
    1665. 

  1665.   Allows DSN-less connections. For best performance, use an OLEDB provider.
    1666. 

  1666.   This is the base class for all ado drivers.</span></p>
    1667. 

  1667.   <p><span style='font-size:10.0pt'>You can set $db-&gt;codePage before
    1668. 

  1668.   connecting.</span></p>
    1669. 

  1669.   </td>
    1670. 

  1670.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    1671. 

  1671.   <p class=MsoNormal><span style='font-size:10.0pt'>? depends on database</span></p>
    1672. 

  1672.   </td>
    1673. 

  1673.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    1674. 

  1674.   <p class=MsoNormal><st1:City w:st="on"><st1:place w:st="on"><span
    1675. 

  1675.     style='font-size:10.0pt'>ADO</span></st1:place></st1:City><span
    1676. 

  1676.   style='font-size:10.0pt'> or OLEDB provider</span></p>
    1677. 

  1677.   </td>
    1678. 

  1678.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    1679. 

  1679.   <p class=MsoNormal><span style='font-size:10.0pt'>Windows only</span></p>
    1680. 

  1680.   </td>
    1681. 

  1681.  </tr>
    1682. 

  1682.  <tr style='mso-yfti-irow:3'>
    1683. 

  1683.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    1684. 

  1684.   <p class=MsoNormal><b><span style='font-size:10.0pt'>ado_access</span></b></p>
    1685. 

  1685.   </td>
    1686. 

  1686.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    1687. 

  1687.   <p class=MsoNormal><span style='font-size:10.0pt'>B</span></p>
    1688. 

  1688.   </td>
    1689. 

  1689.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    1690. 

  1690.   <p class=MsoNormal><span style='font-size:10.0pt'>Microsoft Access/Jet using <st1:City
    1691. 

  1691.   w:st="on"><st1:place w:st="on">ADO</st1:place></st1:City>. Allows DSN-less
    1692. 

  1692.   connections. For best performance, use an OLEDB provider.</span></p>
    1693. 

  1693.   </td>
    1694. 

  1694.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    1695. 

  1695.   <p class=MsoNormal><span style='font-size:10.0pt'>Y/N</span></p>
    1696. 

  1696.   </td>
    1697. 

  1697.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    1698. 

  1698.   <p class=MsoNormal><st1:City w:st="on"><st1:place w:st="on"><span
    1699. 

  1699.     style='font-size:10.0pt'>ADO</span></st1:place></st1:City><span
    1700. 

  1700.   style='font-size:10.0pt'> or OLEDB provider</span></p>
    1701. 

  1701.   </td>
    1702. 

  1702.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    1703. 

  1703.   <p class=MsoNormal><span style='font-size:10.0pt'>Windows only</span></p>
    1704. 

  1704.   </td>
    1705. 

  1705.  </tr>
    1706. 

  1706.  <tr style='mso-yfti-irow:4'>
    1707. 

  1707.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    1708. 

  1708.   <p class=MsoNormal><b><span style='font-size:10.0pt'>ado_mssql</span></b></p>
    1709. 

  1709.   </td>
    1710. 

  1710.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    1711. 

  1711.   <p class=MsoNormal><span style='font-size:10.0pt'>B</span></p>
    1712. 

  1712.   </td>
    1713. 

  1713.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    1714. 

  1714.   <p class=MsoNormal><span style='font-size:10.0pt'>Microsoft SQL Server using <st1:City
    1715. 

  1715.   w:st="on"><st1:place w:st="on">ADO</st1:place></st1:City>. Allows DSN-less
    1716. 

  1716.   connections. For best performance, use an OLEDB provider.</span></p>
    1717. 

  1717.   </td>
    1718. 

  1718.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    1719. 

  1719.   <p class=MsoNormal><span style='font-size:10.0pt'>Y/N</span></p>
    1720. 

  1720.   </td>
    1721. 

  1721.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    1722. 

  1722.   <p class=MsoNormal><st1:City w:st="on"><st1:place w:st="on"><span
    1723. 

  1723.     style='font-size:10.0pt'>ADO</span></st1:place></st1:City><span
    1724. 

  1724.   style='font-size:10.0pt'> or OLEDB provider</span></p>
    1725. 

  1725.   </td>
    1726. 

  1726.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    1727. 

  1727.   <p class=MsoNormal><span style='font-size:10.0pt'>Windows only</span></p>
    1728. 

  1728.   </td>
    1729. 

  1729.  </tr>
    1730. 

  1730.  <tr style='mso-yfti-irow:5;height:40.5pt'>
    1731. 

  1731.   <td valign=top style='padding:.75pt .75pt .75pt .75pt;height:40.5pt'>
    1732. 

  1732.   <p class=MsoNormal><b><span style='font-size:10.0pt'>db2</span></b></p>
    1733. 

  1733.   </td>
    1734. 

  1734.   <td valign=top style='padding:.75pt .75pt .75pt .75pt;height:40.5pt'>
    1735. 

  1735.   <p class=MsoNormal><span style='font-size:10.0pt'>B</span></p>
    1736. 

  1736.   </td>
    1737. 

  1737.   <td valign=top style='padding:.75pt .75pt .75pt .75pt;height:40.5pt'>
    1738. 

  1738.   <p class=MsoNormal><span style='font-size:10.0pt'>Uses PHP's db2-specific
    1739. 

  1739.   extension for better performance.</span></p>
    1740. 

  1740.   </td>
    1741. 

  1741.   <td valign=top style='padding:.75pt .75pt .75pt .75pt;height:40.5pt'>
    1742. 

  1742.   <p class=MsoNormal><span style='font-size:10.0pt'>Y/N</span></p>
    1743. 

  1743.   </td>
    1744. 

  1744.   <td valign=top style='padding:.75pt .75pt .75pt .75pt;height:40.5pt'>
    1745. 

  1745.   <p class=MsoNormal><span style='font-size:10.0pt'>DB2 CLI/ODBC interface</span></p>
    1746. 

  1746.   </td>
    1747. 

  1747.   <td valign=top style='padding:.75pt .75pt .75pt .75pt;height:40.5pt'>
    1748. 

  1748.   <p><span style='font-size:10.0pt'>Unix and Windows. Requires IBM DB2
    1749. 

  1749.   Universal Database client.</span></p>
    1750. 

  1750.   </td>
    1751. 

  1751.  </tr>
    1752. 

  1752. 

  1753.  <tr style='mso-yfti-irow:5;height:40.5pt'>
    1754. 

  1754.   <td valign=top style='padding:.75pt .75pt .75pt .75pt;height:40.5pt'>
    1755. 

  1755.   <p class=MsoNormal><b><span style='font-size:10.0pt'>db2oci</span></b></p>
    1756. 

  1756.   </td>
    1757. 

  1757.   <td valign=top style='padding:.75pt .75pt .75pt .75pt;height:40.5pt'>
    1758. 

  1758.   <p class=MsoNormal><span style='font-size:10.0pt'>C</span></p>
    1759. 

  1759.   </td>
    1760. 

  1760.   <td valign=top style='padding:.75pt .75pt .75pt .75pt;height:40.5pt'>
    1761. 

  1761.   <p class=MsoNormal><span style='font-size:10.0pt'>Based on db2 driver. Allows use of oracle style :0, :1, :2 bind variables. Used with DB2 9.7 or later with PL/SQL mode turned on.</span></p>
    1762. 

  1762.   </td>
    1763. 

  1763.   <td valign=top style='padding:.75pt .75pt .75pt .75pt;height:40.5pt'>
    1764. 

  1764.   <p class=MsoNormal><span style='font-size:10.0pt'>Y/N</span></p>
    1765. 

  1765.   </td>
    1766. 

  1766.   <td valign=top style='padding:.75pt .75pt .75pt .75pt;height:40.5pt'>
    1767. 

  1767.   <p class=MsoNormal><span style='font-size:10.0pt'>DB2 CLI/ODBC interface</span></p>
    1768. 

  1768.   </td>
    1769. 

  1769.   <td valign=top style='padding:.75pt .75pt .75pt .75pt;height:40.5pt'>
    1770. 

  1770.   <p><span style='font-size:10.0pt'>Unix and Windows. Requires IBM DB2
    1771. 

  1771.   Universal Database client.</span></p>
    1772. 

  1772.   </td>
    1773. 

  1773.  </tr>
    1774. 

  1774. 

  1775.  <tr style='mso-yfti-irow:6;height:40.5pt'>
    1776. 

  1776.   <td valign=top style='padding:.75pt .75pt .75pt .75pt;height:40.5pt'>
    1777. 

  1777.   <p class=MsoNormal><b><span style='font-size:10.0pt'>odbc_db2</span></b></p>
    1778. 

  1778.   </td>
    1779. 

  1779.   <td valign=top style='padding:.75pt .75pt .75pt .75pt;height:40.5pt'>
    1780. 

  1780.   <p class=MsoNormal><span style='font-size:10.0pt'>C</span></p>
    1781. 

  1781.   </td>
    1782. 

  1782.   <td valign=top style='padding:.75pt .75pt .75pt .75pt;height:40.5pt'>
    1783. 

  1783.   <p class=MsoNormal><span style='font-size:10.0pt'>Connects to DB2 using
    1784. 

  1784.   generic ODBC extension.</span></p>
    1785. 

  1785.   </td>
    1786. 

  1786.   <td valign=top style='padding:.75pt .75pt .75pt .75pt;height:40.5pt'>
    1787. 

  1787.   <p class=MsoNormal><span style='font-size:10.0pt'>Y/N</span></p>
    1788. 

  1788.   </td>
    1789. 

  1789.   <td valign=top style='padding:.75pt .75pt .75pt .75pt;height:40.5pt'>
    1790. 

  1790.   <p class=MsoNormal><span style='font-size:10.0pt'>DB2 CLI/ODBC interface</span></p>
    1791. 

  1791.   </td>
    1792. 

  1792.   <td valign=top style='padding:.75pt .75pt .75pt .75pt;height:40.5pt'>
    1793. 

  1793.   <p><span style='font-size:10.0pt'>Unix and Windows. <a
    1794. 

  1794.   href="http://www.faqts.com/knowledge_base/view.phtml/aid/6283/fid/14">Unix
    1795. 

  1795.   install hints</a>. I have had reports that the $host and $database params
    1796. 

  1796.   have to be reversed in Connect() when using the CLI interface.</span></p>
    1797. 

  1797.   </td>
    1798. 

  1798.  </tr>
    1799. 

  1799.  <tr style='mso-yfti-irow:7'>
    1800. 

  1800.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    1801. 

  1801.   <p class=MsoNormal><b><span style='font-size:10.0pt'>vfp</span></b></p>
    1802. 

  1802.   </td>
    1803. 

  1803.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    1804. 

  1804.   <p class=MsoNormal><span style='font-size:10.0pt'>A</span></p>
    1805. 

  1805.   </td>
    1806. 

  1806.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    1807. 

  1807.   <p class=MsoNormal><span style='font-size:10.0pt'>Microsoft Visual FoxPro.
    1808. 

  1808.   You need to create an ODBC DSN.</span></p>
    1809. 

  1809.   </td>
    1810. 

  1810.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    1811. 

  1811.   <p class=MsoNormal><span style='font-size:10.0pt'>Y/N</span></p>
    1812. 

  1812.   </td>
    1813. 

  1813.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    1814. 

  1814.   <p class=MsoNormal><span style='font-size:10.0pt'>ODBC</span></p>
    1815. 

  1815.   </td>
    1816. 

  1816.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    1817. 

  1817.   <p class=MsoNormal><span style='font-size:10.0pt'>Windows only</span></p>
    1818. 

  1818.   </td>
    1819. 

  1819.  </tr>
    1820. 

  1820.  <tr style='mso-yfti-irow:8'>
    1821. 

  1821.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    1822. 

  1822.   <p class=MsoNormal><b><span style='font-size:10.0pt'>fbsql</span></b></p>
    1823. 

  1823.   </td>
    1824. 

  1824.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    1825. 

  1825.   <p class=MsoNormal><span style='font-size:10.0pt'>C</span></p>
    1826. 

  1826.   </td>
    1827. 

  1827.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    1828. 

  1828.   <p class=MsoNormal><span style='font-size:10.0pt'>FrontBase. </span></p>
    1829. 

  1829.   </td>
    1830. 

  1830.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    1831. 

  1831.   <p class=MsoNormal><span style='font-size:10.0pt'>Y</span></p>
    1832. 

  1832.   </td>
    1833. 

  1833.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    1834. 

  1834.   <p class=MsoNormal><span style='font-size:10.0pt'>?</span></p>
    1835. 

  1835.   </td>
    1836. 

  1836.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    1837. 

  1837.   <p><span style='font-size:10.0pt'>Unix and Windows</span></p>
    1838. 

  1838.   </td>
    1839. 

  1839.  </tr>
    1840. 

  1840.  <tr style='mso-yfti-irow:9'>
    1841. 

  1841.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    1842. 

  1842.   <p class=MsoNormal><b><span style='font-size:10.0pt'>ibase</span></b></p>
    1843. 

  1843.   </td>
    1844. 

  1844.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    1845. 

  1845.   <p class=MsoNormal><span style='font-size:10.0pt'>B</span></p>
    1846. 

  1846.   </td>
    1847. 

  1847.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    1848. 

  1848.   <p class=MsoNormal><span style='font-size:10.0pt'>Interbase 6 or earlier.
    1849. 

  1849.   Some users report you might need to use this<br>
    1850. 

  1850.   $db-&gt;PConnect('localhost:c:/ibase/employee.gdb', &quot;sysdba&quot;,
    1851. 

  1851.   &quot;masterkey&quot;) to connect. Lacks Affected_Rows currently.<br>
    1852. 

  1852.   <br>
    1853. 

  1853.   You can set $db-&gt;role, $db-&gt;dialect, $db-&gt;buffers and
    1854. 

  1854.   $db-&gt;charSet before connecting.</span></p>
    1855. 

  1855.   </td>
    1856. 

  1856.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    1857. 

  1857.   <p class=MsoNormal><span style='font-size:10.0pt'>Y/N</span></p>
    1858. 

  1858.   </td>
    1859. 

  1859.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    1860. 

  1860.   <p class=MsoNormal><span style='font-size:10.0pt'>Interbase client</span></p>
    1861. 

  1861.   </td>
    1862. 

  1862.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    1863. 

  1863.   <p class=MsoNormal><span style='font-size:10.0pt'>Unix and Windows</span></p>
    1864. 

  1864.   </td>
    1865. 

  1865.  </tr>
    1866. 

  1866.  <tr style='mso-yfti-irow:10'>
    1867. 

  1867.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    1868. 

  1868.   <p class=MsoNormal><b><i><span style='font-size:10.0pt'>firebird</span></i></b></p>
    1869. 

  1869.   </td>
    1870. 

  1870.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    1871. 

  1871.   <p class=MsoNormal><span style='font-size:10.0pt'>C</span></p>
    1872. 

  1872.   </td>
    1873. 

  1873.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    1874. 

  1874.   <p class=MsoNormal><span style='font-size:10.0pt'>Firebird version of
    1875. 

  1875.   interbase.</span></p>
    1876. 

  1876.   </td>
    1877. 

  1877.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    1878. 

  1878.   <p class=MsoNormal><span style='font-size:10.0pt'>Y/N</span></p>
    1879. 

  1879.   </td>
    1880. 

  1880.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    1881. 

  1881.   <p class=MsoNormal><span style='font-size:10.0pt'>Interbase client</span></p>
    1882. 

  1882.   </td>
    1883. 

  1883.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    1884. 

  1884.   <p class=MsoNormal><span style='font-size:10.0pt'>Unix and Windows</span></p>
    1885. 

  1885.   </td>
    1886. 

  1886.  </tr>
    1887. 

  1887.  <tr style='mso-yfti-irow:11'>
    1888. 

  1888.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    1889. 

  1889.   <p class=MsoNormal><b><i><span style='font-size:10.0pt'>borland_ibase</span></i></b></p>
    1890. 

  1890.   </td>
    1891. 

  1891.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    1892. 

  1892.   <p class=MsoNormal><span style='font-size:10.0pt'>C</span></p>
    1893. 

  1893.   </td>
    1894. 

  1894.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    1895. 

  1895.   <p class=MsoNormal><span style='font-size:10.0pt'>Borland version of
    1896. 

  1896.   Interbase 6.5 or later. Very sad that the forks differ.</span></p>
    1897. 

  1897.   </td>
    1898. 

  1898.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    1899. 

  1899.   <p class=MsoNormal><span style='font-size:10.0pt'>Y/N</span></p>
    1900. 

  1900.   </td>
    1901. 

  1901.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    1902. 

  1902.   <p class=MsoNormal><span style='font-size:10.0pt'>Interbase client</span></p>
    1903. 

  1903.   </td>
    1904. 

  1904.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    1905. 

  1905.   <p class=MsoNormal><span style='font-size:10.0pt'>Unix and Windows</span></p>
    1906. 

  1906.   </td>
    1907. 

  1907.  </tr>
    1908. 

  1908.  <tr style='mso-yfti-irow:12'>
    1909. 

  1909.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    1910. 

  1910.   <p class=MsoNormal><b><span style='font-size:10.0pt'>informix</span></b></p>
    1911. 

  1911.   </td>
    1912. 

  1912.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    1913. 

  1913.   <p class=MsoNormal><span style='font-size:10.0pt'>C</span></p>
    1914. 

  1914.   </td>
    1915. 

  1915.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    1916. 

  1916.   <p class=MsoNormal><span style='font-size:10.0pt'>Generic informix driver.
    1917. 

  1917.   Use this if you are using Informix 7.3 or later.</span></p>
    1918. 

  1918.   </td>
    1919. 

  1919.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    1920. 

  1920.   <p class=MsoNormal><span style='font-size:10.0pt'>Y/N</span></p>
    1921. 

  1921.   </td>
    1922. 

  1922.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    1923. 

  1923.   <p class=MsoNormal><span style='font-size:10.0pt'>Informix client</span></p>
    1924. 

  1924.   </td>
    1925. 

  1925.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    1926. 

  1926.   <p class=MsoNormal><span style='font-size:10.0pt'>Unix and Windows</span></p>
    1927. 

  1927.   </td>
    1928. 

  1928.  </tr>
    1929. 

  1929.  <tr style='mso-yfti-irow:13'>
    1930. 

  1930.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    1931. 

  1931.   <p class=MsoNormal><b><span style='font-size:10.0pt'>informix72</span></b></p>
    1932. 

  1932.   </td>
    1933. 

  1933.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    1934. 

  1934.   <p class=MsoNormal><span style='font-size:10.0pt'>C</span></p>
    1935. 

  1935.   </td>
    1936. 

  1936.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    1937. 

  1937.   <p class=MsoNormal><span style='font-size:10.0pt'>Informix databases before
    1938. 

  1938.   Informix 7.3 that do no support SELECT FIRST.</span></p>
    1939. 

  1939.   </td>
    1940. 

  1940.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    1941. 

  1941.   <p class=MsoNormal><span style='font-size:10.0pt'>Y/N</span></p>
    1942. 

  1942.   </td>
    1943. 

  1943.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    1944. 

  1944.   <p class=MsoNormal><span style='font-size:10.0pt'>Informix client</span></p>
    1945. 

  1945.   </td>
    1946. 

  1946.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    1947. 

  1947.   <p class=MsoNormal><span style='font-size:10.0pt'>Unix and Windows</span></p>
    1948. 

  1948.   </td>
    1949. 

  1949.  </tr>
    1950. 

  1950.  <tr style='mso-yfti-irow:14'>
    1951. 

  1951.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    1952. 

  1952.   <p class=MsoNormal><b><span style='font-size:10.0pt'>ldap</span></b></p>
    1953. 

  1953.   </td>
    1954. 

  1954.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    1955. 

  1955.   <p class=MsoNormal><span style='font-size:10.0pt'>C</span></p>
    1956. 

  1956.   </td>
    1957. 

  1957.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    1958. 

  1958.   <p class=MsoNormal><span style='font-size:10.0pt'>LDAP driver. See this
    1959. 

  1959.   example for usage information.</span></p>
    1960. 

  1960.   </td>
    1961. 

  1961.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    1962. 

  1962.   <p class=MsoNormal>&nbsp;</p>
    1963. 

  1963.   </td>
    1964. 

  1964.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    1965. 

  1965.   <p class=MsoNormal><span style='font-size:10.0pt'>LDAP extension</span></p>
    1966. 

  1966.   </td>
    1967. 

  1967.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    1968. 

  1968.   <p class=MsoNormal><span style='font-size:10.0pt'>?</span></p>
    1969. 

  1969.   </td>
    1970. 

  1970.  </tr>
    1971. 

  1971.  <tr style='mso-yfti-irow:15;height:54.75pt'>
    1972. 

  1972.   <td valign=top style='padding:.75pt .75pt .75pt .75pt;height:54.75pt'>
    1973. 

  1973.   <p class=MsoNormal><b><span style='font-size:10.0pt'>mssql</span></b></p>
    1974. 

  1974.   </td>
    1975. 

  1975.   <td valign=top style='padding:.75pt .75pt .75pt .75pt;height:54.75pt'>
    1976. 

  1976.   <p class=MsoNormal><span style='font-size:10.0pt'>A</span></p>
    1977. 

  1977.   </td>
    1978. 

  1978.   <td valign=top style='padding:.75pt .75pt .75pt .75pt;height:54.75pt'>
    1979. 

  1979.   <p><span style='font-size:10.0pt'>Microsoft SQL Server 7 and later. Works
    1980. 

  1980.   with Microsoft SQL Server 2000 also. Note that date formating is problematic
    1981. 

  1981.   with this driver. For example, the PHP mssql extension does not return the
    1982. 

  1982.   seconds for datetime!</span></p>
    1983. 

  1983.   </td>
    1984. 

  1984.   <td valign=top style='padding:.75pt .75pt .75pt .75pt;height:54.75pt'>
    1985. 

  1985.   <p class=MsoNormal><span style='font-size:10.0pt'>Y/N</span></p>
    1986. 

  1986.   </td>
    1987. 

  1987.   <td valign=top style='padding:.75pt .75pt .75pt .75pt;height:54.75pt'>
    1988. 

  1988.   <p class=MsoNormal><span style='font-size:10.0pt'>Mssql client</span></p>
    1989. 

  1989.   </td>
    1990. 

  1990.   <td valign=top style='padding:.75pt .75pt .75pt .75pt;height:54.75pt'>
    1991. 

  1991.   <p><span style='font-size:10.0pt'>Unix and Windows. <br>
    1992. 

  1992.   <a href="http://phpbuilder.com/columns/alberto20000919.php3">Unix install
    1993. 

  1993.   howto</a> and <a
    1994. 

  1994.   href="http://www.linuxjournal.com/article/6636">another
    1995. 

  1995.   one</a>. </span></p>
    1996. 

  1996.   </td>
    1997. 

  1997.  </tr>
    1998. 

  1998.  <tr style='mso-yfti-irow:16;height:54.75pt'>
    1999. 

  1999.   <td valign=top style='padding:.75pt .75pt .75pt .75pt;height:54.75pt'>
    2000. 

  2000.   <p class=MsoNormal><b><span style='font-size:10.0pt'>mssqlpo</span></b></p>
    2001. 

  2001.   </td>
    2002. 

  2002.   <td valign=top style='padding:.75pt .75pt .75pt .75pt;height:54.75pt'>
    2003. 

  2003.   <p class=MsoNormal><span style='font-size:10.0pt'>A</span></p>
    2004. 

  2004.   </td>
    2005. 

  2005.   <td valign=top style='padding:.75pt .75pt .75pt .75pt;height:54.75pt'>
    2006. 

  2006.   <p><span style='font-size:10.0pt'>Portable mssql driver. Identical to above mssql
    2007. 

  2007.   driver, except that '||', the concatenation operator, is converted to '+'.
    2008. 

  2008.   Useful for porting scripts from most other sql variants that use ||.</span></p>
    2009. 

  2009.   </td>
    2010. 

  2010.   <td valign=top style='padding:.75pt .75pt .75pt .75pt;height:54.75pt'>
    2011. 

  2011.   <p class=MsoNormal><span style='font-size:10.0pt'>Y/N</span></p>
    2012. 

  2012.   </td>
    2013. 

  2013.   <td valign=top style='padding:.75pt .75pt .75pt .75pt;height:54.75pt'>
    2014. 

  2014.   <p class=MsoNormal><span style='font-size:10.0pt'>Mssql client</span></p>
    2015. 

  2015.   </td>
    2016. 

  2016.   <td valign=top style='padding:.75pt .75pt .75pt .75pt;height:54.75pt'>
    2017. 

  2017.   <p><span style='font-size:10.0pt'>Unix and Windows. <a
    2018. 

  2018.   href="http://phpbuilder.com/columns/alberto20000919.php3"><br>
    2019. 

  2019.   Unix install howto</a>.</span></p>
    2020. 

  2020.   </td>
    2021. 

  2021.  </tr>
    2022. 

  2022.  <tr style='mso-yfti-irow:17;height:54.75pt'>
    2023. 

  2023.   <td valign=top style='padding:.75pt .75pt .75pt .75pt;height:54.75pt'>
    2024. 

  2024.   <p class=MsoNormal><b><span style='font-size:10.0pt'>mssqlnative</span></b></p>
    2025. 

  2025.   </td>
    2026. 

  2026.   <td valign=top style='padding:.75pt .75pt .75pt .75pt;height:54.75pt'>
    2027. 

  2027.   <p class=MsoNormal><span style='font-size:10.0pt'>C</span></p>
    2028. 

  2028.   </td>
    2029. 

  2029.   <td valign=top style='padding:.75pt .75pt .75pt .75pt;height:54.75pt'>
    2030. 

  2030.   <p><span style='font-size:10.0pt'>Native mssql driver from M'soft. Use with PHP 5.3 or later. </span></p>
    2031. 

  2031.   </td>
    2032. 

  2032.   <td valign=top style='padding:.75pt .75pt .75pt .75pt;height:54.75pt'>
    2033. 

  2033.   <p class=MsoNormal><span style='font-size:10.0pt'>?</span></p>
    2034. 

  2034.   </td>
    2035. 

  2035.   <td valign=top style='padding:.75pt .75pt .75pt .75pt;height:54.75pt'>
    2036. 

  2036.   <p class=MsoNormal><span style='font-size:10.0pt'>?</span></p>
    2037. 

  2037.   </td>
    2038. 

  2038.   <td valign=top style='padding:.75pt .75pt .75pt .75pt;height:54.75pt'>
    2039. 

  2039.   <p><span style='font-size:10.0pt'>Windows. Tq Garrett Serack of M'soft.</span></p>
    2040. 

  2040.   </td>
    2041. 

  2041.  </tr>
    2042. 

  2042.  <tr style='mso-yfti-irow:18'>
    2043. 

  2043.   <td style='padding:.75pt .75pt .75pt .75pt'>
    2044. 

  2044.   <p class=MsoNormal><o:p>&nbsp;</o:p></p>
    2045. 

  2045.   </td>
    2046. 

  2046.   <td style='border:none;padding:.75pt .75pt .75pt .75pt'>
    2047. 

  2047.   <p class=MsoNormal><span style='font-size:10.0pt;color:windowtext'><o:p>&nbsp;</o:p></span></p>
    2048. 

  2048.   </td>
    2049. 

  2049.   <td style='border:none;padding:.75pt .75pt .75pt .75pt'>
    2050. 

  2050.   <p class=MsoNormal><span style='font-size:10.0pt;color:windowtext'><o:p>&nbsp;</o:p></span></p>
    2051. 

  2051.   </td>
    2052. 

  2052.   <td style='border:none;padding:.75pt .75pt .75pt .75pt'>
    2053. 

  2053.   <p class=MsoNormal><span style='font-size:10.0pt;color:windowtext'><o:p>&nbsp;</o:p></span></p>
    2054. 

  2054.   </td>
    2055. 

  2055.   <td style='border:none;padding:.75pt .75pt .75pt .75pt'>
    2056. 

  2056.   <p class=MsoNormal><span style='font-size:10.0pt;color:windowtext'><o:p>&nbsp;</o:p></span></p>
    2057. 

  2057.   </td>
    2058. 

  2058.   <td style='border:none;padding:.75pt .75pt .75pt .75pt'>
    2059. 

  2059.   <p class=MsoNormal><span style='font-size:10.0pt;color:windowtext'><o:p>&nbsp;</o:p></span></p>
    2060. 

  2060.   </td>
    2061. 

  2061.  </tr>
    2062. 

  2062.  <tr style='mso-yfti-irow:19'>
    2063. 

  2063.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    2064. 

  2064.   <p class=MsoNormal><b><span style='font-size:10.0pt'>mysql</span></b></p>
    2065. 

  2065.   </td>
    2066. 

  2066.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    2067. 

  2067.   <p class=MsoNormal><span style='font-size:10.0pt'>A</span></p>
    2068. 

  2068.   </td>
    2069. 

  2069.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    2070. 

  2070.   <p class=MsoNormal><span style='font-size:10.0pt'>MySQL without transaction
    2071. 

  2071.   support. You can also set $db-&gt;clientFlags before connecting.</span></p>
    2072. 

  2072.   </td>
    2073. 

  2073.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    2074. 

  2074.   <p class=MsoNormal><span style='font-size:10.0pt'>Y</span></p>
    2075. 

  2075.   </td>
    2076. 

  2076.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    2077. 

  2077.   <p class=MsoNormal><span style='font-size:10.0pt'>MySQL client</span></p>
    2078. 

  2078.   </td>
    2079. 

  2079.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    2080. 

  2080.   <p class=MsoNormal><span style='font-size:10.0pt'>Unix and Windows</span></p>
    2081. 

  2081.   </td>
    2082. 

  2082.  </tr>
    2083. 

  2083.  <tr style='mso-yfti-irow:20'>
    2084. 

  2084.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    2085. 

  2085.   <p class=MsoNormal><b><span style='font-size:10.0pt'>mysqlt</span></b><span
    2086. 

  2086.   style='font-size:10.0pt'> or <b>maxsql</b></span></p>
    2087. 

  2087.   </td>
    2088. 

  2088.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    2089. 

  2089.   <p class=MsoNormal><span style='font-size:10.0pt'>A</span></p>
    2090. 

  2090.   </td>
    2091. 

  2091.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    2092. 

  2092.   <p><span style='font-size:10.0pt'>MySQL with transaction support. We
    2093. 

  2093.   recommend using || as the concat operator for best portability. This can be
    2094. 

  2094.   done by running MySQL using: <br>
    2095. 

  2095.   <i>mysqld --ansi</i> or <i>mysqld --sql-mode=PIPES_AS_CONCAT</i></span></p>
    2096. 

  2096.   </td>
    2097. 

  2097.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    2098. 

  2098.   <p class=MsoNormal><span style='font-size:10.0pt'>Y/N</span></p>
    2099. 

  2099.   </td>
    2100. 

  2100.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    2101. 

  2101.   <p class=MsoNormal><span style='font-size:10.0pt'>MySQL client</span></p>
    2102. 

  2102.   </td>
    2103. 

  2103.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    2104. 

  2104.   <p class=MsoNormal><span style='font-size:10.0pt'>Unix and Windows</span></p>
    2105. 

  2105.   </td>
    2106. 

  2106.  </tr>
    2107. 

  2107.  <tr style='mso-yfti-irow:21'>
    2108. 

  2108.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    2109. 

  2109.   <p class=MsoNormal><b><span style='font-size:10.0pt'>oci8</span></b></p>
    2110. 

  2110.   </td>
    2111. 

  2111.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    2112. 

  2112.   <p class=MsoNormal><span style='font-size:10.0pt'>A</span></p>
    2113. 

  2113.   </td>
    2114. 

  2114.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    2115. 

  2115.   <p class=MsoNormal><span style='font-size:10.0pt'>Oracle 8/9. Has more
    2116. 

  2116.   functionality than <i>oracle</i> driver (eg. Affected_Rows). You might have
    2117. 

  2117.   to putenv('ORACLE_HOME=...') before Connect/PConnect. </span></p>
    2118. 

  2118.   <p><span style='font-size:10.0pt'>There are 2 ways of connecting - with
    2119. 

  2119.   server IP and service name: <br>
    2120. 

  2120.   <i>PConnect('serverip:1521','scott','tiger','service'</i>)<br>
    2121. 

  2121.   or using an entry in TNSNAMES.ORA or ONAMES or HOSTNAMES: <br>
    2122. 

  2122.   <i>PConnect(false, 'scott', 'tiger', $oraname)</i>. </span></p>
    2123. 

  2123.   <p><span style='font-size:10.0pt'>Since 2.31, we support Oracle REF cursor
    2124. 

  2124.   variables directly (see <a href="#executecursor">ExecuteCursor</a>).</span> </p>
    2125. 

  2125.   </td>
    2126. 

  2126.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    2127. 

  2127.   <p class=MsoNormal><span style='font-size:10.0pt'>Y/N</span></p>
    2128. 

  2128.   </td>
    2129. 

  2129.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    2130. 

  2130.   <p class=MsoNormal><span style='font-size:10.0pt'>Oracle client</span></p>
    2131. 

  2131.   </td>
    2132. 

  2132.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    2133. 

  2133.   <p class=MsoNormal><span style='font-size:10.0pt'>Unix and Windows</span></p>
    2134. 

  2134.   </td>
    2135. 

  2135.  </tr>
    2136. 

  2136.  <tr style='mso-yfti-irow:22'>
    2137. 

  2137.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    2138. 

  2138.   <p class=MsoNormal><b><span style='font-size:10.0pt'>oci805</span></b></p>
    2139. 

  2139.   </td>
    2140. 

  2140.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    2141. 

  2141.   <p class=MsoNormal><span style='font-size:10.0pt'>C</span></p>
    2142. 

  2142.   </td>
    2143. 

  2143.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    2144. 

  2144.   <p class=MsoNormal><span style='font-size:10.0pt'>Supports reduced Oracle
    2145. 

  2145.   functionality for Oracle 8.0.5. SelectLimit is not as efficient as in the
    2146. 

  2146.   oci8 or oci8po drivers.</span></p>
    2147. 

  2147.   </td>
    2148. 

  2148.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    2149. 

  2149.   <p class=MsoNormal><span style='font-size:10.0pt'>Y/N</span></p>
    2150. 

  2150.   </td>
    2151. 

  2151.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    2152. 

  2152.   <p class=MsoNormal><span style='font-size:10.0pt'>Oracle client</span></p>
    2153. 

  2153.   </td>
    2154. 

  2154.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    2155. 

  2155.   <p class=MsoNormal><span style='font-size:10.0pt'>Unix and Windows</span></p>
    2156. 

  2156.   </td>
    2157. 

  2157.  </tr>
    2158. 

  2158.  <tr style='mso-yfti-irow:23'>
    2159. 

  2159.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    2160. 

  2160.   <p class=MsoNormal><b><span style='font-size:10.0pt'>oci8po</span></b></p>
    2161. 

  2161.   </td>
    2162. 

  2162.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    2163. 

  2163.   <p class=MsoNormal><span style='font-size:10.0pt'>A</span></p>
    2164. 

  2164.   </td>
    2165. 

  2165.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    2166. 

  2166.   <p class=MsoNormal><span style='font-size:10.0pt'>Oracle 8/9 portable driver.
    2167. 

  2167.   This is nearly identical with the oci8 driver except (a) bind variables in
    2168. 

  2168.   Prepare() use the ? convention, instead of :bindvar, (b) field names use the
    2169. 

  2169.   more common PHP convention of lowercase names. </span></p>
    2170. 

  2170.   <p><span style='font-size:10.0pt'>Use this driver if porting from other
    2171. 

  2171.   databases is important. Otherwise the oci8 driver offers better performance. </span></p>
    2172. 

  2172.   </td>
    2173. 

  2173.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    2174. 

  2174.   <p class=MsoNormal><span style='font-size:10.0pt'>Y/N</span></p>
    2175. 

  2175.   </td>
    2176. 

  2176.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    2177. 

  2177.   <p class=MsoNormal><span style='font-size:10.0pt'>Oracle client</span></p>
    2178. 

  2178.   </td>
    2179. 

  2179.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    2180. 

  2180.   <p class=MsoNormal><span style='font-size:10.0pt'>Unix and Windows</span></p>
    2181. 

  2181.   </td>
    2182. 

  2182.  </tr>
    2183. 

  2183.  <tr style='mso-yfti-irow:24'>
    2184. 

  2184.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    2185. 

  2185.   <p class=MsoNormal><b><span style='font-size:10.0pt'>odbc</span></b></p>
    2186. 

  2186.   </td>
    2187. 

  2187.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    2188. 

  2188.   <p class=MsoNormal><span style='font-size:10.0pt'>A</span></p>
    2189. 

  2189.   </td>
    2190. 

  2190.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    2191. 

  2191.   <p class=MsoNormal><span style='font-size:10.0pt'>Generic ODBC, not tuned for
    2192. 

  2192.   specific databases. To connect, use <br>
    2193. 

  2193.   PConnect('DSN','user','pwd'). This is the base class for all odbc derived
    2194. 

  2194.   drivers.</span></p>
    2195. 

  2195.   </td>
    2196. 

  2196.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    2197. 

  2197.   <p class=MsoNormal><span style='font-size:10.0pt'>? depends on database</span></p>
    2198. 

  2198.   </td>
    2199. 

  2199.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    2200. 

  2200.   <p class=MsoNormal><span style='font-size:10.0pt'>ODBC</span></p>
    2201. 

  2201.   </td>
    2202. 

  2202.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    2203. 

  2203.   <p class=MsoNormal><span style='font-size:10.0pt'>Unix and Windows. <a
    2204. 

  2204.   href="http://phpbuilder.com/columns/alberto20000919.php3?page=4">Unix hints.</a></span></p>
    2205. 

  2205.   </td>
    2206. 

  2206.  </tr>
    2207. 

  2207.  <tr style='mso-yfti-irow:25'>
    2208. 

  2208.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    2209. 

  2209.   <p class=MsoNormal><b><span style='font-size:10.0pt'>odbc_mssql</span></b></p>
    2210. 

  2210.   </td>
    2211. 

  2211.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    2212. 

  2212.   <p class=MsoNormal><span style='font-size:10.0pt'>C</span></p>
    2213. 

  2213.   </td>
    2214. 

  2214.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    2215. 

  2215.   <p class=MsoNormal><span style='font-size:10.0pt'>Uses ODBC to connect to
    2216. 

  2216.   MSSQL</span></p>
    2217. 

  2217.   </td>
    2218. 

  2218.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    2219. 

  2219.   <p class=MsoNormal><span style='font-size:10.0pt'>Y/N</span></p>
    2220. 

  2220.   </td>
    2221. 

  2221.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    2222. 

  2222.   <p class=MsoNormal><span style='font-size:10.0pt'>ODBC</span></p>
    2223. 

  2223.   </td>
    2224. 

  2224.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    2225. 

  2225.   <p class=MsoNormal><span style='font-size:10.0pt'>Unix and Windows. </span></p>
    2226. 

  2226.   </td>
    2227. 

  2227.  </tr>
    2228. 

  2228.  <tr style='mso-yfti-irow:26'>
    2229. 

  2229.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    2230. 

  2230.   <p class=MsoNormal><b><span style='font-size:10.0pt'>odbc_oracle</span></b></p>
    2231. 

  2231.   </td>
    2232. 

  2232.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    2233. 

  2233.   <p class=MsoNormal><span style='font-size:10.0pt'>C</span></p>
    2234. 

  2234.   </td>
    2235. 

  2235.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    2236. 

  2236.   <p class=MsoNormal><span style='font-size:10.0pt'>Uses ODBC to connect to
    2237. 

  2237.   Oracle</span></p>
    2238. 

  2238.   </td>
    2239. 

  2239.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    2240. 

  2240.   <p class=MsoNormal><span style='font-size:10.0pt'>Y/N</span></p>
    2241. 

  2241.   </td>
    2242. 

  2242.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    2243. 

  2243.   <p class=MsoNormal><span style='font-size:10.0pt'>ODBC</span></p>
    2244. 

  2244.   </td>
    2245. 

  2245.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    2246. 

  2246.   <p class=MsoNormal><span style='font-size:10.0pt'>Unix and Windows. </span></p>
    2247. 

  2247.   </td>
    2248. 

  2248.  </tr>
    2249. 

  2249.  <tr style='mso-yfti-irow:27'>
    2250. 

  2250.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    2251. 

  2251.   <p class=MsoNormal><b><span style='font-size:10.0pt'>odbtp</span></b></p>
    2252. 

  2252.   </td>
    2253. 

  2253.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    2254. 

  2254.   <p class=MsoNormal><span style='font-size:10.0pt'>C</span></p>
    2255. 

  2255.   </td>
    2256. 

  2256.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    2257. 

  2257.   <p class=MsoNormal><span style='font-size:10.0pt'>Generic odbtp driver. <a
    2258. 

  2258.   href="http://odbtp.sourceforge.net/">Odbtp</a> is a software for accessing
    2259. 

  2259.   Windows ODBC data sources from other operating systems.</span></p>
    2260. 

  2260.   </td>
    2261. 

  2261.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    2262. 

  2262.   <p class=MsoNormal><span style='font-size:10.0pt'>Y/N</span></p>
    2263. 

  2263.   </td>
    2264. 

  2264.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    2265. 

  2265.   <p class=MsoNormal><span style='font-size:10.0pt'>odbtp</span></p>
    2266. 

  2266.   </td>
    2267. 

  2267.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    2268. 

  2268.   <p class=MsoNormal><span style='font-size:10.0pt'>Unix and Windows</span></p>
    2269. 

  2269.   </td>
    2270. 

  2270.  </tr>
    2271. 

  2271.  <tr style='mso-yfti-irow:28'>
    2272. 

  2272.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    2273. 

  2273.   <p class=MsoNormal><b><span style='font-size:10.0pt'>odbtp_unicode</span></b></p>
    2274. 

  2274.   </td>
    2275. 

  2275.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    2276. 

  2276.   <p class=MsoNormal><span style='font-size:10.0pt'>C</span></p>
    2277. 

  2277.   </td>
    2278. 

  2278.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    2279. 

  2279.   <p class=MsoNormal><span style='font-size:10.0pt'>Odtbp with unicode support</span></p>
    2280. 

  2280.   </td>
    2281. 

  2281.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    2282. 

  2282.   <p class=MsoNormal><span style='font-size:10.0pt'>Y/N</span></p>
    2283. 

  2283.   </td>
    2284. 

  2284.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    2285. 

  2285.   <p class=MsoNormal><span style='font-size:10.0pt'>odbtp</span></p>
    2286. 

  2286.   </td>
    2287. 

  2287.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    2288. 

  2288.   <p class=MsoNormal><span style='font-size:10.0pt'>Unix and Windows</span></p>
    2289. 

  2289.   </td>
    2290. 

  2290.  </tr>
    2291. 

  2291.  <tr style='mso-yfti-irow:29;height:25.5pt'>
    2292. 

  2292.   <td valign=top style='padding:.75pt .75pt .75pt .75pt;height:25.5pt'>
    2293. 

  2293.   <p class=MsoNormal><b><span style='font-size:10.0pt'>oracle</span></b></p>
    2294. 

  2294.   </td>
    2295. 

  2295.   <td valign=top style='padding:.75pt .75pt .75pt .75pt;height:25.5pt'>
    2296. 

  2296.   <p class=MsoNormal><span style='font-size:10.0pt'>C</span></p>
    2297. 

  2297.   </td>
    2298. 

  2298.   <td valign=top style='padding:.75pt .75pt .75pt .75pt;height:25.5pt'>
    2299. 

  2299.   <p class=MsoNormal><span style='font-size:10.0pt'>Implements old Oracle 7
    2300. 

  2300.   client API. Use oci8 driver if possible for better performance.</span></p>
    2301. 

  2301.   </td>
    2302. 

  2302.   <td valign=top style='padding:.75pt .75pt .75pt .75pt;height:25.5pt'>
    2303. 

  2303.   <p class=MsoNormal><span style='font-size:10.0pt'>Y/N</span></p>
    2304. 

  2304.   </td>
    2305. 

  2305.   <td valign=top style='padding:.75pt .75pt .75pt .75pt;height:25.5pt'>
    2306. 

  2306.   <p class=MsoNormal><span style='font-size:10.0pt'>Oracle client</span></p>
    2307. 

  2307.   </td>
    2308. 

  2308.   <td valign=top style='padding:.75pt .75pt .75pt .75pt;height:25.5pt'>
    2309. 

  2309.   <p class=MsoNormal><span style='font-size:10.0pt'>Unix and Windows</span></p>
    2310. 

  2310.   </td>
    2311. 

  2311.  </tr>
    2312. 

  2312.  <tr style='mso-yfti-irow:30;height:25.5pt'>
    2313. 

  2313.   <td valign=top style='padding:.75pt .75pt .75pt .75pt;height:25.5pt'>
    2314. 

  2314.   <p class=MsoNormal><b><span style='font-size:10.0pt'>netezza</span></b></p>
    2315. 

  2315.   </td>
    2316. 

  2316.   <td valign=top style='padding:.75pt .75pt .75pt .75pt;height:25.5pt'>
    2317. 

  2317.   <p class=MsoNormal><span style='font-size:10.0pt'>C</span></p>
    2318. 

  2318.   </td>
    2319. 

  2319.   <td valign=top style='padding:.75pt .75pt .75pt .75pt;height:25.5pt'>
    2320. 

  2320.   <p class=MsoNormal><span style='font-size:10.0pt'>Netezza driver. Netezza is
    2321. 

  2321.   based on postgres code-base.</span></p>
    2322. 

  2322.   </td>
    2323. 

  2323.   <td valign=top style='padding:.75pt .75pt .75pt .75pt;height:25.5pt'>
    2324. 

  2324.   <p class=MsoNormal><span style='font-size:10.0pt'>Y</span></p>
    2325. 

  2325.   </td>
    2326. 

  2326.   <td valign=top style='padding:.75pt .75pt .75pt .75pt;height:25.5pt'>
    2327. 

  2327.   <p class=MsoNormal><span style='font-size:10.0pt'>?</span></p>
    2328. 

  2328.   </td>
    2329. 

  2329.   <td valign=top style='padding:.75pt .75pt .75pt .75pt;height:25.5pt'>
    2330. 

  2330.   <p class=MsoNormal><span style='font-size:10.0pt'>?</span></p>
    2331. 

  2331.   </td>
    2332. 

  2332.  </tr>
    2333. 

  2333.  <tr style='mso-yfti-irow:31'>
    2334. 

  2334.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    2335. 

  2335.   <p class=MsoNormal><b><span style='font-size:10.0pt'>pdo</span></b></p>
    2336. 

  2336.   </td>
    2337. 

  2337.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    2338. 

  2338.   <p class=MsoNormal><span style='font-size:10.0pt'>C</span></p>
    2339. 

  2339.   </td>
    2340. 

  2340.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    2341. 

  2341.   <p class=MsoNormal><span style='font-size:10.0pt'>Generic PDO driver for
    2342. 

  2342.   PHP5. </span></p>
    2343. 

  2343.   </td>
    2344. 

  2344.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    2345. 

  2345.   <p class=MsoNormal><span style='font-size:10.0pt'>Y</span></p>
    2346. 

  2346.   </td>
    2347. 

  2347.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    2348. 

  2348.   <p class=MsoNormal><span style='font-size:10.0pt'>PDO extension and database
    2349. 

  2349.   specific drivers</span></p>
    2350. 

  2350.   </td>
    2351. 

  2351.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    2352. 

  2352.   <p class=MsoNormal><span style='font-size:10.0pt'>Unix and Windows. </span></p>
    2353. 

  2353.   </td>
    2354. 

  2354.  </tr>
    2355. 

  2355.  <tr style='mso-yfti-irow:32'>
    2356. 

  2356.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    2357. 

  2357.   <p class=MsoNormal><b><span style='font-size:10.0pt'>postgres</span></b></p>
    2358. 

  2358.   </td>
    2359. 

  2359.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    2360. 

  2360.   <p class=MsoNormal><span style='font-size:10.0pt'>A</span></p>
    2361. 

  2361.   </td>
    2362. 

  2362.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    2363. 

  2363.   <p class=MsoNormal><span style='font-size:10.0pt'>Generic PostgreSQL driver.
    2364. 

  2364.   Currently identical to postgres7 driver.</span></p>
    2365. 

  2365.   </td>
    2366. 

  2366.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    2367. 

  2367.   <p class=MsoNormal><span style='font-size:10.0pt'>Y</span></p>
    2368. 

  2368.   </td>
    2369. 

  2369.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    2370. 

  2370.   <p class=MsoNormal><span style='font-size:10.0pt'>PostgreSQL client</span></p>
    2371. 

  2371.   </td>
    2372. 

  2372.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    2373. 

  2373.   <p class=MsoNormal><span style='font-size:10.0pt'>Unix and Windows. </span></p>
    2374. 

  2374.   </td>
    2375. 

  2375.  </tr>
    2376. 

  2376.  <tr style='mso-yfti-irow:33'>
    2377. 

  2377.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    2378. 

  2378.   <p class=MsoNormal><b><span style='font-size:10.0pt'>postgres64</span></b></p>
    2379. 

  2379.   </td>
    2380. 

  2380.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    2381. 

  2381.   <p class=MsoNormal><span style='font-size:10.0pt'>A</span></p>
    2382. 

  2382.   </td>
    2383. 

  2383.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    2384. 

  2384.   <p class=MsoNormal><span style='font-size:10.0pt'>For PostgreSQL 6.4 and
    2385. 

  2385.   earlier which does not support LIMIT internally.</span></p>
    2386. 

  2386.   </td>
    2387. 

  2387.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    2388. 

  2388.   <p class=MsoNormal><span style='font-size:10.0pt'>Y</span></p>
    2389. 

  2389.   </td>
    2390. 

  2390.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    2391. 

  2391.   <p class=MsoNormal><span style='font-size:10.0pt'>PostgreSQL client</span></p>
    2392. 

  2392.   </td>
    2393. 

  2393.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    2394. 

  2394.   <p class=MsoNormal><span style='font-size:10.0pt'>Unix and Windows. </span></p>
    2395. 

  2395.   </td>
    2396. 

  2396.  </tr>
    2397. 

  2397.  <tr style='mso-yfti-irow:34'>
    2398. 

  2398.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    2399. 

  2399.   <p class=MsoNormal><b><span style='font-size:10.0pt'>postgres7</span></b></p>
    2400. 

  2400.   </td>
    2401. 

  2401.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    2402. 

  2402.   <p class=MsoNormal><span style='font-size:10.0pt'>A</span></p>
    2403. 

  2403.   </td>
    2404. 

  2404.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    2405. 

  2405.   <p class=MsoNormal><span style='font-size:10.0pt'>PostgreSQL which supports
    2406. 

  2406.   LIMIT and other version 7 functionality.</span></p>
    2407. 

  2407.   </td>
    2408. 

  2408.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    2409. 

  2409.   <p class=MsoNormal><span style='font-size:10.0pt'>Y</span></p>
    2410. 

  2410.   </td>
    2411. 

  2411.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    2412. 

  2412.   <p class=MsoNormal><span style='font-size:10.0pt'>PostgreSQL client</span></p>
    2413. 

  2413.   </td>
    2414. 

  2414.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    2415. 

  2415.   <p class=MsoNormal><span style='font-size:10.0pt'>Unix and Windows. </span></p>
    2416. 

  2416.   </td>
    2417. 

  2417.  </tr>
    2418. 

  2418.  <tr style='mso-yfti-irow:35'>
    2419. 

  2419.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    2420. 

  2420.   <p class=MsoNormal><b><span style='font-size:10.0pt'>postgres8</span></b></p>
    2421. 

  2421.   </td>
    2422. 

  2422.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    2423. 

  2423.   <p class=MsoNormal><span style='font-size:10.0pt'>A</span></p>
    2424. 

  2424.   </td>
    2425. 

  2425.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    2426. 

  2426.   <p class=MsoNormal><span style='font-size:10.0pt'>PostgreSQL which supports
    2427. 

  2427.   version 8 functionality.</span></p>
    2428. 

  2428.   </td>
    2429. 

  2429.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    2430. 

  2430.   <p class=MsoNormal><span style='font-size:10.0pt'>Y</span></p>
    2431. 

  2431.   </td>
    2432. 

  2432.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    2433. 

  2433.   <p class=MsoNormal><span style='font-size:10.0pt'>PostgreSQL client</span></p>
    2434. 

  2434.   </td>
    2435. 

  2435.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    2436. 

  2436.   <p class=MsoNormal><span style='font-size:10.0pt'>Unix and Windows. </span></p>
    2437. 

  2437.   </td>
    2438. 

  2438.  </tr>
    2439. 

  2439.   <tr style='mso-yfti-irow:35'>
    2440. 

  2440.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    2441. 

  2441.   <p class=MsoNormal><b><span style='font-size:10.0pt'>postgres9</span></b></p>
    2442. 

  2442.   </td>
    2443. 

  2443.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    2444. 

  2444.   <p class=MsoNormal><span style='font-size:10.0pt'>A</span></p>
    2445. 

  2445.   </td>
    2446. 

  2446.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    2447. 

  2447.   <p class=MsoNormal><span style='font-size:10.0pt'>PostgreSQL which supports
    2448. 

  2448.   version 9 functionality.</span></p>
    2449. 

  2449.   </td>
    2450. 

  2450.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    2451. 

  2451.   <p class=MsoNormal><span style='font-size:10.0pt'>Y</span></p>
    2452. 

  2452.   </td>
    2453. 

  2453.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    2454. 

  2454.   <p class=MsoNormal><span style='font-size:10.0pt'>PostgreSQL client</span></p>
    2455. 

  2455.   </td>
    2456. 

  2456.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    2457. 

  2457.   <p class=MsoNormal><span style='font-size:10.0pt'>Unix and Windows. </span></p>
    2458. 

  2458.   </td>
    2459. 

  2459.  </tr>
    2460. 

  2460.  <tr style='mso-yfti-irow:36'>
    2461. 

  2461.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    2462. 

  2462.   <p class=MsoNormal><b><span style='font-size:10.0pt'>sapdb</span></b></p>
    2463. 

  2463.   </td>
    2464. 

  2464.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    2465. 

  2465.   <p class=MsoNormal><span style='font-size:10.0pt'>C</span></p>
    2466. 

  2466.   </td>
    2467. 

  2467.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    2468. 

  2468.   <p class=MsoNormal><span style='font-size:10.0pt'>SAP DB. Should work
    2469. 

  2469.   reliably as based on ODBC driver.</span></p>
    2470. 

  2470.   </td>
    2471. 

  2471.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    2472. 

  2472.   <p class=MsoNormal><span style='font-size:10.0pt'>Y/N</span></p>
    2473. 

  2473.   </td>
    2474. 

  2474.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    2475. 

  2475.   <p class=MsoNormal><span style='font-size:10.0pt'>SAP ODBC client</span></p>
    2476. 

  2476.   </td>
    2477. 

  2477.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    2478. 

  2478.   <p><span style='font-size:10.0pt'>?</span></p>
    2479. 

  2479.   </td>
    2480. 

  2480.  </tr>
    2481. 

  2481.  <tr style='mso-yfti-irow:37'>
    2482. 

  2482.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    2483. 

  2483.   <p class=MsoNormal><b><span style='font-size:10.0pt'>sqlanywhere</span></b></p>
    2484. 

  2484.   </td>
    2485. 

  2485.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    2486. 

  2486.   <p class=MsoNormal><span style='font-size:10.0pt'>C</span></p>
    2487. 

  2487.   </td>
    2488. 

  2488.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    2489. 

  2489.   <p class=MsoNormal><span style='font-size:10.0pt'>Sybase SQL Anywhere. Should
    2490. 

  2490.   work reliably as based on ODBC driver.</span></p>
    2491. 

  2491.   </td>
    2492. 

  2492.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    2493. 

  2493.   <p class=MsoNormal><span style='font-size:10.0pt'>Y/N</span></p>
    2494. 

  2494.   </td>
    2495. 

  2495.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    2496. 

  2496.   <p class=MsoNormal><span style='font-size:10.0pt'>SQL Anywhere ODBC client</span></p>
    2497. 

  2497.   </td>
    2498. 

  2498.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    2499. 

  2499.   <p><span style='font-size:10.0pt'>?</span></p>
    2500. 

  2500.   </td>
    2501. 

  2501.  </tr>
    2502. 

  2502.  <tr style='mso-yfti-irow:38;height:40.5pt'>
    2503. 

  2503.   <td valign=top style='padding:.75pt .75pt .75pt .75pt;height:40.5pt'>
    2504. 

  2504.   <p class=MsoNormal><b><span style='font-size:10.0pt'>sqlite</span></b></p>
    2505. 

  2505.   </td>
    2506. 

  2506.   <td valign=top style='padding:.75pt .75pt .75pt .75pt;height:40.5pt'>
    2507. 

  2507.   <p class=MsoNormal><span style='font-size:10.0pt'>B</span></p>
    2508. 

  2508.   </td>
    2509. 

  2509.   <td valign=top style='padding:.75pt .75pt .75pt .75pt;height:40.5pt'>
    2510. 

  2510.   <p class=MsoNormal><span style='font-size:10.0pt'>SQLite.</span></p>
    2511. 

  2511.   </td>
    2512. 

  2512.   <td valign=top style='padding:.75pt .75pt .75pt .75pt;height:40.5pt'>
    2513. 

  2513.   <p class=MsoNormal><span style='font-size:10.0pt'>Y</span></p>
    2514. 

  2514.   </td>
    2515. 

  2515.   <td valign=top style='padding:.75pt .75pt .75pt .75pt;height:40.5pt'>
    2516. 

  2516.   <p class=MsoNormal><span style='font-size:10.0pt'>-</span></p>
    2517. 

  2517.   </td>
    2518. 

  2518.   <td valign=top style='padding:.75pt .75pt .75pt .75pt;height:40.5pt'>
    2519. 

  2519.   <p><span style='font-size:10.0pt'>Unix and Windows.</span></p>
    2520. 

  2520.   </td>
    2521. 

  2521.  </tr>
    2522. 

  2522.  <tr style='mso-yfti-irow:39;height:40.5pt'>
    2523. 

  2523.   <td valign=top style='padding:.75pt .75pt .75pt .75pt;height:40.5pt'>
    2524. 

  2524.   <p class=MsoNormal><b><span style='font-size:10.0pt'>sqlitepo</span></b></p>
    2525. 

  2525.   </td>
    2526. 

  2526.   <td valign=top style='padding:.75pt .75pt .75pt .75pt;height:40.5pt'>
    2527. 

  2527.   <p class=MsoNormal><span style='font-size:10.0pt'>B</span></p>
    2528. 

  2528.   </td>
    2529. 

  2529.   <td valign=top style='padding:.75pt .75pt .75pt .75pt;height:40.5pt'>
    2530. 

  2530.   <p class=MsoNormal><span style='font-size:10.0pt'>Portable SQLite driver. This
    2531. 

  2531.   is because assoc mode does not work like other drivers in sqlite. Namely,
    2532. 

  2532.   when selecting (joining) multiple tables, the table names are included in the
    2533. 

  2533.   assoc keys in the &quot;sqlite&quot; driver.</span></p>
    2534. 

  2534.   <p><span style='font-size:10.0pt'>In &quot;sqlitepo&quot; driver, the table
    2535. 

  2535.   names are stripped from the returned column names. When this results in a
    2536. 

  2536.   conflict, the first field get preference. </span></p>
    2537. 

  2537.   </td>
    2538. 

  2538.   <td valign=top style='padding:.75pt .75pt .75pt .75pt;height:40.5pt'>
    2539. 

  2539.   <p class=MsoNormal><span style='font-size:10.0pt'>Y</span></p>
    2540. 

  2540.   </td>
    2541. 

  2541.   <td valign=top style='padding:.75pt .75pt .75pt .75pt;height:40.5pt'>
    2542. 

  2542.   <p class=MsoNormal><span style='font-size:10.0pt'>-</span></p>
    2543. 

  2543.   </td>
    2544. 

  2544.   <td valign=top style='padding:.75pt .75pt .75pt .75pt;height:40.5pt'>
    2545. 

  2545.   <p><span style='font-size:10.0pt'>Unix and Windows.</span></p>
    2546. 

  2546.   </td>
    2547. 

  2547.  </tr>
    2548. 

  2548.  <tr style='mso-yfti-irow:40'>
    2549. 

  2549.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    2550. 

  2550.   <p class=MsoNormal><b><span style='font-size:10.0pt'>sybase</span></b></p>
    2551. 

  2551.   </td>
    2552. 

  2552.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    2553. 

  2553.   <p class=MsoNormal><span style='font-size:10.0pt'>C</span></p>
    2554. 

  2554.   </td>
    2555. 

  2555.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    2556. 

  2556.   <p class=MsoNormal><span style='font-size:10.0pt'>Sybase. </span></p>
    2557. 

  2557.   </td>
    2558. 

  2558.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    2559. 

  2559.   <p class=MsoNormal><span style='font-size:10.0pt'>Y/N</span></p>
    2560. 

  2560.   </td>
    2561. 

  2561.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    2562. 

  2562.   <p class=MsoNormal><span style='font-size:10.0pt'>Sybase client</span></p>
    2563. 

  2563.   </td>
    2564. 

  2564.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    2565. 

  2565.   <p><span style='font-size:10.0pt'>Unix and Windows.</span></p>
    2566. 

  2566.   </td>
    2567. 

  2567.  </tr>
    2568. 

  2568.  <tr style='mso-yfti-irow:41;mso-yfti-lastrow:yes'>
    2569. 

  2569.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    2570. 

  2570.   <p class=MsoNormal><b><span style='font-size:10.0pt'>sybase_ase</span></b></p>
    2571. 

  2571.   </td>
    2572. 

  2572.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    2573. 

  2573.   <p class=MsoNormal><span style='font-size:10.0pt'>C</span></p>
    2574. 

  2574.   </td>
    2575. 

  2575.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    2576. 

  2576.   <p class=MsoNormal><span style='font-size:10.0pt'>Sybase ASE. </span></p>
    2577. 

  2577.   </td>
    2578. 

  2578.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    2579. 

  2579.   <p class=MsoNormal><span style='font-size:10.0pt'>Y/N</span></p>
    2580. 

  2580.   </td>
    2581. 

  2581.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    2582. 

  2582.   <p class=MsoNormal><span style='font-size:10.0pt'>Sybase client</span></p>
    2583. 

  2583.   </td>
    2584. 

  2584.   <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
    2585. 

  2585.   <p><span style='font-size:10.0pt'>Unix and Windows.</span></p>
    2586. 

  2586.   </td>
    2587. 

  2587.  </tr>
    2588. 

  2588. </table>
    2589. 

  2589. 

  2590. <p>The &quot;Tested&quot; column indicates how extensively the code has been
    2591. 

  2591. tested and used. <br>
    2592. 

  2592. A = well tested and used by many people<br>
    2593. 

  2593. B = tested and usable, but some features might not be implemented<br>
    2594. 

  2594. C = user contributed or experimental driver. Might not fully support all of the
    2595. 

  2595. latest features of ADOdb. </p>
    2596. 

  2596. 

  2597. <p>The column &quot;RecordCount() usable&quot; indicates whether RecordCount()
    2598. 

  2598. return the number of rows, or returns -1 when a SELECT statement is executed.
    2599. 

  2599. If this column displays Y/N then the RecordCount() is emulated when the global
    2600. 

  2600. variable $ADODB_COUNTRECS=true (this is the default). Note that for large
    2601. 

  2601. recordsets, it might be better to disable RecordCount() emulation because
    2602. 

  2602. substantial amounts of memory are required to cache the recordset for counting.
    2603. 

  2603. Also there is a speed penalty of 40-50% if emulation is required. This is
    2604. 

  2604. emulated in most databases except for PostgreSQL and MySQL. This variable is
    2605. 

  2605. checked every time a query is executed, so you can selectively choose which
    2606. 

  2606. recordsets to count.</p>
    2607. 

  2607. 

  2608. <div class=MsoNormal align=center style='text-align:center'>
    2609. 

  2609. 

  2610. <hr size=2 width="100%" align=center>
    2611. 

  2611. 

  2612. </div>
    2613. 

  2613. 

  2614. <h1>Tutorials<a name=quickstart></a></h1>
    2615. 

  2615. 

  2616. <h3>Example 1: Select Statement<a name=ex1></a></h3>
    2617. 

  2617. 

  2618. <p>Task: Connect to the Access Northwind DSN, display the first 2 columns of
    2619. 

  2619. each row.</p>
    2620. 

  2620. 

  2621. <p>In this example, we create a ADOConnection object, which represents the
    2622. 

  2622. connection to the database. The connection is initiated with <a href="#pconnect"><span
    2623. 

  2623. style='font-family:"Courier New"'>PConnect</span></a>, which is a persistent
    2624. 

  2624. connection. Whenever we want to query the database, we call the <span
    2625. 

  2625. style='font-family:"Courier New"'>ADOConnection.<a href="#execute">Execute</a>()</span>
    2626. 

  2626. function. This returns an ADORecordSet object which is actually a cursor that
    2627. 

  2627. holds the current row in the array <span style='font-family:"Courier New"'>fields[]</span>.
    2628. 

  2628. We use <span style='font-family:"Courier New"'><a href="#movenext">MoveNext</a>()</span>
    2629. 

  2629. to move from row to row.</p>
    2630. 

  2630. 

  2631. <p>NB: A useful function that is not used in this example is <span
    2632. 

  2632. style='font-family:"Courier New"'><a href="#selectlimit">SelectLimit</a></span>,
    2633. 

  2633. which allows us to limit the number of rows shown. </p>
    2634. 

  2634. 

  2635. <div style='mso-element:para-border-div;border:solid #DDDDDD 1.0pt;mso-border-alt:
    2636. 

  2636. solid #DDDDDD .75pt;padding:9.0pt 18.0pt 9.0pt 18.0pt;background:#EEEEEE'><pre>&lt;?<br>
    2637. 

  2637. <b>include</b>('adodb.inc.php');<span style='mso-tab-count:1'> </span><span style='mso-spacerun:yes'>&nbsp;&nbsp; </span># load code common to ADOdb<br>
    2638. 

  2638. $<span style='color:#660000'>conn</span> = &amp;ADONewConnection('access');<span
    2639. 

  2639. style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span># create a connection<br>
    2640. 

  2640. $<span style='color:#660000'>conn</span>-&gt;PConnect('northwind');<span style='mso-spacerun:yes'>&nbsp;&nbsp; </span># connect to MS-Access, northwind DSN<br>
    2641. 

  2641. $<span style='color:#660000'>recordSet</span> = &amp;$<span style='color:#660000'>conn</span>-&gt;Execute('select * from products');<br>
    2642. 

  2642. if (!$<span style='color:#660000'>recordSet</span>) <br>
    2643. 

  2643. <span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>print $<span style='color:#660000'>conn</span>-&gt;ErrorMsg();<br>
    2644. 

  2644. else<br>
    2645. 

  2645. <b>while</b> (!$<span style='color:#660000'>recordSet</span>-&gt;EOF) {<br>
    2646. 

  2646. <span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span><b>print</b> $<span
    2647. 

  2647. style='color:#660000'>recordSet</span>-&gt;fields[0].' '.$<span
    2648. 

  2648. style='color:#660000'>recordSet</span>-&gt;fields[1].'&lt;BR&gt;';<br>
    2649. 

  2649. <span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$<span style='color:#660000'>recordSet</span>-&gt;MoveNext();<br>
    2650. 

  2650. }</pre><pre><o:p>&nbsp;</o:p></pre><pre>$<span style='color:#660000'>recordSet</span>-&gt;Close(); # optional<br>
    2651. 

  2651. $<span style='color:#660000'>conn</span>-&gt;Close(); # optional<br
    2652. 

  2652. style='mso-special-character:line-break'>
    2653. 

  2653. <![if !supportLineBreakNewLine]><br style='mso-special-character:line-break'>
    2654. 

  2654. <![endif]></pre><pre>?&gt;</pre></div>
    2655. 

  2655. 

  2656. <p>The $<span style='font-family:"Courier New"'>recordSet</span> returned
    2657. 

  2657. stores the current row in the <span style='font-family:"Courier New"'>$recordSet-&gt;fields</span>
    2658. 

  2658. array, indexed by column number (starting from zero). We use the <span
    2659. 

  2659. style='font-family:"Courier New"'><a href="#movenext">MoveNext</a>()</span>
    2660. 

  2660. function to move to the next row. The <span style='font-family:"Courier New"'>EOF</span>
    2661. 

  2661. property is set to true when end-of-file is reached. If an error occurs in
    2662. 

  2662. Execute(), we return false instead of a recordset.</p>
    2663. 

  2663. 

  2664. <p>The <code><span style='font-size:10.0pt'>$recordSet-&gt;fields[]</span></code>
    2665. 

  2665. array is generated by the PHP database extension. Some database extensions only
    2666. 

  2666. index by number and do not index the array by field name. To force indexing by
    2667. 

  2667. name - that is associative arrays - use the SetFetchMode function. Each
    2668. 

  2668. recordset saves and uses whatever fetch mode was set when the recordset was
    2669. 

  2669. created in Execute() or SelectLimit(). </p>
    2670. 

  2670. 

  2671. <div style='mso-element:para-border-div;border:solid #DDDDDD 1.0pt;mso-border-alt:
    2672. 

  2672. solid #DDDDDD .75pt;padding:9.0pt 18.0pt 9.0pt 18.0pt;background:#EEEEEE'><pre><span
    2673. 

  2673. style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$db-&gt;SetFetchMode(ADODB_FETCH_NUM);<br>
    2674. 

  2674. <span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$rs1 = $db-&gt;Execute('select * from table');<br>
    2675. 

  2675. <span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$db-&gt;SetFetchMode(ADODB_FETCH_ASSOC);<br>
    2676. 

  2676. <span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$rs2 = $db-&gt;Execute('select * from table');<br>
    2677. 

  2677. <span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>print_r($rs1-&gt;fields); # shows <i>array([0]=&gt;'v0',[1] =&gt;'v1')</i></pre><pre><span
    2678. 

  2678. style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>print_r($rs2-&gt;fields); # shows <i>array(['col1']=&gt;'v0',['col2'] =&gt;'v1')</i></pre></div>
    2679. 

  2679. 

  2680. <p>To get the number of rows in the select statement, you can use <span
    2681. 

  2681. style='font-family:"Courier New"'>$recordSet-&gt;<a href="#recordcount">RecordCount</a>()</span>.
    2682. 

  2682. Note that it can return -1 if the number of rows returned cannot be determined.</p>
    2683. 

  2683. 

  2684. <h3>Example 2: Advanced Select with Field Objects<a name=ex2></a></h3>
    2685. 

  2685. 

  2686. <p>Select a table, display the first two columns. If the second column is a
    2687. 

  2687. date or timestamp, reformat the date to <st1:country-region w:st="on"><st1:place
    2688. 

  2688.  w:st="on">US</st1:place></st1:country-region> format.</p>
    2689. 

  2689. 

  2690. <div style='mso-element:para-border-div;border:solid #DDDDDD 1.0pt;mso-border-alt:
    2691. 

  2691. solid #DDDDDD .75pt;padding:9.0pt 18.0pt 9.0pt 18.0pt;background:#EEEEEE'><pre>&lt;?<br>
    2692. 

  2692. <b>include</b>('adodb.inc.php');<span style='mso-tab-count:1'> </span><span style='mso-spacerun:yes'>&nbsp;&nbsp; </span># load code common to ADOdb<br>
    2693. 

  2693. $<span style='color:#660000'>conn</span> = &amp;ADONewConnection('access');<span
    2694. 

  2694. style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span># create a connection<br>
    2695. 

  2695. $<span style='color:#660000'>conn</span>-&gt;PConnect('northwind');<span style='mso-spacerun:yes'>&nbsp;&nbsp; </span># connect to MS-Access, northwind dsn<br>
    2696. 

  2696. $<span style='color:#660000'>recordSet</span> = &amp;$<span style='color:#660000'>conn</span>-&gt;Execute('select CustomerID,OrderDate from Orders');<br>
    2697. 

  2697. if (!$<span style='color:#660000'>recordSet</span>) <br>
    2698. 

  2698. <span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>print $<span style='color:#660000'>conn</span>-&gt;ErrorMsg();<br>
    2699. 

  2699. else<br>
    2700. 

  2700. <b>while</b> (!$<span style='color:#660000'>recordSet</span>-&gt;EOF) {<br>
    2701. 

  2701. <span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$<span style='color:#660000'>fld</span> = <b><span
    2702. 

  2702. style='color:#336600'>$</span></b><span style='color:#660000'>recordSet</span><b><span
    2703. 

  2703. style='color:#336600'>-&gt;FetchField</span></b><span style='color:#006600'>(</span>1<span
    2704. 

  2704. style='color:#006600'>);</span></pre><pre><span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$<span
    2705. 

  2705. style='color:#660000'>type</span> = <b><span style='color:#336600'>$</span></b><span
    2706. 

  2706. style='color:#660000'>recordSet</span><b><span style='color:#336600'>-&gt;MetaType</span></b>($fld-&gt;type);<br>
    2707. 

  2707. <br>
    2708. 

  2708. <span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span><b>if</b> ( $<span
    2709. 

  2709. style='color:#660000'>type</span> == 'D' || $<span style='color:#660000'>type</span> == 'T') <br>
    2710. 

  2710. <span style='mso-tab-count:2'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span><b>print</b> $<span
    2711. 

  2711. style='color:#660000'>recordSet</span>-&gt;fields[0].' '.<br>
    2712. 

  2712. <span style='mso-tab-count:3'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span><b><span
    2713. 

  2713. style='color:#336600'>$</span></b><span style='color:#660000'>recordSet</span><b><span
    2714. 

  2714. style='color:#336600'>-&gt;UserDate</span></b>($<span style='color:#660000'>recordSet</span>-&gt;fields[1],'<b>m/d/Y</b>').'&lt;BR&gt;';<br>
    2715. 

  2715. <span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span><b>else </b></pre><pre><span
    2716. 

  2716. style='mso-tab-count:2'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span><b>print</b> $<span
    2717. 

  2717. style='color:#660000'>recordSet</span>-&gt;fields[0].' '.$<span
    2718. 

  2718. style='color:#660000'>recordSet</span>-&gt;fields[1].'&lt;BR&gt;';<br>
    2719. 

  2719. <br>
    2720. 

  2720. <span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$<span style='color:#660000'>recordSet</span>-&gt;MoveNext();<br>
    2721. 

  2721. }</pre><pre>$<span style='color:#660000'>recordSet</span>-&gt;Close(); # optional<br>
    2722. 

  2722. $<span style='color:#660000'>conn</span>-&gt;Close(); # optional<br
    2723. 

  2723. style='mso-special-character:line-break'>
    2724. 

  2724. <![if !supportLineBreakNewLine]><br style='mso-special-character:line-break'>
    2725. 

  2725. <![endif]></pre><pre>?&gt;</pre></div>
    2726. 

  2726. 

  2727. <p>In this example, we check the field type of the second column using <span
    2728. 

  2728. style='font-family:"Courier New"'><a href="#fetchfield">FetchField</a>().</span>
    2729. 

  2729. This returns an object with at least 3 fields.</p>
    2730. 

  2730. 

  2731. <ul type=disc>
    2732. 

  2732.  <li class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
    2733. 

  2733.      mso-list:l6 level1 lfo6;tab-stops:list 36.0pt'><b>name</b>: name of column</li>
    2734. 

  2734.  <li class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
    2735. 

  2735.      mso-list:l6 level1 lfo6;tab-stops:list 36.0pt'><b>type</b>: native field
    2736. 

  2736.      type of column</li>
    2737. 

  2737.  <li class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
    2738. 

  2738.      mso-list:l6 level1 lfo6;tab-stops:list 36.0pt'><b>max_length</b>: maximum
    2739. 

  2739.      length of field. Some databases such as MySQL do not return the maximum
    2740. 

  2740.      length of the field correctly. In these cases max_length will be set to
    2741. 

  2741.      -1.</li>
    2742. 

  2742. </ul>
    2743. 

  2743. 

  2744. <p>We then use <span style='font-family:"Courier New"'><a href="#metatype">MetaType</a>()</span>
    2745. 

  2745. to translate the native type to a <i>generic</i> type. Currently the following <i>generic</i>
    2746. 

  2746. types are defined:</p>
    2747. 

  2747. 

  2748. <ul type=disc>
    2749. 

  2749.  <li class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
    2750. 

  2750.      mso-list:l0 level1 lfo7;tab-stops:list 36.0pt'><b>C</b>: character fields
    2751. 

  2751.      that should be shown in a &lt;input type=&quot;text&quot;&gt; tag.</li>
    2752. 

  2752.  <li class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
    2753. 

  2753.      mso-list:l0 level1 lfo7;tab-stops:list 36.0pt'><b>X</b>: TeXt, large text
    2754. 

  2754.      fields that should be shown in a &lt;textarea&gt;</li>
    2755. 

  2755.  <li class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
    2756. 

  2756.      mso-list:l0 level1 lfo7;tab-stops:list 36.0pt'><b>B</b>: Blobs, or Binary
    2757. 

  2757.      Large Objects. Typically images. </li>
    2758. 

  2758.  <li class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
    2759. 

  2759.      mso-list:l0 level1 lfo7;tab-stops:list 36.0pt'><b>D</b>: Date field</li>
    2760. 

  2760.  <li class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
    2761. 

  2761.      mso-list:l0 level1 lfo7;tab-stops:list 36.0pt'><b>T</b>: Timestamp field</li>
    2762. 

  2762.  <li class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
    2763. 

  2763.      mso-list:l0 level1 lfo7;tab-stops:list 36.0pt'><b>L</b>: Logical field
    2764. 

  2764.      (boolean or bit-field)</li>
    2765. 

  2765.  <li class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
    2766. 

  2766.      mso-list:l0 level1 lfo7;tab-stops:list 36.0pt'><b>I</b>:&nbsp; Integer
    2767. 

  2767.      field</li>
    2768. 

  2768.  <li class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
    2769. 

  2769.      mso-list:l0 level1 lfo7;tab-stops:list 36.0pt'><b>N</b>: Numeric field.
    2770. 

  2770.      Includes autoincrement, numeric, floating point, real and integer. </li>
    2771. 

  2771.  <li class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
    2772. 

  2772.      mso-list:l0 level1 lfo7;tab-stops:list 36.0pt'><b>R</b>: Serial field.
    2773. 

  2773.      Includes serial, autoincrement integers. This works for selected
    2774. 

  2774.      databases. </li>
    2775. 

  2775. </ul>
    2776. 

  2776. 

  2777. <p>If the metatype is of type date or timestamp, then we print it using the
    2778. 

  2778. user defined date format with <span style='font-family:"Courier New"'><a
    2779. 

  2779. href="#userdate">UserDate</a>(),</span> which converts the PHP SQL date string
    2780. 

  2780. format to a user defined one. Another use for <span style='font-family:"Courier New"'><a
    2781. 

  2781. href="#metatype">MetaType</a>()</span> is data validation before doing an SQL
    2782. 

  2782. insert or update.</p>
    2783. 

  2783. 

  2784. <h3>Example 3: Inserting<a name=ex3></a></h3>
    2785. 

  2785. 

  2786. <p>Insert a row to the Orders table containing dates and strings that need to
    2787. 

  2787. be quoted before they can be accepted by the database, eg: the single-quote in
    2788. 

  2788. the word <i>John's</i>.</p>
    2789. 

  2789. 

  2790. <div style='mso-element:para-border-div;border:solid #DDDDDD 1.0pt;mso-border-alt:
    2791. 

  2791. solid #DDDDDD .75pt;padding:9.0pt 18.0pt 9.0pt 18.0pt;background:#EEEEEE'><pre
    2792. 

  2792. style='background:#EEEEEE'>&lt;?<br>
    2793. 

  2793. <b>include</b>('adodb.inc.php');<span style='mso-tab-count:1'> </span><span style='mso-spacerun:yes'>&nbsp;&nbsp; </span># load code common to ADOdb<br>
    2794. 

  2794. $<span style='color:#660000'>conn</span> = &amp;ADONewConnection('access');<span
    2795. 

  2795. style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span># create a connection<br>
    2796. 

  2796. <br>
    2797. 

  2797. $<span style='color:#660000'>conn</span>-&gt;PConnect('northwind');<span style='mso-spacerun:yes'>&nbsp;&nbsp; </span># connect to MS-Access, northwind dsn<br>
    2798. 

  2798. $<span style='color:#660000'>shipto</span> = <b><span style='color:#006600'>$conn-&gt;qstr</span></b>(&quot;<i>John's Old Shoppe</i>&quot;);<br>
    2799. 

  2799. <br>
    2800. 

  2800. $<span style='color:#660000'>sql</span> = &quot;insert into orders (customerID,EmployeeID,OrderDate,ShipName) &quot;;<br>
    2801. 

  2801. $<span style='color:#660000'>sql</span> .= &quot;values ('ANATR',2,&quot;.<b><span
    2802. 

  2802. style='color:#006600'>$conn-&gt;DBDate(</span>time()</b><b><span
    2803. 

  2803. style='color:#006600'>)</span></b><span style='color:#006600'>.</span>&quot;,$<span
    2804. 

  2804. style='color:#660000'>shipto</span>)&quot;;<br>
    2805. 

  2805. <br>
    2806. 

  2806. <b>if</b> ($<span style='color:#660000'>conn</span>-&gt;Execute($<span
    2807. 

  2807. style='color:#660000'>sql</span>) <b><span style='color:#336600'>=== false</span></b>) {<br>
    2808. 

  2808. <span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span><b>print</b> 'error inserting: '.<b><span
    2809. 

  2809. style='color:#336600'>$conn-&gt;ErrorMsg()</span></b>.'&lt;BR&gt;';<br>
    2810. 

  2810. }<br>
    2811. 

  2811. ?&gt;</pre></div>
    2812. 

  2812. 

  2813. <p>In this example, we see the advanced date and quote handling facilities of
    2814. 

  2814. ADOdb. The unix timestamp (which is a long integer) is appropriately formated
    2815. 

  2815. for Access with <span style='font-family:"Courier New"'><a href="#dbdate">DBDate</a>()</span>,
    2816. 

  2816. and the right escape character is used for quoting the <i>John's Old Shoppe</i>,
    2817. 

  2817. which is<b> </b><i>John'<b>'</b>s Old Shoppe</i> and not PHP's default <i>John<b>'</b>s
    2818. 

  2818. Old Shoppe</i> with <span style='font-family:"Courier New"'><a href="#qstr">qstr</a>()</span>.
    2819. 

  2819. </p>
    2820. 

  2820. 

  2821. <p>Observe the error-handling of the Execute statement. False is returned by<span
    2822. 

  2822. style='font-family:"Courier New"'> <a href="#execute">Execute</a>() </span>if
    2823. 

  2823. an error occured. The error message for the last error that occurred is
    2824. 

  2824. displayed in <span style='font-family:"Courier New"'><a href="#errormsg">ErrorMsg</a>()</span>.
    2825. 

  2825. Note: <i>php_track_errors</i> might have to be enabled for error messages to be
    2826. 

  2826. saved.</p>
    2827. 

  2827. 

  2828. <h3>Example 4: Debugging<a name=ex4></a></h3>
    2829. 

  2829. 

  2830. <div style='mso-element:para-border-div;border:solid #DDDDDD 1.0pt;mso-border-alt:
    2831. 

  2831. solid #DDDDDD .75pt;padding:9.0pt 18.0pt 9.0pt 18.0pt;background:#EEEEEE'><pre>&lt;?<br>
    2832. 

  2832. <b>include</b>('adodb.inc.php');<span style='mso-tab-count:1'> </span><span style='mso-spacerun:yes'>&nbsp;&nbsp; </span># load code common to ADOdb<br>
    2833. 

  2833. $<span style='color:#663300'>conn</span> = &amp;ADONewConnection('access');<span
    2834. 

  2834. style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span># create a connection<br>
    2835. 

  2835. $<span style='color:#663300'>conn</span>-&gt;PConnect('northwind');<span style='mso-spacerun:yes'>&nbsp;&nbsp; </span># connect to MS-Access, northwind dsn<br>
    2836. 

  2836. $<span style='color:#663300'>shipto</span> = <b>$conn-&gt;qstr</b>(&quot;John's Old Shoppe&quot;);<br>
    2837. 

  2837. $<span style='color:#663300'>sql</span> = &quot;insert into orders (customerID,EmployeeID,OrderDate,ShipName) &quot;;<br>
    2838. 

  2838. $<span style='color:#663300'>sql</span> .= &quot;values ('ANATR',2,&quot;.$<span
    2839. 

  2839. style='color:#663300'>conn</span>-&gt;FormatDate(time()).&quot;,$shipto)&quot;;<br>
    2840. 

  2840. <b><span style='color:#336600'>$</span></b><b><span style='color:#663300'>conn</span></b><b><span
    2841. 

  2841. style='color:#336600'>-&gt;debug = true;</span></b></pre><pre><b>if</b> ($<span
    2842. 

  2842. style='color:#663300'>conn</span>-&gt;Execute($sql) <b>=== false</b>) <b>print</b> 'error inserting';</pre><pre>?&gt;</pre></div>
    2843. 

  2843. 

  2844. <p>In the above example, we have turned on debugging by setting <b>debug = true</b>.
    2845. 

  2845. This will display the SQL statement before execution, and also show any error
    2846. 

  2846. messages. There is no need to call <span style='font-family:"Courier New"'><a
    2847. 

  2847. href="#errormsg">ErrorMsg</a>()</span> in this case. For displaying the
    2848. 

  2848. recordset, see the <span style='font-family:"Courier New"'><a href="#exrs2html">rs2html</a>()
    2849. 

  2849. </span>example.</p>
    2850. 

  2850. 

  2851. <p>Also see the section on <a href="#errorhandling">Custom Error Handlers</a>.</p>
    2852. 

  2852. 

  2853. <h3>Example 5: MySQL and Menus<a name=ex5></a></h3>
    2854. 

  2854. 

  2855. <p>Connect to MySQL database <i>agora</i>, and generate a &lt;select&gt; menu
    2856. 

  2856. from an SQL statement where the &lt;option&gt; captions are in the 1st column,
    2857. 

  2857. and the value to send back to the server is in the 2nd column.</p>
    2858. 

  2858. 

  2859. <div style='mso-element:para-border-div;border:solid #DDDDDD 1.0pt;mso-border-alt:
    2860. 

  2860. solid #DDDDDD .75pt;padding:9.0pt 18.0pt 9.0pt 18.0pt;background:#EEEEEE'><pre
    2861. 

  2861. style='background:#EEEEEE'>&lt;?<br>
    2862. 

  2862. <b>include</b>('adodb.inc.php'); # load code common to ADOdb<br>
    2863. 

  2863. $<span style='color:#663300'>conn</span> = &amp;ADONewConnection('mysql');<span style='mso-spacerun:yes'>&nbsp; </span># create a connection<br>
    2864. 

  2864. $<span style='color:#663300'>conn</span>-&gt;PConnect('localhost','userid','','agora');# connect to MySQL, agora db<br>
    2865. 

  2865. $<span style='color:#663300'>sql</span> = 'select CustomerName, CustomerID from customers';<br>
    2866. 

  2866. $<span style='color:#663300'>rs</span> = $<span style='color:#663300'>conn</span>-&gt;Execute($sql);<br>
    2867. 

  2867. <b>print</b> <b><span style='color:#336600'>$</span></b><b><span
    2868. 

  2868. style='color:#663300'>rs</span></b><b><span style='color:#336600'>-&gt;GetMenu('GetCust','Mary Rosli');<br>
    2869. 

  2869. ?&gt;</span></b></pre></div>
    2870. 

  2870. 

  2871. <p>Here we define a menu named GetCust, with the menu option 'Mary Rosli'
    2872. 

  2872. selected. See <a href="#getmenu"><span style='font-family:"Courier New"'>GetMenu</span></a><span
    2873. 

  2873. style='font-family:"Courier New"'>()</span>. We also have functions that return
    2874. 

  2874. the recordset as an array: <span style='font-family:"Courier New"'><a
    2875. 

  2875. href="#getarray">GetArray</a>()</span>, and as an associative array with the
    2876. 

  2876. key being the first column: <a href="#getassoc1">GetAssoc</a>().</p>
    2877. 

  2877. 

  2878. <h3>Example 6: Connecting to 2 Databases At Once<a name=ex6></a></h3>
    2879. 

  2879. 

  2880. <div style='mso-element:para-border-div;border:solid #DDDDDD 1.0pt;mso-border-alt:
    2881. 

  2881. solid #DDDDDD .75pt;padding:9.0pt 18.0pt 9.0pt 18.0pt;background:#EEEEEE'><pre
    2882. 

  2882. style='background:#EEEEEE'>&lt;?<br>
    2883. 

  2883. <b>include</b>('adodb.inc.php');<span style='mso-tab-count:1'> </span> # load code common to ADOdb<br>
    2884. 

  2884. $<span style='color:#663300'>conn1</span> = &amp;ADONewConnection('mysql');<span style='mso-spacerun:yes'>&nbsp; </span># create a mysql connection<br>
    2885. 

  2885. $<span style='color:#663300'>conn2</span> = &amp;ADONewConnection('oracle');<span style='mso-spacerun:yes'>&nbsp; </span># create a oracle connection<br>
    2886. 

  2886. <br>
    2887. 

  2887. $conn1-&gt;PConnect($server, $userid, $password, $database);<br>
    2888. 

  2888. $conn2-&gt;PConnect(false, $ora_userid, $ora_pwd, $oraname);<br>
    2889. 

  2889. <br>
    2890. 

  2890. $conn1-&gt;Execute('insert ...');<br>
    2891. 

  2891. $conn2-&gt;Execute('update ...');<br>
    2892. 

  2892. ?&gt;</pre></div>
    2893. 

  2893. 

  2894. <h3>Example 7: Generating Update and Insert SQL<a name=ex7></a></h3>
    2895. 

  2895. 

  2896. <p>Since ADOdb 4.56, we support <a
    2897. 

  2897. href="reference.functions.getupdatesql.html#autoexecute">AutoExecute()</a>,
    2898. 

  2898. which simplifies things by providing an advanced wrapper for GetInsertSQL() and
    2899. 

  2899. GetUpdateSQL(). For example, an INSERT can be carried out with: </p>
    2900. 

  2900. 

  2901. <div style='mso-element:para-border-div;border:solid #DDDDDD 1.0pt;mso-border-alt:
    2902. 

  2902. solid #DDDDDD .75pt;padding:9.0pt 18.0pt 9.0pt 18.0pt;background:#EEEEEE'><pre><o:p>&nbsp;</o:p></pre><pre><span style='mso-spacerun:yes'>&nbsp;&nbsp;&nbsp; </span>$record[&quot;firstname&quot;] = &quot;Bob&quot;; </pre><pre><span style='mso-spacerun:yes'>&nbsp;&nbsp;&nbsp;&nbsp;</span>$record[&quot;lastname&quot;] = &quot;Smith&quot;; </pre><pre><span style='mso-spacerun:yes'>&nbsp;&nbsp;&nbsp;&nbsp;</span>$record[&quot;created&quot;] = time(); </pre><pre><span style='mso-spacerun:yes'>&nbsp;&nbsp;&nbsp;&nbsp;</span>$insertSQL = $conn-&gt;AutoExecute($rs, $record, 'INSERT'); </pre></div>
    2903. 

  2903. 

  2904. <p class=MsoNormal>and an UPDATE with: </p>
    2905. 

  2905. 

  2906. <div style='mso-element:para-border-div;border:solid #DDDDDD 1.0pt;mso-border-alt:
    2907. 

  2907. solid #DDDDDD .75pt;padding:9.0pt 18.0pt 9.0pt 18.0pt;background:#EEEEEE'><pre><o:p>&nbsp;</o:p></pre><pre><span style='mso-spacerun:yes'>&nbsp;&nbsp;&nbsp; </span>$record[&quot;firstname&quot;] = &quot;Caroline&quot;; </pre><pre><span style='mso-spacerun:yes'>&nbsp;&nbsp;&nbsp;&nbsp;</span>$record[&quot;lastname&quot;] = &quot;Smith&quot;; # Update Caroline's lastname from Miranda to Smith </pre><pre><span style='mso-spacerun:yes'>&nbsp;&nbsp;&nbsp;&nbsp;</span>$insertSQL = $conn-&gt;AutoExecute($rs, $record, 'UPDATE', 'id = 1'); </pre></div>
    2908. 

  2908. 

  2909. <p>The rest of this section is out-of-date: </p>
    2910. 

  2910. 

  2911. <p>ADOdb 1.31 and later supports two new recordset functions: GetUpdateSQL( )
    2912. 

  2912. and GetInsertSQL( ). This allow you to perform a &quot;SELECT * FROM table
    2913. 

  2913. query WHERE...&quot;, make a copy of the $rs-&gt;fields, modify the fields, and
    2914. 

  2914. then generate the SQL to update or insert into the table automatically. </p>
    2915. 

  2915. 

  2916. <p>We show how the functions can be used when accessing a table with the
    2917. 

  2917. following fields: (ID, FirstName, LastName, Created). </p>
    2918. 

  2918. 

  2919. <p>Before these functions can be called, you need to initialize the recordset by
    2920. 

  2920. performing a select on the table. Idea and code by Jonathan Younger
    2921. 

  2921. jyounger#unilab.com. Since ADOdb 2.42, you can pass a table name instead of a
    2922. 

  2922. recordset into GetInsertSQL (in $rs), and it will generate an insert statement
    2923. 

  2923. for that table. </p>
    2924. 

  2924. 

  2925. <div style='mso-element:para-border-div;border:solid #DDDDDD 1.0pt;mso-border-alt:
    2926. 

  2926. solid #DDDDDD .75pt;padding:9.0pt 18.0pt 9.0pt 18.0pt;background:#EEEEEE'><pre
    2927. 

  2927. style='background:#EEEEEE'>&lt;?<br>
    2928. 

  2928. #==============================================<br>
    2929. 

  2929. # SAMPLE GetUpdateSQL() and GetInsertSQL() code<br>
    2930. 

  2930. #==============================================<br>
    2931. 

  2931. include('adodb.inc.php');<br>
    2932. 

  2932. include('tohtml.inc.php');<br>
    2933. 

  2933. <br>
    2934. 

  2934. #==========================<br>
    2935. 

  2935. # This code tests an insert<br>
    2936. 

  2936. <br>
    2937. 

  2937. $sql = &quot;SELECT * FROM ADOXYZ WHERE id = -1&quot;; <br>
    2938. 

  2938. # Select an empty record from the database<br>
    2939. 

  2939. <br>
    2940. 

  2940. $conn = &amp;ADONewConnection(&quot;mysql&quot;);<span style='mso-spacerun:yes'>&nbsp; </span># create a connection<br>
    2941. 

  2941. $conn-&gt;debug=1;<br>
    2942. 

  2942. $conn-&gt;PConnect(&quot;localhost&quot;, &quot;admin&quot;, &quot;&quot;, &quot;test&quot;); # connect to MySQL, testdb<br>
    2943. 

  2943. $rs = $conn-&gt;Execute($sql); # Execute the query and get the empty recordset<br>
    2944. 

  2944. <br>
    2945. 

  2945. $record = array(); # Initialize an array to hold the record data to insert<br>
    2946. 

  2946. <br>
    2947. 

  2947. # Set the values for the fields in the record<br>
    2948. 

  2948. # Note that field names are case-insensitive<br>
    2949. 

  2949. $record[&quot;firstname&quot;] = &quot;Bob&quot;;<br>
    2950. 

  2950. $record[&quot;lastNamE&quot;] = &quot;Smith&quot;;<br>
    2951. 

  2951. $record[&quot;creaTed&quot;] = time();<br>
    2952. 

  2952. <br>
    2953. 

  2953. # Pass the empty recordset and the array containing the data to insert<br>
    2954. 

  2954. # into the GetInsertSQL function. The function will process the data and return<br>
    2955. 

  2955. # a fully formatted insert sql statement.<br>
    2956. 

  2956. $insertSQL = $conn-&gt;GetInsertSQL($rs, $record);<br>
    2957. 

  2957. <br>
    2958. 

  2958. $conn-&gt;Execute($insertSQL); # Insert the record into the database<br>
    2959. 

  2959. <br>
    2960. 

  2960. #==========================<br>
    2961. 

  2961. # This code tests an update<br>
    2962. 

  2962. <br>
    2963. 

  2963. $sql = &quot;SELECT * FROM ADOXYZ WHERE id = 1&quot;; <br>
    2964. 

  2964. # Select a record to update<br>
    2965. 

  2965. <br>
    2966. 

  2966. $rs = $conn-&gt;Execute($sql); # Execute the query and get the existing record to update<br>
    2967. 

  2967. <br>
    2968. 

  2968. $record = array(); # Initialize an array to hold the record data to update<br>
    2969. 

  2969. <br>
    2970. 

  2970. # Set the values for the fields in the record<br>
    2971. 

  2971. # Note that field names are case-insensitive<br>
    2972. 

  2972. $record[&quot;firstname&quot;] = &quot;Caroline&quot;;<br>
    2973. 

  2973. $record[&quot;LasTnAme&quot;] = &quot;Smith&quot;; # Update Caroline's lastname from Miranda to Smith<br>
    2974. 

  2974. <br>
    2975. 

  2975. # Pass the single record recordset and the array containing the data to update<br>
    2976. 

  2976. # into the GetUpdateSQL function. The function will process the data and return<br>
    2977. 

  2977. # a fully formatted update sql statement with the correct WHERE clause.<br>
    2978. 

  2978. # If the data has not changed, no recordset is returned<br>
    2979. 

  2979. $updateSQL = $conn-&gt;GetUpdateSQL($rs, $record);<br>
    2980. 

  2980. <br>
    2981. 

  2981. $conn-&gt;Execute($updateSQL); # Update the record in the database<br>
    2982. 

  2982. $conn-&gt;Close();<br>
    2983. 

  2983. ?&gt;</pre></div>
    2984. 

  2984. 

  2985. <p class=MsoNormal><a name="ADODB_FORCE_TYPE"></a><b>$ADODB_FORCE_TYPE</b></p>
    2986. 

  2986. 

  2987. <p>The behaviour of AutoExecute(), GetUpdateSQL() and GetInsertSQL() when
    2988. 

  2988. converting empty or null PHP variables to SQL is controlled by the global
    2989. 

  2989. $ADODB_FORCE_TYPE variable. Set it to one of the values below. Default is
    2990. 

  2990. ADODB_FORCE_VALUE (3): </p>
    2991. 

  2991. 

  2992. <div style='mso-element:para-border-div;border:solid #DDDDDD 1.0pt;mso-border-alt:
    2993. 

  2993. solid #DDDDDD .75pt;padding:9.0pt 18.0pt 9.0pt 18.0pt;background:#EEEEEE'><pre
    2994. 

  2994. style='background:#EEEEEE'>0 = ignore empty fields. All empty fields in array are ignored.<br>
    2995. 

  2995. 1 = force null. All empty, php null and string 'null' fields are changed to sql NULL values.<br>
    2996. 

  2996. 2 = force empty. All empty, php null and string 'null' fields are changed to sql empty '' or 0 values.<br>
    2997. 

  2997. 3 = force value. Value is left as it is. Php null and string 'null' are set to sql NULL values and <br>
    2998. 

  2998. <span style='mso-spacerun:yes'>&nbsp;&nbsp;&nbsp; </span>empty fields '' are set to empty '' sql values.<br>
    2999. 

  2999. <br>
    3000. 

  3000. define('ADODB_FORCE_IGNORE',0);<br>
    3001. 

  3001. define('ADODB_FORCE_NULL',1);<br>
    3002. 

  3002. define('ADODB_FORCE_EMPTY',2);<br>
    3003. 

  3003. define('ADODB_FORCE_VALUE',3);</pre></div>
    3004. 

  3004. 

  3005. <p>Thanks to Niko (nuko#mbnet.fi) for the $ADODB_FORCE_TYPE code. </p>
    3006. 

  3006. 

  3007. <p>Note: the constant ADODB_FORCE_NULLS is obsolete since 4.52 and is ignored.
    3008. 

  3008. Set $ADODB_FORCE_TYPE = ADODB_FORCE_NULL for equivalent behaviour. </p>
    3009. 

  3009. 

  3010. <p>Since 4.62, the table name to be used can be overridden by setting
    3011. 

  3011. $rs-&gt;tableName before AutoExecute(), GetInsertSQL() or GetUpdateSQL() is
    3012. 

  3012. called. </p>
    3013. 

  3013. 

  3014. <h3>Example 8: Implementing Scrolling with Next and Previous<a name=ex8></a></h3>
    3015. 

  3015. 

  3016. <p>The following code creates a very simple recordset pager, where you can
    3017. 

  3017. scroll from page to page of a recordset.</p>
    3018. 

  3018. 

  3019. <div style='mso-element:para-border-div;border:solid #DDDDDD 1.0pt;mso-border-alt:
    3020. 

  3020. solid #DDDDDD .75pt;padding:9.0pt 18.0pt 9.0pt 18.0pt;background:#EEEEEE'><pre
    3021. 

  3021. style='background:#EEEEEE'>include_once('../adodb.inc.php');<br>
    3022. 

  3022. include_once('../adodb-pager.inc.php');<br>
    3023. 

  3023. session_start();<br>
    3024. 

  3024. <br>
    3025. 

  3025. $db = NewADOConnection('mysql');<br>
    3026. 

  3026. <br>
    3027. 

  3027. $db-&gt;Connect('localhost','root','','xphplens');<br>
    3028. 

  3028. <br>
    3029. 

  3029. $sql = &quot;select * from adoxyz &quot;;<br>
    3030. 

  3030. <br>
    3031. 

  3031. $pager = new ADODB_Pager($db,$sql);<br>
    3032. 

  3032. $pager-&gt;Render($rows_per_page=5);</pre></div>
    3033. 

  3033. 

  3034. <p>This will create a basic record pager that looks like this: <a name=scr></a></p>
    3035. 

  3035. 

  3036. <table class=MsoNormalTable border=1 cellpadding=0 style='mso-cellspacing:1.5pt;
    3037. 

  3037.  background:beige'>
    3038. 

  3038.  <tr style='mso-yfti-irow:0;mso-yfti-firstrow:yes'>
    3039. 

  3039.   <td style='padding:.75pt .75pt .75pt .75pt'>
    3040. 

  3040.   <p class=MsoNormal><a href="#scr"><code><span style='font-size:10.0pt'>|&lt;</span></code></a>
    3041. 

  3041.   &nbsp; <a href="#scr"><code><span style='font-size:10.0pt'>&lt;&lt;</span></code></a>
    3042. 

  3042.   &nbsp; <a href="#scr"><code><span style='font-size:10.0pt'>&gt;&gt;</span></code></a>
    3043. 

  3043.   &nbsp; <a href="#scr"><code><span style='font-size:10.0pt'>&gt;|</span></code></a>
    3044. 

  3044.   &nbsp; </p>
    3045. 

  3045.   </td>
    3046. 

  3046.  </tr>
    3047. 

  3047.  <tr style='mso-yfti-irow:1'>
    3048. 

  3048.   <td style='padding:.75pt .75pt .75pt .75pt'>
    3049. 

  3049.   <table class=MsoNormalTable border=1 cellpadding=0 width="100%"
    3050. 

  3050.    style='width:100.0%;mso-cellspacing:1.5pt;background:white' cols=4>
    3051. 

  3051.    <tr style='mso-yfti-irow:0;mso-yfti-firstrow:yes'>
    3052. 

  3052.     <td style='padding:.75pt .75pt .75pt .75pt'>
    3053. 

  3053.     <p class=MsoNormal align=center style='text-align:center'><b>ID<o:p></o:p></b></p>
    3054. 

  3054.     </td>
    3055. 

  3055.     <td style='padding:.75pt .75pt .75pt .75pt'>
    3056. 

  3056.     <p class=MsoNormal align=center style='text-align:center'><b>First Name<o:p></o:p></b></p>
    3057. 

  3057.     </td>
    3058. 

  3058.     <td style='padding:.75pt .75pt .75pt .75pt'>
    3059. 

  3059.     <p class=MsoNormal align=center style='text-align:center'><b>Last Name<o:p></o:p></b></p>
    3060. 

  3060.     </td>
    3061. 

  3061.     <td style='padding:.75pt .75pt .75pt .75pt'>
    3062. 

  3062.     <p class=MsoNormal align=center style='text-align:center'><b>Date Created<o:p></o:p></b></p>
    3063. 

  3063.     </td>
    3064. 

  3064.    </tr>
    3065. 

  3065.    <tr style='mso-yfti-irow:1'>
    3066. 

  3066.     <td style='padding:.75pt .75pt .75pt .75pt'>
    3067. 

  3067.     <p class=MsoNormal align=right style='text-align:right'>36&nbsp;</p>
    3068. 

  3068.     </td>
    3069. 

  3069.     <td style='padding:.75pt .75pt .75pt .75pt'>
    3070. 

  3070.     <p class=MsoNormal>Alan&nbsp;</p>
    3071. 

  3071.     </td>
    3072. 

  3072.     <td style='padding:.75pt .75pt .75pt .75pt'>
    3073. 

  3073.     <p class=MsoNormal>Turing&nbsp;</p>
    3074. 

  3074.     </td>
    3075. 

  3075.     <td style='padding:.75pt .75pt .75pt .75pt'>
    3076. 

  3076.     <p class=MsoNormal>Sat 06, Oct 2001&nbsp;</p>
    3077. 

  3077.     </td>
    3078. 

  3078.    </tr>
    3079. 

  3079.    <tr style='mso-yfti-irow:2'>
    3080. 

  3080.     <td style='padding:.75pt .75pt .75pt .75pt'>
    3081. 

  3081.     <p class=MsoNormal align=right style='text-align:right'>37&nbsp;</p>
    3082. 

  3082.     </td>
    3083. 

  3083.     <td style='padding:.75pt .75pt .75pt .75pt'>
    3084. 

  3084.     <p class=MsoNormal>Serena&nbsp;</p>
    3085. 

  3085.     </td>
    3086. 

  3086.     <td style='padding:.75pt .75pt .75pt .75pt'>
    3087. 

  3087.     <p class=MsoNormal>Williams&nbsp;</p>
    3088. 

  3088.     </td>
    3089. 

  3089.     <td style='padding:.75pt .75pt .75pt .75pt'>
    3090. 

  3090.     <p class=MsoNormal>Sat 06, Oct 2001&nbsp;</p>
    3091. 

  3091.     </td>
    3092. 

  3092.    </tr>
    3093. 

  3093.    <tr style='mso-yfti-irow:3'>
    3094. 

  3094.     <td style='padding:.75pt .75pt .75pt .75pt'>
    3095. 

  3095.     <p class=MsoNormal align=right style='text-align:right'>38&nbsp;</p>
    3096. 

  3096.     </td>
    3097. 

  3097.     <td style='padding:.75pt .75pt .75pt .75pt'>
    3098. 

  3098.     <p class=MsoNormal>Yat Sun&nbsp;</p>
    3099. 

  3099.     </td>
    3100. 

  3100.     <td style='padding:.75pt .75pt .75pt .75pt'>
    3101. 

  3101.     <p class=MsoNormal>Sun&nbsp;</p>
    3102. 

  3102.     </td>
    3103. 

  3103.     <td style='padding:.75pt .75pt .75pt .75pt'>
    3104. 

  3104.     <p class=MsoNormal>Sat 06, Oct 2001&nbsp;</p>
    3105. 

  3105.     </td>
    3106. 

  3106.    </tr>
    3107. 

  3107.    <tr style='mso-yfti-irow:4'>
    3108. 

  3108.     <td style='padding:.75pt .75pt .75pt .75pt'>
    3109. 

  3109.     <p class=MsoNormal align=right style='text-align:right'>39&nbsp;</p>
    3110. 

  3110.     </td>
    3111. 

  3111.     <td style='padding:.75pt .75pt .75pt .75pt'>
    3112. 

  3112.     <p class=MsoNormal>Wai Hun&nbsp;</p>
    3113. 

  3113.     </td>
    3114. 

  3114.     <td style='padding:.75pt .75pt .75pt .75pt'>
    3115. 

  3115.     <p class=MsoNormal>See&nbsp;</p>
    3116. 

  3116.     </td>
    3117. 

  3117.     <td style='padding:.75pt .75pt .75pt .75pt'>
    3118. 

  3118.     <p class=MsoNormal>Sat 06, Oct 2001&nbsp;</p>
    3119. 

  3119.     </td>
    3120. 

  3120.    </tr>
    3121. 

  3121.    <tr style='mso-yfti-irow:5;mso-yfti-lastrow:yes'>
    3122. 

  3122.     <td style='padding:.75pt .75pt .75pt .75pt'>
    3123. 

  3123.     <p class=MsoNormal align=right style='text-align:right'>40&nbsp;</p>
    3124. 

  3124.     </td>
    3125. 

  3125.     <td style='padding:.75pt .75pt .75pt .75pt'>
    3126. 

  3126.     <p class=MsoNormal>Steven&nbsp;</p>
    3127. 

  3127.     </td>
    3128. 

  3128.     <td style='padding:.75pt .75pt .75pt .75pt'>
    3129. 

  3129.     <p class=MsoNormal>Oey&nbsp;</p>
    3130. 

  3130.     </td>
    3131. 

  3131.     <td style='padding:.75pt .75pt .75pt .75pt'>
    3132. 

  3132.     <p class=MsoNormal>Sat 06, Oct 2001&nbsp;</p>
    3133. 

  3133.     </td>
    3134. 

  3134.    </tr>
    3135. 

  3135.   </table>
    3136. 

  3136.   <p class=MsoNormal><o:p></o:p></p>
    3137. 

  3137.   </td>
    3138. 

  3138.  </tr>
    3139. 

  3139.  <tr style='mso-yfti-irow:2;mso-yfti-lastrow:yes'>
    3140. 

  3140.   <td style='padding:.75pt .75pt .75pt .75pt'>
    3141. 

  3141.   <p class=MsoNormal><span style='font-size:10.0pt'>Page 8/10</span></p>
    3142. 

  3142.   </td>
    3143. 

  3143.  </tr>
    3144. 

  3144. </table>
    3145. 

  3145. 

  3146. <p>The number of rows to display at one time is controled by the Render($rows)
    3147. 

  3147. method. If you do not pass any value to Render(), ADODB_Pager will default to
    3148. 

  3148. 10 records per page. </p>
    3149. 

  3149. 

  3150. <p>You can control the column titles by modifying your SQL (supported by most
    3151. 

  3151. databases): </p>
    3152. 

  3152. 

  3153. <div style='mso-element:para-border-div;border:solid #DDDDDD 1.0pt;mso-border-alt:
    3154. 

  3154. solid #DDDDDD .75pt;padding:9.0pt 18.0pt 9.0pt 18.0pt;background:#EEEEEE'><pre
    3155. 

  3155. style='background:#EEEEEE'>$sql = 'select id as &quot;ID&quot;, firstname as &quot;First Name&quot;, <br>
    3156. 

  3156. <span style='mso-tab-count:2'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span><span style='mso-spacerun:yes'>&nbsp; </span>lastname as &quot;Last Name&quot;, created as &quot;Date Created&quot; <br>
    3157. 

  3157. <span style='mso-tab-count:2'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>from adoxyz';</pre></div>
    3158. 

  3158. 

  3159. <p>The above code can be found in the <i>adodb/tests/testpaging.php</i> example
    3160. 

  3160. included with this release, and the class ADODB_Pager in <i>adodb/adodb-pager.inc.php</i>.
    3161. 

  3161. The ADODB_Pager code can be adapted by a programmer so that the text links can
    3162. 

  3162. be replaced by images, and the dull white background be replaced with more
    3163. 

  3163. interesting colors. </p>
    3164. 

  3164. 

  3165. <p>You can also allow display of html by setting $pager-&gt;htmlSpecialChars =
    3166. 

  3166. false. </p>
    3167. 

  3167. 

  3168. <p>Some of the code used here was contributed by Iván Oliva and Cornel G. </p>
    3169. 

  3169. 

  3170. <h3><a name=ex9></a>Example 9: Exporting in CSV or Tab-Delimited Format</h3>
    3171. 

  3171. 

  3172. <p>We provide some helper functions to export in comma-separated-value (CSV)
    3173. 

  3173. and tab-delimited formats:</p>
    3174. 

  3174. 

  3175. <div style='mso-element:para-border-div;border:solid #DDDDDD 1.0pt;mso-border-alt:
    3176. 

  3176. solid #DDDDDD .75pt;padding:9.0pt 18.0pt 9.0pt 18.0pt;background:#EEEEEE'><pre><b>include_once('/path/to/adodb/toexport.inc.php');</b><br>
    3177. 

  3177. include_once('/path/to/adodb/adodb.inc.php');<br style='mso-special-character:
    3178. 

  3178. line-break'>
    3179. 

  3179. <![if !supportLineBreakNewLine]><br style='mso-special-character:line-break'>
    3180. 

  3180. <![endif]></pre><pre style='background:#EEEEEE'>$db = &amp;NewADOConnection('mysql');<br>
    3181. 

  3181. $db-&gt;Connect($server, $userid, $password, $database);<br>
    3182. 

  3182. <br>
    3183. 

  3183. $rs = $db-&gt;Execute('select fname as &quot;First Name&quot;, surname as &quot;Surname&quot; from table');<br>
    3184. 

  3184. <br>
    3185. 

  3185. print &quot;&lt;pre&gt;&quot;;<br>
    3186. 

  3186. print <b>rs2csv</b>($rs); # return a string, CSV format</pre>
    3187. 

  3187. 

  3188. <p style='tab-stops:45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt;
    3189. 

  3189. background:#EEEEEE;border:none;mso-border-alt:solid #DDDDDD .75pt;padding:0cm;
    3190. 

  3190. mso-padding-alt:9.0pt 18.0pt 9.0pt 18.0pt'><span style='font-size:9.0pt;
    3191. 

  3191. font-family:"Courier New"'>print '&lt;hr&gt;';<br>
    3192. 

  3192. <br>
    3193. 

  3193. $rs-&gt;MoveFirst(); # note, some databases do not support MoveFirst<br>
    3194. 

  3194. print <b>rs2tab</b>($rs,<i>false</i>); # return a string, tab-delimited<br>
    3195. 

  3195. <span style='mso-tab-count:6'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span><span
    3196. 

  3196. style='mso-spacerun:yes'>&nbsp;</span># false == suppress field names in first line<o:p></o:p></span></p>
    3197. 

  3197. 

  3198. <pre style='background:#EEEEEE'>print '&lt;hr&gt;';<br>
    3199. 

  3199. $rs-&gt;MoveFirst();<br>
    3200. 

  3200. <b>rs2tabout</b>($rs); # send to stdout directly (there is also an rs2csvout function)<br>
    3201. 

  3201. print &quot;&lt;/pre&gt;&quot;;<br>
    3202. 

  3202. <br>
    3203. 

  3203. $rs-&gt;MoveFirst();<br>
    3204. 

  3204. $fp = fopen($path, &quot;w&quot;);<br>
    3205. 

  3205. if ($fp) {<br>
    3206. 

  3206. <span style='mso-spacerun:yes'>&nbsp; </span><b>rs2csvfile</b>($rs, $fp); # write to file (there is also an rs2tabfile function)<br>
    3207. 

  3207. <span style='mso-spacerun:yes'>&nbsp; </span>fclose($fp);<br>
    3208. 

  3208. }</pre></div>
    3209. 

  3209. 

  3210. <p>Carriage-returns or newlines are converted to spaces. Field names are
    3211. 

  3211. returned in the first line of text. Strings containing the delimiter character
    3212. 

  3212. are quoted with double-quotes. Double-quotes are double-quoted again. This
    3213. 

  3213. conforms to Excel import and export guide-lines. </p>
    3214. 

  3214. 

  3215. <p>All the above functions take as an optional last parameter, $addtitles which
    3216. 

  3216. defaults to <i>true</i>. When set to <i>false</i> field names in the first line
    3217. 

  3217. are suppressed. </p>
    3218. 

  3218. 

  3219. <h3>Example 10: Recordset Filters<a name=ex10></a></h3>
    3220. 

  3220. 

  3221. <p>Sometimes we want to pre-process all rows in a recordset before we use it.
    3222. 

  3222. For example, we want to ucwords all text in recordset. </p>
    3223. 

  3223. 

  3224. <div style='mso-element:para-border-div;border:solid #DDDDDD 1.0pt;mso-border-alt:
    3225. 

  3225. solid #DDDDDD .75pt;padding:9.0pt 18.0pt 9.0pt 18.0pt;background:#EEEEEE'><pre
    3226. 

  3226. style='background:#EEEEEE'>include_once('adodb/rsfilter.inc.php');<br>
    3227. 

  3227. include_once('adodb/adodb.inc.php');<br>
    3228. 

  3228. <br>
    3229. 

  3229. // ucwords() every element in the recordset<br>
    3230. 

  3230. function do_ucwords(&amp;$arr,$rs)<br>
    3231. 

  3231. {<br>
    3232. 

  3232. <span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>foreach($arr as $k =&gt; $v) {<br>
    3233. 

  3233. <span style='mso-tab-count:2'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$arr[$k] = ucwords($v);<br>
    3234. 

  3234. <span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>}<br>
    3235. 

  3235. }<br>
    3236. 

  3236. <br>
    3237. 

  3237. $db = NewADOConnection('mysql');<br>
    3238. 

  3238. $db-&gt;PConnect('server','user','pwd','db');<br>
    3239. 

  3239. <br>
    3240. 

  3240. $rs = $db-&gt;Execute('select ... from table');<br>
    3241. 

  3241. $rs = <b>RSFilter</b>($rs,'do_ucwords');</pre></div>
    3242. 

  3242. 

  3243. <p>The <i>RSFilter</i> function takes 2 parameters, the recordset, and the name
    3244. 

  3244. of the <i>filter</i> function. It returns the processed recordset scrolled to
    3245. 

  3245. the first record. The <i>filter</i> function takes two parameters, the current
    3246. 

  3246. row as an array, and the recordset object. For future compatibility, you should
    3247. 

  3247. not use the original recordset object. </p>
    3248. 

  3248. 

  3249. <h3>Example 11:<a name=ex11></a> Smart Transactions</h3>
    3250. 

  3250. 

  3251. <p class=MsoNormal>The old way of doing transactions required you to use </p>
    3252. 

  3252. 

  3253. <div style='mso-element:para-border-div;border:solid #DDDDDD 1.0pt;mso-border-alt:
    3254. 

  3254. solid #DDDDDD .75pt;padding:9.0pt 18.0pt 9.0pt 18.0pt;background:#EEEEEE'><pre
    3255. 

  3255. style='background:#EEEEEE'>$conn-&gt;<b>BeginTrans</b>();<br>
    3256. 

  3256. $ok = $conn-&gt;Execute($sql);<br>
    3257. 

  3257. if ($ok) $ok = $conn-&gt;Execute($sql2);<br>
    3258. 

  3258. if (!$ok) $conn-&gt;<b>RollbackTrans</b>();<br>
    3259. 

  3259. else $conn-&gt;<b>CommitTrans</b>();</pre></div>
    3260. 

  3260. 

  3261. <p class=MsoNormal>This is very complicated for large projects because you have
    3262. 

  3262. to track the error status. Smart Transactions is much simpler. You start a
    3263. 

  3263. smart transaction by calling StartTrans(): </p>
    3264. 

  3264. 

  3265. <div style='mso-element:para-border-div;border:solid #DDDDDD 1.0pt;mso-border-alt:
    3266. 

  3266. solid #DDDDDD .75pt;padding:9.0pt 18.0pt 9.0pt 18.0pt;background:#EEEEEE'><pre
    3267. 

  3267. style='background:#EEEEEE'>$conn-&gt;<b>StartTrans</b>();<br>
    3268. 

  3268. $conn-&gt;Execute($sql);<br>
    3269. 

  3269. $conn-&gt;Execute($Sql2);<br>
    3270. 

  3270. $conn-&gt;<b>CompleteTrans</b>();</pre></div>
    3271. 

  3271. 

  3272. <p class=MsoNormal>CompleteTrans() detects when an SQL error occurs, and will
    3273. 

  3273. Rollback/Commit as appropriate. To specificly force a rollback even if no error
    3274. 

  3274. occured, use FailTrans(). Note that the rollback is done in CompleteTrans(),
    3275. 

  3275. and not in FailTrans(). </p>
    3276. 

  3276. 

  3277. <div style='mso-element:para-border-div;border:solid #DDDDDD 1.0pt;mso-border-alt:
    3278. 

  3278. solid #DDDDDD .75pt;padding:9.0pt 18.0pt 9.0pt 18.0pt;background:#EEEEEE'><pre
    3279. 

  3279. style='background:#EEEEEE'>$conn-&gt;<b>StartTrans</b>();<br>
    3280. 

  3280. $conn-&gt;Execute($sql);<br>
    3281. 

  3281. if (!CheckRecords()) $conn-&gt;<strong><span style='font-family:"Courier New"'>FailTrans</span></strong>();<br>
    3282. 

  3282. $conn-&gt;Execute($Sql2);<br>
    3283. 

  3283. $conn-&gt;<b>CompleteTrans</b>();</pre></div>
    3284. 

  3284. 

  3285. <p>You can also check if a transaction has failed, using HasFailedTrans(),
    3286. 

  3286. which returns true if FailTrans() was called, or there was an error in the SQL
    3287. 

  3287. execution. Make sure you call HasFailedTrans() before you call CompleteTrans(),
    3288. 

  3288. as it is only works between StartTrans/CompleteTrans. </p>
    3289. 

  3289. 

  3290. <p>Lastly, StartTrans/CompleteTrans is nestable, and only the outermost block
    3291. 

  3291. is executed. In contrast, BeginTrans/CommitTrans/RollbackTrans is NOT nestable.
    3292. 

  3292. </p>
    3293. 

  3293. 

  3294. <div style='mso-element:para-border-div;border:solid #DDDDDD 1.0pt;mso-border-alt:
    3295. 

  3295. solid #DDDDDD .75pt;padding:9.0pt 18.0pt 9.0pt 18.0pt;background:#EEEEEE'><pre>$conn-&gt;<strong><span
    3296. 

  3296. style='font-family:"Courier New"'>StartTrans</span></strong>();<br>
    3297. 

  3297. $conn-&gt;Execute($sql);<br>
    3298. 

  3298. <span style='mso-spacerun:yes'>&nbsp; </span>$conn-&gt;<strong><span
    3299. 

  3299. style='font-family:"Courier New"'>StartTrans</span></strong>();<span style='mso-spacerun:yes'>&nbsp;&nbsp;&nbsp; </span><span
    3300. 

  3300. style='color:#006600'># ignored</span></pre><pre><span style='mso-spacerun:yes'>&nbsp; </span>if (!CheckRecords()) $conn-&gt;FailTrans();</pre><pre><span style='mso-spacerun:yes'>&nbsp; </span>$conn-&gt;<strong><span
    3301. 

  3301. style='font-family:"Courier New"'>CompleteTrans</span></strong>(); <span
    3302. 

  3302. style='color:#006600'># ignored</span></pre><pre>$conn-&gt;Execute($Sql2);</pre><pre
    3303. 

  3303. style='background:#EEEEEE'>$conn-&gt;<strong><span style='font-family:"Courier New"'>CompleteTrans</span></strong>();</pre></div>
    3304. 

  3304. 

  3305. <p>Note: Savepoints are currently not supported. </p>
    3306. 

  3306. 

  3307. <h2><a name=errorhandling></a>Using Custom Error Handlers and PEAR_Error</h2>
    3308. 

  3308. 

  3309. <p>ADOdb supports PHP5 exceptions. Just include <i>adodb-exceptions.inc.php</i>
    3310. 

  3310. and you can now catch exceptions on errors as they occur. </p>
    3311. 

  3311. 

  3312. <div style='mso-element:para-border-div;border:solid #DDDDDD 1.0pt;mso-border-alt:
    3313. 

  3313. solid #DDDDDD .75pt;padding:9.0pt 18.0pt 9.0pt 18.0pt;background:#EEEEEE'><pre
    3314. 

  3314. style='background:#EEEEEE'><span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span><b>include(&quot;../adodb-exceptions.inc.php&quot;);</b> <br>
    3315. 

  3315. <span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>include(&quot;../adodb.inc.php&quot;);<span
    3316. 

  3316. style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span> <br>
    3317. 

  3317. <span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>try { <br>
    3318. 

  3318. <span style='mso-tab-count:2'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$db = NewADOConnection(&quot;oci8://scott:bad-password@mytns/&quot;); <br>
    3319. 

  3319. <span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>} catch (exception $e) { <br>
    3320. 

  3320. <span style='mso-tab-count:2'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>var_dump($e); <br>
    3321. 

  3321. <span style='mso-tab-count:2'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>adodb_backtrace($e-&gt;gettrace());<br>
    3322. 

  3322. <span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>} </pre></div>
    3323. 

  3323. 

  3324. <p>ADOdb also provides two custom handlers which you can modify for your needs.
    3325. 

  3325. The first one is in the <b>adodb-errorhandler.inc.php</b> file. This makes use
    3326. 

  3326. of the standard PHP functions <a href="http://php.net/error_reporting">error_reporting</a>
    3327. 

  3327. to control what error messages types to display, and <a
    3328. 

  3328. href="http://php.net/trigger_error">trigger_error</a> which invokes the default
    3329. 

  3329. PHP error handler. </p>
    3330. 

  3330. 

  3331. <p>Including the above file will cause <i>trigger_error($errorstring,E_USER_ERROR)</i>
    3332. 

  3332. to be called when<br>
    3333. 

  3333. (a) Connect() or PConnect() fails, or <br>
    3334. 

  3334. (b) a function that executes SQL statements such as Execute() or SelectLimit()
    3335. 

  3335. has an error.<br>
    3336. 

  3336. (c) GenID() appears to go into an infinite loop. </p>
    3337. 

  3337. 

  3338. <p>The $errorstring is generated by ADOdb and will contain useful debugging
    3339. 

  3339. information similar to the error.log data generated below. This file
    3340. 

  3340. adodb-errorhandler.inc.php should be included before you create any
    3341. 

  3341. ADOConnection objects. </p>
    3342. 

  3342. 

  3343. <p>If you define error_reporting(0), no errors will be passed to the error
    3344. 

  3344. handler. If you set error_reporting(E_ALL), all errors will be passed to the
    3345. 

  3345. error handler. You still need to use <b>ini_set(&quot;display_errors&quot;,
    3346. 

  3346. &quot;0&quot; or &quot;1&quot;)</b> to control the display of errors. </p>
    3347. 

  3347. 

  3348. <div style='mso-element:para-border-div;border:solid #DDDDDD 1.0pt;mso-border-alt:
    3349. 

  3349. solid #DDDDDD .75pt;padding:9.0pt 18.0pt 9.0pt 18.0pt;background:#EEEEEE'><pre>&lt;?php<br>
    3350. 

  3350. <b>error_reporting(E_ALL); # pass any error messages triggered to error handler<br>
    3351. 

  3351. include('adodb-errorhandler.inc.php');</b></pre><pre>include('adodb.inc.php');</pre><pre>include('tohtml.inc.php');</pre><pre>$c = NewADOConnection('mysql');</pre><pre>$c-&gt;PConnect('localhost','root','','northwind');</pre><pre>$rs=$c-&gt;Execute('select * from productsz'); #invalid table productsz');</pre><pre>if ($rs) rs2html($rs);</pre><pre>?&gt;</pre></div>
    3352. 

  3352. 

  3353. <p>If you want to log the error message, you can do so by defining the
    3354. 

  3354. following optional constants ADODB_ERROR_LOG_TYPE and ADODB_ERROR_LOG_DEST.
    3355. 

  3355. ADODB_ERROR_LOG_TYPE is the error log message type (see <a
    3356. 

  3356. href="http://php.net/error_log">error_log</a> in the PHP manual). In this case
    3357. 

  3357. we set it to 3, which means log to the file defined by the constant
    3358. 

  3358. ADODB_ERROR_LOG_DEST. </p>
    3359. 

  3359. 

  3360. <div style='mso-element:para-border-div;border:solid #DDDDDD 1.0pt;mso-border-alt:
    3361. 

  3361. solid #DDDDDD .75pt;padding:9.0pt 18.0pt 9.0pt 18.0pt;background:#EEEEEE'><pre>&lt;?php<br>
    3362. 

  3362. <b>error_reporting(E_ALL); # report all errors<br>
    3363. 

  3363. ini_set(&quot;display_errors&quot;, &quot;0&quot;); # but do not echo the errors<br>
    3364. 

  3364. define('ADODB_ERROR_LOG_TYPE',3);<br>
    3365. 

  3365. define('ADODB_ERROR_LOG_DEST','C:/errors.log');<br>
    3366. 

  3366. include('adodb-errorhandler.inc.php');</b></pre><pre>include('adodb.inc.php');</pre><pre>include('tohtml.inc.php');</pre><pre><o:p>&nbsp;</o:p></pre><pre>$c = NewADOConnection('mysql');</pre><pre>$c-&gt;PConnect('localhost','root','','northwind');</pre><pre>$rs=$c-&gt;Execute('select * from productsz'); ## invalid table productsz</pre><pre>if ($rs) rs2html($rs);</pre><pre>?&gt;</pre></div>
    3367. 

  3367. 

  3368. <p class=MsoNormal>The following message will be logged in the error.log file: </p>
    3369. 

  3369. 

  3370. <div style='mso-element:para-border-div;border:solid #DDDDDD 1.0pt;mso-border-alt:
    3371. 

  3371. solid #DDDDDD .75pt;padding:9.0pt 18.0pt 9.0pt 18.0pt;background:#EEEEEE'><pre
    3372. 

  3372. style='background:#EEEEEE'>(2001-10-28 14:20:38) mysql error: [1146: Table 'northwind.productsz' doesn't exist] in<br>
    3373. 

  3373. <span style='mso-spacerun:yes'>&nbsp;</span>EXECUTE(&quot;select * from productsz&quot;)</pre></div>
    3374. 

  3374. 

  3375. <h3>PEAR_ERROR</h3>
    3376. 

  3376. 

  3377. <p class=MsoNormal>The second error handler is <b>adodb-errorpear.inc.php</b>.
    3378. 

  3378. This will create a PEAR_Error derived object whenever an error occurs. The last
    3379. 

  3379. PEAR_Error object created can be retrieved using ADODB_Pear_Error(). </p>
    3380. 

  3380. 

  3381. <div style='mso-element:para-border-div;border:solid #DDDDDD 1.0pt;mso-border-alt:
    3382. 

  3382. solid #DDDDDD .75pt;padding:9.0pt 18.0pt 9.0pt 18.0pt;background:#EEEEEE'><pre>&lt;?php<br>
    3383. 

  3383. <b>include('adodb-errorpear.inc.php');</b></pre><pre>include('adodb.inc.php');</pre><pre>include('tohtml.inc.php');</pre><pre>$c = NewADOConnection('mysql');</pre><pre>$c-&gt;PConnect('localhost','root','','northwind');</pre><pre>$rs=$c-&gt;Execute('select * from productsz'); #invalid table productsz');</pre><pre>if ($rs) rs2html($rs);</pre><pre>else {</pre><pre><span
    3384. 

  3384. style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span><b>$e = ADODB_Pear_Error();<br>
    3385. 

  3385. <span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>echo '&lt;p&gt;',$e-&gt;message,'&lt;/p&gt;';</b></pre><pre>}</pre><pre>?&gt;</pre></div>
    3386. 

  3386. 

  3387. <p>You can use a PEAR_Error derived class by defining the constant
    3388. 

  3388. ADODB_PEAR_ERROR_CLASS before the adodb-errorpear.inc.php file is included. For
    3389. 

  3389. easy debugging, you can set the default error handler in the beginning of the
    3390. 

  3390. PHP script to PEAR_ERROR_DIE, which will cause an error message to be printed,
    3391. 

  3391. then halt script execution: </p>
    3392. 

  3392. 

  3393. <div style='mso-element:para-border-div;border:solid #DDDDDD 1.0pt;mso-border-alt:
    3394. 

  3394. solid #DDDDDD .75pt;padding:9.0pt 18.0pt 9.0pt 18.0pt;background:#EEEEEE'><pre
    3395. 

  3395. style='background:#EEEEEE'>include('PEAR.php');<br>
    3396. 

  3396. PEAR::setErrorHandling('PEAR_ERROR_DIE');</pre></div>
    3397. 

  3397. 

  3398. <p>Note that we do not explicitly return a PEAR_Error object to you when an
    3399. 

  3399. error occurs. We return false instead. You have to call ADODB_Pear_Error() to
    3400. 

  3400. get the last error or use the PEAR_ERROR_DIE technique. </p>
    3401. 

  3401. 

  3402. <h3>MetaError and MetaErrMsg</h3>
    3403. 

  3403. 

  3404. <p>If you need error messages that work across multiple databases, then use <a
    3405. 

  3405. href="#metaerror">MetaError()</a>, which returns a virtualized error number,
    3406. 

  3406. based on PEAR DB's error number system, and <a href="#metaerrmsg">MetaErrMsg()</a>.
    3407. 

  3407. </p>
    3408. 

  3408. 

  3409. <h4>Error Messages</h4>
    3410. 

  3410. 

  3411. <p>Error messages are outputted using the static method
    3412. 

  3412. ADOConnnection::outp($msg,$newline=true). By default, it sends the messages to
    3413. 

  3413. the client. You can override this to perform error-logging. </p>
    3414. 

  3414. 

  3415. <h2><a name=dsn></a>Data Source Names</h2>
    3416. 

  3416. 

  3417. <p>We now support connecting using PEAR style DSN's. A DSN is a connection
    3418. 

  3418. string of the form:</p>
    3419. 

  3419. 

  3420. <p>$dsn = <i>&quot;$driver://$username:$password@$hostname/$databasename&quot;</i>;</p>
    3421. 

  3421. 

  3422. <p>An example:</p>
    3423. 

  3423. 

  3424. <div style='mso-element:para-border-div;border:solid #DDDDDD 1.0pt;mso-border-alt:
    3425. 

  3425. solid #DDDDDD .75pt;padding:9.0pt 18.0pt 9.0pt 18.0pt;background:#EEEEEE'><pre
    3426. 

  3426. style='background:#EEEEEE'><span style='mso-spacerun:yes'>&nbsp;&nbsp; </span>$username = 'root';<br>
    3427. 

  3427. <span style='mso-spacerun:yes'>&nbsp;&nbsp; </span>$password = '';<br>
    3428. 

  3428. <span style='mso-spacerun:yes'>&nbsp;&nbsp; </span>$hostname = 'localhost';<br>
    3429. 

  3429. <span style='mso-spacerun:yes'>&nbsp;&nbsp; </span>$databasename = 'xphplens';<br>
    3430. 

  3430. <span style='mso-spacerun:yes'>&nbsp;&nbsp; </span>$driver = 'mysql';<br>
    3431. 

  3431. <span style='mso-spacerun:yes'>&nbsp;&nbsp; </span>$dsn = &quot;$driver://$username:$password@$hostname/$databasename&quot;<br>
    3432. 

  3432. <span style='mso-spacerun:yes'>&nbsp;&nbsp; </span>$db = NewADOConnection(); <br>
    3433. 

  3433. <span style='mso-spacerun:yes'>&nbsp;&nbsp; </span># DB::Connect($dsn) also works if you include 'adodb/adodb-pear.inc.php' at the top<br>
    3434. 

  3434. <span style='mso-spacerun:yes'>&nbsp;&nbsp; </span>$rs = $db-&gt;query('select firstname,lastname from adoxyz');<br>
    3435. 

  3435. <span style='mso-spacerun:yes'>&nbsp;&nbsp; </span>$cnt = 0;<br>
    3436. 

  3436. <span style='mso-spacerun:yes'>&nbsp;&nbsp; </span>while ($arr = $rs-&gt;fetchRow()) {<br>
    3437. 

  3437. <span style='mso-tab-count:2'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>print_r($arr); print &quot;&lt;br&gt;&quot;;<br>
    3438. 

  3438. <span style='mso-spacerun:yes'>&nbsp;&nbsp; </span>}</pre></div>
    3439. 

  3439. 

  3440. <p><a href="#dsnsupport">More info and connection examples</a> on the DSN
    3441. 

  3441. format. </p>
    3442. 

  3442. 

  3443. <h2><a name=pear></a>PEAR Compatibility</h2>
    3444. 

  3444. 

  3445. <p class=MsoNormal>We support DSN's (see above), and the following functions: </p>
    3446. 

  3446. 

  3447. <div style='mso-element:para-border-div;border:solid #DDDDDD 1.0pt;mso-border-alt:
    3448. 

  3448. solid #DDDDDD .75pt;padding:9.0pt 18.0pt 9.0pt 18.0pt;background:#EEEEEE'><pre><b><span style='mso-spacerun:yes'>&nbsp;</span>DB_Common</b></pre><pre> <span
    3449. 

  3449. style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>query - returns PEAR_Error on error</pre><pre><span
    3450. 

  3450. style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>limitQuery - return PEAR_Error on error</pre><pre><span
    3451. 

  3451. style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>prepare - does not return PEAR_Error on error</pre><pre><span
    3452. 

  3452. style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>execute - does not return PEAR_Error on error</pre><pre><span
    3453. 

  3453. style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>setFetchMode - supports ASSOC and ORDERED</pre><pre><span
    3454. 

  3454. style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>errorNative</pre><pre><span
    3455. 

  3455. style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>quote</pre><pre><span style='mso-tab-count:
    3456. 

  3456. 1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>nextID</pre><pre><span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>disconnect</pre><pre><span
    3457. 

  3457. style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></pre><pre><span style='mso-tab-count:
    3458. 

  3458. 1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>getOne</pre><pre><span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>getAssoc</pre><pre><span
    3459. 

  3459. style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>getRow</pre><pre><span
    3460. 

  3460. style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>getCol</pre><pre><span
    3461. 

  3461. style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></pre><pre><b> DB_Result</b></pre><pre> <span
    3462. 

  3462. style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>numRows - returns -1 if not supported</pre><pre><span
    3463. 

  3463. style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>numCols</pre><pre><span
    3464. 

  3464. style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>fetchInto - does not support passing of fetchmode</pre><pre><span
    3465. 

  3465. style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>fetchRows - does not support passing of fetchmode</pre><pre><span
    3466. 

  3466. style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>free</pre></div>
    3467. 

  3467. 

  3468. <h2><a name=caching></a>Caching of Recordsets</h2>
    3469. 

  3469. 

  3470. <p>ADOdb now supports caching of recordsets in the file system using the
    3471. 

  3471. CacheExecute( ), CachePageExecute( ) and CacheSelectLimit( ) functions. There
    3472. 

  3472. are similar to the non-cache functions, except that they take a new first
    3473. 

  3473. parameter, $secs2cache. </p>
    3474. 

  3474. 

  3475. <p>An example: </p>
    3476. 

  3476. 

  3477. <div style='mso-element:para-border-div;border:solid #DDDDDD 1.0pt;mso-border-alt:
    3478. 

  3478. solid #DDDDDD .75pt;padding:9.0pt 18.0pt 9.0pt 18.0pt;background:#EEEEEE'><pre
    3479. 

  3479. style='background:#EEEEEE'><b>include</b>('adodb.inc.php'); # load code common to ADOdb<br>
    3480. 

  3480. $ADODB_CACHE_DIR = '/usr/ADODB_cache';<br>
    3481. 

  3481. $<span style='color:#663300'>conn</span> = &amp;ADONewConnection('mysql');<span style='mso-spacerun:yes'>&nbsp; </span># create a connection<br>
    3482. 

  3482. $<span style='color:#663300'>conn</span>-&gt;PConnect('localhost','userid','','agora');# connect to MySQL, agora db<br>
    3483. 

  3483. $<span style='color:#663300'>sql</span> = 'select CustomerName, CustomerID from customers';<br>
    3484. 

  3484. $<span style='color:#663300'>rs</span> = $<span style='color:#663300'>conn</span>-&gt;CacheExecute(15,$sql);</pre></div>
    3485. 

  3485. 

  3486. <p>The first parameter is the number of seconds to cache the query. Subsequent
    3487. 

  3487. calls to that query will used the cached version stored in $ADODB_CACHE_DIR. To
    3488. 

  3488. force a query to execute and flush the cache, call CacheExecute() with the
    3489. 

  3489. first parameter set to zero. Alternatively, use the CacheFlush($sql) call. </p>
    3490. 

  3490. 

  3491. <p>For the sake of security, we recommend you set <i>register_globals=off</i> in
    3492. 

  3492. php.ini if you are using $ADODB_CACHE_DIR.</p>
    3493. 

  3493. 

  3494. <p>In ADOdb 1.80 onwards, the secs2cache parameter is optional in
    3495. 

  3495. CacheSelectLimit() and CacheExecute(). If you leave it out, it will use the
    3496. 

  3496. $connection-&gt;cacheSecs parameter, which defaults to 60 minutes. The following
    3497. 

  3497. are equivalent: </p>
    3498. 

  3498. 

  3499. <div style='mso-element:para-border-div;border:solid #DDDDDD 1.0pt;mso-border-alt:
    3500. 

  3500. solid #DDDDDD .75pt;padding:9.0pt 18.0pt 9.0pt 18.0pt;background:#EEEEEE'><pre><o:p>&nbsp;</o:p></pre><pre><span style='mso-spacerun:yes'>&nbsp; </span># (1)</pre><pre><span style='mso-spacerun:yes'>&nbsp; </span>$rs = $db-&gt;SelectLimit(30, 'select * from table', 10);</pre><pre><span style='mso-spacerun:yes'>&nbsp; </span></pre><pre><span style='mso-spacerun:yes'>&nbsp;&nbsp;</span># (2)</pre><pre><span style='mso-spacerun:yes'>&nbsp; </span>$db-&gt;cacheSsecs = 30;</pre><pre><span style='mso-spacerun:yes'>&nbsp; </span>$rs = $db-&gt;SelectLimit('select * from table', 10);</pre><pre
    3501. 

  3501. style='background:#EEEEEE'><span style='mso-spacerun:yes'>&nbsp; </span></pre><pre><span
    3502. 

  3502. style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$conn-&gt;Connect(...);<br>
    3503. 

  3503. <span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$conn-&gt;cacheSecs = 3600*24; # cache 24 hours<br>
    3504. 

  3504. <span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$rs = $conn-&gt;CacheExecute('select * from table');</pre></div>
    3505. 

  3505. 

  3506. <p>Please note that magic_quotes_runtime should be turned off. Do not change
    3507. 

  3507. $ADODB_FETCH_MODE (or SetFetchMode) as the cached recordset will use the
    3508. 

  3508. $ADODB_FETCH_MODE set when the query was executed. <a name=memcache></a></p>
    3509. 

  3509. 

  3510. <h3><span style='mso-bookmark:memcache'>MemCache support</span></h3>
    3511. 

  3511. 

  3512. <p><span style='mso-bookmark:memcache'>You can also share cached recordsets on
    3513. 

  3513. a memcache server. The memcache API supports one or more pooled hosts. Only if
    3514. 

  3514. none of the pooled servers can be contacted will a connect error be generated.
    3515. 

  3515. Example below: </span></p>
    3516. 

  3516. 

  3517. <div style='mso-element:para-border-div;border:solid #DDDDDD 1.0pt;mso-border-alt:
    3518. 

  3518. solid #DDDDDD .75pt;padding:9.0pt 18.0pt 9.0pt 18.0pt;background:#EEEEEE'><pre><span
    3519. 

  3519. style='mso-bookmark:memcache'><o:p>&nbsp;</o:p></span></pre><pre><span
    3520. 

  3520. style='mso-bookmark:memcache'>$db = NewADOConnection($driver='mysql');</span></pre><pre><span
    3521. 

  3521. style='mso-bookmark:memcache'>$db-&gt;memCache = true;</span></pre><pre><span
    3522. 

  3522. style='mso-bookmark:memcache'>$db-&gt;memCacheHost = array($ip1, $ip2, $ip3); /// $db-&gt;memCacheHost = $ip1; will work too</span></pre><pre><span
    3523. 

  3523. style='mso-bookmark:memcache'>$db-&gt;memCachePort = 11211; /// this is default memCache port</span></pre><pre><span
    3524. 

  3524. style='mso-bookmark:memcache'>$db-&gt;memCacheCompress = false; /// Use 'true' to store the item compressed (uses zlib)</span></pre><pre><span
    3525. 

  3525. style='mso-bookmark:memcache'><o:p>&nbsp;</o:p></span></pre><pre><span
    3526. 

  3526. style='mso-bookmark:memcache'>$db-&gt;Connect(...);</span></pre><pre><span
    3527. 

  3527. style='mso-bookmark:memcache'>$db-&gt;CacheExecute($sql);</span></pre></div>
    3528. 

  3528. 

  3529. <p><span style='mso-bookmark:memcache'>More info on memcache can be found at </span><a
    3530. 

  3530. href="http://www.danga.com/memcached/">http://www.danga.com/memcached/</a>. <a
    3531. 

  3531. name=cacheapi></a></p>
    3532. 

  3532. 

  3533. <h3><span style='mso-bookmark:cacheapi'>Caching API</span></h3>
    3534. 

  3534. 

  3535. <p><span style='mso-bookmark:cacheapi'>There is also a caching API since
    3536. 

  3536. 4.99/5.05. Two implementations of the API are already available providing file
    3537. 

  3537. and memcache support. </span></p>
    3538. 

  3538. 

  3539. <p><span style='mso-bookmark:cacheapi'>The new API for creating your custom
    3540. 

  3540. caching class uses 2 globals: </span></p>
    3541. 

  3541. 

  3542. <ul type=disc>
    3543. 

  3543.  <li class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
    3544. 

  3544.      mso-list:l8 level1 lfo8;tab-stops:list 36.0pt'><span style='mso-bookmark:
    3545. 

  3545.      cacheapi'>$ADODB_CACHE_CLASS: name of caching class </span></li>
    3546. 

  3546.  <li class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
    3547. 

  3547.      mso-list:l8 level1 lfo8;tab-stops:list 36.0pt'><span style='mso-bookmark:
    3548. 

  3548.      cacheapi'>$ADODB_CACHE: instance of $ADODB_CACHE_CLASS </span></li>
    3549. 

  3549. </ul>
    3550. 

  3550. 

  3551. <div style='mso-element:para-border-div;border:solid #DDDDDD 1.0pt;mso-border-alt:
    3552. 

  3552. solid #DDDDDD .75pt;padding:9.0pt 18.0pt 9.0pt 18.0pt;background:#EEEEEE'><pre><span
    3553. 

  3553. style='mso-bookmark:cacheapi'><o:p>&nbsp;</o:p></span></pre><pre><span
    3554. 

  3554. style='mso-bookmark:cacheapi'>include &quot;/path/to/adodb.inc.php&quot;;</span></pre><pre><span
    3555. 

  3555. style='mso-bookmark:cacheapi'>$ADODB_CACHE_CLASS = 'MyCacheClass';</span></pre><pre><span
    3556. 

  3556. style='mso-bookmark:cacheapi'><o:p>&nbsp;</o:p></span></pre><pre><span
    3557. 

  3557. style='mso-bookmark:cacheapi'>class MyCacheClass extends ADODB_Cache_File</span></pre><pre><span
    3558. 

  3558. style='mso-bookmark:cacheapi'>{</span></pre><pre><span style='mso-bookmark:
    3559. 

  3559. cacheapi'><span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>var $createdir = false; // do not set this to true unless you use temp directories in cache path</span></pre><pre><span
    3560. 

  3560. style='mso-bookmark:cacheapi'><span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>function writecache($filename, $contents,$debug=false){...}</span></pre><pre><span
    3561. 

  3561. style='mso-bookmark:cacheapi'><span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>function &amp;readcache($filename, &amp;$err, $secs2cache, $rsClass){ ...}</span></pre><pre><span
    3562. 

  3562. style='mso-bookmark:cacheapi'><span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span> :</span></pre><pre><span
    3563. 

  3563. style='mso-bookmark:cacheapi'>}</span></pre><pre><span style='mso-bookmark:
    3564. 

  3564. cacheapi'><o:p>&nbsp;</o:p></span></pre><pre><span style='mso-bookmark:cacheapi'>$DB = NewADOConnection($driver);</span></pre><pre><span
    3565. 

  3565. style='mso-bookmark:cacheapi'>$DB-&gt;Connect(...);<span style='mso-spacerun:yes'>&nbsp; </span>## MyCacheClass created here and stored in $ADODB_CACHE global variable.</span></pre><pre><span
    3566. 

  3566. style='mso-bookmark:cacheapi'><o:p>&nbsp;</o:p></span></pre><pre><span
    3567. 

  3567. style='mso-bookmark:cacheapi'>$data = $rs-&gt;CacheGetOne($sql); ## MyCacheClass is used here for caching...</span></pre></div>
    3568. 

  3568. 

  3569. <span style='mso-bookmark:cacheapi'></span>
    3570. 

  3570. 

  3571. <h2><a name=pivot></a>Pivot Tables</h2>
    3572. 

  3572. 

  3573. <p>Since ADOdb 2.30, we support the generation of SQL to create pivot tables,
    3574. 

  3574. also known as cross-tabulations. For further explanation read this DevShed <a
    3575. 

  3575. href="http://www.devshed.com/c/a/MySQL/MySQL-wizardry/1/">Cross-Tabulation tutorial</a>.
    3576. 

  3576. We assume that your database supports the SQL case-when expression. </p>
    3577. 

  3577. 

  3578. <p>In this example, we will use the Northwind database from Microsoft. In the
    3579. 

  3579. database, we have a products table, and we want to analyze this table by <i>suppliers
    3580. 

  3580. versus product categories</i>. We will place the suppliers on each row, and
    3581. 

  3581. pivot on categories. So from the table on the left, we generate the pivot-table
    3582. 

  3582. on the right:</p>
    3583. 

  3583. 

  3584. <div align=center>
    3585. 

  3585. 

  3586. <table class=MsoNormalTable border=0 cellpadding=0 style='mso-cellspacing:1.5pt;
    3587. 

  3587.  mso-padding-alt:1.5pt 1.5pt 1.5pt 1.5pt'>
    3588. 

  3588.  <tr style='mso-yfti-irow:0;mso-yfti-firstrow:yes;mso-yfti-lastrow:yes'>
    3589. 

  3589.   <td style='padding:1.5pt 1.5pt 1.5pt 1.5pt'>
    3590. 

  3590.   <div align=center>
    3591. 

  3591.   <table class=MsoNormalTable border=1 cellpadding=0 width=142
    3592. 

  3592.    style='width:106.5pt;mso-cellspacing:1.5pt;mso-padding-alt:1.5pt 1.5pt 1.5pt 1.5pt'>
    3593. 

  3593.    <tr style='mso-yfti-irow:0;mso-yfti-firstrow:yes'>
    3594. 

  3594.     <td style='padding:1.5pt 1.5pt 1.5pt 1.5pt'>
    3595. 

  3595.     <p class=MsoNormal><i>Supplier</i></p>
    3596. 

  3596.     </td>
    3597. 

  3597.     <td style='padding:1.5pt 1.5pt 1.5pt 1.5pt'>
    3598. 

  3598.     <p class=MsoNormal><i>Category</i></p>
    3599. 

  3599.     </td>
    3600. 

  3600.    </tr>
    3601. 

  3601.    <tr style='mso-yfti-irow:1'>
    3602. 

  3602.     <td style='padding:1.5pt 1.5pt 1.5pt 1.5pt'>
    3603. 

  3603.     <p class=MsoNormal>supplier1</p>
    3604. 

  3604.     </td>
    3605. 

  3605.     <td style='padding:1.5pt 1.5pt 1.5pt 1.5pt'>
    3606. 

  3606.     <p class=MsoNormal>category1</p>
    3607. 

  3607.     </td>
    3608. 

  3608.    </tr>
    3609. 

  3609.    <tr style='mso-yfti-irow:2'>
    3610. 

  3610.     <td style='padding:1.5pt 1.5pt 1.5pt 1.5pt'>
    3611. 

  3611.     <p class=MsoNormal>supplier2</p>
    3612. 

  3612.     </td>
    3613. 

  3613.     <td style='padding:1.5pt 1.5pt 1.5pt 1.5pt'>
    3614. 

  3614.     <p class=MsoNormal>category1</p>
    3615. 

  3615.     </td>
    3616. 

  3616.    </tr>
    3617. 

  3617.    <tr style='mso-yfti-irow:3;mso-yfti-lastrow:yes'>
    3618. 

  3618.     <td style='padding:1.5pt 1.5pt 1.5pt 1.5pt'>
    3619. 

  3619.     <p class=MsoNormal>supplier2</p>
    3620. 

  3620.     </td>
    3621. 

  3621.     <td style='padding:1.5pt 1.5pt 1.5pt 1.5pt'>
    3622. 

  3622.     <p class=MsoNormal>category2</p>
    3623. 

  3623.     </td>
    3624. 

  3624.    </tr>
    3625. 

  3625.   </table>
    3626. 

  3626.   </div>
    3627. 

  3627.   <p class=MsoNormal><o:p></o:p></p>
    3628. 

  3628.   </td>
    3629. 

  3629.   <td style='padding:1.5pt 1.5pt 1.5pt 1.5pt'>
    3630. 

  3630.   <p class=MsoNormal><span style='font-family:"Courier New"'>--&gt;</span></p>
    3631. 

  3631.   </td>
    3632. 

  3632.   <td style='padding:1.5pt 1.5pt 1.5pt 1.5pt'>
    3633. 

  3633.   <div align=center>
    3634. 

  3634.   <table class=MsoNormalTable border=1 cellpadding=0 style='mso-cellspacing:
    3635. 

  3635.    1.5pt;mso-padding-alt:1.5pt 1.5pt 1.5pt 1.5pt'>
    3636. 

  3636.    <tr style='mso-yfti-irow:0;mso-yfti-firstrow:yes'>
    3637. 

  3637.     <td style='padding:1.5pt 1.5pt 1.5pt 1.5pt'>
    3638. 

  3638.     <p class=MsoNormal>&nbsp;</p>
    3639. 

  3639.     </td>
    3640. 

  3640.     <td style='padding:1.5pt 1.5pt 1.5pt 1.5pt'>
    3641. 

  3641.     <p class=MsoNormal><i>category1</i></p>
    3642. 

  3642.     </td>
    3643. 

  3643.     <td style='padding:1.5pt 1.5pt 1.5pt 1.5pt'>
    3644. 

  3644.     <p class=MsoNormal><i>category2</i></p>
    3645. 

  3645.     </td>
    3646. 

  3646.     <td style='padding:1.5pt 1.5pt 1.5pt 1.5pt'>
    3647. 

  3647.     <p class=MsoNormal><i>total</i></p>
    3648. 

  3648.     </td>
    3649. 

  3649.    </tr>
    3650. 

  3650.    <tr style='mso-yfti-irow:1'>
    3651. 

  3651.     <td style='padding:1.5pt 1.5pt 1.5pt 1.5pt'>
    3652. 

  3652.     <p class=MsoNormal><i>supplier1</i></p>
    3653. 

  3653.     </td>
    3654. 

  3654.     <td style='padding:1.5pt 1.5pt 1.5pt 1.5pt'>
    3655. 

  3655.     <p class=MsoNormal align=right style='text-align:right'>1</p>
    3656. 

  3656.     </td>
    3657. 

  3657.     <td style='padding:1.5pt 1.5pt 1.5pt 1.5pt'>
    3658. 

  3658.     <p class=MsoNormal align=right style='text-align:right'>0</p>
    3659. 

  3659.     </td>
    3660. 

  3660.     <td style='padding:1.5pt 1.5pt 1.5pt 1.5pt'>
    3661. 

  3661.     <p class=MsoNormal align=right style='text-align:right'>1</p>
    3662. 

  3662.     </td>
    3663. 

  3663.    </tr>
    3664. 

  3664.    <tr style='mso-yfti-irow:2;mso-yfti-lastrow:yes'>
    3665. 

  3665.     <td style='padding:1.5pt 1.5pt 1.5pt 1.5pt'>
    3666. 

  3666.     <p class=MsoNormal><i>supplier2</i></p>
    3667. 

  3667.     </td>
    3668. 

  3668.     <td style='padding:1.5pt 1.5pt 1.5pt 1.5pt'>
    3669. 

  3669.     <p class=MsoNormal align=right style='text-align:right'>1</p>
    3670. 

  3670.     </td>
    3671. 

  3671.     <td style='padding:1.5pt 1.5pt 1.5pt 1.5pt'>
    3672. 

  3672.     <p class=MsoNormal align=right style='text-align:right'>1</p>
    3673. 

  3673.     </td>
    3674. 

  3674.     <td style='padding:1.5pt 1.5pt 1.5pt 1.5pt'>
    3675. 

  3675.     <p class=MsoNormal align=right style='text-align:right'>2</p>
    3676. 

  3676.     </td>
    3677. 

  3677.    </tr>
    3678. 

  3678.   </table>
    3679. 

  3679.   </div>
    3680. 

  3680.   <p class=MsoNormal><o:p></o:p></p>
    3681. 

  3681.   </td>
    3682. 

  3682.  </tr>
    3683. 

  3683. </table>
    3684. 

  3684. 

  3685. </div>
    3686. 

  3686. 

  3687. <p>The following code will generate the SQL for a cross-tabulation: </p>
    3688. 

  3688. 

  3689. <div style='mso-element:para-border-div;border:solid #DDDDDD 1.0pt;mso-border-alt:
    3690. 

  3690. solid #DDDDDD .75pt;padding:9.0pt 18.0pt 9.0pt 18.0pt;background:#EEEEEE'><pre
    3691. 

  3691. style='background:#EEEEEE'># Query the main &quot;product&quot; table<br>
    3692. 

  3692. # Set the rows to SupplierName<br>
    3693. 

  3693. # and the columns to the values of Categories<br>
    3694. 

  3694. # and define the joins to link to lookup tables <br>
    3695. 

  3695. # &quot;categories&quot; and &quot;suppliers&quot;<br>
    3696. 

  3696. #<br>
    3697. 

  3697. <span style='mso-spacerun:yes'>&nbsp;</span>include &quot;adodb/pivottable.inc.php&quot;;<br>
    3698. 

  3698. <span style='mso-spacerun:yes'>&nbsp;</span>$sql = PivotTableSQL(<br>
    3699. 

  3699. <span style='mso-spacerun:yes'>&nbsp;</span><span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$gDB,<span style='mso-spacerun:yes'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span># adodb connection<br>
    3700. 

  3700. <span style='mso-spacerun:yes'>&nbsp;</span><span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>'products p ,categories c ,suppliers s',<span style='mso-spacerun:yes'>&nbsp;&nbsp; </span># tables<br>
    3701. 

  3701. <span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>'SupplierName',<span style='mso-spacerun:yes'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span># rows (multiple fields allowed)<br>
    3702. 

  3702. <span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>'CategoryName',<span style='mso-spacerun:yes'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span># column to pivot on <br>
    3703. 

  3703. <span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>'p.CategoryID = c.CategoryID and s.SupplierID= p.SupplierID' # joins/where<br>
    3704. 

  3704. );</pre></div>
    3705. 

  3705. 

  3706. <p>This will generate the following SQL:</p>
    3707. 

  3707. 

  3708. <p><code><span style='font-size:10.0pt'>SELECT SupplierName, </span></code><span
    3709. 

  3709. style='font-size:10.0pt;font-family:"Courier New"'><br>
    3710. 

  3710. <code>SUM(CASE WHEN CategoryName='Beverages' THEN 1 ELSE 0 END) AS
    3711. 

  3711. &quot;Beverages&quot;, </code><br>
    3712. 

  3712. <code>SUM(CASE WHEN CategoryName='Condiments' THEN 1 ELSE 0 END) AS
    3713. 

  3713. &quot;Condiments&quot;, </code><br>
    3714. 

  3714. <code>SUM(CASE WHEN CategoryName='Confections' THEN 1 ELSE 0 END) AS
    3715. 

  3715. &quot;Confections&quot;, </code><br>
    3716. 

  3716. <code>SUM(CASE WHEN CategoryName='Dairy Products' THEN 1 ELSE 0 END) AS
    3717. 

  3717. &quot;Dairy Products&quot;, </code><br>
    3718. 

  3718. <code>SUM(CASE WHEN CategoryName='Grains/Cereals' THEN 1 ELSE 0 END) AS
    3719. 

  3719. &quot;Grains/Cereals&quot;, </code><br>
    3720. 

  3720. <code>SUM(CASE WHEN CategoryName='Meat/Poultry' THEN 1 ELSE 0 END) AS
    3721. 

  3721. &quot;Meat/Poultry&quot;, </code><br>
    3722. 

  3722. <code>SUM(CASE WHEN CategoryName='Produce' THEN 1 ELSE 0 END) AS
    3723. 

  3723. &quot;Produce&quot;, </code><br>
    3724. 

  3724. <code>SUM(CASE WHEN CategoryName='Seafood' THEN 1 ELSE 0 END) AS
    3725. 

  3725. &quot;Seafood&quot;, </code><br>
    3726. 

  3726. <code>SUM(1) as Total </code><br>
    3727. 

  3727. <code>FROM products p ,categories c ,suppliers s WHERE p.CategoryID =
    3728. 

  3728. c.CategoryID and s.SupplierID= p.SupplierID </code><br>
    3729. 

  3729. <code>GROUP BY SupplierName</code></span></p>
    3730. 

  3730. 

  3731. <p>You can also pivot on <i>numerical columns</i> and <i>generate totals</i> by
    3732. 

  3732. using ranges. This code was revised in ADODB 2.41 and is not backward
    3733. 

  3733. compatible. The second example shows this:</p>
    3734. 

  3734. 

  3735. <div style='mso-element:para-border-div;border:solid #DDDDDD 1.0pt;mso-border-alt:
    3736. 

  3736. solid #DDDDDD .75pt;padding:9.0pt 18.0pt 9.0pt 18.0pt;background:#EEEEEE'><pre><span style='mso-spacerun:yes'>&nbsp;</span>$sql = PivotTableSQL(<br>
    3737. 

  3737. <span style='mso-spacerun:yes'>&nbsp;</span><span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$gDB,<span style='mso-spacerun:yes'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span># adodb connection<br>
    3738. 

  3738. <span style='mso-spacerun:yes'>&nbsp;</span><span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>'products p ,categories c ,suppliers s',<span style='mso-spacerun:yes'>&nbsp;&nbsp;&nbsp; </span># tables<br>
    3739. 

  3739. <span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>'SupplierName',<span style='mso-spacerun:yes'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span># rows (multiple fields allowed)</pre><pre><span style='mso-spacerun:yes'>&nbsp;&nbsp; </span>array(<span style='mso-spacerun:yes'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span><span style='mso-spacerun:yes'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span># column ranges</pre><pre><span
    3740. 

  3740. style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>' 0 '<span style='mso-spacerun:yes'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>=&gt; 'UnitsInStock &lt;= 0',</pre><pre><span
    3741. 

  3741. style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>&quot;1 to 5&quot;<span style='mso-spacerun:yes'>&nbsp;&nbsp; </span>=&gt; '0 &lt; UnitsInStock and UnitsInStock &lt;= 5',</pre><pre><span
    3742. 

  3742. style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>&quot;6 to 10&quot;<span style='mso-spacerun:yes'>&nbsp; </span>=&gt; '5 &lt; UnitsInStock and UnitsInStock &lt;= 10',</pre><pre><span
    3743. 

  3743. style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>&quot;11 to 15&quot; =&gt; '10 &lt; UnitsInStock and UnitsInStock &lt;= 15',</pre><pre><span
    3744. 

  3744. style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>&quot;16+&quot;<span style='mso-spacerun:yes'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>=&gt; '15 &lt; UnitsInStock'</pre><pre><span
    3745. 

  3745. style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>),</pre><pre><span style='mso-tab-count:
    3746. 

  3746. 1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>' p.CategoryID = c.CategoryID and s.SupplierID= p.SupplierID', # joins/where</pre><pre><span
    3747. 

  3747. style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>'UnitsInStock',<span style='mso-spacerun:yes'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span># sum this field</pre><pre><span
    3748. 

  3748. style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>'Sum '<span style='mso-spacerun:yes'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span># sum label prefix</pre><pre>);</pre></div>
    3749. 

  3749. 

  3750. <p>Which generates: </p>
    3751. 

  3751. 

  3752. <p><code><span style='font-size:10.0pt'>SELECT SupplierName, </span></code><span
    3753. 

  3753. style='font-size:10.0pt;font-family:"Courier New"'><br>
    3754. 

  3754. <code>SUM(CASE WHEN UnitsInStock &lt;= 0 THEN UnitsInStock ELSE 0 END) AS
    3755. 

  3755. &quot;Sum 0 &quot;, </code><br>
    3756. 

  3756. <code>SUM(CASE WHEN 0 &lt; UnitsInStock and UnitsInStock &lt;= 5 THEN
    3757. 

  3757. UnitsInStock ELSE 0 END) AS &quot;Sum 1 to 5&quot;,</code><br>
    3758. 

  3758. <code>SUM(CASE WHEN 5 &lt; UnitsInStock and UnitsInStock &lt;= 10 THEN UnitsInStock
    3759. 

  3759. ELSE 0 END) AS &quot;Sum 6 to 10&quot;,</code><br>
    3760. 

  3760. <code>SUM(CASE WHEN 10 &lt; UnitsInStock and UnitsInStock &lt;= 15 THEN
    3761. 

  3761. UnitsInStock ELSE 0 END) AS &quot;Sum 11 to 15&quot;, </code><br>
    3762. 

  3762. <code>SUM(CASE WHEN 15 &lt; UnitsInStock THEN UnitsInStock ELSE 0 END) AS
    3763. 

  3763. &quot;Sum 16+&quot;, </code><br>
    3764. 

  3764. <code>SUM(UnitsInStock) AS &quot;Sum UnitsInStock&quot;, </code><br>
    3765. 

  3765. <code>SUM(1) as Total,</code><br>
    3766. 

  3766. <code>FROM products p ,categories c ,suppliers s WHERE p.CategoryID =
    3767. 

  3767. c.CategoryID and s.SupplierID= p.SupplierID </code><br>
    3768. 

  3768. <code>GROUP BY SupplierName</code></span></p>
    3769. 

  3769. 

  3770. <div class=MsoNormal align=center style='text-align:center'>
    3771. 

  3771. 

  3772. <hr size=2 width="100%" align=center>
    3773. 

  3773. 

  3774. </div>
    3775. 

  3775. 

  3776. <h1>Class Reference<a name=ref></a></h1>
    3777. 

  3777. 

  3778. <p>Function parameters with [ ] around them are optional.</p>
    3779. 

  3779. 

  3780. <h2>Global Variables</h2>
    3781. 

  3781. 

  3782. <h3><a name="adodb_countrecs"></a>$ADODB_COUNTRECS</h3>
    3783. 

  3783. 

  3784. <p>If the database driver API does not support counting the number of records
    3785. 

  3785. returned in a SELECT statement, the function RecordCount() is emulated when the
    3786. 

  3786. global variable $ADODB_COUNTRECS is set to true, which is the default. We
    3787. 

  3787. emulate this by buffering the records, which can take up large amounts of
    3788. 

  3788. memory for big recordsets. Set this variable to false for the best performance.
    3789. 

  3789. This variable is checked every time a query is executed, so you can selectively
    3790. 

  3790. choose which recordsets to count.</p>
    3791. 

  3791. 

  3792. <h3><a name="adodb_cache_dir"></a>$ADODB_CACHE_DIR</h3>
    3793. 

  3793. 

  3794. <p>If you are using recordset caching, this is the directory to save your
    3795. 

  3795. recordsets in. Define this before you call any caching functions such as
    3796. 

  3796. CacheExecute( ). We recommend setting <i>register_globals=off</i> in php.ini if
    3797. 

  3797. you use this feature for security reasons.</p>
    3798. 

  3798. 

  3799. <p>If you are using Unix and apache, you might need to set your cache directory
    3800. 

  3800. permissions to something similar to the following:</p>
    3801. 

  3801. 

  3802. <p>chown -R apache /path/to/adodb/cache<br>
    3803. 

  3803. chgrp -R apache /path/to/adodb/cache </p>
    3804. 

  3804. 

  3805. <h3><a name="adodb_ansi_padding_off"></a>$ADODB_ANSI_PADDING_OFF</h3>
    3806. 

  3806. 

  3807. <p>Determines whether to right trim CHAR fields (and also VARCHAR for
    3808. 

  3808. ibase/firebird). Set to true to trim. Default is false. Currently works for
    3809. 

  3809. oci8po, ibase and firebird drivers. Added in ADOdb 4.01. </p>
    3810. 

  3810. 

  3811. <h3><a name="adodb_lang"></a>$ADODB_LANG</h3>
    3812. 

  3812. 

  3813. <p>Determines the language used in MetaErrorMsg(). The default is 'en', for
    3814. 

  3814. English. To find out what languages are supported, see the files in
    3815. 

  3815. adodb/lang/adodb-$lang.inc.php, where $lang is the supported langauge. </p>
    3816. 

  3816. 

  3817. <h3><a name="adodb_fetch_mode"></a>$ADODB_FETCH_MODE</h3>
    3818. 

  3818. 

  3819. <p>This is a global variable that determines how arrays are retrieved by recordsets.
    3820. 

  3820. The recordset saves this value on creation (eg. in Execute( ) or SelectLimit(
    3821. 

  3821. )), and any subsequent changes to $ADODB_FETCH_MODE have no affect on existing
    3822. 

  3822. recordsets, only on recordsets created in the future.</p>
    3823. 

  3823. 

  3824. <p>The following constants are defined:</p>
    3825. 

  3825. 

  3826. <ul>
    3827. 

  3827.     <li>ADODB_FETCH_DEFAULT = 0</li>
    3828. 

  3828.     <li>ADODB_FETCH_NUM = 1</li>
    3829. 

  3829.     <li>ADODB_FETCH_ASSOC = 2</li>
    3830. 

  3830.     <li>ADODB_FETCH_BOTH = 3</li>
    3831. 

  3831. </ul>
    3832. 

  3832. 

  3833. <p>An example: </p>
    3834. 

  3834. 

  3835. <div style='mso-element:para-border-div;border:solid #DDDDDD 1.0pt;mso-border-alt:
    3836. 

  3836. solid #DDDDDD .75pt;padding:9.0pt 18.0pt 9.0pt 18.0pt;background:#EEEEEE'><pre><span
    3837. 

  3837. style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$ADODB_<b>FETCH_MODE</b> = ADODB_FETCH_NUM;<br>
    3838. 

  3838. <span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$rs1 = $db-&gt;Execute('select * from table');<br>
    3839. 

  3839. <span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$ADODB_<b>FETCH_MODE</b> = ADODB_FETCH_ASSOC;<br>
    3840. 

  3840. <span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$rs2 = $db-&gt;Execute('select * from table');<br>
    3841. 

  3841. <span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>print_r($rs1-&gt;fields); # shows <i>array([0]=&gt;'v0',[1] =&gt;'v1')</i></pre><pre><span
    3842. 

  3842. style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>print_r($rs2-&gt;fields); # shows <i>array(['col1']=&gt;'v0',['col2'] =&gt;'v1')</i></pre></div>
    3843. 

  3843. 

  3844. <p>As you can see in the above example, both recordsets store and use different
    3845. 

  3845. fetch modes based on the $ADODB_FETCH_MODE setting when the recordset was
    3846. 

  3846. created by Execute().</p>
    3847. 

  3847. 

  3848. <p>If no fetch mode is predefined, it defaults to
    3849. 

  3849. ADODB_FETCH_DEFAULT. The behaviour of this mode varies from driver to
    3850. 

  3850. driver, so do for portability reasons it is discouraged to rely on
    3851. 

  3851. ADODB_FETCH_DEFAULT; stick to ADODB_FETCH_NUM or ADODB_FETCH_ASSOC instead.
    3852. 

  3852. Note that many drivers do not support ADODB_FETCH_BOTH.</p>
    3853. 

  3853. 

  3854. <p><strong>SetFetchMode Function</strong></p>
    3855. 

  3855. 

  3856. <p>If you have multiple connection objects, and want to have different fetch
    3857. 

  3857. modes for each connection, then use <a href="#setfetchmode">SetFetchMode</a>.
    3858. 

  3858. Once this function is called for a connection object, that connection object
    3859. 

  3859. will ignore the global variable $ADODB_FETCH_MODE and will use the internal
    3860. 

  3860. fetchMode property exclusively.</p>
    3861. 

  3861. 

  3862. <div style='mso-element:para-border-div;border:solid #DDDDDD 1.0pt;mso-border-alt:
    3863. 

  3863. solid #DDDDDD .75pt;padding:9.0pt 18.0pt 9.0pt 18.0pt;background:#EEEEEE'><pre><span
    3864. 

  3864. style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$db-&gt;SetFetchMode(ADODB_FETCH_NUM);<br>
    3865. 

  3865. <span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$rs1 = $db-&gt;Execute('select * from table');<br>
    3866. 

  3866. <span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$db-&gt;SetFetchMode(ADODB_FETCH_ASSOC);<br>
    3867. 

  3867. <span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$rs2 = $db-&gt;Execute('select * from table');<br>
    3868. 

  3868. <span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>print_r($rs1-&gt;fields); # shows <i>array([0]=&gt;'v0',[1] =&gt;'v1')</i></pre><pre
    3869. 

  3869. style='background:#EEEEEE'><span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>print_r($rs2-&gt;fields); # shows <i>array(['col1']=&gt;'v0',['col2'] =&gt;'v1')</i></pre></div>
    3870. 

  3870. 

  3871. <p>To retrieve the previous fetch mode, you can use check the $db-&gt;fetchMode
    3872. 

  3872. property, or use the return value of SetFetchMode( ). </p>
    3873. 

  3873. 

  3874. <p><a name="adodb_assoc_case"></a><strong>ADODB_ASSOC_CASE</strong></p>
    3875. 

  3875. 

  3876. <p>You can control the associative fetch case for certain drivers which behave
    3877. 

  3877. differently. For the <i>sybase, oci8, mssql, odbc and ibase</i> drivers (including
    3878. 

  3878. all those derived from them). Define the ADODB_ASSOC_CASE constant as appropriate to
    3879. 

  3879. change the case of the keys. The default is to use native case. Possible values are:</p>
    3880. 

  3880. 

  3881. <ul>
    3882. 

  3882.     <li>ADODB_ASSOC_CASE_LOWER = 0 - $rs->fields['orderid']</li>
    3883. 

  3883.     <li>ADODB_ASSOC_CASE_UPPER = 1 - $rs->fields['ORDERID']</li>
    3884. 

  3884.     <li>ADODB_ASSOC_CASE_NATIVE = 2 - $rs->fields['OrderID'] (or whatever the RDBMS will return)</li>
    3885. 

  3885. </ul>
    3886. 

  3886. 

  3887. <p>Example: <pre>
    3888. 

  3888. include('adodb.inc.php');
    3889. 

  3889. define('ADODB_ASSOC_CASE', ADODB_ASSOC_CASE_LOWER);
    3890. 

  3890. </pre></p>
    3891. 

  3891. 

  3892. <h3><a name="force_type"></a>$ADODB_FORCE_TYPE</h3>
    3893. 

  3893. 

  3894. <p>See the <a href="#ADODB_FORCE_TYPE">GetUpdateSQL tutorial</a>. </p>
    3895. 

  3895. 

  3896. <h3><a name="adodb_auto_quote"></a>$ADODB_QUOTE_FIELDNAMES</h3>
    3897. 

  3897. 

  3898. <p>Auto-quotes field names when using AutoExecute() when set to true. </p>
    3899. 

  3899. <p>Since 5.13, if $ADODB_QUOTE_FIELDNAMES is set to:
    3900. 

  3900. <ul>
    3901. 

  3901. <li>'UPPER' or true: uppercase field names. This is the default.
    3902. 

  3902. <li>'NATIVE' : use native case.
    3903. 

  3903. <li>'LOWER': lowercase field names.
    3904. 

  3904. </ul>
    3905. 

  3905. <p>&nbsp;</p>
    3906. 

  3906. 

  3907. <div class=MsoNormal align=center style='text-align:center'>
    3908. 

  3908. 

  3909. <hr size=2 width="100%" align=center>
    3910. 

  3910. 

  3911. </div>
    3912. 

  3912. 

  3913. <h2>ADOConnection<a name=adoconnection></a></h2>
    3914. 

  3914. 

  3915. <p>Object that performs the connection to the database, executes SQL statements
    3916. 

  3916. and has a set of utility functions for standardising the format of SQL
    3917. 

  3917. statements for issues such as concatenation and date formats.</p>
    3918. 

  3918. 

  3919. <h3>ADOConnection Fields</h3>
    3920. 

  3920. 

  3921. <p><b>databaseType</b>: Name of the database system we are connecting to. Eg. <b>odbc</b>
    3922. 

  3922. or <b>mssql</b> or <b>mysql</b>.</p>
    3923. 

  3923. 

  3924. <p><b>dataProvider</b>: The underlying mechanism used to connect to the
    3925. 

  3925. database. Normally set to <b>native</b>, unless using <b>odbc</b> or <b>ado</b>.</p>
    3926. 

  3926. 

  3927. <p><b>host: </b>Name of server or data source name (DSN) to connect to.</p>
    3928. 

  3928. 

  3929. <p><b>database</b>: Name of the database or to connect to. If ado is used, it
    3930. 

  3930. will hold the ado data provider.</p>
    3931. 

  3931. 

  3932. <p><b>user</b>: Login id to connect to database. Password is not saved for
    3933. 

  3933. security reasons.</p>
    3934. 

  3934. 

  3935. <p><b>raiseErrorFn</b>: Allows you to define an error handling function. See
    3936. 

  3936. adodb-errorhandler.inc.php for an example.</p>
    3937. 

  3937. 

  3938. <p><b>debug</b>: Set to <i>true</i> to make debug statements. Set to -99 to only display errors. Set to 99 to display debug statements and add a backtrace.</p>
    3939. 

  3939. 

  3940. <p><b>concat_operator</b>: Set to '+' or '||' normally. The operator used to
    3941. 

  3941. concatenate strings in SQL. Used by the <b><a href="#concat">Concat</a></b>
    3942. 

  3942. function.</p>
    3943. 

  3943. 

  3944. <p><b>fmtDate</b>: The format used by the <b><a href="#dbdate">DBDate</a></b>
    3945. 

  3945. function to send dates to the database. is '#Y-m-d#' for Microsoft Access, and
    3946. 

  3946. ''Y-m-d'' for MySQL.</p>
    3947. 

  3947. 

  3948. <p><b>fmtTimeStamp: </b>The format used by the <b><a href="#dbtimestamp">DBTimeStamp</a></b>
    3949. 

  3949. function to send timestamps to the database. </p>
    3950. 

  3950. 

  3951. <p><b>true</b>: The value used to represent true.Eg. '.T.'. for Foxpro, '1' for
    3952. 

  3952. Microsoft SQL.</p>
    3953. 

  3953. 

  3954. <p><b>false: </b>The value used to represent false. Eg. '.F.'. for Foxpro, '0'
    3955. 

  3955. for Microsoft SQL.</p>
    3956. 

  3956. 

  3957. <p><b>replaceQuote</b>: The string used to escape quotes. Eg. double
    3958. 

  3958. single-quotes for Microsoft SQL, and backslash-quote for MySQL. Used by <a
    3959. 

  3959. href="#qstr">qstr</a>.</p>
    3960. 

  3960. 

  3961. <p><b>autoCommit</b>: indicates whether automatic commit is enabled. Default is
    3962. 

  3962. true.</p>
    3963. 

  3963. 

  3964. <p><b>charSet</b>: set the default charset to use. Currently only
    3965. 

  3965. interbase/firebird supports this.</p>
    3966. 

  3966. 

  3967. <p><b>dialect</b>: set the default sql dialect to use. Currently only interbase/firebird
    3968. 

  3968. supports this.</p>
    3969. 

  3969. 

  3970. <p><b>role</b>: set the role. Currently only interbase/firebird supports this.</p>
    3971. 

  3971. 

  3972. <p><b>metaTablesSQL</b>: SQL statement to return a list of available tables.
    3973. 

  3973. Eg. <i>SHOW TABLES</i> in MySQL.</p>
    3974. 

  3974. 

  3975. <p><b>genID</b>: The latest id generated by GenID() if supported by the
    3976. 

  3976. database.</p>
    3977. 

  3977. 

  3978. <p><b>cacheSecs</b>: The number of seconds to cache recordsets if
    3979. 

  3979. CacheExecute() or CacheSelectLimit() omit the $secs2cache parameter. Defaults
    3980. 

  3980. to 60 minutes.</p>
    3981. 

  3981. 

  3982. <p><b>sysDate</b>: String that holds the name of the database function to call
    3983. 

  3983. to get the current date. Useful for inserts and updates.</p>
    3984. 

  3984. 

  3985. <p><b>sysTimeStamp</b>: String that holds the name of the database function to
    3986. 

  3986. call to get the current timestamp/datetime value.</p>
    3987. 

  3987. 

  3988. <p><b>leftOuter</b>: String that holds operator for left outer join, if known.
    3989. 

  3989. Otherwise set to false.</p>
    3990. 

  3990. 

  3991. <p><b>rightOuter</b>: String that holds operator for left outer join, if known.
    3992. 

  3992. Otherwise set to false.</p>
    3993. 

  3993. 

  3994. <p><b>ansiOuter</b>: Boolean that if true indicates that ANSI style outer joins
    3995. 

  3995. are permitted. Eg. <i>select * from table1 left join table2 on p1=p2.</i></p>
    3996. 

  3996. 

  3997. <p><b>connectSID</b>: Boolean that indicates whether to treat the $database
    3998. 

  3998. parameter in connects as the SID for the oci8 driver. Defaults to false. Useful
    3999. 

  3999. for Oracle 8.0.5 and earlier.</p>
    4000. 

  4000. 

  4001. <p><b>autoRollback</b>: Persistent connections are auto-rollbacked in PConnect(
    4002. 

  4002. ) if this is set to true. Default is false.</p>
    4003. 

  4003. 

  4004. <div class=MsoNormal align=center style='text-align:center'>
    4005. 

  4005. 

  4006. <hr size=2 width="100%" align=center>
    4007. 

  4007. 

  4008. </div>
    4009. 

  4009. 

  4010. <h3>ADOConnection Main Functions</h3>
    4011. 

  4011. 

  4012. <p><b>ADOConnection( )</b></p>
    4013. 

  4013. 

  4014. <p>Constructor function. Do not call this directly. Use ADONewConnection( )
    4015. 

  4015. instead.</p>
    4016. 

  4016. 

  4017. <p><b>Connect<a name=connect></a>($host,[$user],[$password],[$database])</b></p>
    4018. 

  4018. 

  4019. <p>Non-persistent connect to data source or server $<b>host</b>, using userid $<b>user
    4020. 

  4020. </b>and password $<b>password</b>. If the server supports multiple databases,
    4021. 

  4021. connect to database $<b>database</b>. </p>
    4022. 

  4022. 

  4023. <p>Returns true/false depending on connection success. Since 4.23, null is
    4024. 

  4024. returned if the extension is not loaded.</p>
    4025. 

  4025. 

  4026. <p><st1:City w:st="on"><st1:place w:st="on">ADO</st1:place></st1:City> Note: If
    4027. 

  4027. you are using a Microsoft ADO and not OLEDB, you can set the $database
    4028. 

  4028. parameter to the OLEDB data provider you are using.</p>
    4029. 

  4029. 

  4030. <p>PostgreSQL: An alternative way of connecting to the database is to pass the
    4031. 

  4031. standard PostgreSQL connection string in the first parameter $host, and the
    4032. 

  4032. other parameters will be ignored.</p>
    4033. 

  4033. 

  4034. <p>For Oracle and Oci8, there are two ways to connect. First is to use the TNS
    4035. 

  4035. name defined in your local tnsnames.ora (or ONAMES or HOSTNAMES). Place the
    4036. 

  4036. name in the $database field, and set the $host field to false. Alternatively,
    4037. 

  4037. set $host to the server, and $database to the database SID, this bypassed
    4038. 

  4038. tnsnames.ora. </p>
    4039. 

  4039. 

  4040. <p>Examples: </p>
    4041. 

  4041. 

  4042. <div style='mso-element:para-border-div;border:solid #DDDDDD 1.0pt;mso-border-alt:
    4043. 

  4043. solid #DDDDDD .75pt;padding:9.0pt 18.0pt 9.0pt 18.0pt;background:#EEEEEE'><pre
    4044. 

  4044. style='background:#EEEEEE'><span style='mso-spacerun:yes'>&nbsp;</span># $oraname in tnsnames.ora/ONAMES/HOSTNAMES<br>
    4045. 

  4045. <span style='mso-spacerun:yes'>&nbsp;</span>$conn-&gt;Connect(false, 'scott', 'tiger', $oraname); <br>
    4046. 

  4046. <span style='mso-spacerun:yes'>&nbsp;</span>$conn-&gt;Connect('server:1521', 'scott', 'tiger', 'ServiceName'); # bypass tnsnames.ora</pre></div>
    4047. 

  4047. 

  4048. <p>There are many examples of connecting to a database. See <a
    4049. 

  4049. href="#connect_ex">Connection Examples</a> for many examples. </p>
    4050. 

  4050. 

  4051. <p><b>PConnect<a name=pconnect></a>($host,[$user],[$password],[$database])</b></p>
    4052. 

  4052. 

  4053. <p>Persistent connect to data source or server $<b>host</b>, using userid $<b>user</b>
    4054. 

  4054. and password $<b>password</b>. If the server supports multiple databases,
    4055. 

  4055. connect to database $<b>database</b>.</p>
    4056. 

  4056. 

  4057. <p>We now perform a rollback on persistent connection for selected databases
    4058. 

  4058. since 2.21, as advised in the PHP manual. See change log or source code for
    4059. 

  4059. which databases are affected. </p>
    4060. 

  4060. 

  4061. <p>Returns true/false depending on connection. Since 4.23, 0 is returned if the
    4062. 

  4062. extension is not loaded. See Connect( ) above for more info.</p>
    4063. 

  4063. 

  4064. <p>Since ADOdb 2.21, we also support autoRollback. If you set:</p>
    4065. 

  4065. 

  4066. <div style='mso-element:para-border-div;border:solid #DDDDDD 1.0pt;mso-border-alt:
    4067. 

  4067. solid #DDDDDD .75pt;padding:9.0pt 18.0pt 9.0pt 18.0pt;background:#EEEEEE'><pre
    4068. 

  4068. style='background:#EEEEEE'><span style='mso-spacerun:yes'>&nbsp;</span>$conn = &amp;NewADOConnection('mysql');<br>
    4069. 

  4069. <span style='mso-spacerun:yes'>&nbsp;</span>$conn-&gt;autoRollback = true; # default is false<br>
    4070. 

  4070. <span style='mso-spacerun:yes'>&nbsp;</span>$conn-&gt;PConnect(...); # rollback here</pre></div>
    4071. 

  4071. 

  4072. <p>Then when doing a persistent connection with PConnect( ), ADOdb will perform
    4073. 

  4073. a rollback first. This is because it is documented that PHP is not guaranteed
    4074. 

  4074. to rollback existing failed transactions when persistent connections are used.
    4075. 

  4075. This is implemented in Oracle, MySQL, PgSQL, MSSQL, ODBC currently. </p>
    4076. 

  4076. 

  4077. <p>Since ADOdb 3.11, you can force non-persistent connections even if PConnect
    4078. 

  4078. is called by defining the constant ADODB_NEVER_PERSIST before you call
    4079. 

  4079. PConnect. </p>
    4080. 

  4080. 

  4081. <p>Since 4.23, null is returned if the extension is not loaded. </p>
    4082. 

  4082. 

  4083. <p><b>NConnect<a name=nconnect></a>($host,[$user],[$password],[$database])</b></p>
    4084. 

  4084. 

  4085. <p>Always force a new connection. In contrast, PHP sometimes reuses connections
    4086. 

  4086. when you use Connect() or PConnect(). Currently works only on mysql (PHP 4.3.0
    4087. 

  4087. or later), postgresql and oci8-derived drivers. For other drivers, NConnect()
    4088. 

  4088. works like Connect().</p>
    4089. 

  4089. 

  4090. <p><b>IsConnected( )</b><a name=isconnected></a></p>
    4091. 

  4091. 

  4092. <p>Returns true if connected to database. Added in 4.53. </p>
    4093. 

  4093. 

  4094. <p><b>Execute<a name=execute></a>($sql,$inputarr=false)</b></p>
    4095. 

  4095. 

  4096. <p>Execute SQL statement $<b>sql</b> and return derived class of ADORecordSet
    4097. 

  4097. if successful. Note that a record set is always returned on success, even if we
    4098. 

  4098. are executing an insert or update statement. You can also pass in $sql a
    4099. 

  4099. statement prepared in <a href="#prepare">Prepare()</a>.</p>
    4100. 

  4100. 

  4101. <p>Returns derived class of ADORecordSet. Eg. if connecting via mysql, then
    4102. 

  4102. ADORecordSet_mysql would be returned. False is returned if there was an error
    4103. 

  4103. in executing the sql.</p>
    4104. 

  4104. 

  4105. <p>The $inputarr parameter can be used for binding variables to parameters.
    4106. 

  4106. Below is an Oracle example:</p>
    4107. 

  4107. 

  4108. <div style='mso-element:para-border-div;border:solid #DDDDDD 1.0pt;mso-border-alt:
    4109. 

  4109. solid #DDDDDD .75pt;padding:9.0pt 18.0pt 9.0pt 18.0pt;background:#EEEEEE'><pre
    4110. 

  4110. style='background:#EEEEEE'><span style='mso-spacerun:yes'>&nbsp;</span>$conn-&gt;Execute(&quot;SELECT * FROM TABLE WHERE COND=:val&quot;, array('val'=&gt; $val));<br>
    4111. 

  4111. <span style='mso-spacerun:yes'>&nbsp;</span></pre></div>
    4112. 

  4112. 

  4113. <p>Another example, using ODBC,which uses the ? convention:</p>
    4114. 

  4114. 

  4115. <div style='mso-element:para-border-div;border:solid #DDDDDD 1.0pt;mso-border-alt:
    4116. 

  4116. solid #DDDDDD .75pt;padding:9.0pt 18.0pt 9.0pt 18.0pt;background:#EEEEEE'><pre
    4117. 

  4117. style='background:#EEEEEE'><span style='mso-spacerun:yes'>&nbsp; </span>$conn-&gt;Execute(&quot;SELECT * FROM TABLE WHERE COND=?&quot;, array($val));</pre></div>
    4118. 

  4118. 

  4119. <p class=MsoNormal><a name=binding></a><i>Binding variables</i></p>
    4120. 

  4120. 

  4121. <p>Variable binding speeds the compilation and caching of SQL statements,
    4122. 

  4122. leading to higher performance. Currently Oracle, Interbase and ODBC supports
    4123. 

  4123. variable binding. Interbase/ODBC style ? binding is emulated in databases that
    4124. 

  4124. do not support binding. Note that you do not have to quote strings if you use
    4125. 

  4125. binding. </p>
    4126. 

  4126. 

  4127. <p>Variable binding in the odbc, interbase and oci8po drivers. </p>
    4128. 

  4128. 

  4129. <div style='mso-element:para-border-div;border:solid #DDDDDD 1.0pt;mso-border-alt:
    4130. 

  4130. solid #DDDDDD .75pt;padding:9.0pt 18.0pt 9.0pt 18.0pt;background:#EEEEEE'><pre
    4131. 

  4131. style='background:#EEEEEE'>$rs = $db-&gt;Execute('select * from table where val=?', array('10'));</pre></div>
    4132. 

  4132. 

  4133. <p class=MsoNormal>Variable binding in the oci8 driver: </p>
    4134. 

  4134. 

  4135. <div style='mso-element:para-border-div;border:solid #DDDDDD 1.0pt;mso-border-alt:
    4136. 

  4136. solid #DDDDDD .75pt;padding:9.0pt 18.0pt 9.0pt 18.0pt;background:#EEEEEE'><pre
    4137. 

  4137. style='background:#EEEEEE'>$rs = $db-&gt;Execute('select name from table where val=:key', <br>
    4138. 

  4138. <span style='mso-spacerun:yes'>&nbsp; </span>array('key' =&gt; 10));</pre></div>
    4139. 

  4139. 

  4140. <p class=MsoNormal><a name=bulkbind></a><i>Bulk binding</i> </p>
    4141. 

  4141. 

  4142. <p>Since ADOdb 3.80, we support bulk binding in Execute(), in which you pass in
    4143. 

  4143. a 2-dimensional array to be bound to an INSERT/UPDATE or DELETE statement. And since ADOdb 5.11 this is
    4144. 

  4144. disabled by default due to security issues. To enable, set $conn->bulkBind = true. </p>
    4145. 

  4145. 

  4146. <div style='mso-element:para-border-div;border:solid #DDDDDD 1.0pt;mso-border-alt:
    4147. 

  4147. solid #DDDDDD .75pt;padding:9.0pt 18.0pt 9.0pt 18.0pt;background:#EEEEEE'><pre
    4148. 

  4148. style='background:#EEEEEE'>$arr = array(<br>
    4149. 

  4149. <span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>array('Ahmad',32),<br>
    4150. 

  4150. <span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>array('Zulkifli', 24),<br>
    4151. 

  4151. <span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>array('Rosnah', 21)<br>
    4152. 

  4152. <span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>);<br>
    4153. 

  4153. $ok = $db-&gt;Execute('insert into table (name,age) values (?,?)',$arr);</pre></div>
    4154. 

  4154. 

  4155. <p>This provides very high performance as the SQL statement is prepared first.
    4156. 

  4156. The prepared statement is executed repeatedly for each array row until all rows
    4157. 

  4157. are completed, or until the first error. Very useful for importing data. </p>
    4158. 

  4158. 

  4159. <p><b>CacheExecute<a name=cacheexecute></a>([$secs2cache,]$sql,$inputarr=false)</b></p>
    4160. 

  4160. 

  4161. <p>Similar to Execute, except that the recordset is cached for $secs2cache
    4162. 

  4162. seconds in the $ADODB_CACHE_DIR directory, and $inputarr only accepts
    4163. 

  4163. 1-dimensional arrays. If CacheExecute() is called again with the same $sql,
    4164. 

  4164. $inputarr, and also the same database, same userid, and the cached recordset
    4165. 

  4165. has not expired, the cached recordset is returned. </p>
    4166. 

  4166. 

  4167. <div style='mso-element:para-border-div;border:solid #DDDDDD 1.0pt;mso-border-alt:
    4168. 

  4168. solid #DDDDDD .75pt;padding:9.0pt 18.0pt 9.0pt 18.0pt;background:#EEEEEE'><pre
    4169. 

  4169. style='background:#EEEEEE'><span style='mso-spacerun:yes'>&nbsp; </span>include('adodb.inc.php'); <br>
    4170. 

  4170. <span style='mso-spacerun:yes'>&nbsp; </span>include('tohtml.inc.php');<br>
    4171. 

  4171. <span style='mso-spacerun:yes'>&nbsp; </span>$ADODB_<b>CACHE_DIR</b> = '/usr/local/ADOdbcache';<br>
    4172. 

  4172. <span style='mso-spacerun:yes'>&nbsp; </span>$conn = &amp;ADONewConnection('mysql'); <br>
    4173. 

  4173. <span style='mso-spacerun:yes'>&nbsp; </span>$conn-&gt;PConnect('localhost','userid','password','database');<br>
    4174. 

  4174. <span style='mso-spacerun:yes'>&nbsp; </span>$rs = $conn-&gt;<b>CacheExecute</b>(15, 'select * from table'); # cache 15 secs<br>
    4175. 

  4175. <span style='mso-spacerun:yes'>&nbsp; </span>rs2html($rs); /* recordset to html table */<span style='mso-spacerun:yes'>&nbsp; </span></pre></div>
    4176. 

  4176. 

  4177. <p>Alternatively, since ADOdb 1.80, the $secs2cache parameter is optional:</p>
    4178. 

  4178. 

  4179. <div style='mso-element:para-border-div;border:solid #DDDDDD 1.0pt;mso-border-alt:
    4180. 

  4180. solid #DDDDDD .75pt;padding:9.0pt 18.0pt 9.0pt 18.0pt;background:#EEEEEE'><pre
    4181. 

  4181. style='background:#EEEEEE'><span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$conn-&gt;Connect(...);<br>
    4182. 

  4182. <span style='mso-spacerun:yes'>&nbsp;&nbsp; </span><span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$conn-&gt;cacheSecs = 3600*24; // cache 24 hours<br>
    4183. 

  4183. <span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$rs = $conn-&gt;CacheExecute('select * from table');</pre></div>
    4184. 

  4184. 

  4185. <p class=MsoNormal>If $secs2cache is omitted, we use the value in
    4186. 

  4186. $connection-&gt;cacheSecs (default is 3600 seconds, or 1 hour). Use
    4187. 

  4187. CacheExecute() only with SELECT statements. </p>
    4188. 

  4188. 

  4189. <p>Performance note: I have done some benchmarks and found that they vary so
    4190. 

  4190. greatly that it's better to talk about when caching is of benefit. When your
    4191. 

  4191. database server is <i>much slower </i>than your Web server or the database is <i>very
    4192. 

  4192. overloaded </i>then ADOdb's caching is good because it reduces the load on your
    4193. 

  4193. database server. If your database server is lightly loaded or much faster than
    4194. 

  4194. your Web server, then caching could actually reduce performance. </p>
    4195. 

  4195. 

  4196. <p><b>ExecuteCursor<a name=executecursor></a>($sql,$cursorName='rs',$parameters=false)</b></p>
    4197. 

  4197. 

  4198. <p>Execute an Oracle stored procedure, and returns an Oracle REF cursor
    4199. 

  4199. variable as a regular ADOdb recordset. Does not work with any other database
    4200. 

  4200. except oci8. Thanks to Robert Tuttle for the design. </p>
    4201. 

  4201. 

  4202. <div style='mso-element:para-border-div;border:solid #DDDDDD 1.0pt;mso-border-alt:
    4203. 

  4203. solid #DDDDDD .75pt;padding:9.0pt 18.0pt 9.0pt 18.0pt;background:#EEEEEE'><pre
    4204. 

  4204. style='background:#EEEEEE'><span style='mso-spacerun:yes'>&nbsp;&nbsp;&nbsp; </span>$db = ADONewConnection(&quot;oci8&quot;); <br>
    4205. 

  4205. <span style='mso-spacerun:yes'>&nbsp;&nbsp;&nbsp; </span>$db-&gt;Connect(&quot;foo.com:1521&quot;, &quot;uid&quot;, &quot;pwd&quot;, &quot;FOO&quot;); <br>
    4206. 

  4206. <span style='mso-spacerun:yes'>&nbsp;&nbsp;&nbsp; </span>$rs = $db-&gt;ExecuteCursor(&quot;begin :cursorvar := getdata(:param1); end;&quot;, <br>
    4207. 

  4207. <span style='mso-tab-count:5'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>'cursorvar',<br>
    4208. 

  4208. <span style='mso-tab-count:5'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>array('param1'=&gt;10)); <br>
    4209. 

  4209. <span style='mso-spacerun:yes'>&nbsp;&nbsp;&nbsp; </span># $rs is now just like any other ADOdb recordset object<br>
    4210. 

  4210. <span style='mso-spacerun:yes'>&nbsp;&nbsp;&nbsp; </span>rs2html($rs);</pre></div>
    4211. 

  4211. 

  4212. <p>ExecuteCursor() is a helper function that does the following internally: </p>
    4213. 

  4213. 

  4214. <div style='mso-element:para-border-div;border:solid #DDDDDD 1.0pt;mso-border-alt:
    4215. 

  4215. solid #DDDDDD .75pt;padding:9.0pt 18.0pt 9.0pt 18.0pt;background:#EEEEEE'><pre
    4216. 

  4216. style='background:#EEEEEE'><span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$stmt = $db-&gt;Prepare(&quot;begin :cursorvar := getdata(:param1); end;&quot;, true); <br>
    4217. 

  4217. <span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$db-&gt;Parameter($stmt, $cur, 'cursorvar', false, -1, OCI_B_CURSOR);<br>
    4218. 

  4218. <span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$rs = $db-&gt;Execute($stmt,$bindarr);</pre></div>
    4219. 

  4219. 

  4220. <p>ExecuteCursor only accepts 1 out parameter. So if you have 2 out parameters,
    4221. 

  4221. use: </p>
    4222. 

  4222. 

  4223. <div style='mso-element:para-border-div;border:solid #DDDDDD 1.0pt;mso-border-alt:
    4224. 

  4224. solid #DDDDDD .75pt;padding:9.0pt 18.0pt 9.0pt 18.0pt;background:#EEEEEE'><pre
    4225. 

  4225. style='background:#EEEEEE'><span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$vv = 'A%';<br>
    4226. 

  4226. <span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$stmt = $db-&gt;PrepareSP(&quot;BEGIN list_tabs(:crsr,:tt); END;&quot;);<br>
    4227. 

  4227. <span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$db-&gt;OutParameter($stmt, $cur, 'crsr', -1, OCI_B_CURSOR);<br>
    4228. 

  4228. <span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$db-&gt;OutParameter($stmt, $vv, 'tt', 32); # return varchar(32)<br>
    4229. 

  4229. <span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$arr = $db-&gt;GetArray($stmt);<br>
    4230. 

  4230. <span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>print_r($arr);<br>
    4231. 

  4231. <span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>echo &quot; val = $vv&quot;; ## outputs 'TEST'</pre></div>
    4232. 

  4232. 

  4233. <p class=MsoNormal>for the following PL/SQL: </p>
    4234. 

  4234. 

  4235. <div style='mso-element:para-border-div;border:solid #DDDDDD 1.0pt;mso-border-alt:
    4236. 

  4236. solid #DDDDDD .75pt;padding:9.0pt 18.0pt 9.0pt 18.0pt;background:#EEEEEE'><pre
    4237. 

  4237. style='background:#EEEEEE'><span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>TYPE TabType IS REF CURSOR RETURN TAB%ROWTYPE;<br>
    4238. 

  4238. <br>
    4239. 

  4239. <span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>PROCEDURE list_tabs(tabcursor IN OUT TabType,tablenames IN OUT VARCHAR) IS<br>
    4240. 

  4240. <span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>BEGIN<br>
    4241. 

  4241. <span style='mso-tab-count:2'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>OPEN tabcursor FOR SELECT * FROM TAB WHERE tname LIKE tablenames;<br>
    4242. 

  4242. <span style='mso-tab-count:2'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>tablenames := 'TEST';<br>
    4243. 

  4243. <span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>END list_tabs;</pre></div>
    4244. 

  4244. 

  4245. <p><b>SelectLimit<a name=selectlimit></a>($sql,$numrows=-1,$offset=-1,$inputarr=false)</b></p>
    4246. 

  4246. 

  4247. <p>Returns a recordset if successful. Returns false otherwise. Performs a
    4248. 

  4248. select statement, simulating PostgreSQL's SELECT statement, LIMIT $numrows
    4249. 

  4249. OFFSET $offset clause.</p>
    4250. 

  4250. 

  4251. <p>In PostgreSQL, SELECT * FROM TABLE LIMIT 3 will return the first 3 records
    4252. 

  4252. only. The equivalent is <code><span style='font-size:10.0pt'>$connection-&gt;SelectLimit('SELECT
    4253. 

  4253. * FROM TABLE',3)</span></code>. This functionality is simulated for databases
    4254. 

  4254. that do not possess this feature.</p>
    4255. 

  4255. 

  4256. <p>And SELECT * FROM TABLE LIMIT 3 OFFSET 2 will return records 3, 4 and 5 (eg.
    4257. 

  4257. after record 2, return 3 rows). The equivalent in ADOdb is <code><span
    4258. 

  4258. style='font-size:10.0pt'>$connection-&gt;SelectLimit('SELECT * FROM TABLE',3,2)</span></code>.</p>
    4259. 

  4259. 

  4260. <p>Note that this is the <i>opposite</i> of MySQL's LIMIT clause. You can also
    4261. 

  4261. set <code><span style='font-size:10.0pt'>$connection-&gt;SelectLimit('SELECT *
    4262. 

  4262. FROM TABLE',-1,10)</span></code> to get rows 11 to the last row.</p>
    4263. 

  4263. 

  4264. <p>The last parameter $inputarr is for databases that support variable binding
    4265. 

  4265. such as Oracle oci8. This substantially reduces SQL compilation overhead. Below
    4266. 

  4266. is an Oracle example:</p>
    4267. 

  4267. 

  4268. <div style='mso-element:para-border-div;border:solid #DDDDDD 1.0pt;mso-border-alt:
    4269. 

  4269. solid #DDDDDD .75pt;padding:9.0pt 18.0pt 9.0pt 18.0pt;background:#EEEEEE'><pre
    4270. 

  4270. style='background:#EEEEEE'><span style='mso-spacerun:yes'>&nbsp;</span>$conn-&gt;SelectLimit(&quot;SELECT * FROM TABLE WHERE COND=:val&quot;, 100,-1,array('val'=&gt; $val));<br>
    4271. 

  4271. <span style='mso-spacerun:yes'>&nbsp;</span></pre></div>
    4272. 

  4272. 

  4273. <p>The oci8po driver (oracle portable driver) uses the more standard bind
    4274. 

  4274. variable of ?: </p>
    4275. 

  4275. 

  4276. <div style='mso-element:para-border-div;border:solid #DDDDDD 1.0pt;mso-border-alt:
    4277. 

  4277. solid #DDDDDD .75pt;padding:9.0pt 18.0pt 9.0pt 18.0pt;background:#EEEEEE'><pre
    4278. 

  4278. style='background:#EEEEEE'><span style='mso-spacerun:yes'>&nbsp;</span>$conn-&gt;SelectLimit(&quot;SELECT * FROM TABLE WHERE COND=?&quot;, 100,-1,array('val'=&gt; $val));</pre></div>
    4279. 

  4279. 

  4280. <p>Ron Wilson reports that SelectLimit does not work with UNIONs. </p>
    4281. 

  4281. 

  4282. <p><b>CacheSelectLimit<a name=cacheselectlimit></a>([$secs2cache,] $sql,
    4283. 

  4283. $numrows=-1,$offset=-1,$inputarr=false)</b></p>
    4284. 

  4284. 

  4285. <p>Similar to SelectLimit, except that the recordset returned is cached for
    4286. 

  4286. $secs2cache seconds in the $ADODB_CACHE_DIR directory. </p>
    4287. 

  4287. 

  4288. <p>Since 1.80, $secs2cache has been optional, and you can define the caching
    4289. 

  4289. time in $connection-&gt;cacheSecs.</p>
    4290. 

  4290. 

  4291. <div style='mso-element:para-border-div;border:solid #DDDDDD 1.0pt;mso-border-alt:
    4292. 

  4292. solid #DDDDDD .75pt;padding:9.0pt 18.0pt 9.0pt 18.0pt;background:#EEEEEE'><pre
    4293. 

  4293. style='background:#EEEEEE'><span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$conn-&gt;Connect(...);<br>
    4294. 

  4294. <span style='mso-spacerun:yes'>&nbsp;&nbsp; </span>$conn-&gt;cacheSecs = 3600*24; // cache 24 hours<br>
    4295. 

  4295. <span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$rs = $conn-&gt;CacheSelectLimit('select * from table',10);</pre></div>
    4296. 

  4296. 

  4297. <p><b>CacheFlush<a name=cacheflush></a>($sql=false,$inputarr=false)</b></p>
    4298. 

  4298. 

  4299. <p>Flush (delete) any cached recordsets for the SQL statement $sql in
    4300. 

  4300. $ADODB_CACHE_DIR. </p>
    4301. 

  4301. 

  4302. <p>If no parameter is passed in, then all adodb_*.cache files are deleted. </p>
    4303. 

  4303. 

  4304. <p>CacheSelectLimit() rewrites the SQL query, so you won't be able to pass the
    4305. 

  4305. SQL to CacheFlush. In this case, to flush the cached SQL recordset returned by
    4306. 

  4306. CacheSelectLimit(), set $secs2cache to -1: </p>
    4307. 

  4307. 

  4308. <div style='mso-element:para-border-div;border:solid #DDDDDD 1.0pt;mso-border-alt:
    4309. 

  4309. solid #DDDDDD .75pt;padding:9.0pt 18.0pt 9.0pt 18.0pt;background:#EEEEEE'><pre><o:p>&nbsp;</o:p></pre><pre><span
    4310. 

  4310. style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$db-&gt;CacheSelectLimit(-1, $sql, $nrows);</pre></div>
    4311. 

  4311. 

  4312. <p>If you want to flush all cached recordsets manually, execute the following
    4313. 

  4313. PHP code (works only under Unix): <br>
    4314. 

  4314. <code><span style='font-size:10.0pt'>&nbsp; system(&quot;rm -f `find
    4315. 

  4315. &quot;.$ADODB_CACHE_DIR.&quot; -name adodb_*.cache`&quot;);</span></code></p>
    4316. 

  4316. 

  4317. <p>For general cleanup of all expired files, you should use
    4318. 

  4318. <a href="http://www.adminschoice.com/crontab-quick-reference">crontab</a> on Unix,
    4319. 

  4319. or at.exe on Windows, and a shell script similar to the following:
    4320. 

  4320. <span style='font-family:"Courier New"'><br>
    4321. 

  4321. #------------------------------------------------------ <br>
    4322. 

  4322. # This particular example deletes files in the TMPPATH <br>
    4323. 

  4323. # directory with the string &quot;.cache&quot; in their name that <br>
    4324. 

  4324. # are more than 7 days old. <br>
    4325. 

  4325. #------------------------------------------------------ <br>
    4326. 

  4326. AGED=7 <br>
    4327. 

  4327. find ${TMPPATH} -mtime +$AGED | grep &quot;\.cache&quot; | xargs rm -f </span></p>
    4328. 

  4328. 

  4329. <p><b>MetaError<a name=metaerror></a>($errno=false)</b></p>
    4330. 

  4330. 

  4331. <p>Returns a virtualized error number, based on PEAR DB's error number system.
    4332. 

  4332. You might need to include adodb-error.inc.php before you call this function.
    4333. 

  4333. The parameter $errno is the native error number you want to convert. If you do
    4334. 

  4334. not pass any parameter, MetaError will call ErrorNo() for you and convert it.
    4335. 

  4335. If the error number cannot be virtualized, MetaError will return -1 (DB_ERROR).</p>
    4336. 

  4336. 

  4337. <p><b>MetaErrorMsg<a name=metaerrormsg></a>($errno)</b></p>
    4338. 

  4338. 

  4339. <p>Pass the error number returned by MetaError() for the equivalent textual
    4340. 

  4340. error message.</p>
    4341. 

  4341. 

  4342. <p><b>ErrorMsg<a name=errormsg></a>()</b></p>
    4343. 

  4343. 

  4344. <p>Returns the last status or error message. The error message is reset after
    4345. 

  4345. every call to Execute(). </p>
    4346. 

  4346. 

  4347. <p>This can return a string even if no error occurs. In general you do not need
    4348. 

  4348. to call this function unless an ADOdb function returns false on an error. </p>
    4349. 

  4349. 

  4350. <p>Note: If <b>debug</b> is enabled, the SQL error message is always displayed
    4351. 

  4351. when the <b>Execute</b> function is called.</p>
    4352. 

  4352. 

  4353. <p><b>ErrorNo<a name=errorno></a>()</b></p>
    4354. 

  4354. 

  4355. <p>Returns the last error number. The error number is reset after every call to
    4356. 

  4356. Execute(). If 0 is returned, no error occurred. </p>
    4357. 

  4357. 

  4358. <p>Note that old versions of PHP (pre 4.0.6) do not support error number for
    4359. 

  4359. ODBC. In general you do not need to call this function unless an ADOdb function
    4360. 

  4360. returns false on an error.</p>
    4361. 

  4361. 

  4362. <p><b>IgnoreErrors<a name=ignoreerrors></a>($saveErrHandlers)</b></p>
    4363. 

  4363. 

  4364. <p>Allows you to ignore errors so that StartTrans()/CompleteTrans() is not
    4365. 

  4365. affected, nor is the default error handler called if an error occurs. Useful
    4366. 

  4366. when you want to check if a field or table exists in a database without
    4367. 

  4367. invoking an error if it does not exist. </p>
    4368. 

  4368. 

  4369. <p>Usage: </p>
    4370. 

  4370. 

  4371. <div style='mso-element:para-border-div;border:solid #DDDDDD 1.0pt;mso-border-alt:
    4372. 

  4372. solid #DDDDDD .75pt;padding:9.0pt 18.0pt 9.0pt 18.0pt;background:#EEEEEE'><pre><o:p>&nbsp;</o:p></pre><pre>$saveErrHandlers = $conn-&gt;IgnoreErrors();</pre><pre>$rs = $conn-&gt;Execute(&quot;select field from some_table_that_might_not_exist&quot;);</pre><pre>$conn-&gt;IgnoreErrors($saveErrHandlers);</pre></div>
    4373. 

  4373. 

  4374. <p>Warning: do not call StartTrans()/CompleteTrans() inside a code block that
    4375. 

  4375. is using IgnoreErrors(). </p>
    4376. 

  4376. 

  4377. <p><b>SetFetchMode<a name=setfetchmode></a>($mode)</b></p>
    4378. 

  4378. 

  4379. <p>Sets the current fetch mode for the connection and stores it in
    4380. 

  4380. $db-&gt;fetchMode. Legal modes are ADODB_FETCH_ASSOC and ADODB_FETCH_NUM. For
    4381. 

  4381. more info, see <a href="#adodb_fetch_mode">$ADODB_FETCH_MODE</a>.</p>
    4382. 

  4382. 

  4383. <p>Returns the previous fetch mode, which could be false if SetFetchMode( ) has
    4384. 

  4384. not been called before.</p>
    4385. 

  4385. 

  4386. <p><b>CreateSequence<a name=createseq></a>($seqName = 'adodbseq',$startID=1)</b></p>
    4387. 

  4387. 

  4388. <p>Create a sequence. The next time GenID( ) is called, the value returned will
    4389. 

  4389. be $startID. Added in 2.60. </p>
    4390. 

  4390. 

  4391. <p><b>DropSequence<a name=dropseq></a>($seqName = 'adodbseq')</b></p>
    4392. 

  4392. 

  4393. <p>Delete a sequence. Added in 2.60. </p>
    4394. 

  4394. 

  4395. <p><b>GenID<a name=genid></a>($seqName = 'adodbseq',$startID=1)</b></p>
    4396. 

  4396. 

  4397. <p>Generate a sequence number . Works for interbase, mysql, postgresql, oci8,
    4398. 

  4398. oci8po, mssql, ODBC based (access,vfp,db2,etc) drivers currently. Uses $seqName
    4399. 

  4399. as the name of the sequence. GenID() will automatically create the sequence for
    4400. 

  4400. you if it does not exist (provided the userid has permission to do so).
    4401. 

  4401. Otherwise you will have to create the sequence yourself. </p>
    4402. 

  4402. 

  4403. <p>If your database driver emulates sequences, the name of the table is the
    4404. 

  4404. sequence name. The table has one column, &quot;id&quot; which should be of type
    4405. 

  4405. integer, or if you need something larger - numeric(16). </p>
    4406. 

  4406. 

  4407. <p>For ODBC and databases that do not support sequences natively (eg mssql,
    4408. 

  4408. mysql), we create a table for each sequence. If the sequence has not been
    4409. 

  4409. defined earlier, it is created with the starting value set in $startID.</p>
    4410. 

  4410. 

  4411. <p>Note that the mssql driver's GenID() before 1.90 used to generate 16 byte
    4412. 

  4412. GUID's.</p>
    4413. 

  4413. 

  4414. <p><b>UpdateBlob<a name=updateblob></a>($table,$column,$val,$where)</b></p>
    4415. 

  4415. 

  4416. <p class=MsoNormal>Allows you to store a blob (in $val) into $table into
    4417. 

  4417. $column in a row at $where. </p>
    4418. 

  4418. 

  4419. <p>Usage: </p>
    4420. 

  4420. 

  4421. <div style='mso-element:para-border-div;border:solid #DDDDDD 1.0pt;mso-border-alt:
    4422. 

  4422. solid #DDDDDD .75pt;padding:9.0pt 18.0pt 9.0pt 18.0pt;background:#EEEEEE'><pre
    4423. 

  4423. style='background:#EEEEEE'><span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span># for oracle<br>
    4424. 

  4424. <span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$conn-&gt;Execute('INSERT INTO blobtable (id, blobcol) VALUES (1, empty_blob())');<br>
    4425. 

  4425. <span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$conn-&gt;UpdateBlob('blobtable','blobcol',$blobvalue,'id=1');<br>
    4426. 

  4426. <span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span><br>
    4427. 

  4427. <span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span># non oracle databases<br>
    4428. 

  4428. <span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$conn-&gt;Execute('INSERT INTO blobtable (id, blobcol) VALUES (1, null)');<br>
    4429. 

  4429. <span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$conn-&gt;UpdateBlob('blobtable','blobcol',$blobvalue,'id=1');</pre></div>
    4430. 

  4430. 

  4431. <p>Returns true if succesful, false otherwise. Supported by MySQL, PostgreSQL,
    4432. 

  4432. Oci8, Oci8po and Interbase drivers. Other drivers might work, depending on the
    4433. 

  4433. state of development.</p>
    4434. 

  4434. 

  4435. <p>Note that when an Interbase blob is retrieved using SELECT, it still needs
    4436. 

  4436. to be decoded using $connection-&gt;DecodeBlob($blob); to derive the original
    4437. 

  4437. value in versions of PHP before 4.1.0. </p>
    4438. 

  4438. 

  4439. <p>For PostgreSQL, you can store your blob using blob oid's or as a bytea field.
    4440. 

  4440. You can use bytea fields but not blob oid's currently with UpdateBlob( ).
    4441. 

  4441. Conversely UpdateBlobFile( ) supports oid's, but not bytea data.<br>
    4442. 

  4442. <br>
    4443. 

  4443. If you do not pass in an oid, then UpdateBlob() assumes that you are storing in
    4444. 

  4444. bytea fields. </p>
    4445. 

  4445. 

  4446. <p>If you do not have any blob fields, you can improve you can improve general
    4447. 

  4447. SQL query performance by disabling blob handling with
    4448. 

  4448. $connection-&gt;disableBlobs = true. </p>
    4449. 

  4449. 

  4450. <p><b>UpdateClob<a name=updateclob></a>($table,$column,$val,$where)</b></p>
    4451. 

  4451. 

  4452. <p class=MsoNormal>Allows you to store a clob (in $val) into $table into
    4453. 

  4453. $column in a row at $where. Similar to UpdateBlob (see above), but for
    4454. 

  4454. Character Large OBjects. </p>
    4455. 

  4455. 

  4456. <p>Usage: </p>
    4457. 

  4457. 

  4458. <div style='mso-element:para-border-div;border:solid #DDDDDD 1.0pt;mso-border-alt:
    4459. 

  4459. solid #DDDDDD .75pt;padding:9.0pt 18.0pt 9.0pt 18.0pt;background:#EEEEEE'><pre
    4460. 

  4460. style='background:#EEEEEE'><span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span># for oracle<br>
    4461. 

  4461. <span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$conn-&gt;Execute('INSERT INTO clobtable (id, clobcol) VALUES (1, empty_clob())');<br>
    4462. 

  4462. <span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$conn-&gt;UpdateBlob('clobtable','clobcol',$clobvalue,'id=1');<br>
    4463. 

  4463. <span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span><br>
    4464. 

  4464. <span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span># non oracle databases<br>
    4465. 

  4465. <span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$conn-&gt;Execute('INSERT INTO clobtable (id, clobcol) VALUES (1, null)');<br>
    4466. 

  4466. <span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$conn-&gt;UpdateBlob('clobtable','clobcol',$clobvalue,'id=1');</pre></div>
    4467. 

  4467. 

  4468. <p><b>UpdateBlobFile<a name=updateblobfile></a>($table,$column,$path,$where,$blobtype='BLOB')</b></p>
    4469. 

  4469. 

  4470. <p>Similar to UpdateBlob, except that we pass in a file path to where the blob
    4471. 

  4471. resides. </p>
    4472. 

  4472. 

  4473. <p>For PostgreSQL, if you are using blob oid's, use this interface. This
    4474. 

  4474. interface does not support bytea fields. </p>
    4475. 

  4475. 

  4476. <p>Returns true if successful, false otherwise. </p>
    4477. 

  4477. 

  4478. <p><b>BlobEncode<a name=blobencode id=blobencode></a>($blob)</b> </p>
    4479. 

  4479. 

  4480. <p>Some databases require blob's to be encoded manually before upload. Note if
    4481. 

  4481. you use UpdateBlob( ) or UpdateBlobFile( ) the conversion is done automatically
    4482. 

  4482. for you and you do not have to call this function. For PostgreSQL, currently,
    4483. 

  4483. BlobEncode() can only be used for bytea fields. </p>
    4484. 

  4484. 

  4485. <p>Returns the encoded blob value. </p>
    4486. 

  4486. 

  4487. <p>Note that there is a connection property called <em>blobEncodeType</em>
    4488. 

  4488. which has 3 legal values: </p>
    4489. 

  4489. 

  4490. <p>false - no need to perform encoding or decoding.<br>
    4491. 

  4491. 'I' - blob encoding required, and returned encoded blob is a numeric value (no
    4492. 

  4492. need to quote).<br>
    4493. 

  4493. 'C' - blob encoding required, and returned encoded blob is a character value
    4494. 

  4494. (requires quoting). </p>
    4495. 

  4495. 

  4496. <p>This is purely for documentation purposes, so that programs that accept
    4497. 

  4497. multiple database drivers know what is the right thing to do when processing
    4498. 

  4498. blobs. </p>
    4499. 

  4499. 

  4500. <p><strong>BlobDecode<a name=blobdecode></a>($blob, $maxblobsize = false)</strong>
    4501. 

  4501. </p>
    4502. 

  4502. 

  4503. <p>Some databases require blob's to be decoded manually after doing a select
    4504. 

  4504. statement. If the database does not require decoding, then this function will
    4505. 

  4505. return the blob unchanged. Currently BlobDecode is only required for one
    4506. 

  4506. database, PostgreSQL, and only if you are using blob oid's (if you are using
    4507. 

  4507. bytea fields, we auto-decode for you). The default maxblobsize is set in
    4508. 

  4508. $connection-&gt;maxblobsize, which is set to 256K in adodb 4.54. </p>
    4509. 

  4509. 

  4510. <p>In ADOdb 4.54 and later, the blob is the return value. In earlier versions,
    4511. 

  4511. the blob data is sent to stdout.</p>
    4512. 

  4512. 

  4513. <div style='mso-element:para-border-div;border:solid #DDDDDD 1.0pt;mso-border-alt:
    4514. 

  4514. solid #DDDDDD .75pt;padding:9.0pt 18.0pt 9.0pt 18.0pt;background:#EEEEEE'><pre
    4515. 

  4515. style='background:#EEEEEE'>$rs = $db-&gt;Execute(&quot;select bloboid from postgres_table where id=$key&quot;);<br>
    4516. 

  4516. $blob = $db-&gt;BlobDecode( reset($rs-&gt;fields) );</pre></div>
    4517. 

  4517. 

  4518. <p><b>Replace<a name=replace></a>($table, $arrFields,
    4519. 

  4519. $keyCols,$autoQuote=false)</b></p>
    4520. 

  4520. 

  4521. <p>Try to update a record, and if the record is not found, an insert statement
    4522. 

  4522. is generated and executed. Returns 0 on failure, 1 if update statement worked,
    4523. 

  4523. 2 if no record was found and the insert was executed successfully. This differs
    4524. 

  4524. from MySQL's replace which deletes the record and inserts a new record. This
    4525. 

  4525. also means you cannot update the primary key. The only exception to this is
    4526. 

  4526. Interbase and its derivitives, which uses delete and insert because of some
    4527. 

  4527. Interbase API limitations. </p>
    4528. 

  4528. 

  4529. <p>The parameters are $table which is the table name, the $arrFields which is
    4530. 

  4530. an associative array where the keys are the field names, and $keyCols is the
    4531. 

  4531. name of the primary key, or an array of field names if it is a compound key. If
    4532. 

  4532. $autoQuote is set to true, then Replace() will quote all values that are
    4533. 

  4533. non-numeric; auto-quoting will not quote nulls. Note that auto-quoting will not
    4534. 

  4534. work if you use SQL functions or operators. </p>
    4535. 

  4535. 

  4536. <p>Examples: </p>
    4537. 

  4537. 

  4538. <div style='mso-element:para-border-div;border:solid #DDDDDD 1.0pt;mso-border-alt:
    4539. 

  4539. solid #DDDDDD .75pt;padding:9.0pt 18.0pt 9.0pt 18.0pt;background:#EEEEEE'><pre
    4540. 

  4540. style='background:#EEEEEE'># single field primary key<br>
    4541. 

  4541. $ret = $db-&gt;Replace('atable', <br>
    4542. 

  4542. <span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>array('id'=&gt;1000,'firstname'=&gt;'Harun','lastname'=&gt;'Al-Rashid'),<br>
    4543. 

  4543. <span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>'id',$autoquote = true);<span
    4544. 

  4544. style='mso-tab-count:1'>&nbsp; </span><br>
    4545. 

  4545. # generates UPDATE atable SET firstname='Harun',lastname='Al-Rashid' WHERE id=1000<br>
    4546. 

  4546. # or INSERT INTO atable (id,firstname,lastname) VALUES (1000,'Harun','Al-Rashid')<br>
    4547. 

  4547. <br>
    4548. 

  4548. # compound key<br>
    4549. 

  4549. $ret = $db-&gt;Replace('atable2', <br>
    4550. 

  4550. <span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>array('firstname'=&gt;'Harun','lastname'=&gt;'Al-Rashid', 'age' =&gt; 33, 'birthday' =&gt; 'null'),<br>
    4551. 

  4551. <span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>array('lastname','firstname'),<br>
    4552. 

  4552. <span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$autoquote = true);<br>
    4553. 

  4553. <br>
    4554. 

  4554. # no auto-quoting<br>
    4555. 

  4555. $ret = $db-&gt;Replace('atable2', <br>
    4556. 

  4556. <span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>array('firstname'=&gt;&quot;'Harun'&quot;,'lastname'=&gt;&quot;'Al-Rashid'&quot;, 'age' =&gt; 'null'),<br>
    4557. 

  4557. <span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>array('lastname','firstname'));<span
    4558. 

  4558. style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp; </span></pre></div>
    4559. 

  4559. 

  4560. <p><b>AutoExecute<a name=autoexecute></a>($table, $arrFields, $mode,
    4561. 

  4561. $where=false, $forceUpdate=true,$magicq=false)</b></p>
    4562. 

  4562. 

  4563. <p>Since ADOdb 4.56, you can automatically generate and execute INSERTs and
    4564. 

  4564. UPDATEs on a given table with this function, which is a wrapper for
    4565. 

  4565. GetInsertSQL() and GetUpdateSQL(). </p>
    4566. 

  4566. 

  4567. <p>AutoExecute() inserts or updates $table given an array of $arrFields, where
    4568. 

  4568. the keys are the field names and the array values are the field values to
    4569. 

  4569. store. Note that there is some overhead because the table is first queried to
    4570. 

  4570. extract key information before the SQL is generated. We generate an INSERT or
    4571. 

  4571. UPDATE based on $mode (see below). </p>
    4572. 

  4572. 

  4573. <p>Legal values for $mode are </p>
    4574. 

  4574. 

  4575. <ul type=disc>
    4576. 

  4576.  <li class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
    4577. 

  4577.      mso-list:l5 level1 lfo9;tab-stops:list 36.0pt'>'INSERT' or 1 or DB_AUTOQUERY_INSERT
    4578. 

  4578.      </li>
    4579. 

  4579.  <li class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
    4580. 

  4580.      mso-list:l5 level1 lfo9;tab-stops:list 36.0pt'>'UPDATE' or 2 or
    4581. 

  4581.      DB_AUTOQUERY_UPDATE </li>
    4582. 

  4582. </ul>
    4583. 

  4583. 

  4584. <p>The $where clause is required if $mode == 'UPDATE'. If $forceUpdate=false
    4585. 

  4585. then we will query the database first and check if the field value returned by
    4586. 

  4586. the query matches the current field value; only if they differ do we update
    4587. 

  4587. that field. </p>
    4588. 

  4588. 

  4589. <p>Returns true on success, false on error. </p>
    4590. 

  4590. 

  4591. <p>An example of its use is: </p>
    4592. 

  4592. 

  4593. <div style='mso-element:para-border-div;border:solid #DDDDDD 1.0pt;mso-border-alt:
    4594. 

  4594. solid #DDDDDD .75pt;padding:9.0pt 18.0pt 9.0pt 18.0pt;background:#EEEEEE'><pre><o:p>&nbsp;</o:p></pre><pre>$record[&quot;firstName&quot;] = &quot;Carol&quot;;</pre><pre>$record[&quot;lasTname&quot;] = &quot;Smith&quot;; </pre><pre>$conn-&gt;AutoExecute($table,$record,'INSERT');</pre><pre># executes <i>&quot;INSERT INTO $table (firstName,lasTname) values ('Carol',Smith')&quot;</i>;</pre><pre><o:p>&nbsp;</o:p></pre><pre>$record[&quot;firstName&quot;] = &quot;Carol&quot;;</pre><pre>$record[&quot;lasTname&quot;] = &quot;Jones&quot;; </pre><pre>$conn-&gt;AutoExecute($table,$record,'UPDATE', &quot;lastname like 'Sm%'&quot;);</pre><pre># executes <i>&quot;UPDATE $table SET firstName='Carol',lasTname='Jones' WHERE lastname like 'Sm%'&quot;</i>;</pre></div>
    4595. 

  4595. 

  4596. <p>Note: One of the strengths of ADOdb's AutoExecute() is that only valid field
    4597. 

  4597. names for $table are updated. If $arrFields contains keys that are invalid
    4598. 

  4598. field names for $table, they are ignored. There is some overhead in doing this
    4599. 

  4599. as we have to query the database to get the field names, but given that you are
    4600. 

  4600. not directly coding the SQL yourself, you probably aren't interested in speed
    4601. 

  4601. at all, but convenience. </p>
    4602. 

  4602. 

  4603. <p>Since 4.62, the table name to be used can be overridden by setting
    4604. 

  4604. $rs-&gt;tableName before AutoExecute(), GetInsertSQL() or GetUpdateSQL() is
    4605. 

  4605. called. </p>
    4606. 

  4606. 

  4607. <p>Since 4.94, setting the global variable $ADODB_QUOTE_FIELDNAMES to true will
    4608. 

  4608. force field names to be auto-quoted in AutoExecute(), GetInsertSQL() and
    4609. 

  4609. GetUpdateSQL(). </p>
    4610. 

  4610. 

  4611. <p><b>GetUpdateSQL<a name=getupdatesql></a>(&amp;$rs, $arrFields,
    4612. 

  4612. $forceUpdate=false,$magicq=false, $force=null)</b></p>
    4613. 

  4613. 

  4614. <p>Generate SQL to update a table given a recordset $rs, and the modified
    4615. 

  4615. fields of the array $arrFields (which must be an associative array holding the
    4616. 

  4616. column names and the new values) are compared with the current recordset. If
    4617. 

  4617. $forceUpdate is true, then we also generate the SQL even if $arrFields is
    4618. 

  4618. identical to $rs-&gt;fields. Requires the recordset to be associative. $magicq
    4619. 

  4619. is used to indicate whether magic quotes are enabled (see qstr()). The field
    4620. 

  4620. names in the array are case-insensitive.</p>
    4621. 

  4621. 

  4622. <p>Since 4.52, we allow you to pass the $force type parameter, and this
    4623. 

  4623. overrides the <a href="#ADODB_FORCE_TYPE">$ADODB_FORCE_TYPE</a> global
    4624. 

  4624. variable. </p>
    4625. 

  4625. 

  4626. <p>Since 4.62, the table name to be used can be overridden by setting
    4627. 

  4627. $rs-&gt;tableName before AutoExecute(), GetInsertSQL() or GetUpdateSQL() is
    4628. 

  4628. called. </p>
    4629. 

  4629. 

  4630. <p><b>GetInsertSQL<a name=getinsertsql></a>(&amp;$rs, $arrFields,$magicq=false,$force_type=false)</b></p>
    4631. 

  4631. 

  4632. <p>Generate SQL to insert into a table given a recordset $rs. Requires the
    4633. 

  4633. query to be associative. $magicq is used to indicate whether magic quotes are
    4634. 

  4634. enabled (for qstr()). The field names in the array are case-insensitive.</p>
    4635. 

  4635. 

  4636. <p>Since 2.42, you can pass a table name instead of a recordset into
    4637. 

  4637. GetInsertSQL (in $rs), and it will generate an insert statement for that table.
    4638. 

  4638. </p>
    4639. 

  4639. 

  4640. <p>Since 4.52, we allow you to pass the $force_type parameter, and this
    4641. 

  4641. overrides the <a href="#ADODB_FORCE_TYPE">$ADODB_FORCE_TYPE</a> global
    4642. 

  4642. variable. </p>
    4643. 

  4643. 

  4644. <p>Since 4.62, the table name to be used can be overridden by setting
    4645. 

  4645. $rs-&gt;tableName before AutoExecute(), GetInsertSQL() or GetUpdateSQL() is
    4646. 

  4646. called. </p>
    4647. 

  4647. 

  4648. <p><b>PageExecute<a name=pageexecute></a>($sql, $nrows, $page, $inputarr=false)</b>
    4649. 

  4649. </p>
    4650. 

  4650. 

  4651. <p>Used for pagination of recordset. $page is 1-based. See <a href="#ex8">Example
    4652. 

  4652. 8</a>.</p>
    4653. 

  4653. 

  4654. <p><b>CachePageExecute<a name=cachepageexecute></a>($secs2cache, $sql, $nrows,
    4655. 

  4655. $page, $inputarr=false)</b> </p>
    4656. 

  4656. 

  4657. <p>Used for pagination of recordset. $page is 1-based. See <a href="#ex8">Example
    4658. 

  4658. 8</a>. Caching version of PageExecute.</p>
    4659. 

  4659. 

  4660. <p><b>Close<a name=close></a>( )</b></p>
    4661. 

  4661. 

  4662. <p>Close the database connection. PHP4 proudly states that we no longer have to
    4663. 

  4663. clean up at the end of the connection because the reference counting mechanism
    4664. 

  4664. of PHP4 will automatically clean up for us.</p>
    4665. 

  4665. 

  4666. <p><b>StartTrans<a name=starttrans></a>( )</b></p>
    4667. 

  4667. 

  4668. <p>Start a monitored transaction. As SQL statements are executed, ADOdb will
    4669. 

  4669. monitor for SQL errors, and if any are detected, when CompleteTrans() is
    4670. 

  4670. called, we auto-rollback. </p>
    4671. 

  4671. 

  4672. <p>To understand why StartTrans() is superior to BeginTrans(), let us examine a
    4673. 

  4673. few ways of using BeginTrans(). The following is the wrong way to use
    4674. 

  4674. transactions: </p>
    4675. 

  4675. 

  4676. <div style='mso-element:para-border-div;border:solid #DDDDDD 1.0pt;mso-border-alt:
    4677. 

  4677. solid #DDDDDD .75pt;padding:9.0pt 18.0pt 9.0pt 18.0pt;background:#EEEEEE'><pre
    4678. 

  4678. style='background:#EEEEEE'>$DB-&gt;BeginTrans();<br>
    4679. 

  4679. $DB-&gt;Execute(&quot;update table1 set val=$val1 where id=$id&quot;);<br>
    4680. 

  4680. $DB-&gt;Execute(&quot;update table2 set val=$val2 where id=$id&quot;);<br>
    4681. 

  4681. $DB-&gt;CommitTrans();</pre></div>
    4682. 

  4682. 

  4683. <p>because you perform no error checking. It is possible to update table1 and
    4684. 

  4684. for the update on table2 to fail. Here is a better way: </p>
    4685. 

  4685. 

  4686. <div style='mso-element:para-border-div;border:solid #DDDDDD 1.0pt;mso-border-alt:
    4687. 

  4687. solid #DDDDDD .75pt;padding:9.0pt 18.0pt 9.0pt 18.0pt;background:#EEEEEE'><pre
    4688. 

  4688. style='background:#EEEEEE'>$DB-&gt;BeginTrans();<br>
    4689. 

  4689. $ok = $DB-&gt;Execute(&quot;update table1 set val=$val1 where id=$id&quot;);<br>
    4690. 

  4690. if ($ok) $ok = $DB-&gt;Execute(&quot;update table2 set val=$val2 where id=$id&quot;);<br>
    4691. 

  4691. if ($ok) $DB-&gt;CommitTrans();<br>
    4692. 

  4692. else $DB-&gt;RollbackTrans();</pre></div>
    4693. 

  4693. 

  4694. <p>Another way is (since ADOdb 2.0): </p>
    4695. 

  4695. 

  4696. <div style='mso-element:para-border-div;border:solid #DDDDDD 1.0pt;mso-border-alt:
    4697. 

  4697. solid #DDDDDD .75pt;padding:9.0pt 18.0pt 9.0pt 18.0pt;background:#EEEEEE'><pre
    4698. 

  4698. style='background:#EEEEEE'>$DB-&gt;BeginTrans();<br>
    4699. 

  4699. $ok = $DB-&gt;Execute(&quot;update table1 set val=$val1 where id=$id&quot;);<br>
    4700. 

  4700. if ($ok) $ok = $DB-&gt;Execute(&quot;update table2 set val=$val2 where id=$id&quot;);<br>
    4701. 

  4701. $DB-&gt;CommitTrans($ok);</pre></div>
    4702. 

  4702. 

  4703. <p>Now it is a headache monitoring $ok all over the place. StartTrans() is an
    4704. 

  4704. improvement because it monitors all SQL errors for you. This is particularly
    4705. 

  4705. useful if you are calling black-box functions in which SQL queries might be
    4706. 

  4706. executed. Also all BeginTrans, CommitTrans and RollbackTrans calls inside a
    4707. 

  4707. StartTrans block will be disabled, so even if the black box function does a
    4708. 

  4708. commit, it will be ignored. </p>
    4709. 

  4709. 

  4710. <div style='mso-element:para-border-div;border:solid #DDDDDD 1.0pt;mso-border-alt:
    4711. 

  4711. solid #DDDDDD .75pt;padding:9.0pt 18.0pt 9.0pt 18.0pt;background:#EEEEEE'><pre
    4712. 

  4712. style='background:#EEEEEE'>$DB-&gt;StartTrans();<br>
    4713. 

  4713. CallBlackBox();<br>
    4714. 

  4714. $DB-&gt;Execute(&quot;update table1 set val=$val1 where id=$id&quot;);<br>
    4715. 

  4715. $DB-&gt;Execute(&quot;update table2 set val=$val2 where id=$id&quot;);<br>
    4716. 

  4716. $DB-&gt;CompleteTrans();</pre></div>
    4717. 

  4717. 

  4718. <p>Note that a StartTrans blocks are nestable, the inner blocks are ignored. </p>
    4719. 

  4719. 

  4720. <p><b>CompleteTrans<a name=completetrans></a>($autoComplete=true)</b></p>
    4721. 

  4721. 

  4722. <p>Complete a transaction called with StartTrans(). This function monitors for
    4723. 

  4723. SQL errors, and will commit if no errors have occured, otherwise it will
    4724. 

  4724. rollback. Returns true on commit, false on rollback. If the parameter
    4725. 

  4725. $autoComplete is true monitor sql errors and commit and rollback as
    4726. 

  4726. appropriate. Set $autoComplete to false to force rollback even if no SQL error
    4727. 

  4727. detected. </p>
    4728. 

  4728. 

  4729. <p><b>FailTrans<a name=failtrans></a>( )</b></p>
    4730. 

  4730. 

  4731. <p>Fail a transaction started with StartTrans(). The rollback will only occur
    4732. 

  4732. when CompleteTrans() is called. </p>
    4733. 

  4733. 

  4734. <p><b>HasFailedTrans<a name=hasfailedtrans></a>( )</b></p>
    4735. 

  4735. 

  4736. <p>Check whether smart transaction has failed, eg. returns true if there was an
    4737. 

  4737. error in SQL execution or FailTrans() was called. If not within smart
    4738. 

  4738. transaction, returns false. </p>
    4739. 

  4739. 

  4740. <p><b>BeginTrans<a name=begintrans></a>( )</b></p>
    4741. 

  4741. 

  4742. <p>Begin a transaction. Turns off autoCommit. Returns true if successful. Some
    4743. 

  4743. databases will always return false if transaction support is not available. Any
    4744. 

  4744. open transactions will be rolled back when the connection is closed. Among the
    4745. 

  4745. databases that support transactions are Oracle, PostgreSQL, Interbase, MSSQL,
    4746. 

  4746. certain versions of MySQL, DB2, Informix, Sybase, etc.</p>
    4747. 

  4747. 

  4748. <p>Note that <a href="#starttrans">StartTrans()</a> and CompleteTrans() is a
    4749. 

  4749. superior method of handling transactions, available since ADOdb 3.40. For a
    4750. 

  4750. explanation, see the <a href="#starttrans">StartTrans()</a> documentation. </p>
    4751. 

  4751. 

  4752. <p>You can also use the ADOdb <a href="#errorhandling">error handler</a> to die
    4753. 

  4753. and rollback your transactions for you transparently. Some buggy database
    4754. 

  4754. extensions are known to commit all outstanding tranasactions, so you might want
    4755. 

  4755. to explicitly do a $DB-&gt;RollbackTrans() in your error handler for safety. </p>
    4756. 

  4756. 

  4757. <h4>Detecting Transactions</h4>
    4758. 

  4758. 

  4759. <p>Since ADOdb 2.50, you are able to detect when you are inside a transaction.
    4760. 

  4760. Check that $connection-&gt;transCnt &gt; 0. This variable is incremented whenever
    4761. 

  4761. BeginTrans() is called, and decremented whenever RollbackTrans() or
    4762. 

  4762. CommitTrans() is called. </p>
    4763. 

  4763. 

  4764. <p><b>CommitTrans<a name=committrans></a>($ok=true)</b></p>
    4765. 

  4765. 

  4766. <p>End a transaction successfully. Returns true if successful. If the database
    4767. 

  4767. does not support transactions, will return true also as data is always
    4768. 

  4768. committed. </p>
    4769. 

  4769. 

  4770. <p>If you pass the parameter $ok=false, the data is rolled back. See example in
    4771. 

  4771. BeginTrans().</p>
    4772. 

  4772. 

  4773. <p><b>RollbackTrans<a name=rollbacktrans></a>( )</b></p>
    4774. 

  4774. 

  4775. <p>End a transaction, rollback all changes. Returns true if successful. If the
    4776. 

  4776. database does not support transactions, will return false as data is never
    4777. 

  4777. rollbacked. </p>
    4778. 

  4778. 

  4779. <p><b>SetTransactionMode<a name=SetTransactionMode></a>($mode )</b></p>
    4780. 

  4780. 

  4781. <p>SetTransactionMode allows you to pass in the transaction mode to use for all
    4782. 

  4782. subsequent transactions. Note: if you have persistent connections and using
    4783. 

  4783. mssql or mysql, you might have to explicitly reset your transaction mode at the
    4784. 

  4784. beginning of each page request. This is only supported in postgresql, mssql,
    4785. 

  4785. mysql with InnoDB and oci8 currently. For example: </p>
    4786. 

  4786. 

  4787. <div style='mso-element:para-border-div;border:solid #DDDDDD 1.0pt;mso-border-alt:
    4788. 

  4788. solid #DDDDDD .75pt;padding:9.0pt 18.0pt 9.0pt 18.0pt;background:#EEEEEE'><pre><o:p>&nbsp;</o:p></pre><pre>$db-&gt;SetTransactionMode(&quot;SERIALIZABLE&quot;);</pre><pre>$db-&gt;BeginTrans();</pre><pre>$db-&gt;Execute(...); $db-&gt;Execute(...);</pre><pre>$db-&gt;CommitTrans();</pre><pre><o:p>&nbsp;</o:p></pre><pre>$db-&gt;SetTransactionMode(&quot;&quot;); // restore to default</pre><pre>$db-&gt;StartTrans();</pre><pre>$db-&gt;Execute(...); $db-&gt;Execute(...);</pre><pre>$db-&gt;CompleteTrans();</pre></div>
    4789. 

  4789. 

  4790. <p>Supported values to pass in: </p>
    4791. 

  4791. 

  4792. <ul type=disc>
    4793. 

  4793.  <li class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
    4794. 

  4794.      mso-list:l1 level1 lfo10;tab-stops:list 36.0pt'>READ UNCOMMITTED (allows
    4795. 

  4795.      dirty reads, but fastest) </li>
    4796. 

  4796.  <li class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
    4797. 

  4797.      mso-list:l1 level1 lfo10;tab-stops:list 36.0pt'>READ COMMITTED (default
    4798. 

  4798.      postgres, mssql and oci8) </li>
    4799. 

  4799.  <li class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
    4800. 

  4800.      mso-list:l1 level1 lfo10;tab-stops:list 36.0pt'>REPEATABLE READ (default
    4801. 

  4801.      mysql) </li>
    4802. 

  4802.  <li class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
    4803. 

  4803.      mso-list:l1 level1 lfo10;tab-stops:list 36.0pt'>SERIALIZABLE (slowest and
    4804. 

  4804.      most restrictive) </li>
    4805. 

  4805. </ul>
    4806. 

  4806. 

  4807. <p>You can also pass in database specific values such as 'SNAPSHOT' for mssql
    4808. 

  4808. or 'READ ONLY' for oci8/postgres. </p>
    4809. 

  4809. 

  4810. <p>See transaction levels for <a
    4811. 

  4811. href="http://www.postgresql.org/docs/8.1/interactive/sql-set-transaction.html">PostgreSQL</a>,
    4812. 

  4812. <a
    4813. 

  4813. href="http://www.stanford.edu/dept/itss/docs/oracle/10g/server.101/b10759/statements_10005.htm">Oracle</a>,
    4814. 

  4814. <a href="http://dev.mysql.com/doc/refman/5.0/en/set-transaction.html">MySQL</a>,
    4815. 

  4815. and <a href="http://msdn.microsoft.com/en-us/ms173763.aspx">MS SQL Server</a>.
    4816. 

  4816. </p>
    4817. 

  4817. 

  4818. <p><b>GetAssoc<a name=getassoc1></a>($sql,$inputarr=false,$force_array=false,$first2cols=false)</b></p>
    4819. 

  4819. 

  4820. <p>Returns an associative array for the given query $sql with optional bind
    4821. 

  4821. parameters in $inputarr. If the number of columns returned is greater to two, a
    4822. 

  4822. 2-dimensional array is returned, with the first column of the recordset becomes
    4823. 

  4823. the keys to the rest of the rows. If the columns is equal to two, a 1-dimensional
    4824. 

  4824. array is created, where the the keys directly map to the values (unless
    4825. 

  4825. $force_array is set to true, when an array is created for each value). </p>
    4826. 

  4826. 

  4827. <p>Examples:<a name=getassocex></a></p>
    4828. 

  4828. 

  4829. <p>We have the following data in a recordset:</p>
    4830. 

  4830. 

  4831. <p>row1: Apple, Fruit, Edible<br>
    4832. 

  4832. row2: Cactus, Plant, Inedible<br>
    4833. 

  4833. row3: Rose, Flower, Edible</p>
    4834. 

  4834. 

  4835. <p>GetAssoc will generate the following 2-dimensional associative array:</p>
    4836. 

  4836. 

  4837. <p>Apple =&gt; array[Fruit, Edible]<br>
    4838. 

  4838. Cactus =&gt; array[Plant, Inedible]<br>
    4839. 

  4839. Rose =&gt; array[Flower,Edible]</p>
    4840. 

  4840. 

  4841. <p>If the dataset is:</p>
    4842. 

  4842. 

  4843. <p>row1: Apple, Fruit<br>
    4844. 

  4844. row2: Cactus, Plant<br>
    4845. 

  4845. row3: Rose, Flower </p>
    4846. 

  4846. 

  4847. <p>GetAssoc will generate the following 1-dimensional associative array (with
    4848. 

  4848. $force_array==false):</p>
    4849. 

  4849. 

  4850. <p>Apple =&gt; Fruit<br>
    4851. 

  4851. Cactus=&gt;Plant<br>
    4852. 

  4852. Rose=&gt;Flower </p>
    4853. 

  4853. 

  4854. <p>The function returns:</p>
    4855. 

  4855. 

  4856. <p>The associative array, or false if an error occurs.</p>
    4857. 

  4857. 

  4858. <p><b>CacheGetAssoc<a name=cachegetassoc></a>([$secs2cache,] $sql,$inputarr=false,$force_array=false,$first2cols=false)</b></p>
    4859. 

  4859. 

  4860. <p>Caching version of <a href="#getassoc1">GetAssoc</a> function above. </p>
    4861. 

  4861. 

  4862. <p><b>GetMedian<a name=getmedian></a>($table, $field, $where='')</b></p>
    4863. 

  4863. 

  4864. <p>Returns the median value of $field for $table. The $where clause is
    4865. 

  4865. optional. If used, make sure the WHERE is included, as in &quot;WHERE name &gt;
    4866. 

  4866. 'A'&quot;. If an error occurs, false is returned. Since ADOdb 5.06 and PHP
    4867. 

  4867. 4.991. </p>
    4868. 

  4868. 

  4869. <p><b>GetOne<a name=getone></a>($sql,$inputarr=false)</b></p>
    4870. 

  4870. 

  4871. <p>Executes the SQL and returns the first field of the first row. The recordset
    4872. 

  4872. and remaining rows are discarded for you automatically. If an error occur,
    4873. 

  4873. false is returned; use ErrorNo() or ErrorMsg() to get the error details. Since
    4874. 

  4874. 4.96/5.00, we return null if no records were found. And since 4.991/5.06, you
    4875. 

  4875. can have change the return value if no records are found using the global
    4876. 

  4876. variable $ADODB_GETONE_EOF: $ADODB_GETONE_EOF = false;</p>
    4877. 

  4877. 

  4878. <p><b>GetRow<a name=getrow></a>($sql,$inputarr=false)</b></p>
    4879. 

  4879. 

  4880. <p>Executes the SQL and returns the first row as an array. The recordset and
    4881. 

  4881. remaining rows are discarded for you automatically. If no records are returned,
    4882. 

  4882. an empty array is returned. If an error occurs, false is returned.</p>
    4883. 

  4883. 

  4884. <p><b>GetAll<a name=getall></a>($sql,$inputarr=false)</b></p>
    4885. 

  4885. 

  4886. <p>Executes the SQL and returns the all the rows as a 2-dimensional array. The
    4887. 

  4887. recordset is discarded for you automatically. If an error occurs, false is
    4888. 

  4888. returned. <i>GetArray</i> is a synonym for <i>GetAll</i>.</p>
    4889. 

  4889. 

  4890. <p><b>GetCol<a name=getcol></a>($sql,$inputarr=false,$trim=false)</b></p>
    4891. 

  4891. 

  4892. <p>Executes the SQL and returns all elements of the first column as a
    4893. 

  4893. 1-dimensional array. The recordset is discarded for you automatically. If an
    4894. 

  4894. error occurs, false is returned.</p>
    4895. 

  4895. 

  4896. <p><b>CacheGetOne<a name=cachegetone></a>([$secs2cache,] $sql,$inputarr=false),
    4897. 

  4897. CacheGetRow<a name=cachegetrow></a>([$secs2cache,] $sql,$inputarr=false),
    4898. 

  4898. CacheGetAll<a name=cachegetall></a>([$secs2cache,] $sql,$inputarr=false),
    4899. 

  4899. CacheGetCol<a name=cachegetcol></a>([$secs2cache,]
    4900. 

  4900. $sql,$inputarr=false,$trim=false)</b></p>
    4901. 

  4901. 

  4902. <p>Similar to above Get* functions, except that the recordset is serialized and
    4903. 

  4903. cached in the $ADODB_CACHE_DIR directory for $secs2cache seconds. Good for
    4904. 

  4904. speeding up queries on rarely changing data. Note that the $secs2cache
    4905. 

  4905. parameter is optional. If omitted, we use the value in
    4906. 

  4906. $connection-&gt;cacheSecs (default is 3600 seconds, or 1 hour). </p>
    4907. 

  4907. 

  4908. <p><b>Prepare<a name=prepare></a>($sql )</b></p>
    4909. 

  4909. 

  4910. <p>Prepares (compiles) an SQL query for repeated execution. Bind parameters are
    4911. 

  4911. denoted by ?, except for the oci8 driver, which uses the traditional Oracle
    4912. 

  4912. :varname convention. </p>
    4913. 

  4913. 

  4914. <p>Returns an array containing the original sql statement in the first array
    4915. 

  4915. element; the remaining elements of the array are driver dependent. If there is
    4916. 

  4916. an error, or we are emulating Prepare( ), we return the original $sql string.
    4917. 

  4917. This is because all error-handling has been centralized in Execute( ).</p>
    4918. 

  4918. 

  4919. <p>Prepare( ) cannot be used with functions that use SQL query rewriting
    4920. 

  4920. techniques, e.g. PageExecute( ) and SelectLimit( ).</p>
    4921. 

  4921. 

  4922. <p>Example:</p>
    4923. 

  4923. 

  4924. <div style='mso-element:para-border-div;border:solid #DDDDDD 1.0pt;mso-border-alt:
    4925. 

  4925. solid #DDDDDD .75pt;padding:9.0pt 18.0pt 9.0pt 18.0pt;background:#EEEEEE'><pre
    4926. 

  4926. style='background:#EEEEEE'>$stmt = $DB-&gt;Prepare('insert into table (col1,col2) values (?,?)');<br>
    4927. 

  4927. for ($i=0; $i &lt; $max; $i++)<br>
    4928. 

  4928. <span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$DB-&gt;Execute($stmt,array((string) rand(), $i));</pre></div>
    4929. 

  4929. 

  4930. <p>Also see InParameter(), OutParameter() and PrepareSP() below. Only supported
    4931. 

  4931. internally by interbase, oci8 and selected ODBC-based drivers, otherwise it is
    4932. 

  4932. emulated. There is no performance advantage to using Prepare() with emulation. </p>
    4933. 

  4933. 

  4934. <p>Important: Due to limitations or bugs in PHP, if you are getting errors when
    4935. 

  4935. you using prepared queries, try setting $ADODB_COUNTRECS = false before
    4936. 

  4936. preparing. This behaviour has been observed with ODBC. </p>
    4937. 

  4937. 

  4938. <p><b>IfNull<a name=ifnull></a>($field, $nullReplacementValue)</b></p>
    4939. 

  4939. 

  4940. <p>Portable IFNULL function (NVL in Oracle). Returns a string that represents
    4941. 

  4941. the function that checks whether a $field is null for the given database, and
    4942. 

  4942. if null, change the value returned to $nullReplacementValue. Eg.</p>
    4943. 

  4943. 

  4944. <div style='mso-element:para-border-div;border:solid #DDDDDD 1.0pt;mso-border-alt:
    4945. 

  4945. solid #DDDDDD .75pt;padding:9.0pt 18.0pt 9.0pt 18.0pt;background:#EEEEEE'><pre
    4946. 

  4946. style='background:#EEEEEE'>$sql = <span style='color:#993300'>'SELECT '</span>.$db-&gt;IfNull('name', <span
    4947. 

  4947. style='color:#993300'>&quot;'- unknown -'&quot;</span>).<span style='color:
    4948. 

  4948. #993300'> ' FROM table'</span>;</pre></div>
    4949. 

  4949. 

  4950. <p><b>length</b><a name=length></a></p>
    4951. 

  4951. 

  4952. <p>This is not a function, but a property. Some databases have
    4953. 

  4953. &quot;length&quot; and others &quot;len&quot; as the function to measure the
    4954. 

  4954. length of a string. To use this property: </p>
    4955. 

  4955. 

  4956. <div style='mso-element:para-border-div;border:solid #DDDDDD 1.0pt;mso-border-alt:
    4957. 

  4957. solid #DDDDDD .75pt;padding:9.0pt 18.0pt 9.0pt 18.0pt;background:#EEEEEE'><pre
    4958. 

  4958. style='background:#EEEEEE'><span style='mso-spacerun:yes'>&nbsp; </span>$sql = <span
    4959. 

  4959. style='color:#993300'>&quot;SELECT &quot;</span>.$db-&gt;length.<span
    4960. 

  4960. style='color:#993300'>&quot;(field) from table&quot;</span>;<br>
    4961. 

  4961. <span style='mso-spacerun:yes'>&nbsp; </span>$rs = $db-&gt;Execute($sql);</pre></div>
    4962. 

  4962. 

  4963. <p><b>random</b><a name=random></a></p>
    4964. 

  4964. 

  4965. <p>This is not a function, but a property. This is a string that holds the sql
    4966. 

  4966. to generate a random number between 0.0 and 1.0 inclusive. </p>
    4967. 

  4967. 

  4968. <p><b>substr</b><a name=substr></a></p>
    4969. 

  4969. 

  4970. <p>This is not a function, but a property. Some databases have
    4971. 

  4971. &quot;substr&quot; and others &quot;substring&quot; as the function to retrieve
    4972. 

  4972. a sub-string. To use this property: </p>
    4973. 

  4973. 

  4974. <div style='mso-element:para-border-div;border:solid #DDDDDD 1.0pt;mso-border-alt:
    4975. 

  4975. solid #DDDDDD .75pt;padding:9.0pt 18.0pt 9.0pt 18.0pt;background:#EEEEEE'><pre
    4976. 

  4976. style='background:#EEEEEE'><span style='mso-spacerun:yes'>&nbsp; </span>$sql = <span
    4977. 

  4977. style='color:#993300'>&quot;SELECT &quot;</span>.$db-&gt;substr.<span
    4978. 

  4978. style='color:#993300'>&quot;(field, $offset, $length) from table&quot;</span>;<br>
    4979. 

  4979. <span style='mso-spacerun:yes'>&nbsp; </span>$rs = $db-&gt;Execute($sql);</pre></div>
    4980. 

  4980. 

  4981. <p>For all databases, the 1st parameter of <i>substr</i> is the field, the 2nd
    4982. 

  4982. is the offset (1-based) to the beginning of the sub-string, and the 3rd is the
    4983. 

  4983. length of the sub-string. </p>
    4984. 

  4984. 

  4985. <p><b>Param<a name=param></a>($name)</b></p>
    4986. 

  4986. 

  4987. <p>Generates a bind placeholder portably. For most databases, the bind
    4988. 

  4988. placeholder is &quot;?&quot;. However some databases use named bind parameters
    4989. 

  4989. such as Oracle, eg &quot;:somevar&quot;. This allows us to portably define an
    4990. 

  4990. SQL statement with bind parameters: </p>
    4991. 

  4991. 

  4992. <div style='mso-element:para-border-div;border:solid #DDDDDD 1.0pt;mso-border-alt:
    4993. 

  4993. solid #DDDDDD .75pt;padding:9.0pt 18.0pt 9.0pt 18.0pt;background:#EEEEEE'><pre
    4994. 

  4994. style='background:#EEEEEE'>$sql = <span style='color:#993300'>'insert into table (col1,col2) values ('</span>.$DB-&gt;Param('a').<span
    4995. 

  4995. style='color:#993300'>','</span>.$DB-&gt;Param('b').<span style='color:#993300'>')'</span>;<br>
    4996. 

  4996. <span style='color:#006600'># generates 'insert into table (col1,col2) values (?,?)'<br>
    4997. 

  4997. # or<span style='mso-spacerun:yes'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>'insert into table (col1,col2) values (:a,:b)</span>'<br>
    4998. 

  4998. $stmt = $DB-&gt;Prepare($sql);<br>
    4999. 

  4999. $stmt = $DB-&gt;Execute($stmt,array('one','two'));</pre></div>
    5000. 

  5000. 

  5001. <p><b>PrepareSP<a name=preparesp></a>($sql, $cursor=false )</b></p>
    5002. 

  5002. 

  5003. <p>When calling stored procedures in mssql and oci8 (oracle), and you might
    5004. 

  5004. want to directly bind to parameters that return values, or for special LOB
    5005. 

  5005. handling. PrepareSP() allows you to do so. </p>
    5006. 

  5006. 

  5007. <p>Returns the same array or $sql string as Prepare( ) above. If you do not
    5008. 

  5008. need to bind to return values, you should use Prepare( ) instead.</p>
    5009. 

  5009. 

  5010. <p>The 2nd parameter, $cursor is not used except with oci8. Setting it to true
    5011. 

  5011. will force OCINewCursor to be called; this is to support output REF CURSORs. </p>
    5012. 

  5012. 

  5013. <p>For examples of usage of PrepareSP( ), see InParameter( ) below. </p>
    5014. 

  5014. 

  5015. <p>Note: in the mssql driver, preparing stored procedures requires a special
    5016. 

  5016. function call, mssql_init( ), which is called by this function. PrepareSP( ) is
    5017. 

  5017. available in all other drivers, and is emulated by calling Prepare( ). </p>
    5018. 

  5018. 

  5019. <p><b>InParameter<a name=inparameter></a>($stmt, $var, $name, $maxLen = 4000,
    5020. 

  5020. $type = false )</b></p>
    5021. 

  5021. 

  5022. <p class=MsoNormal>Binds a PHP variable as input to a stored procedure
    5023. 

  5023. variable. The parameter <i>$stmt</i> is the value returned by PrepareSP(), <i>$var</i>
    5024. 

  5024. is the PHP variable you want to bind, $name is the name of the stored procedure
    5025. 

  5025. variable. Optional is <i>$maxLen</i>, the maximum length of the data to bind,
    5026. 

  5026. and $type which is database dependant. Consult <a
    5027. 

  5027. href="http://php.net/mssql_bind">mssql_bind</a> and <a
    5028. 

  5028. href="http://php.net/ocibindbyname">ocibindbyname</a> docs at php.net for more
    5029. 

  5029. info on legal values for $type. </p>
    5030. 

  5030. 

  5031. <p>InParameter() is a wrapper function that calls Parameter() with
    5032. 

  5032. $isOutput=false. The advantage of this function is that it is self-documenting,
    5033. 

  5033. because the $isOutput parameter is no longer needed. Only for mssql and oci8
    5034. 

  5034. currently. </p>
    5035. 

  5035. 

  5036. <p>Here is an example using oci8: </p>
    5037. 

  5037. 

  5038. <div style='mso-element:para-border-div;border:solid #DDDDDD 1.0pt;mso-border-alt:
    5039. 

  5039. solid #DDDDDD .75pt;padding:9.0pt 18.0pt 9.0pt 18.0pt;background:#EEEEEE'><pre><span
    5040. 

  5040. style='color:green'># For oracle, Prepare and PrepareSP are identical</span></pre><pre>$stmt = $db-&gt;PrepareSP(</pre><pre
    5041. 

  5041. style='background:#EEEEEE'><span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span><span
    5042. 

  5042. style='color:#993300'>&quot;declare RETVAL integer; <br>
    5043. 

  5043. <span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>begin<br>
    5044. 

  5044. <span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>:RETVAL := SP_RUNSOMETHING(:myid,:group);<br>
    5045. 

  5045. <span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>end;&quot;</span>);<br>
    5046. 

  5046. $db-&gt;InParameter($stmt,$id,'myid');<br>
    5047. 

  5047. $db-&gt;InParameter($stmt,$group,'group',64);<br>
    5048. 

  5048. $db-&gt;OutParameter($stmt,$ret,'RETVAL');<br>
    5049. 

  5049. $db-&gt;Execute($stmt);</pre></div>
    5050. 

  5050. 

  5051. <p>The same example using mssql:</p>
    5052. 

  5052. 

  5053. <div style='mso-element:para-border-div;border:solid #DDDDDD 1.0pt;mso-border-alt:
    5054. 

  5054. solid #DDDDDD .75pt;padding:9.0pt 18.0pt 9.0pt 18.0pt;background:#EEEEEE'><pre><span
    5055. 

  5055. style='color:green'># @RETVAL = SP_RUNSOMETHING @myid,@group</span></pre><pre>$stmt = $db-&gt;PrepareSP(<span
    5056. 

  5056. style='color:#993333'>'</span><span style='color:#993300'>SP_RUNSOMETHING</span><span
    5057. 

  5057. style='color:#993333'>'</span>); <br>
    5058. 

  5058. <span style='color:green'># note that the parameter name does not have @ in front!</span></pre><pre>$db-&gt;InParameter($stmt,$id,'myid');</pre><pre>$db-&gt;InParameter($stmt,$group,'group',64);</pre><pre
    5059. 

  5059. style='background:#EEEEEE'><span style='color:green'># return value in mssql - RETVAL is hard-coded name</span> <br>
    5060. 

  5060. $db-&gt;OutParameter($stmt,$ret,'RETVAL');<br>
    5061. 

  5061. $db-&gt;Execute($stmt); </pre></div>
    5062. 

  5062. 

  5063. <p>Note that the only difference between the oci8 and mssql implementations is
    5064. 

  5064. $sql.</p>
    5065. 

  5065. 

  5066. <p>If $type parameter is set to false, in mssql, $type will be dynamicly
    5067. 

  5067. determined based on the type of the PHP variable passed <span style='font-family:
    5068. 

  5068. "Courier New"'>(string =&gt; SQLCHAR, boolean =&gt;SQLINT1, integer
    5069. 

  5069. =&gt;SQLINT4 or float/double=&gt;SQLFLT8)</span>. </p>
    5070. 

  5070. 

  5071. <p>In oci8, $type can be set to OCI_B_FILE (Binary-File), OCI_B_CFILE
    5072. 

  5072. (Character-File), OCI_B_CLOB (Character-LOB), OCI_B_BLOB (Binary-LOB) and
    5073. 

  5073. OCI_B_ROWID (ROWID). To pass in a null, use<span style='font-family:"Courier New"'>
    5074. 

  5074. $db-&gt;Parameter($stmt, $null=null, 'param')</span>. </p>
    5075. 

  5075. 

  5076. <p><b>OutParameter<a name=outparameter></a>($stmt, $var, $name, $maxLen = 4000,
    5077. 

  5077. $type = false )</b></p>
    5078. 

  5078. 

  5079. <p class=MsoNormal>Binds a PHP variable as output from a stored procedure
    5080. 

  5080. variable. The parameter <i>$stmt</i> is the value returned by PrepareSP(), <i>$var</i>
    5081. 

  5081. is the PHP variable you want to bind, <i>$name</i> is the name of the stored
    5082. 

  5082. procedure variable. Optional is <i>$maxLen</i>, the maximum length of the data
    5083. 

  5083. to bind, and <i>$type</i> which is database dependant. </p>
    5084. 

  5084. 

  5085. <p>OutParameter() is a wrapper function that calls Parameter() with
    5086. 

  5086. $isOutput=true. The advantage of this function is that it is self-documenting,
    5087. 

  5087. because the $isOutput parameter is no longer needed. Only for mssql and oci8
    5088. 

  5088. currently. </p>
    5089. 

  5089. 

  5090. <p>For an example, see <a href="#inparameter">InParameter</a>. </p>
    5091. 

  5091. 

  5092. <p><b>Parameter<a name=parameter></a>($stmt, $var, $name, $isOutput=false,
    5093. 

  5093. $maxLen = 4000, $type = false )</b></p>
    5094. 

  5094. 

  5095. <p>Note: This function is deprecated, because of the new InParameter() and
    5096. 

  5096. OutParameter() functions. These are superior because they are self-documenting,
    5097. 

  5097. unlike Parameter(). </p>
    5098. 

  5098. 

  5099. <p>Adds a bind parameter suitable for return values or special data handling
    5100. 

  5100. (eg. LOBs) after a statement has been prepared using PrepareSP(). Only for
    5101. 

  5101. mssql and oci8 currently. The parameters are:<br>
    5102. 

  5102. <br>
    5103. 

  5103. $<b><i>stmt</i></b> Statement returned by Prepare() or PrepareSP().<br>
    5104. 

  5104. $<b><i>var</i></b> PHP variable to bind to. Make sure you pre-initialize it!<br>
    5105. 

  5105. $<b><i>name</i></b> Name of stored procedure variable name to bind to.<br>
    5106. 

  5106. [$<b><i>isOutput</i></b>] Indicates direction of parameter 0/false=IN 1=OUT 2=
    5107. 

  5107. IN/OUT. This is ignored in oci8 as this driver auto-detects the direction.<br>
    5108. 

  5108. [$<b>maxLen</b>] Maximum length of the parameter variable.<br>
    5109. 

  5109. [$<b>type</b>] Consult <a href="http://php.net/mssql_bind">mssql_bind</a> and <a
    5110. 

  5110. href="http://php.net/ocibindbyname">ocibindbyname</a> docs at php.net for more
    5111. 

  5111. info on legal values for type.</p>
    5112. 

  5112. 

  5113. <p>Lastly, in oci8, bind parameters can be reused without calling PrepareSP( ) or
    5114. 

  5114. Parameters again. This is not possible with mssql. An oci8 example:</p>
    5115. 

  5115. 

  5116. <div style='mso-element:para-border-div;border:solid #DDDDDD 1.0pt;mso-border-alt:
    5117. 

  5117. solid #DDDDDD .75pt;padding:9.0pt 18.0pt 9.0pt 18.0pt;background:#EEEEEE'><pre>$id = 0; $i = 0;<br>
    5118. 

  5118. $stmt = $db-&gt;PrepareSP( <span style='color:#993300'>&quot;update table set val=:i where id=:id&quot;</span>);<br>
    5119. 

  5119. $db-&gt;Parameter($stmt,$id,'id');<br>
    5120. 

  5120. $db-&gt;Parameter($stmt,$i, 'i');<br>
    5121. 

  5121. for ($cnt=0; $cnt &lt; 1000; $cnt++) {<br>
    5122. 

  5122. <span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$id = $cnt; <br>
    5123. 

  5123. <span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$i = $cnt * $cnt; <span
    5124. 

  5124. style='color:green'># works with oci8!</span></pre><pre style='background:#EEEEEE'><span
    5125. 

  5125. style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$db-&gt;Execute($stmt); <br>
    5126. 

  5126. }</pre></div>
    5127. 

  5127. 

  5128. <p><b>Bind<a name=bind></a>($stmt, $var, $size=4001, $type=false, $name=false)</b></p>
    5129. 

  5129. 

  5130. <p>This is a low-level function supported only by the oci8 driver. <b>Avoid
    5131. 

  5131. using</b> unless you only want to support Oracle. The Parameter( ) function is
    5132. 

  5132. the recommended way to go with bind variables.</p>
    5133. 

  5133. 

  5134. <p>Bind( ) allows you to use bind variables in your sql statement. This binds a
    5135. 

  5135. PHP variable to a name defined in an Oracle sql statement that was previously
    5136. 

  5136. prepared using Prepare(). Oracle named variables begin with a colon, and ADOdb
    5137. 

  5137. requires the named variables be called :0, :1, :2, :3, etc. The first
    5138. 

  5138. invocation of Bind() will match :0, the second invocation will match :1, etc.
    5139. 

  5139. Binding can provide 100% speedups for insert, select and update statements. </p>
    5140. 

  5140. 

  5141. <p>The other variables, $size sets the buffer size for data storage, $type is
    5142. 

  5142. the optional descriptor type OCI_B_FILE (Binary-File), OCI_B_CFILE
    5143. 

  5143. (Character-File), OCI_B_CLOB (Character-LOB), OCI_B_BLOB (Binary-LOB) and
    5144. 

  5144. OCI_B_ROWID (ROWID). Lastly, instead of using the default :0, :1, etc names,
    5145. 

  5145. you can define your own bind-name using $name. </p>
    5146. 

  5146. 

  5147. <p>The following example shows 3 bind variables being used: p1, p2 and p3.
    5148. 

  5148. These variables are bound to :0, :1 and :2.</p>
    5149. 

  5149. 

  5150. <div style='mso-element:para-border-div;border:solid #DDDDDD 1.0pt;mso-border-alt:
    5151. 

  5151. solid #DDDDDD .75pt;padding:9.0pt 18.0pt 9.0pt 18.0pt;background:#EEEEEE'><pre
    5152. 

  5152. style='background:#EEEEEE'>$stmt = $DB-&gt;Prepare(&quot;insert into table (col0, col1, col2) values (:0, :1, :2)&quot;);<br>
    5153. 

  5153. $DB-&gt;Bind($stmt, $p1);<br>
    5154. 

  5154. $DB-&gt;Bind($stmt, $p2);<br>
    5155. 

  5155. $DB-&gt;Bind($stmt, $p3);<br>
    5156. 

  5156. for ($i = 0; $i &lt; $max; $i++) { <br>
    5157. 

  5157. <span style='mso-spacerun:yes'>&nbsp;&nbsp; </span>$p1 = ?; $p2 = ?; $p3 = ?;<br>
    5158. 

  5158. <span style='mso-spacerun:yes'>&nbsp;&nbsp; </span>$DB-&gt;Execute($stmt);<br>
    5159. 

  5159. }</pre></div>
    5160. 

  5160. 

  5161. <p>You can also use named variables:</p>
    5162. 

  5162. 

  5163. <div style='mso-element:para-border-div;border:solid #DDDDDD 1.0pt;mso-border-alt:
    5164. 

  5164. solid #DDDDDD .75pt;padding:9.0pt 18.0pt 9.0pt 18.0pt;background:#EEEEEE'><pre
    5165. 

  5165. style='background:#EEEEEE'>$stmt = $DB-&gt;Prepare(&quot;insert into table (col0, col1, col2) values (:name0, :name1, :name2)&quot;);<br>
    5166. 

  5166. $DB-&gt;Bind($stmt, $p1, &quot;name0&quot;);<br>
    5167. 

  5167. $DB-&gt;Bind($stmt, $p2, &quot;name1&quot;);<br>
    5168. 

  5168. $DB-&gt;Bind($stmt, $p3, &quot;name2&quot;);<br>
    5169. 

  5169. for ($i = 0; $i &lt; $max; $i++) { <br>
    5170. 

  5170. <span style='mso-spacerun:yes'>&nbsp;&nbsp; </span>$p1 = ?; $p2 = ?; $p3 = ?;<br>
    5171. 

  5171. <span style='mso-spacerun:yes'>&nbsp;&nbsp; </span>$DB-&gt;Execute($stmt);<br>
    5172. 

  5172. }</pre></div>
    5173. 

  5173. 

  5174. <p><b>LogSQL($enable=true)</b><a name=logsql></a></p>
    5175. 

  5175. 

  5176. <p class=MsoNormal>Call this method to install a SQL logging and timing
    5177. 

  5177. function (using fnExecute). Then all SQL statements are logged into an
    5178. 

  5178. adodb_logsql table in a database. If the adodb_logsql table does not exist,
    5179. 

  5179. ADOdb will create the table if you have the appropriate permissions. Returns
    5180. 

  5180. the previous logging value (true for enabled, false for disabled). Here are
    5181. 

  5181. samples of the DDL for selected databases: </p>
    5182. 

  5182. 

  5183. <div style='mso-element:para-border-div;border:solid #DDDDDD 1.0pt;mso-border-alt:
    5184. 

  5184. solid #DDDDDD .75pt;padding:9.0pt 18.0pt 9.0pt 18.0pt;background:#EEEEEE'><pre><span
    5185. 

  5185. style='mso-tab-count:2'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span><b>mysql:</b></pre><pre><span
    5186. 

  5186. style='mso-tab-count:2'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>CREATE TABLE adodb_logsql (</pre><pre><span
    5187. 

  5187. style='mso-tab-count:2'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span><span style='mso-spacerun:yes'>&nbsp; </span>created datetime NOT NULL,</pre><pre><span
    5188. 

  5188. style='mso-tab-count:2'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span><span style='mso-spacerun:yes'>&nbsp; </span>sql0 varchar(250) NOT NULL,</pre><pre><span
    5189. 

  5189. style='mso-tab-count:2'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span><span style='mso-spacerun:yes'>&nbsp; </span>sql1 text NOT NULL,</pre><pre><span
    5190. 

  5190. style='mso-tab-count:2'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span><span style='mso-spacerun:yes'>&nbsp; </span>params text NOT NULL,</pre><pre><span
    5191. 

  5191. style='mso-tab-count:2'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span><span style='mso-spacerun:yes'>&nbsp; </span>tracer text NOT NULL,</pre><pre><span
    5192. 

  5192. style='mso-tab-count:2'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span><span style='mso-spacerun:yes'>&nbsp; </span>timer decimal(16,6) NOT NULL</pre><pre><span
    5193. 

  5193. style='mso-tab-count:2'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>)</pre><pre><span
    5194. 

  5194. style='mso-tab-count:2'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></pre><pre><span
    5195. 

  5195. style='mso-tab-count:2'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span><b>postgres:</b></pre><pre><span
    5196. 

  5196. style='mso-tab-count:2'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>CREATE TABLE adodb_logsql (</pre><pre><span
    5197. 

  5197. style='mso-tab-count:2'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span><span style='mso-spacerun:yes'>&nbsp; </span>created timestamp NOT NULL,</pre><pre><span
    5198. 

  5198. style='mso-tab-count:2'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span><span style='mso-spacerun:yes'>&nbsp; </span>sql0 varchar(250) NOT NULL,</pre><pre><span
    5199. 

  5199. style='mso-tab-count:2'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span><span style='mso-spacerun:yes'>&nbsp; </span>sql1 text NOT NULL,</pre><pre><span
    5200. 

  5200. style='mso-tab-count:2'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span><span style='mso-spacerun:yes'>&nbsp; </span>params text NOT NULL,</pre><pre><span
    5201. 

  5201. style='mso-tab-count:2'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span><span style='mso-spacerun:yes'>&nbsp; </span>tracer text NOT NULL,</pre><pre><span
    5202. 

  5202. style='mso-tab-count:2'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span><span style='mso-spacerun:yes'>&nbsp; </span>timer decimal(16,6) NOT NULL</pre><pre><span
    5203. 

  5203. style='mso-tab-count:2'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>)</pre><pre><span
    5204. 

  5204. style='mso-tab-count:2'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></pre><pre><span
    5205. 

  5205. style='mso-tab-count:2'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span><b>mssql:</b></pre><pre><span
    5206. 

  5206. style='mso-tab-count:2'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>CREATE TABLE adodb_logsql (</pre><pre><span
    5207. 

  5207. style='mso-tab-count:2'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span><span style='mso-spacerun:yes'>&nbsp; </span>created datetime NOT NULL,</pre><pre><span
    5208. 

  5208. style='mso-tab-count:2'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span><span style='mso-spacerun:yes'>&nbsp; </span>sql0 varchar(250) NOT NULL,</pre><pre><span
    5209. 

  5209. style='mso-tab-count:2'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span><span style='mso-spacerun:yes'>&nbsp; </span>sql1 varchar(4000) NOT NULL,</pre><pre><span
    5210. 

  5210. style='mso-tab-count:2'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span><span style='mso-spacerun:yes'>&nbsp; </span>params varchar(3000) NOT NULL,</pre><pre><span
    5211. 

  5211. style='mso-tab-count:2'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span><span style='mso-spacerun:yes'>&nbsp; </span>tracer varchar(500) NOT NULL,</pre><pre><span
    5212. 

  5212. style='mso-tab-count:2'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span><span style='mso-spacerun:yes'>&nbsp; </span>timer decimal(16,6) NOT NULL</pre><pre><span
    5213. 

  5213. style='mso-tab-count:2'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>)</pre><pre><span
    5214. 

  5214. style='mso-tab-count:2'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></pre><pre><span
    5215. 

  5215. style='mso-tab-count:2'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span><b>oci8:</b></pre><pre><span
    5216. 

  5216. style='mso-tab-count:2'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>CREATE TABLE adodb_logsql (</pre><pre><span
    5217. 

  5217. style='mso-tab-count:2'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span><span style='mso-spacerun:yes'>&nbsp; </span>created date NOT NULL,</pre><pre><span
    5218. 

  5218. style='mso-tab-count:2'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span><span style='mso-spacerun:yes'>&nbsp; </span>sql0 varchar(250) NOT NULL,</pre><pre><span
    5219. 

  5219. style='mso-tab-count:2'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span><span style='mso-spacerun:yes'>&nbsp; </span>sql1 varchar(4000) NOT NULL,</pre><pre><span
    5220. 

  5220. style='mso-tab-count:2'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span><span style='mso-spacerun:yes'>&nbsp; </span>params varchar(4000),</pre><pre><span
    5221. 

  5221. style='mso-tab-count:2'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span><span style='mso-spacerun:yes'>&nbsp; </span>tracer varchar(4000),</pre><pre><span
    5222. 

  5222. style='mso-tab-count:2'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span><span style='mso-spacerun:yes'>&nbsp; </span>timer decimal(16,6) NOT NULL</pre><pre><span
    5223. 

  5223. style='mso-tab-count:2'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>)</pre></div>
    5224. 

  5224. 

  5225. <p class=MsoNormal>Usage: </p>
    5226. 

  5226. 

  5227. <div style='mso-element:para-border-div;border:solid #DDDDDD 1.0pt;mso-border-alt:
    5228. 

  5228. solid #DDDDDD .75pt;padding:9.0pt 18.0pt 9.0pt 18.0pt;background:#EEEEEE'><pre
    5229. 

  5229. style='background:#EEEEEE'><span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$conn-&gt;LogSQL(); // turn on logging<br>
    5230. 

  5230. <span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span><span style='mso-spacerun:yes'>&nbsp; </span>:<br>
    5231. 

  5231. <span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$conn-&gt;Execute(...);<br>
    5232. 

  5232. <span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span><span style='mso-spacerun:yes'>&nbsp; </span>:<br>
    5233. 

  5233. <span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$conn-&gt;LogSQL(false); // turn off logging<br>
    5234. 

  5234. <span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span><br>
    5235. 

  5235. <span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span># output summary of SQL logging results<br>
    5236. 

  5236. <span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$perf = NewPerfMonitor($conn);<br>
    5237. 

  5237. <span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>echo $perf-&gt;SuspiciousSQL();<br>
    5238. 

  5238. <span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>echo $perf-&gt;ExpensiveSQL();</pre></div>
    5239. 

  5239. 

  5240. <p>One limitation of logging is that rollback also prevents SQL from being
    5241. 

  5241. logged. </p>
    5242. 

  5242. 

  5243. <p>If you prefer to use another name for the table used to store the SQL, you
    5244. 

  5244. can override it by calling adodb_perf::table($tablename), where $tablename is
    5245. 

  5245. the new table name (you will still need to manually create the table yourself).
    5246. 

  5246. An example: </p>
    5247. 

  5247. 

  5248. <div style='mso-element:para-border-div;border:solid #DDDDDD 1.0pt;mso-border-alt:
    5249. 

  5249. solid #DDDDDD .75pt;padding:9.0pt 18.0pt 9.0pt 18.0pt;background:#EEEEEE'><pre
    5250. 

  5250. style='background:#EEEEEE'><span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>include('adodb.inc.php');<br>
    5251. 

  5251. <span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>include('adodb-perf.inc.php');<br>
    5252. 

  5252. <span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>adodb_perf::table('my_logsql_table');</pre></div>
    5253. 

  5253. 

  5254. <p class=MsoNormal>Also see <a href="docs-perf.htm">Performance Monitor</a>. </p>
    5255. 

  5255. 

  5256. <p><b>fnExecute and fnCacheExecute properties</b><a name=fnexecute
    5257. 

  5257. id=fnexecute></a></p>
    5258. 

  5258. 

  5259. <p>These two properties allow you to define bottleneck functions for all sql
    5260. 

  5260. statements processed by ADOdb. This allows you to perform statistical analysis
    5261. 

  5261. and query-rewriting of your sql. </p>
    5262. 

  5262. 

  5263. <p><b>Examples of fnExecute</b></p>
    5264. 

  5264. 

  5265. <p>Here is an example of using fnExecute, to count all cached queries and
    5266. 

  5266. non-cached queries, you can do this:</p>
    5267. 

  5267. 

  5268. <div style='mso-element:para-border-div;border:solid #DDDDDD 1.0pt;mso-border-alt:
    5269. 

  5269. solid #DDDDDD .75pt;padding:9.0pt 18.0pt 9.0pt 18.0pt;background:#EEEEEE'><pre><span
    5270. 

  5270. style='color:#006600'># $db is the connection object</span></pre><pre>function &amp;CountExecs($db, $sql, $inputarray)</pre><pre>{</pre><pre>global $EXECS;</pre><pre><o:p>&nbsp;</o:p></pre><pre><span
    5271. 

  5271. style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>if (!is_array(inputarray)) $EXECS++;</pre><pre><span
    5272. 

  5272. style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span><span style='color:#006600'># handle 2-dimensional input arrays</span></pre><pre><span
    5273. 

  5273. style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>else if (is_array(reset($inputarray))) $EXECS += sizeof($inputarray);</pre><pre><span
    5274. 

  5274. style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>else $EXECS++;</pre><pre><span
    5275. 

  5275. style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></pre><pre><span style='mso-tab-count:
    5276. 

  5276. 1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span><span style='color:#006600'># in PHP4.4 and PHP5, we need to return a value by reference</span></pre><pre><span
    5277. 

  5277. style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$null = null;</pre><pre><span
    5278. 

  5278. style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>return $null;</pre><pre>}</pre><pre><o:p>&nbsp;</o:p></pre><pre><span
    5279. 

  5279. style='color:#006600'># $db is the connection object</span></pre><pre>function CountCachedExecs($db, $secs2cache, $sql, $inputarray)</pre><pre
    5280. 

  5280. style='background:#EEEEEE'>{<br>
    5281. 

  5281. global $CACHED; $CACHED++;<br>
    5282. 

  5282. }<br>
    5283. 

  5283. <br>
    5284. 

  5284. $db = NewADOConnection('mysql');<br>
    5285. 

  5285. $db-&gt;Connect(...);<br>
    5286. 

  5286. $db-&gt;<strong><span style='font-family:"Courier New"'>fnExecute</span></strong> = 'CountExecs';<br>
    5287. 

  5287. $db-&gt;<strong><span style='font-family:"Courier New"'>fnCacheExecute</span></strong> = 'CountCachedExecs';<br>
    5288. 

  5288. <span style='mso-spacerun:yes'>&nbsp;</span>:<br>
    5289. 

  5289. <span style='mso-spacerun:yes'>&nbsp;</span>:<br>
    5290. 

  5290. <span style='color:#006600'># After many sql statements:</span>`<br>
    5291. 

  5291. printf(&quot;&lt;p&gt;Total queries=%d; total cached=%d&lt;/p&gt;&quot;,$EXECS+$CACHED, $CACHED);</pre></div>
    5292. 

  5292. 

  5293. <p>The fnExecute function is called before the sql is parsed and executed, so
    5294. 

  5294. you can perform a query rewrite. If you are passing in a prepared statement,
    5295. 

  5295. then $sql is an array (see <a href="#prepare">Prepare</a>). The fnCacheExecute
    5296. 

  5296. function is only called if the recordset returned was cached. The function
    5297. 

  5297. parameters match the Execute and CacheExecute functions respectively, except
    5298. 

  5298. that $this (the connection object) is passed as the first parameter.</p>
    5299. 

  5299. 

  5300. <p>Since ADOdb 3.91, the behaviour of fnExecute varies depending on whether the
    5301. 

  5301. defined function returns a value. If it does not return a value, then the $sql
    5302. 

  5302. is executed as before. This is useful for query rewriting or counting sql
    5303. 

  5303. queries. </p>
    5304. 

  5304. 

  5305. <p>On the other hand, you might want to replace the Execute function with one
    5306. 

  5306. of your own design. If this is the case, then have your function return a
    5307. 

  5307. value. If a value is returned, that value is returned immediately, without any
    5308. 

  5308. further processing. This is used internally by ADOdb to implement LogSQL()
    5309. 

  5309. functionality. </p>
    5310. 

  5310. 

  5311. <div class=MsoNormal align=center style='text-align:center'>
    5312. 

  5312. 

  5313. <hr size=2 width="100%" align=center>
    5314. 

  5314. 

  5315. </div>
    5316. 

  5316. 

  5317. <h3>ADOConnection Utility Functions</h3>
    5318. 

  5318. 

  5319. <p><b>BlankRecordSet<a name=blankrecordset></a>([$queryid])</b></p>
    5320. 

  5320. 

  5321. <p>No longer available - removed since 1.99.</p>
    5322. 

  5322. 

  5323. <p><b>Concat<a name=concat></a>($s1,$s2,....)</b></p>
    5324. 

  5324. 

  5325. <p>Generates the sql string used to concatenate $s1, $s2, etc together. Uses
    5326. 

  5326. the string in the concat_operator field to generate the concatenation. Override
    5327. 

  5327. this function if a concatenation operator is not used, eg. MySQL.</p>
    5328. 

  5328. 

  5329. <p>Returns the concatenated string.</p>
    5330. 

  5330. 

  5331. <p><b>DBDate<a name=dbdate></a>($date)</b></p>
    5332. 

  5332. 

  5333. <p>Format the $<b>date</b> in the format the database accepts - the return
    5334. 

  5334. string is also quoted. This is used when you are sending dates to the database
    5335. 

  5335. (eg INSERT, UPDATE or where clause of SELECT statement). The $<b>date</b>
    5336. 

  5336. parameter can be a PHP DateTime object (since ADOdb 5.09), a Unix integer timestamp or an ISO format Y-m-d. Uses the
    5337. 

  5337. fmtDate field, which holds the format to use. If null or false or '' is passed
    5338. 

  5338. in, it will be converted to an SQL null.</p>
    5339. 

  5339. 

  5340. <p>Returns the date as a quoted string.</p>
    5341. 

  5341. 

  5342. <div style='mso-element:para-border-div;border:solid #DDDDDD 1.0pt;mso-border-alt:
    5343. 

  5343. solid #DDDDDD .75pt;padding:9.0pt 18.0pt 9.0pt 18.0pt;background:#EEEEEE'><pre><o:p>&nbsp;</o:p></pre><pre><span
    5344. 

  5344. style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$sql = &quot;select * from atable where created &gt; &quot;.$db-&gt;DBDate(&quot;$year-$month-$day&quot;);</pre><pre><span
    5345. 

  5345. style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$db-&gt;Execute($sql);</pre></div>
    5346. 

  5346. 

  5347. <p>Note to retrieve a date column in a specific format, use <a href="#sqldate">SQLDate</a>.
    5348. 

  5348. </p>
    5349. 

  5349. 

  5350. <p><b>BindDate<a name=binddate></a>($date)</b></p>
    5351. 

  5351. 

  5352. <p>Format the $<b>date</b> in the bind format the database accepts. Normally
    5353. 

  5353. this means that the date string is not quoted, unlike DBDate, which quotes the
    5354. 

  5354. string. </p>
    5355. 

  5355. 

  5356. <div style='mso-element:para-border-div;border:solid #DDDDDD 1.0pt;mso-border-alt:
    5357. 

  5357. solid #DDDDDD .75pt;padding:9.0pt 18.0pt 9.0pt 18.0pt;background:#EEEEEE'><pre><o:p>&nbsp;</o:p></pre><pre><span
    5358. 

  5358. style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$sql = &quot;select * from atable where created &gt; &quot;.$db-&gt;Param('0');</pre><pre><span
    5359. 

  5359. style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>// or</pre><pre><span style='mso-tab-count:
    5360. 

  5360. 1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$sql = &quot;select * from atable where created &gt; ?&quot;;</pre><pre><span
    5361. 

  5361. style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$db-&gt;Execute($sql,array($db-&gt;BindDate(&quot;$year-$month-$day&quot;));</pre></div>
    5362. 

  5362. 

  5363. <p><b>DBTimeStamp<a name=dbtimestamp></a>($ts)</b></p>
    5364. 

  5364. 

  5365. <p>Format the timestamp $<b>ts</b> in the format the database accepts; this can
    5366. 

  5366. be a PHP DateTime object (since ADOdb 5.09), a Unix integer timestamp or an ISO format Y-m-d H:i:s. Uses the fmtTimeStamp
    5367. 

  5367. field, which holds the format to use. If null or false or '' is passed in, it
    5368. 

  5368. will be converted to an SQL null.</p>
    5369. 

  5369. 

  5370. <p>Returns the timestamp as a quoted string.</p>
    5371. 

  5371. 

  5372. <div style='mso-element:para-border-div;border:solid #DDDDDD 1.0pt;mso-border-alt:
    5373. 

  5373. solid #DDDDDD .75pt;padding:9.0pt 18.0pt 9.0pt 18.0pt;background:#EEEEEE'><pre><o:p>&nbsp;</o:p></pre><pre><span
    5374. 

  5374. style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$sql = &quot;select * from atable where created &gt; &quot;.$db-&gt;DBTimeStamp(&quot;$year-$month-$day $hr:$min:$secs&quot;);</pre><pre><span
    5375. 

  5375. style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$db-&gt;Execute($sql);</pre></div>
    5376. 

  5376. 

  5377. <p><b>BindTimeStamp<a name=bindtimestamp></a>($ts)</b></p>
    5378. 

  5378. 

  5379. <p>Format the timestamp $<b>ts</b> in the bind format the database accepts.
    5380. 

  5380. Normally this means that the timestamp string is not quoted, unlike
    5381. 

  5381. DBTimeStamp, which quotes the string. </p>
    5382. 

  5382. 

  5383. <div style='mso-element:para-border-div;border:solid #DDDDDD 1.0pt;mso-border-alt:
    5384. 

  5384. solid #DDDDDD .75pt;padding:9.0pt 18.0pt 9.0pt 18.0pt;background:#EEEEEE'><pre><o:p>&nbsp;</o:p></pre><pre><span
    5385. 

  5385. style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$sql = &quot;select * from atable where created &gt; &quot;.$db-&gt;Param('0');</pre><pre><span
    5386. 

  5386. style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>// or</pre><pre><span style='mso-tab-count:
    5387. 

  5387. 1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$sql = &quot;select * from atable where created &gt; ?&quot;;</pre><pre><span
    5388. 

  5388. style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$db-&gt;Execute($sql,array($db-&gt;BindTimeStamp(&quot;$year-$month-$day $hr:$min:$secs&quot;));</pre></div>
    5389. 

  5389. 

  5390. <p><b>qstr<a name=qstr></a>($s,[$magic_quotes_enabled</b>=false]<b>)</b></p>
    5391. 

  5391. 

  5392. <p>Quotes a string to be sent to the database. The $<b>magic_quotes_enabled</b>
    5393. 

  5393. parameter may look funny, but the idea is if you are quoting a string extracted
    5394. 

  5394. from a POST/GET variable, then pass get_magic_quotes_gpc() as the second
    5395. 

  5395. parameter. This will ensure that the variable is not quoted twice, once by <i>qstr</i>
    5396. 

  5396. and once by the <i>magic_quotes_gpc</i>.</p>
    5397. 

  5397. 

  5398. <p>Eg.<span style='font-family:"Courier New"'> $s = $db-&gt;qstr(HTTP_GET_VARS['name'],get_magic_quotes_gpc());</span></p>
    5399. 

  5399. 

  5400. <p>Returns the quoted string.</p>
    5401. 

  5401. 

  5402. <p><b>Quote<a name=quote></a>($s)</b></p>
    5403. 

  5403. 

  5404. <p>Quotes the string $s, escaping the database specific quote character as
    5405. 

  5405. appropriate. Formerly checked magic quotes setting, but this was disabled since
    5406. 

  5406. 3.31 for compatibility with PEAR DB. </p>
    5407. 

  5407. 

  5408. <p><b>Affected_Rows<a name="affected_rows"></a>( )</b></p>
    5409. 

  5409. 

  5410. <p>Returns the number of rows affected by a update or delete statement. Returns
    5411. 

  5411. false if function not supported.</p>
    5412. 

  5412. 

  5413. <p>Not supported by interbase/firebird currently. </p>
    5414. 

  5414. 

  5415. <p><b>Insert_ID<a name="inserted_id"></a>( )</b></p>
    5416. 

  5416. 

  5417. <p>Returns the last autonumbering ID inserted. Returns false if function not
    5418. 

  5418. supported. </p>
    5419. 

  5419. 

  5420. <p>Only supported by databases that support auto-increment or object id's, such
    5421. 

  5421. as PostgreSQL, MySQL and MS SQL Server currently. PostgreSQL returns the OID,
    5422. 

  5422. which can change on a database reload.</p>
    5423. 

  5423. 

  5424. <p><b>RowLock<a name=rowlock></a>($table,$where)</b></p>
    5425. 

  5425. 

  5426. <p>Lock a table row for the duration of a transaction. For example to lock
    5427. 

  5427. record $id in table1: </p>
    5428. 

  5428. 

  5429. <div style='mso-element:para-border-div;border:solid #DDDDDD 1.0pt;mso-border-alt:
    5430. 

  5430. solid #DDDDDD .75pt;padding:9.0pt 18.0pt 9.0pt 18.0pt;background:#EEEEEE'><pre
    5431. 

  5431. style='background:#EEEEEE'><span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$DB-&gt;StartTrans();<br>
    5432. 

  5432. <span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$DB-&gt;RowLock(&quot;table1&quot;,&quot;rowid=$id&quot;);<br>
    5433. 

  5433. <span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$DB-&gt;Execute($sql1);<br>
    5434. 

  5434. <span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$DB-&gt;Execute($sql2);<br>
    5435. 

  5435. <span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$DB-&gt;CompleteTrans();</pre></div>
    5436. 

  5436. 

  5437. <p>Supported in db2, interbase, informix, mssql, oci8, postgres, sybase. </p>
    5438. 

  5438. 

  5439. <p><b>MetaDatabases<a name=metadatabases></a>()</b></p>
    5440. 

  5440. 

  5441. <p>Returns a list of databases available on the server as an array. You have to
    5442. 

  5442. connect to the server first. Only available for ODBC, MySQL and ADO.</p>
    5443. 

  5443. 

  5444. <p><b>MetaTables<a name=metatables></a>($ttype = false, $showSchema = false,
    5445. 

  5445. $mask=false)</b></p>
    5446. 

  5446. 

  5447. <p>Returns an array of tables and views for the current database as an array.
    5448. 

  5448. The array should exclude system catalog tables if possible. To only show
    5449. 

  5449. tables, use $db-&gt;MetaTables('TABLES'). To show only views, use
    5450. 

  5450. $db-&gt;MetaTables('VIEWS'). The $showSchema parameter currently works only for
    5451. 

  5451. DB2, and when set to true, will add the schema name to the table, eg.
    5452. 

  5452. &quot;SCHEMA.TABLE&quot;. </p>
    5453. 

  5453. 

  5454. <p>You can define a mask for matching. For example, setting $mask = 'TMP%' will
    5455. 

  5455. match all tables that begin with 'TMP'. Currently only mssql, oci8, odbc_mssql
    5456. 

  5456. and postgres* support $mask. </p>
    5457. 

  5457. 

  5458. <p><b>MetaColumns<a name=metacolumns></a>($table,$notcasesensitive=true)</b></p>
    5459. 

  5459. 

  5460. <p>Returns an array of ADOFieldObject's, one field object for every column of
    5461. 

  5461. $table. A field object is a class instance with (name, type, max_length)
    5462. 

  5462. defined. Currently Sybase does not recognise date types, and ADO cannot
    5463. 

  5463. identify the correct data type (so we default to varchar). </p>
    5464. 

  5464. 

  5465. <p>The $notcasesensitive parameter determines whether we uppercase or lowercase
    5466. 

  5466. the table name to normalize it (required for some databases). Does not work
    5467. 

  5467. with MySQL ISAM tables. </p>
    5468. 

  5468. 

  5469. <p>For schema support, pass in the $table parameter,
    5470. 

  5470. &quot;$schema.$tablename&quot;. This is only supported for selected databases. </p>
    5471. 

  5471. 

  5472. <p><b>MetaColumnNames<a name=metacolumnames></a>($table,$numericIndex=false)</b></p>
    5473. 

  5473. 

  5474. <p>Returns an array of column names for $table. Since ADOdb 4.22, this is an
    5475. 

  5475. associative array, with the keys in uppercase. Set $numericIndex=true if you
    5476. 

  5476. want the old behaviour of numeric indexes (since 4.23). </p>
    5477. 

  5477. 

  5478. <p>e.g. array('FIELD1' =&gt; 'Field1', 'FIELD2'=&gt;'Field2') </p>
    5479. 

  5479. 

  5480. <p><b>MetaPrimaryKeys<a name=metaprimarykeys></a>($table, $owner=false)</b> </p>
    5481. 

  5481. 

  5482. <p>Returns an array containing column names that are the primary keys of
    5483. 

  5483. $table. Supported by mysql, odbc (including db2, odbc_mssql, etc), mssql,
    5484. 

  5484. postgres, interbase/firebird, oci8 currently. </p>
    5485. 

  5485. 

  5486. <p>Views (and some tables) have primary keys, but sometimes this information is
    5487. 

  5487. not available from the database. You can define a function
    5488. 

  5488. ADODB_View_PrimaryKeys($databaseType, $database, $view, $owner) that should
    5489. 

  5489. return an array containing the fields that make up the primary key. If that
    5490. 

  5490. function exists, it will be called when MetaPrimaryKeys() cannot find a primary
    5491. 

  5491. key for a table or view. </p>
    5492. 

  5492. 

  5493. <div style='mso-element:para-border-div;border:solid #DDDDDD 1.0pt;mso-border-alt:
    5494. 

  5494. solid #DDDDDD .75pt;padding:9.0pt 18.0pt 9.0pt 18.0pt;background:#EEEEEE'><pre
    5495. 

  5495. style='background:#EEEEEE'>// In this example: dbtype = 'oci8', $db = 'mydb', $view = 'dataView', $owner = false <br>
    5496. 

  5496. function ADODB_View_PrimaryKeys($dbtype,$db,$view,$owner)<br>
    5497. 

  5497. {<br>
    5498. 

  5498. <span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>switch(strtoupper($view)) {<br>
    5499. 

  5499. <span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>case 'DATAVIEW': return array('DATAID');<br>
    5500. 

  5500. <span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>default: return false;<br>
    5501. 

  5501. <span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>}<br>
    5502. 

  5502. }<br>
    5503. 

  5503. <br>
    5504. 

  5504. $db = NewADOConnection('oci8');<br>
    5505. 

  5505. $db-&gt;Connect('localhost','root','','mydb'); <br>
    5506. 

  5506. $db-&gt;MetaPrimaryKeys('dataView');</pre></div>
    5507. 

  5507. 

  5508. <p><b>ServerInfo<a name=serverinfo id=serverinfo></a>()</b> </p>
    5509. 

  5509. 

  5510. <p>Returns an array of containing two elements 'description' and 'version'. The
    5511. 

  5511. 'description' element contains the string description of the database. The
    5512. 

  5512. 'version' naturally holds the version number (which is also a string).</p>
    5513. 

  5513. 

  5514. <p><b>SetCharSet<a name=setcharset id=setcharset></a>($charset)</b> </p>
    5515. 

  5515. 

  5516. <p>Set the charset of the connection. The parameter passed in is dependent on the actual database RDBMS. e.g.
    5517. 

  5517. <pre>
    5518. 

  5518. 	$DB->SetCharSet('utf8'); // for mysql
    5519. 

  5519. </pre>
    5520. 

  5520. This is database driver specific and only supported for mysql, mysqlt, mysqli, and also postgres7 and later.</p>
    5521. 

  5521. 

  5522. <p><b>MetaForeignKeys<a name=metaforeignkeys></a>($table, $owner=false,
    5523. 

  5523. $upper=false)</b> </p>
    5524. 

  5524. 

  5525. <p>Returns an associate array of foreign keys, or false if not supported. For
    5526. 

  5526. example, if table employee has a foreign key where employee.deptkey points to
    5527. 

  5527. dept_table.deptid, and employee.posn=posn_table.postionid and
    5528. 

  5528. employee.poscategory=posn_table.category, then
    5529. 

  5529. $conn-&gt;MetaForeignKeys('employee') will return </p>
    5530. 

  5530. 

  5531. <div style='mso-element:para-border-div;border:solid #DDDDDD 1.0pt;mso-border-alt:
    5532. 

  5532. solid #DDDDDD .75pt;padding:9.0pt 18.0pt 9.0pt 18.0pt;background:#EEEEEE'><pre
    5533. 

  5533. style='background:#EEEEEE'><span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>array(<br>
    5534. 

  5534. <span style='mso-tab-count:2'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>'dept_table' =&gt; array('deptkey=deptid'),<br>
    5535. 

  5535. <span style='mso-tab-count:2'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>'posn_table' =&gt; array('posn=positionid','poscategory=category')<br>
    5536. 

  5536. <span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>)</pre></div>
    5537. 

  5537. 

  5538. <p>The optional schema or owner can be defined in $owner. If $upper is true,
    5539. 

  5539. then the table names (array keys) are upper-cased. </p>
    5540. 

  5540. 

  5541. <div class=MsoNormal align=center style='text-align:center'>
    5542. 

  5542. 

  5543. <hr size=2 width="100%" align=center>
    5544. 

  5544. 

  5545. </div>
    5546. 

  5546. 

  5547. <h2>ADORecordSet<a name=adorecordset></a></h2>
    5548. 

  5548. 

  5549. <p>When an SQL statement successfully is executed by <span style='font-family:
    5550. 

  5550. "Courier New"'>ADOConnection-&gt;Execute($sql),</span>an ADORecordSet object is
    5551. 

  5551. returned. This object contains a virtual cursor so we can move from row to row,
    5552. 

  5552. functions to obtain information about the columns and column types, and helper
    5553. 

  5553. functions to deal with formating the results to show to the user.</p>
    5554. 

  5554. 

  5555. <h3>ADORecordSet Fields</h3>
    5556. 

  5556. 

  5557. <p><b>fields: </b>Array containing the current row. This is not associative,
    5558. 

  5558. but is an indexed array from 0 to columns-1. See also the function <b><a
    5559. 

  5559. href="#fields">Fields</a></b>, which behaves like an associative array.</p>
    5560. 

  5560. 

  5561. <p><b>dataProvider</b>: The underlying mechanism used to connect to the
    5562. 

  5562. database. Normally set to <b>native</b>, unless using <b>odbc</b> or <b>ado</b>.</p>
    5563. 

  5563. 

  5564. <p><b>blobSize</b>: Maximum size of a char, string or varchar object before it
    5565. 

  5565. is treated as a Blob (Blob's should be shown with textarea's). See the <a
    5566. 

  5566. href="#metatype">MetaType</a> function.</p>
    5567. 

  5567. 

  5568. <p><b>sql</b>: Holds the sql statement used to generate this record set.</p>
    5569. 

  5569. 

  5570. <p><b>canSeek</b>: Set to true if Move( ) function works.</p>
    5571. 

  5571. 

  5572. <p><b>EOF</b>: True if we have scrolled the cursor past the last record.</p>
    5573. 

  5573. 

  5574. <h3>ADORecordSet Functions</h3>
    5575. 

  5575. 

  5576. <p><b>ADORecordSet( )</b></p>
    5577. 

  5577. 

  5578. <p>Constructer. Normally you never call this function yourself.</p>
    5579. 

  5579. 

  5580. <p><b>GetAssoc<a name=getassoc></a>([$force_array])</b></p>
    5581. 

  5581. 

  5582. <p>Generates an associative array from the recordset. Note that is this
    5583. 

  5583. function is also <a href="#getassoc1">available</a> in the connection object.
    5584. 

  5584. More details can be found there.</p>
    5585. 

  5585. 

  5586. <p><b>GetArray<a name=getarray></a>([$number_of_rows])</b></p>
    5587. 

  5587. 

  5588. <p>Generate a 2-dimensional array of records from the current cursor position,
    5589. 

  5589. indexed from 0 to $number_of_rows - 1. If $number_of_rows is undefined, till
    5590. 

  5590. EOF.</p>
    5591. 

  5591. 

  5592. <p><b>GetRows<a name=getrows></a>([$number_of_rows])</b></p>
    5593. 

  5593. 

  5594. <p class=MsoNormal>Generate a 2-dimensional array of records from the current
    5595. 

  5595. cursor position. Synonym for GetArray() for compatibility with Microsoft ADO. </p>
    5596. 

  5596. 

  5597. <p><b>GetMenu<a name=getmenu></a>($name, [$default_str=''],
    5598. 

  5598. [$blank1stItem=true], [$multiple_select=false], [$size=0], [$moreAttr=''])</b></p>
    5599. 

  5599. 

  5600. <p>Generate a HTML menu
    5601. 

  5601. (&lt;select&gt;&lt;option&gt;&lt;option&gt;&lt;/select&gt;). The first column
    5602. 

  5602. of the recordset (fields[0]) will hold the string to display in the option
    5603. 

  5603. tags. If the recordset has more than 1 column, the second column (fields[1]) is
    5604. 

  5604. the value to send back to the web server.. The menu will be given the name $<i>name</i>.
    5605. 

  5605. </p>
    5606. 

  5606. 

  5607. <p>If $<i>default_str</i> is defined, then if $<i>default_str</i> == fields[0],
    5608. 

  5608. that field is selected. If $<i>blank1stItem</i> is true, the first option is
    5609. 

  5609. empty. You can also set the first option strings by setting $blank1stItem =
    5610. 

  5610. &quot;$value:$text&quot;.</p>
    5611. 

  5611. 

  5612. <p>$<i>Default_str</i> can be array for a multiple select listbox.</p>
    5613. 

  5613. 

  5614. <p>To get a listbox, set the $<i>size</i> to a non-zero value (or pass
    5615. 

  5615. $default_str as an array). If $<i>multiple_select</i> is true then a listbox
    5616. 

  5616. will be generated with $<i>size</i> items (or if $size==0, then 5 items)
    5617. 

  5617. visible, and we will return an array to a server. Lastly use $<i>moreAttr </i>to
    5618. 

  5618. add additional attributes such as javascript or styles. </p>
    5619. 

  5619. 

  5620. <p>Menu Example 1: <code><span style='font-size:10.0pt'>GetMenu('menu1','A',true)</span></code>
    5621. 

  5621. will generate a menu: <SELECT NAME="menu1">
    5622. 

  5622. <OPTION>
    5623. 

  5623. <OPTION SELECTED VALUE="1">A
    5624. 

  5624. <OPTION VALUE="2">B
    5625. 

  5625. <OPTION VALUE="3">C
    5626. 

  5626. </SELECT>for
    5627. 

  5627. the data (A,1), (B,2), (C,3). Also see <a href="#ex5">example 5</a>.</p>
    5628. 

  5628. 

  5629. <p>Menu Example 2: For the same data, <code><span style='font-size:10.0pt'>GetMenu('menu1',array('A','B'),false)</span></code>
    5630. 

  5630. will generate a menu with both A and B selected: <br>
    5631. 

  5631. <SELECT MULTIPLE NAME="menu1" SIZE="3">
    5632. 

  5632. <OPTION SELECTED VALUE="1">A
    5633. 

  5633. <OPTION SELECTED VALUE="2">B
    5634. 

  5634. <OPTION VALUE="3">C
    5635. 

  5635. </SELECT></p>
    5636. 

  5636. 

  5637. <p><b>GetMenu2<a name=getmenu2></a>($name, [$default_str=''],
    5638. 

  5638. [$blank1stItem=true], [$multiple_select=false], [$size=0], [$moreAttr=''])</b></p>
    5639. 

  5639. 

  5640. <p>This is nearly identical to GetMenu, except that the $<i>default_str</i> is
    5641. 

  5641. matched to fields[1] (the option values).</p>
    5642. 

  5642. 

  5643. <p>Menu Example 3: Given the data in menu example 2, <code><span
    5644. 

  5644. style='font-size:10.0pt'>GetMenu2('menu1',array('1','2'),false)</span></code>
    5645. 

  5645. will generate a menu with both A and B selected in menu example 2, but this
    5646. 

  5646. time the selection is based on the 2nd column, which holds the values to return
    5647. 

  5647. to the Web server. </p>
    5648. 

  5648. 

  5649. <p><b>UserDate<a name=userdate></a>($str, [$fmt])</b></p>
    5650. 

  5650. 

  5651. <p>Converts the date string $<i>str</i> to another format. The date format is
    5652. 

  5652. Y-m-d, or Unix timestamp format. The default $<i>fmt</i> is Y-m-d.</p>
    5653. 

  5653. 

  5654. <p><b>UserTimeStamp<a name=usertimestamp></a>($str, [$fmt])</b></p>
    5655. 

  5655. 

  5656. <p>Converts the timestamp string $<b>str</b> to another format. The timestamp
    5657. 

  5657. format is Y-m-d H:i:s, as in '2002-02-28 23:00:12', or Unix timestamp format.
    5658. 

  5658. UserTimeStamp calls UnixTimeStamp to parse $<i>str</i>, and $<i>fmt</i>
    5659. 

  5659. defaults to Y-m-d H:i:s if not defined. </p>
    5660. 

  5660. 

  5661. <p><b>UnixDate<a name=unixdate></a>($str)</b></p>
    5662. 

  5662. 

  5663. <p>Parses the date string $<b>str</b> and returns it in unix mktime format (eg.
    5664. 

  5664. a number indicating the seconds after January 1st, 1970). Expects the date to
    5665. 

  5665. be in Y-m-d H:i:s format, except for Sybase and Microsoft SQL Server, where M d
    5666. 

  5666. Y is also accepted (the 3 letter month strings are controlled by a global
    5667. 

  5667. array, which might need localisation).</p>
    5668. 

  5668. 

  5669. <p>This function is available in both ADORecordSet and ADOConnection since
    5670. 

  5670. 1.91.</p>
    5671. 

  5671. 

  5672. <p><b>UnixTimeStamp<a name=unixtimestamp></a>($str)</b></p>
    5673. 

  5673. 

  5674. <p>Parses the timestamp string $<b>str</b> and returns it in unix mktime format
    5675. 

  5675. (eg. a number indicating the seconds after January 1st, 1970). Expects the date
    5676. 

  5676. to be in &quot;Y-m-d, H:i:s&quot; (1970-12-24, 00:00:00) or &quot;Y-m-d
    5677. 

  5677. H:i:s&quot; (1970-12-24 00:00:00) or &quot;YmdHis&quot; (19701225000000)
    5678. 

  5678. format, except for Sybase and Microsoft SQL Server, where &quot;M d Y
    5679. 

  5679. h:i:sA&quot; (Dec 25 1970 00:00:00AM) is also accepted (the 3 letter month
    5680. 

  5680. strings are controlled by a global array, which might need localisation).</p>
    5681. 

  5681. 

  5682. <p>This function is available in both ADORecordSet and ADOConnection since
    5683. 

  5683. 1.91. </p>
    5684. 

  5684. 

  5685. <p><b>OffsetDate<a name=OffsetDate></a>($dayFraction, $basedate=false)</b></p>
    5686. 

  5686. 

  5687. <p>Returns a string with the native SQL functions to calculate future and past
    5688. 

  5688. dates based on $basedate in a portable fashion. If $basedate is not defined,
    5689. 

  5689. then the current date (at 12 midnight) is used. Returns the SQL string that
    5690. 

  5690. performs the calculation when passed to Execute(). </p>
    5691. 

  5691. 

  5692. <p>For example, in Oracle, to find the date and time that is 2.5 days from
    5693. 

  5693. today, you can use:</p>
    5694. 

  5694. 

  5695. <div style='mso-element:para-border-div;border:solid #DDDDDD 1.0pt;mso-border-alt:
    5696. 

  5696. solid #DDDDDD .75pt;padding:9.0pt 18.0pt 9.0pt 18.0pt;background:#EEEEEE'><pre
    5697. 

  5697. style='background:#EEEEEE'># get date one week from now<br>
    5698. 

  5698. $fld = $conn-&gt;OffsetDate(7); // returns &quot;(trunc(sysdate)+7&quot;)</pre><pre># get date and time that is 60 hours from current date and time<br>
    5699. 

  5699. $fld = $conn-&gt;OffsetDate(2.5, $conn-&gt;sysTimeStamp);<span
    5700. 

  5700. style='mso-tab-count:1'> </span>// returns &quot;(sysdate+2.5)&quot;<br>
    5701. 

  5701. <br>
    5702. 

  5702. $conn-&gt;Execute(&quot;UPDATE TABLE SET dodate=$fld WHERE ID=$id&quot;);</pre></div>
    5703. 

  5703. 

  5704. <p>This function is available for mysql, mssql, oracle, oci8 and postgresql
    5705. 

  5705. drivers since 2.13. It might work with other drivers provided they allow
    5706. 

  5706. performing numeric day arithmetic on dates.</p>
    5707. 

  5707. 

  5708. <p><b>SQLDate<a name=sqldate></a>($dateFormat, $basedate=false)</b></p>
    5709. 

  5709. 

  5710. <p class=MsoNormal>Returns a string which contains the native SQL functions to
    5711. 

  5711. format a date or date column $basedate. This is used when retrieving date
    5712. 

  5712. columns in SELECT statements. For sending dates to the database (eg. in UPDATE,
    5713. 

  5713. INSERT or the where clause of SELECT statements) use <a href="#dbdate">DBDate</a>.
    5714. 

  5714. It uses a case-sensitive $dateFormat, which supports: </p>
    5715. 

  5715. 

  5716. <div style='mso-element:para-border-div;border:solid #DDDDDD 1.0pt;mso-border-alt:
    5717. 

  5717. solid #DDDDDD .75pt;padding:9.0pt 18.0pt 9.0pt 18.0pt;background:#EEEEEE'><pre><span style='mso-spacerun:yes'>&nbsp;</span></pre><pre><span style='mso-spacerun:yes'>&nbsp; </span>Y: 4-digit Year</pre><pre><span style='mso-spacerun:yes'>&nbsp; </span>Q: Quarter (1-4)</pre><pre><span style='mso-spacerun:yes'>&nbsp; </span>M: Month (Jan-Dec)</pre><pre><span style='mso-spacerun:yes'>&nbsp; </span>m: Month (01-12)</pre><pre><span style='mso-spacerun:yes'>&nbsp; </span>d: Day (01-31)</pre><pre><span style='mso-spacerun:yes'>&nbsp; </span>H: Hour (00-23)</pre><pre><span style='mso-spacerun:yes'>&nbsp; </span>h: Hour (1-12)</pre><pre><span style='mso-spacerun:yes'>&nbsp; </span>i: Minute (00-59)</pre><pre><span style='mso-spacerun:yes'>&nbsp; </span>s: Second (00-60)</pre><pre><span style='mso-spacerun:yes'>&nbsp; </span>A: AM/PM indicator</pre><pre><span style='mso-spacerun:yes'>&nbsp; </span>w: day of week (0-6 or 1-7 depending on DB)</pre><pre><span style='mso-spacerun:yes'>&nbsp; </span>l: day of week (as string - lowercase L)</pre><pre><span style='mso-spacerun:yes'>&nbsp; </span>W: week in year (0..53 for MySQL, 1..53 for PostgreSQL and Oracle)</pre><pre
    5718. 

  5718. style='background:#EEEEEE'><span style='mso-spacerun:yes'>&nbsp; </span></pre></div>
    5719. 

  5719. 

  5720. <p>All other characters are treated as strings. You can also use \ to escape
    5721. 

  5721. characters. Available on selected databases, including mysql, postgresql,
    5722. 

  5722. mssql, oci8 and DB2. </p>
    5723. 

  5723. 

  5724. <p>This is useful in writing portable sql statements that GROUP BY on dates.
    5725. 

  5725. For example to display total cost of goods sold broken by quarter (dates are
    5726. 

  5726. stored in a field called postdate): </p>
    5727. 

  5727. 

  5728. <div style='mso-element:para-border-div;border:solid #DDDDDD 1.0pt;mso-border-alt:
    5729. 

  5729. solid #DDDDDD .75pt;padding:9.0pt 18.0pt 9.0pt 18.0pt;background:#EEEEEE'><pre
    5730. 

  5730. style='background:#EEEEEE'><span style='mso-spacerun:yes'>&nbsp;</span>$sqlfn = $db-&gt;SQLDate('Y-\QQ','postdate'); # get sql that formats postdate to output 2002-Q1<br>
    5731. 

  5731. <span style='mso-spacerun:yes'>&nbsp;</span>$sql = &quot;SELECT $sqlfn,SUM(cogs) FROM table GROUP BY $sqlfn ORDER BY 1 desc&quot;;<br>
    5732. 

  5732. <span style='mso-spacerun:yes'>&nbsp;</span></pre></div>
    5733. 

  5733. 

  5734. <p><b>MoveNext<a name=movenext></a>( )</b></p>
    5735. 

  5735. 

  5736. <p>Move the internal cursor to the next row. The <i>$this-&gt;fields</i> array
    5737. 

  5737. is automatically updated. Returns false if unable to do so (normally because
    5738. 

  5738. EOF has been reached), otherwise true. </p>
    5739. 

  5739. 

  5740. <p>If EOF is reached, then the $this-&gt;fields array is set to false (this was
    5741. 

  5741. only implemented consistently in ADOdb 3.30). For the pre-3.30 behaviour of
    5742. 

  5742. $this-&gt;fields (at EOF), set the global variable $ADODB_COMPAT_FETCH = true.</p>
    5743. 

  5743. 

  5744. <p>Example:</p>
    5745. 

  5745. 

  5746. <div style='mso-element:para-border-div;border:solid #DDDDDD 1.0pt;mso-border-alt:
    5747. 

  5747. solid #DDDDDD .75pt;padding:9.0pt 18.0pt 9.0pt 18.0pt;background:#EEEEEE'><pre
    5748. 

  5748. style='background:#EEEEEE'>$rs = $db-&gt;Execute($sql);<br>
    5749. 

  5749. if ($rs) <br>
    5750. 

  5750. <span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>while (!$rs-&gt;EOF) {<br>
    5751. 

  5751. <span style='mso-spacerun:yes'>&nbsp;</span><span style='mso-tab-count:2'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>ProcessArray($rs-&gt;fields);<span
    5752. 

  5752. style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span><br>
    5753. 

  5753. <span style='mso-tab-count:2'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>$rs-&gt;MoveNext();<br>
    5754. 

  5754. <span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>} </pre></div>
    5755. 

  5755. 

  5756. <p><b>Move<a name=move></a>($to)</b></p>
    5757. 

  5757. 

  5758. <p>Moves the internal cursor to a specific row $<b>to</b>. Rows are zero-based
    5759. 

  5759. eg. 0 is the first row. The <b>fields</b> array is automatically updated. For
    5760. 

  5760. databases that do not support scrolling internally, ADOdb will simulate forward
    5761. 

  5761. scrolling. Some databases do not support backward scrolling. If the $<b>to</b>
    5762. 

  5762. position is after the EOF, $<b>to</b> will move to the end of the RecordSet for
    5763. 

  5763. most databases. Some obscure databases using odbc might not behave this way.</p>
    5764. 

  5764. 

  5765. <p>Note: This function uses <i>absolute positioning</i>, unlike Microsoft's
    5766. 

  5766. ADO.</p>
    5767. 

  5767. 

  5768. <p>Returns true or false. If false, the internal cursor is not moved in most
    5769. 

  5769. implementations, so AbsolutePosition( ) will return the last cursor position
    5770. 

  5770. before the Move( ). </p>
    5771. 

  5771. 

  5772. <p><b>MoveFirst<a name=movefirst></a>()</b></p>
    5773. 

  5773. 

  5774. <p>Internally calls Move(0). Note that some databases do not support this function.</p>
    5775. 

  5775. 

  5776. <p><b>MoveLast<a name=movelast></a>()</b></p>
    5777. 

  5777. 

  5778. <p>Internally calls Move(RecordCount()-1). Note that some databases do not
    5779. 

  5779. support this function.</p>
    5780. 

  5780. 

  5781. <p><b>GetRowAssoc</b><a name=getrowassoc></a>($toUpper=true)</p>
    5782. 

  5782. 

  5783. <p>Returns an associative array containing the current row. The keys to the
    5784. 

  5784. array are the column names. The column names are upper-cased for easy access.
    5785. 

  5785. To get the next row, you will still need to call MoveNext(). </p>
    5786. 

  5786. 

  5787. <p>For example:<br>
    5788. 

  5788. Array ( [ID] =&gt; 1 [FIRSTNAME] =&gt; Caroline [LASTNAME] =&gt; Miranda
    5789. 

  5789. [CREATED] =&gt; 2001-07-05 ) </p>
    5790. 

  5790. 

  5791. <p>Note: do not use GetRowAssoc() with $ADODB_FETCH_MODE = ADODB_FETCH_ASSOC.
    5792. 

  5792. Because they have the same functionality, they will interfere with each other.</p>
    5793. 

  5793. 

  5794. <p><b>AbsolutePage<a name=absolutepage></a>($page=-1) </b></p>
    5795. 

  5795. 

  5796. <p>Returns the current page. Requires PageExecute()/CachePageExecute() to be
    5797. 

  5797. called. See <a href="#ex8">Example 8</a>.</p>
    5798. 

  5798. 

  5799. <p><b>AtFirstPage<a name=atfirstpage>($status='')</a></b><span
    5800. 

  5800. style='mso-bookmark:atfirstpage'></span></p>
    5801. 

  5801. 

  5802. <p>Returns true if at first page (1-based). Requires
    5803. 

  5803. PageExecute()/CachePageExecute() to be called. See <a href="#ex8">Example 8</a>.</p>
    5804. 

  5804. 

  5805. <p><b>AtLastPage<a name=atlastpage>($status='')</a></b><span style='mso-bookmark:
    5806. 

  5806. atlastpage'></span></p>
    5807. 

  5807. 

  5808. <p>Returns true if at last page (1-based). Requires
    5809. 

  5809. PageExecute()/CachePageExecute() to be called. See <a href="#ex8">Example 8</a>.</p>
    5810. 

  5810. 

  5811. <p><b>Fields</b><a name=fields></a>(<b>$colname</b>)</p>
    5812. 

  5812. 

  5813. <p>Returns the value of the associated column $<b>colname</b> for the current
    5814. 

  5814. row. The column name is case-insensitive.</p>
    5815. 

  5815. 

  5816. <p>This is a convenience function. For higher performance, use <a
    5817. 

  5817. href="#adodb_fetch_mode">$ADODB_FETCH_MODE</a>. </p>
    5818. 

  5818. 

  5819. <p><b>FetchRow</b><a name=fetchrow></a>()</p>
    5820. 

  5820. 

  5821. <p>Returns array containing current row, or false if EOF. FetchRow( )
    5822. 

  5822. internally moves to the next record after returning the current row. </p>
    5823. 

  5823. 

  5824. <p>Warning: Do not mix using FetchRow() with MoveNext().</p>
    5825. 

  5825. 

  5826. <p>Usage:</p>
    5827. 

  5827. 

  5828. <div style='mso-element:para-border-div;border:solid #DDDDDD 1.0pt;mso-border-alt:
    5829. 

  5829. solid #DDDDDD .75pt;padding:9.0pt 18.0pt 9.0pt 18.0pt;background:#EEEEEE'><pre
    5830. 

  5830. style='background:#EEEEEE'>$rs = $db-&gt;Execute($sql);<br>
    5831. 

  5831. if ($rs)<br>
    5832. 

  5832. <span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>while ($arr = $rs-&gt;FetchRow()) {<br>
    5833. 

  5833. <span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span><span style='mso-spacerun:yes'>&nbsp;&nbsp; </span>&nbsp;&nbsp;# process $arr<span
    5834. 

  5834. style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span><br>
    5835. 

  5835. <span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>}</pre></div>
    5836. 

  5836. 

  5837. <p><b>FetchInto</b><a name=fetchinto></a>(<b>&amp;$array</b>)</p>
    5838. 

  5838. 

  5839. <p>Sets $array to the current row. Returns PEAR_Error object if EOF, 1 if ok
    5840. 

  5840. (DB_OK constant). If PEAR is undefined, false is returned when EOF. FetchInto(
    5841. 

  5841. ) internally moves to the next record after returning the current row. </p>
    5842. 

  5842. 

  5843. <p>FetchRow() is easier to use. See above.</p>
    5844. 

  5844. 

  5845. <p><b>FetchField<a name=fetchfield></a>($column_number)</b></p>
    5846. 

  5846. 

  5847. <p>Returns an object containing the <b>name</b>, <b>type</b> and <b>max_length</b>
    5848. 

  5848. of the associated field. If the max_length cannot be determined reliably, it
    5849. 

  5849. will be set to -1. The column numbers are zero-based. See <a href="#ex2">example
    5850. 

  5850. 2.</a></p>
    5851. 

  5851. 

  5852. <p><b>FieldCount<a name=fieldcount></a>( )</b></p>
    5853. 

  5853. 

  5854. <p>Returns the number of fields (columns) in the record set.</p>
    5855. 

  5855. 

  5856. <p><b>RecordCount<a name=recordcount></a>( )</b></p>
    5857. 

  5857. 

  5858. <p>Returns the number of rows in the record set. If the number of records
    5859. 

  5859. returned cannot be determined from the database driver API, we will buffer all
    5860. 

  5860. rows and return a count of the rows after all the records have been retrieved.
    5861. 

  5861. This buffering can be disabled (for performance reasons) by setting the global
    5862. 

  5862. variable $ADODB_COUNTRECS = false. When disabled, RecordCount( ) will return -1
    5863. 

  5863. for certain databases. See the supported databases list above for more details.
    5864. 

  5864. </p>
    5865. 

  5865. 

  5866. <p>RowCount is a synonym for RecordCount.</p>
    5867. 

  5867. 

  5868. <p><b>PO_RecordCount<a name="po_recordcount"></a>($table, $where)</b></p>
    5869. 

  5869. 

  5870. <p>Returns the number of rows in the record set. If the database does not
    5871. 

  5871. support this, it will perform a SELECT COUNT(*) on the table $table, with the
    5872. 

  5872. given $where condition to return an estimate of the recordset size.</p>
    5873. 

  5873. 

  5874. <p>$numrows = $rs-&gt;PO_RecordCount(&quot;articles_table&quot;,
    5875. 

  5875. &quot;group=$group&quot;);</p>
    5876. 

  5876. 

  5877. <p class=MsoNormal><b>NextRecordSet<a name=nextrecordset id=nextrecordset></a>()</b>
    5878. 

  5878. </p>
    5879. 

  5879. 

  5880. <p>For databases that allow multiple recordsets to be returned in one query,
    5881. 

  5881. this function allows you to switch to the next recordset. Currently only
    5882. 

  5882. supported by mssql driver.</p>
    5883. 

  5883. 

  5884. <div style='mso-element:para-border-div;border:solid #DDDDDD 1.0pt;mso-border-alt:
    5885. 

  5885. solid #DDDDDD .75pt;padding:9.0pt 18.0pt 9.0pt 18.0pt;background:#EEEEEE'><pre
    5886. 

  5886. style='background:#EEEEEE'>$rs = $db-&gt;Execute('execute return_multiple_rs');<br>
    5887. 

  5887. $arr1 = $rs-&gt;GetArray();<br>
    5888. 

  5888. $rs-&gt;NextRecordSet();<br>
    5889. 

  5889. $arr2 = $rs-&gt;GetArray();</pre></div>
    5890. 

  5890. 

  5891. <p><b>FetchObject<a name=fetchobject></a>($toupper=true)</b></p>
    5892. 

  5892. 

  5893. <p>Returns the current row as an object. If you set $toupper to true, then the
    5894. 

  5894. object fields are set to upper-case. Note: The newer FetchNextObject() is the
    5895. 

  5895. recommended way of accessing rows as objects. See below.</p>
    5896. 

  5896. 

  5897. <p><b>FetchNextObject<a name=fetchnextobject></a>($toupper=true)</b></p>
    5898. 

  5898. 

  5899. <p>Gets the current row as an object and moves to the next row automatically.
    5900. 

  5900. Returns false if at end-of-file. If you set $toupper to true, then the object
    5901. 

  5901. fields are set to upper-case. Note that for some drivers such as mssql, you
    5902. 

  5902. need to SetFetchMode(ADODB_FETCH_ASSOC) or SetFetchMode(ADODB_FETCH_BOTH).</p>
    5903. 

  5903. 

  5904. <div style='mso-element:para-border-div;border:solid #DDDDDD 1.0pt;mso-border-alt:
    5905. 

  5905. solid #DDDDDD .75pt;padding:9.0pt 18.0pt 9.0pt 18.0pt;background:#EEEEEE'><pre
    5906. 

  5906. style='background:#EEEEEE'>$rs = $db-&gt;Execute('select firstname,lastname from table');<br>
    5907. 

  5907. if ($rs) {<br>
    5908. 

  5908. <span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>while ($o = $rs-&gt;FetchNextObject()) {<br>
    5909. 

  5909. <span style='mso-tab-count:2'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>print &quot;$o-&gt;FIRSTNAME, $o-&gt;LASTNAME&lt;BR&gt;&quot;;<br>
    5910. 

  5910. <span style='mso-tab-count:1'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>}<br>
    5911. 

  5911. }</pre></div>
    5912. 

  5912. 

  5913. <p>There is some trade-off in speed in using FetchNextObject(). If performance
    5914. 

  5914. is important, you should access rows with the <code><span style='font-size:
    5915. 

  5915. 10.0pt'>fields[]</span></code> array. <b>FetchObj<a name=fetchobj id=fetchobj></a>()</b>
    5916. 

  5916. </p>
    5917. 

  5917. 

  5918. <p>Returns the current record as an object. Fields are not upper-cased, unlike
    5919. 

  5919. FetchObject. </p>
    5920. 

  5920. 

  5921. <p><b>FetchNextObj<a name=fetchnextobj id=fetchnextobj></a>()</b> </p>
    5922. 

  5922. 

  5923. <p>Returns the current record as an object and moves to the next record. If
    5924. 

  5924. EOF, false is returned. Fields are not upper-cased, unlike FetctNextObject. </p>
    5925. 

  5925. 

  5926. <p><b>CurrentRow<a name=currentrow></a>( )</b></p>
    5927. 

  5927. 

  5928. <p>Returns the current row of the record set. 0 is the first row.</p>
    5929. 

  5929. 

  5930. <p><b>AbsolutePosition<a name=abspos></a>( )</b></p>
    5931. 

  5931. 

  5932. <p>Synonym for <b>CurrentRow</b> for compatibility with ADO. Returns the
    5933. 

  5933. current row of the record set. 0 is the first row.</p>
    5934. 

  5934. 

  5935. <p><b>MetaType<a name=metatype></a>($nativeDBType[,$field_max_length],[$fieldobj])</b></p>
    5936. 

  5936. 

  5937. <p>Determine what <i>generic</i> meta type a database field type is given its
    5938. 

  5938. native type $<b>nativeDBType</b> as a string and the length of the field $<b>field_max_length</b>.
    5939. 

  5939. Note that field_max_length can be -1 if it is not known. The field object
    5940. 

  5940. returned by FetchField() can be passed in $<b>fieldobj</b> or as the 1st
    5941. 

  5941. parameter <b>$nativeDBType</b>. This is useful for databases such as <i>mysql</i>
    5942. 

  5942. which has additional properties in the field object such as <i>primary_key</i>.
    5943. 

  5943. </p>
    5944. 

  5944. 

  5945. <p>Uses the field <b>blobSize</b> and compares it with $<b>field_max_length</b>
    5946. 

  5946. to determine whether the character field is actually a blob.</p>
    5947. 

  5947. 

  5948. <p class=MsoNormal>For example, $db-&gt;MetaType('char') will return 'C'. </p>
    5949. 

  5949. 

  5950. <p>Returns:</p>
    5951. 

  5951. 

  5952. <ul type=disc>
    5953. 

  5953.  <li class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
    5954. 

  5954.      mso-list:l7 level1 lfo11;tab-stops:list 36.0pt'><b>C</b>: Character fields
    5955. 

  5955.      that should be shown in a &lt;input type=&quot;text&quot;&gt; tag. </li>
    5956. 

  5956.  <li class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
    5957. 

  5957.      mso-list:l7 level1 lfo11;tab-stops:list 36.0pt'><b>X</b>: Clob (character
    5958. 

  5958.      large objects), or large text fields that should be shown in a
    5959. 

  5959.      &lt;textarea&gt;</li>
    5960. 

  5960.  <li class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
    5961. 

  5961.      mso-list:l7 level1 lfo11;tab-stops:list 36.0pt'><b>D</b>: Date field</li>
    5962. 

  5962.  <li class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
    5963. 

  5963.      mso-list:l7 level1 lfo11;tab-stops:list 36.0pt'><b>T</b>: Timestamp field</li>
    5964. 

  5964.  <li class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
    5965. 

  5965.      mso-list:l7 level1 lfo11;tab-stops:list 36.0pt'><b>L</b>: Logical field
    5966. 

  5966.      (boolean or bit-field)</li>
    5967. 

  5967.  <li class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
    5968. 

  5968.      mso-list:l7 level1 lfo11;tab-stops:list 36.0pt'><b>N</b>: Numeric field.
    5969. 

  5969.      Includes decimal, numeric, floating point, and real. </li>
    5970. 

  5970.  <li class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
    5971. 

  5971.      mso-list:l7 level1 lfo11;tab-stops:list 36.0pt'><b>I</b>:&nbsp; Integer
    5972. 

  5972.      field. </li>
    5973. 

  5973.  <li class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
    5974. 

  5974.      mso-list:l7 level1 lfo11;tab-stops:list 36.0pt'><b>R</b>: Counter or
    5975. 

  5975.      Autoincrement field. Must be numeric.</li>
    5976. 

  5976.  <li class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
    5977. 

  5977.      mso-list:l7 level1 lfo11;tab-stops:list 36.0pt'><b>B</b>: Blob, or binary
    5978. 

  5978.      large objects. </li>
    5979. 

  5979. </ul>
    5980. 

  5980. 

  5981. <p>Since ADOdb 3.0, MetaType accepts $fieldobj as the first parameter, instead
    5982. 

  5982. of $nativeDBType. </p>
    5983. 

  5983. 

  5984. <p><b>Close( )</b><a name=rsclose></a></p>
    5985. 

  5985. 

  5986. <p>Closes the recordset, cleaning all memory and resources associated with the
    5987. 

  5987. recordset. </p>
    5988. 

  5988. 

  5989. <p>If memory management is not an issue, you do not need to call this function
    5990. 

  5990. as recordsets are closed for you by PHP at the end of the script. SQL
    5991. 

  5991. statements such as INSERT/UPDATE/DELETE do not really return a recordset, so you
    5992. 

  5992. do not have to call Close() for such SQL statements.</p>
    5993. 

  5993. 

  5994. <div class=MsoNormal align=center style='text-align:center'>
    5995. 

  5995. 

  5996. <hr size=2 width="100%" align=center>
    5997. 

  5997. 

  5998. </div>
    5999. 

  5999. 

  6000. <h3>function rs2html<a name=rs2html></a>($adorecordset,[$tableheader_attributes],
    6001. 

  6001. [$col_titles])</h3>
    6002. 

  6002. 

  6003. <p>This is a standalone function (rs2html = recordset to html) that is similar
    6004. 

  6004. to PHP's <i>odbc_result_all</i> function, it prints a ADORecordSet, $<b>adorecordset</b>
    6005. 

  6005. as a HTML table. $<b>tableheader_attributes</b> allow you to control the table <i>cellpadding</i>,
    6006. 

  6006. <i>cellspacing</i> and <i>border</i> attributes. Lastly you can replace the
    6007. 

  6007. database column names with your own column titles with the array $<b>col_titles</b>.
    6008. 

  6008. This is designed more as a quick debugging mechanism, not a production table
    6009. 

  6009. recordset viewer.</p>
    6010. 

  6010. 

  6011. <p>You will need to include the file <i>tohtml.inc.php</i>.</p>
    6012. 

  6012. 

  6013. <p>Example of rs2html:<a name=exrs2html></a></p>
    6014. 

  6014. 

  6015. <div style='mso-element:para-border-div;border:solid #DDDDDD 1.0pt;mso-border-alt:
    6016. 

  6016. solid #DDDDDD .75pt;padding:9.0pt 18.0pt 9.0pt 18.0pt;background:#EEEEEE'><pre
    6017. 

  6017. style='background:#EEEEEE'><b><span style='color:#336600'>&lt;?<br>
    6018. 

  6018. include('tohtml.inc.php')</span></b>; # load code common to ADOdb <br>
    6019. 

  6019. <b>include</b>('adodb.inc.php'); # load code common to ADOdb <br>
    6020. 

  6020. $<span style='color:#663300'>conn</span> = &amp;ADONewConnection('mysql');<span style='mso-spacerun:yes'>&nbsp;&nbsp; </span># create a connection <br>
    6021. 

  6021. $<span style='color:#663300'>conn</span>-&gt;PConnect('localhost','userid','','agora');# connect to MySQL, agora db<br>
    6022. 

  6022. $<span style='color:#663300'>sql</span> = 'select CustomerName, CustomerID from customers'; <br>
    6023. 

  6023. $<span style='color:#663300'>rs</span><span style='mso-spacerun:yes'>&nbsp;&nbsp; </span>= $<span
    6024. 

  6024. style='color:#663300'>conn</span>-&gt;Execute($sql); <br>
    6025. 

  6025. <b><span style='color:#336600'>rs2html</span>($</b><b><span style='color:#663300'>rs</span>,'<i>border=2 cellpadding=3</i>',array('<i>Customer Name','Customer ID</i>'));<br>
    6026. 

  6026. ?&gt;</b></pre></div>
    6027. 

  6027. 

  6028. <div class=MsoNormal align=center style='text-align:center'>
    6029. 

  6029. 

  6030. <hr size=2 width="100%" align=center>
    6031. 

  6031. 

  6032. </div>
    6033. 

  6033. 

  6034. <h3>Differences between this ADOdb library and Microsoft ADO<a name=adodiff></a></h3>
    6035. 

  6035. 

  6036. <ol start=1 type=1>
    6037. 

  6037.  <li class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
    6038. 

  6038.      mso-list:l10 level1 lfo12;tab-stops:list 36.0pt'>ADOdb only supports
    6039. 

  6039.      recordsets created by a connection object. Recordsets cannot be created
    6040. 

  6040.      independently.</li>
    6041. 

  6041.  <li class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
    6042. 

  6042.      mso-list:l10 level1 lfo12;tab-stops:list 36.0pt'>ADO properties are implemented
    6043. 

  6043.      as functions in ADOdb. This makes it easier to implement any enhanced ADO
    6044. 

  6044.      functionality in the future.</li>
    6045. 

  6045.  <li class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
    6046. 

  6046.      mso-list:l10 level1 lfo12;tab-stops:list 36.0pt'>ADOdb's <span
    6047. 

  6047.      style='font-family:"Courier New"'>ADORecordSet-&gt;Move()</span> uses
    6048. 

  6048.      absolute positioning, not relative. Bookmarks are not supported.</li>
    6049. 

  6049.  <li class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
    6050. 

  6050.      mso-list:l10 level1 lfo12;tab-stops:list 36.0pt'><span style='font-family:
    6051. 

  6051.      "Courier New"'>ADORecordSet-&gt;AbsolutePosition() </span>cannot be used
    6052. 

  6052.      to move the record cursor.</li>
    6053. 

  6053.  <li class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
    6054. 

  6054.      mso-list:l10 level1 lfo12;tab-stops:list 36.0pt'>ADO Parameter objects are
    6055. 

  6055.      not supported. Instead we have the ADOConnection::<a href="#parameter">Parameter</a>(
    6056. 

  6056.      ) function, which provides a simpler interface for calling preparing
    6057. 

  6057.      parameters and calling stored procedures.</li>
    6058. 

  6058.  <li class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
    6059. 

  6059.      mso-list:l10 level1 lfo12;tab-stops:list 36.0pt'>Recordset properties for
    6060. 

  6060.      paging records are available, but implemented as in <a href="#ex8">Example
    6061. 

  6061.      8</a>.</li>
    6062. 

  6062. </ol>
    6063. 

  6063. 

  6064. <div class=MsoNormal align=center style='text-align:center'>
    6065. 

  6065. 

  6066. <hr size=2 width="100%" align=center>
    6067. 

  6067. 

  6068. </div>
    6069. 

  6069. 

  6070. <h1>Database Driver Guide<a name=driverguide></a></h1>
    6071. 

  6071. 

  6072. <p>This describes how to create a class to connect to a new database. To ensure
    6073. 

  6073. there is no duplication of work, kindly email me at jlim#natsoft.com if you
    6074. 

  6074. decide to create such a class.</p>
    6075. 

  6075. 

  6076. <p>First decide on a name in lower case to call the database type. Let's say we
    6077. 

  6077. call it xbase. </p>
    6078. 

  6078. 

  6079. <p>Then we need to create two classes ADODB_xbase and ADORecordSet_xbase in the
    6080. 

  6080. file adodb-xbase.inc.php.</p>
    6081. 

  6081. 

  6082. <p>The simplest form of database driver is an adaptation of an existing ODBC
    6083. 

  6083. driver. Then we just need to create the class <i>ADODB_xbase extends ADODB_odbc</i>
    6084. 

  6084. to support the new <b>date</b> and <b>timestamp</b> formats, the <b>concatenation</b>
    6085. 

  6085. operator used, <b>true</b> and <b>false</b>. For the<i> ADORecordSet_xbase
    6086. 

  6086. extends ADORecordSet_odbc </i>we need to change the <b>MetaType</b> function.
    6087. 

  6087. See<b> adodb-vfp.inc.php</b> as an example.</p>
    6088. 

  6088. 

  6089. <p>More complicated is a totally new database driver that connects to a new PHP
    6090. 

  6090. extension. Then you will need to implement several functions. Fortunately, you
    6091. 

  6091. do not have to modify most of the complex code. You only need to override a few
    6092. 

  6092. stub functions. See <b>adodb-mysql.inc.php</b> for example.</p>
    6093. 

  6093. 

  6094. <p>The default date format of ADOdb internally is YYYY-MM-DD (Ansi-92). All
    6095. 

  6095. dates should be converted to that format when passing to an ADOdb date
    6096. 

  6096. function. See Oracle for an example how we use ALTER SESSION to change the
    6097. 

  6097. default date format in _pconnect _connect.</p>
    6098. 

  6098. 

  6099. <p><b>ADOConnection Functions to Override</b></p>
    6100. 

  6100. 

  6101. <p>Defining a constructor for your ADOConnection derived function is optional.
    6102. 

  6102. There is no need to call the base class constructor.</p>
    6103. 

  6103. 

  6104. <p>_<b>connect</b>: Low level implementation of Connect. Returns true or false.
    6105. 

  6105. Should set the _<b>connectionID</b>.</p>
    6106. 

  6106. 

  6107. <p>_<b>pconnect:</b> Low level implemention of PConnect. Returns true or false.
    6108. 

  6108. Should set the _<b>connectionID</b>.</p>
    6109. 

  6109. 

  6110. <p>_<b>query</b>: Execute a query. Returns the queryID, or false.</p>
    6111. 

  6111. 

  6112. <p>_<b>close: </b>Close the connection -- PHP should clean up all recordsets. </p>
    6113. 

  6113. 

  6114. <p><b>ErrorMsg</b>: Stores the error message in the private variable _errorMsg.
    6115. 

  6115. </p>
    6116. 

  6116. 

  6117. <p><b>ADOConnection Fields to Set</b></p>
    6118. 

  6118. 

  6119. <p>_<b>bindInputArray</b>: Set to true if binding of parameters for SQL inserts
    6120. 

  6120. and updates is allowed using ?, eg. as with ODBC.</p>
    6121. 

  6121. 

  6122. <p><b>fmtDate</b></p>
    6123. 

  6123. 

  6124. <p><b>fmtTimeStamp</b></p>
    6125. 

  6125. 

  6126. <p><b>true</b></p>
    6127. 

  6127. 

  6128. <p><b>false</b></p>
    6129. 

  6129. 

  6130. <p><b>concat_operator</b></p>
    6131. 

  6131. 

  6132. <p><b>replaceQuote</b></p>
    6133. 

  6133. 

  6134. <p><b>hasLimit</b> support SELECT * FROM TABLE LIMIT 10 of MySQL.</p>
    6135. 

  6135. 

  6136. <p><b>hasTop</b> support Microsoft style SELECT TOP 10 * FROM TABLE.</p>
    6137. 

  6137. 

  6138. <p><b>ADORecordSet Functions to Override</b></p>
    6139. 

  6139. 

  6140. <p>You will need to define a constructor for your ADORecordSet derived class
    6141. 

  6141. that calls the parent class constructor.</p>
    6142. 

  6142. 

  6143. <p><b>FetchField: </b>as documented above in ADORecordSet</p>
    6144. 

  6144. 

  6145. <p>_<b>initrs</b>: low level initialization of the recordset: setup the _<b>numOfRows</b>
    6146. 

  6146. and _<b>numOfFields</b> fields -- called by the constructor.</p>
    6147. 

  6147. 

  6148. <p>_<b>seek</b>: seek to a particular row. Do not load the data into the fields
    6149. 

  6149. array. This is done by _fetch. Returns true or false. Note that some
    6150. 

  6150. implementations such as Interbase do not support seek. Set canSeek to false.</p>
    6151. 

  6151. 

  6152. <p>_<b>fetch</b>: fetch a row using the database extension function and then
    6153. 

  6153. move to the next row. Sets the <b>fields</b> array. If the parameter
    6154. 

  6154. $ignore_fields is true then there is no need to populate the <b>fields</b>
    6155. 

  6155. array, just move to the next row. then Returns true or false.</p>
    6156. 

  6156. 

  6157. <p>_<b>close</b>: close the recordset</p>
    6158. 

  6158. 

  6159. <p><b>Fields</b>: If the array row returned by the PHP extension is not an
    6160. 

  6160. associative one, you will have to override this. See adodb-odbc.inc.php for an
    6161. 

  6161. example. For databases such as MySQL and MSSQL where an associative array is
    6162. 

  6162. returned, there is no need to override this function.</p>
    6163. 

  6163. 

  6164. <p><b>ADOConnection Fields to Set</b></p>
    6165. 

  6165. 

  6166. <p>canSeek: Set to true if the _seek function works.</p>
    6167. 

  6167. 

  6168. <h2>Optimizing PHP</h2>
    6169. 

  6169. 

  6170. <p class=MsoNormal>For info on tuning PHP, read this article on <a
    6171. 

  6171. href="http://phplens.com/lens/php-book/optimizing-debugging-php.php">Optimizing
    6172. 

  6172. PHP</a>. </p>
    6173. 

  6173. 

  6174. </div>
    6175. 

  6175. 

  6176. </body>
    6177. 

  6177. 

  6178. </html>
    6179.