123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146114711481149115011511152115311541155115611571158115911601161116211631164116511661167116811691170117111721173117411751176117711781179118011811182118311841185118611871188118911901191119211931194119511961197119811991200120112021203120412051206120712081209121012111212121312141215121612171218121912201221122212231224122512261227122812291230123112321233123412351236123712381239124012411242124312441245124612471248124912501251125212531254125512561257125812591260126112621263126412651266126712681269127012711272127312741275127612771278127912801281128212831284128512861287128812891290129112921293129412951296129712981299130013011302130313041305130613071308130913101311131213131314131513161317131813191320132113221323132413251326132713281329133013311332133313341335133613371338133913401341134213431344134513461347134813491350135113521353135413551356135713581359136013611362136313641365136613671368136913701371137213731374137513761377137813791380138113821383138413851386138713881389139013911392139313941395139613971398139914001401140214031404140514061407140814091410141114121413141414151416141714181419142014211422142314241425142614271428142914301431143214331434143514361437143814391440144114421443144414451446144714481449145014511452145314541455145614571458145914601461146214631464146514661467146814691470147114721473147414751476147714781479148014811482148314841485148614871488148914901491149214931494149514961497149814991500150115021503150415051506150715081509151015111512151315141515151615171518151915201521152215231524152515261527152815291530153115321533153415351536153715381539154015411542154315441545154615471548154915501551155215531554155515561557155815591560156115621563156415651566156715681569157015711572157315741575157615771578157915801581158215831584158515861587158815891590159115921593159415951596159715981599160016011602160316041605160616071608160916101611161216131614161516161617161816191620162116221623162416251626162716281629163016311632163316341635163616371638163916401641164216431644164516461647164816491650165116521653165416551656165716581659166016611662166316641665166616671668166916701671167216731674167516761677167816791680168116821683168416851686168716881689169016911692169316941695169616971698169917001701170217031704170517061707170817091710171117121713171417151716171717181719172017211722172317241725172617271728172917301731173217331734173517361737173817391740174117421743174417451746174717481749175017511752175317541755175617571758175917601761176217631764176517661767176817691770177117721773177417751776177717781779178017811782178317841785178617871788178917901791179217931794179517961797179817991800180118021803180418051806180718081809181018111812181318141815181618171818181918201821182218231824182518261827182818291830183118321833183418351836183718381839184018411842184318441845184618471848184918501851185218531854185518561857185818591860186118621863186418651866186718681869187018711872187318741875187618771878187918801881188218831884188518861887188818891890189118921893189418951896189718981899190019011902190319041905190619071908190919101911191219131914191519161917191819191920192119221923192419251926192719281929193019311932193319341935193619371938193919401941194219431944194519461947194819491950195119521953195419551956195719581959196019611962196319641965196619671968196919701971197219731974197519761977197819791980198119821983198419851986198719881989199019911992199319941995199619971998199920002001200220032004200520062007200820092010201120122013201420152016201720182019202020212022202320242025202620272028202920302031203220332034203520362037203820392040204120422043204420452046204720482049205020512052205320542055205620572058205920602061206220632064206520662067206820692070207120722073207420752076207720782079208020812082208320842085208620872088208920902091209220932094209520962097209820992100210121022103210421052106210721082109211021112112211321142115211621172118211921202121212221232124212521262127212821292130213121322133213421352136213721382139214021412142214321442145214621472148214921502151215221532154215521562157215821592160216121622163216421652166216721682169217021712172217321742175217621772178217921802181218221832184218521862187218821892190219121922193219421952196219721982199220022012202220322042205220622072208220922102211221222132214221522162217221822192220222122222223222422252226222722282229223022312232223322342235223622372238223922402241224222432244224522462247224822492250225122522253225422552256225722582259226022612262226322642265226622672268226922702271227222732274227522762277227822792280228122822283228422852286228722882289229022912292229322942295229622972298229923002301230223032304230523062307230823092310231123122313231423152316231723182319232023212322232323242325232623272328232923302331233223332334233523362337233823392340234123422343234423452346234723482349235023512352235323542355235623572358235923602361236223632364236523662367236823692370237123722373237423752376237723782379238023812382238323842385238623872388238923902391239223932394239523962397239823992400240124022403240424052406240724082409241024112412241324142415241624172418241924202421242224232424242524262427242824292430243124322433243424352436243724382439244024412442244324442445244624472448244924502451245224532454245524562457245824592460246124622463246424652466246724682469247024712472247324742475247624772478247924802481248224832484248524862487248824892490249124922493249424952496249724982499250025012502250325042505250625072508250925102511251225132514251525162517251825192520252125222523252425252526252725282529253025312532253325342535253625372538253925402541254225432544254525462547254825492550255125522553255425552556255725582559256025612562256325642565256625672568256925702571257225732574257525762577257825792580258125822583258425852586258725882589259025912592259325942595259625972598259926002601260226032604260526062607260826092610261126122613261426152616261726182619262026212622262326242625262626272628262926302631263226332634263526362637263826392640264126422643264426452646264726482649265026512652265326542655265626572658265926602661266226632664266526662667266826692670267126722673267426752676267726782679268026812682268326842685268626872688268926902691269226932694269526962697269826992700270127022703270427052706270727082709271027112712271327142715271627172718271927202721272227232724272527262727272827292730273127322733273427352736273727382739274027412742274327442745274627472748274927502751275227532754275527562757275827592760276127622763276427652766276727682769277027712772277327742775277627772778277927802781278227832784278527862787278827892790279127922793279427952796279727982799280028012802280328042805280628072808280928102811281228132814281528162817281828192820282128222823282428252826282728282829283028312832283328342835283628372838283928402841284228432844284528462847284828492850285128522853285428552856285728582859286028612862286328642865286628672868286928702871287228732874287528762877287828792880288128822883288428852886288728882889289028912892289328942895289628972898289929002901290229032904290529062907290829092910291129122913291429152916291729182919292029212922292329242925292629272928292929302931293229332934293529362937293829392940294129422943294429452946294729482949295029512952295329542955295629572958295929602961296229632964296529662967296829692970297129722973297429752976297729782979298029812982298329842985298629872988298929902991299229932994299529962997299829993000300130023003300430053006300730083009301030113012301330143015301630173018301930203021302230233024302530263027302830293030303130323033303430353036303730383039304030413042304330443045304630473048304930503051305230533054305530563057305830593060306130623063306430653066306730683069307030713072307330743075307630773078307930803081308230833084308530863087308830893090309130923093309430953096309730983099310031013102310331043105310631073108310931103111311231133114311531163117311831193120312131223123312431253126312731283129313031313132313331343135313631373138313931403141314231433144314531463147314831493150315131523153315431553156315731583159316031613162316331643165316631673168316931703171317231733174317531763177317831793180318131823183318431853186318731883189319031913192319331943195319631973198319932003201320232033204320532063207320832093210321132123213321432153216321732183219322032213222322332243225322632273228322932303231323232333234323532363237323832393240324132423243324432453246324732483249325032513252325332543255325632573258325932603261326232633264326532663267326832693270327132723273327432753276327732783279328032813282328332843285328632873288328932903291329232933294329532963297329832993300330133023303330433053306330733083309331033113312331333143315331633173318331933203321332233233324332533263327332833293330333133323333333433353336333733383339334033413342334333443345334633473348334933503351335233533354335533563357335833593360336133623363336433653366336733683369337033713372337333743375337633773378337933803381338233833384338533863387338833893390339133923393339433953396339733983399340034013402340334043405340634073408340934103411341234133414341534163417341834193420342134223423342434253426342734283429343034313432343334343435343634373438343934403441344234433444344534463447344834493450345134523453345434553456345734583459346034613462346334643465346634673468346934703471347234733474347534763477347834793480348134823483348434853486348734883489349034913492349334943495349634973498349935003501350235033504350535063507350835093510351135123513351435153516351735183519352035213522352335243525352635273528352935303531353235333534353535363537353835393540354135423543354435453546354735483549355035513552355335543555355635573558355935603561356235633564356535663567356835693570357135723573357435753576357735783579358035813582358335843585358635873588358935903591359235933594359535963597359835993600360136023603360436053606360736083609361036113612361336143615361636173618361936203621362236233624362536263627362836293630363136323633363436353636363736383639364036413642364336443645364636473648364936503651365236533654365536563657365836593660366136623663366436653666366736683669367036713672367336743675367636773678367936803681368236833684368536863687368836893690369136923693369436953696369736983699370037013702 |
- <?php
- /**
- * Base class for elFinder volume.
- * Provide 2 layers:
- * 1. Public API (commands)
- * 2. abstract fs API
- *
- * All abstract methods begin with "_"
- *
- * @author Dmitry (dio) Levashov
- * @author Troex Nevelin
- * @author Alexey Sukhotin
- **/
- abstract class elFinderVolumeDriver {
- /**
- * Driver id
- * Must be started from letter and contains [a-z0-9]
- * Used as part of volume id
- *
- * @var string
- **/
- protected $driverId = 'a';
- /**
- * Volume id - used as prefix for files hashes
- *
- * @var string
- **/
- protected $id = '';
- /**
- * Flag - volume "mounted" and available
- *
- * @var bool
- **/
- protected $mounted = false;
- /**
- * Root directory path
- *
- * @var string
- **/
- protected $root = '';
- /**
- * Root basename | alias
- *
- * @var string
- **/
- protected $rootName = '';
- /**
- * Default directory to open
- *
- * @var string
- **/
- protected $startPath = '';
- /**
- * Base URL
- *
- * @var string
- **/
- protected $URL = '';
- /**
- * Thumbnails dir path
- *
- * @var string
- **/
- protected $tmbPath = '';
- /**
- * Is thumbnails dir writable
- *
- * @var bool
- **/
- protected $tmbPathWritable = false;
- /**
- * Thumbnails base URL
- *
- * @var string
- **/
- protected $tmbURL = '';
- /**
- * Thumbnails size in px
- *
- * @var int
- **/
- protected $tmbSize = 48;
- /**
- * Image manipulation lib name
- * auto|imagick|mogtify|gd
- *
- * @var string
- **/
- protected $imgLib = 'auto';
- /**
- * Library to crypt files name
- *
- * @var string
- **/
- protected $cryptLib = '';
- /**
- * Archivers config
- *
- * @var array
- **/
- protected $archivers = array(
- 'create' => array(),
- 'extract' => array()
- );
- /**
- * How many subdirs levels return for tree
- *
- * @var int
- **/
- protected $treeDeep = 1;
- /**
- * Errors from last failed action
- *
- * @var array
- **/
- protected $error = array();
- /**
- * Today 24:00 timestamp
- *
- * @var int
- **/
- protected $today = 0;
- /**
- * Yesterday 24:00 timestamp
- *
- * @var int
- **/
- protected $yesterday = 0;
- /**
- * Object configuration
- *
- * @var array
- **/
- protected $options = array(
- 'id' => '',
- // root directory path
- 'path' => '',
- // open this path on initial request instead of root path
- 'startPath' => '',
- // how many subdirs levels return per request
- 'treeDeep' => 1,
- // root url, not set to disable sending URL to client (replacement for old "fileURL" option)
- 'URL' => '',
- // directory separator. required by client to show paths correctly
- 'separator' => DIRECTORY_SEPARATOR,
- // library to crypt/uncrypt files names (not implemented)
- 'cryptLib' => '',
- // how to detect files mimetypes. (auto/internal/finfo/mime_content_type)
- 'mimeDetect' => 'auto',
- // mime.types file path (for mimeDetect==internal)
- 'mimefile' => '',
- // directory for thumbnails
- 'tmbPath' => '.tmb',
- // mode to create thumbnails dir
- 'tmbPathMode' => 0777,
- // thumbnails dir URL. Set it if store thumbnails outside root directory
- 'tmbURL' => '',
- // thumbnails size (px)
- 'tmbSize' => 48,
- // thumbnails crop (true - crop, false - scale image to fit thumbnail size)
- 'tmbCrop' => true,
- // thumbnails background color (hex #rrggbb or 'transparent')
- 'tmbBgColor' => '#ffffff',
- // image manipulations library
- 'imgLib' => 'auto',
- // on paste file - if true - old file will be replaced with new one, if false new file get name - original_name-number.ext
- 'copyOverwrite' => true,
- // if true - join new and old directories content on paste
- 'copyJoin' => true,
- // on upload - if true - old file will be replaced with new one, if false new file get name - original_name-number.ext
- 'uploadOverwrite' => true,
- // mimetypes allowed to upload
- 'uploadAllow' => array(),
- // mimetypes not allowed to upload
- 'uploadDeny' => array(),
- // order to proccess uploadAllow and uploadDeny options
- 'uploadOrder' => array('deny', 'allow'),
- // maximum upload file size. NOTE - this is size for every uploaded files
- 'uploadMaxSize' => 0,
- // files dates format
- 'dateFormat' => 'j M Y H:i',
- // files time format
- 'timeFormat' => 'H:i',
- // if true - every folder will be check for children folders, otherwise all folders will be marked as having subfolders
- 'checkSubfolders' => true,
- // allow to copy from this volume to other ones?
- 'copyFrom' => true,
- // allow to copy from other volumes to this one?
- 'copyTo' => true,
- // list of commands disabled on this root
- 'disabled' => array(),
- // regexp or function name to validate new file name
- 'acceptedName' => '/^[^\.].*/', //<-- DONT touch this! Use constructor options to overwrite it!
- // function/class method to control files permissions
- 'accessControl' => null,
- // some data required by access control
- 'accessControlData' => null,
- // default permissions. not set hidden/locked here - take no effect
- 'defaults' => array(
- 'read' => true,
- 'write' => true
- ),
- // files attributes
- 'attributes' => array(),
- // Allowed archive's mimetypes to create. Leave empty for all available types.
- 'archiveMimes' => array(),
- // Manual config for archivers. See example below. Leave empty for auto detect
- 'archivers' => array(),
- // plugin settings
- 'plugin' => array(),
- // required to fix bug on macos
- 'utf8fix' => false,
- // й ё Й Ё Ø Å
- 'utf8patterns' => array("\u0438\u0306", "\u0435\u0308", "\u0418\u0306", "\u0415\u0308", "\u00d8A", "\u030a"),
- 'utf8replace' => array("\u0439", "\u0451", "\u0419", "\u0401", "\u00d8", "\u00c5")
- );
- /**
- * Defaults permissions
- *
- * @var array
- **/
- protected $defaults = array(
- 'read' => true,
- 'write' => true,
- 'locked' => false,
- 'hidden' => false
- );
- /**
- * Access control function/class
- *
- * @var mixed
- **/
- protected $attributes = array();
- /**
- * Access control function/class
- *
- * @var mixed
- **/
- protected $access = null;
- /**
- * Mime types allowed to upload
- *
- * @var array
- **/
- protected $uploadAllow = array();
- /**
- * Mime types denied to upload
- *
- * @var array
- **/
- protected $uploadDeny = array();
- /**
- * Order to validate uploadAllow and uploadDeny
- *
- * @var array
- **/
- protected $uploadOrder = array();
- /**
- * Maximum allowed upload file size.
- * Set as number or string with unit - "10M", "500K", "1G"
- *
- * @var int|string
- **/
- protected $uploadMaxSize = 0;
- /**
- * Mimetype detect method
- *
- * @var string
- **/
- protected $mimeDetect = 'auto';
- /**
- * Flag - mimetypes from externail file was loaded
- *
- * @var bool
- **/
- private static $mimetypesLoaded = false;
- /**
- * Finfo object for mimeDetect == 'finfo'
- *
- * @var object
- **/
- protected $finfo = null;
- /**
- * List of disabled client's commands
- *
- * @var array
- **/
- protected $diabled = array();
- /**
- * default extensions/mimetypes for mimeDetect == 'internal'
- *
- * @var array
- **/
- protected static $mimetypes = array(
- // applications
- 'ai' => 'application/postscript',
- 'eps' => 'application/postscript',
- 'exe' => 'application/x-executable',
- 'doc' => 'application/vnd.ms-word',
- 'xls' => 'application/vnd.ms-excel',
- 'ppt' => 'application/vnd.ms-powerpoint',
- 'pps' => 'application/vnd.ms-powerpoint',
- 'pdf' => 'application/pdf',
- 'xml' => 'application/xml',
- 'swf' => 'application/x-shockwave-flash',
- 'torrent' => 'application/x-bittorrent',
- 'jar' => 'application/x-jar',
- // open office (finfo detect as application/zip)
- 'odt' => 'application/vnd.oasis.opendocument.text',
- 'ott' => 'application/vnd.oasis.opendocument.text-template',
- 'oth' => 'application/vnd.oasis.opendocument.text-web',
- 'odm' => 'application/vnd.oasis.opendocument.text-master',
- 'odg' => 'application/vnd.oasis.opendocument.graphics',
- 'otg' => 'application/vnd.oasis.opendocument.graphics-template',
- 'odp' => 'application/vnd.oasis.opendocument.presentation',
- 'otp' => 'application/vnd.oasis.opendocument.presentation-template',
- 'ods' => 'application/vnd.oasis.opendocument.spreadsheet',
- 'ots' => 'application/vnd.oasis.opendocument.spreadsheet-template',
- 'odc' => 'application/vnd.oasis.opendocument.chart',
- 'odf' => 'application/vnd.oasis.opendocument.formula',
- 'odb' => 'application/vnd.oasis.opendocument.database',
- 'odi' => 'application/vnd.oasis.opendocument.image',
- 'oxt' => 'application/vnd.openofficeorg.extension',
- // MS office 2007 (finfo detect as application/zip)
- 'docx' => 'application/vnd.openxmlformats-officedocument.wordprocessingml.document',
- 'docm' => 'application/vnd.ms-word.document.macroEnabled.12',
- 'dotx' => 'application/vnd.openxmlformats-officedocument.wordprocessingml.template',
- 'dotm' => 'application/vnd.ms-word.template.macroEnabled.12',
- 'xlsx' => 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet',
- 'xlsm' => 'application/vnd.ms-excel.sheet.macroEnabled.12',
- 'xltx' => 'application/vnd.openxmlformats-officedocument.spreadsheetml.template',
- 'xltm' => 'application/vnd.ms-excel.template.macroEnabled.12',
- 'xlsb' => 'application/vnd.ms-excel.sheet.binary.macroEnabled.12',
- 'xlam' => 'application/vnd.ms-excel.addin.macroEnabled.12',
- 'pptx' => 'application/vnd.openxmlformats-officedocument.presentationml.presentation',
- 'pptm' => 'application/vnd.ms-powerpoint.presentation.macroEnabled.12',
- 'ppsx' => 'application/vnd.openxmlformats-officedocument.presentationml.slideshow',
- 'ppsm' => 'application/vnd.ms-powerpoint.slideshow.macroEnabled.12',
- 'potx' => 'application/vnd.openxmlformats-officedocument.presentationml.template',
- 'potm' => 'application/vnd.ms-powerpoint.template.macroEnabled.12',
- 'ppam' => 'application/vnd.ms-powerpoint.addin.macroEnabled.12',
- 'sldx' => 'application/vnd.openxmlformats-officedocument.presentationml.slide',
- 'sldm' => 'application/vnd.ms-powerpoint.slide.macroEnabled.12',
- // archives
- 'gz' => 'application/x-gzip',
- 'tgz' => 'application/x-gzip',
- 'bz' => 'application/x-bzip2',
- 'bz2' => 'application/x-bzip2',
- 'tbz' => 'application/x-bzip2',
- 'zip' => 'application/zip',
- 'rar' => 'application/x-rar',
- 'tar' => 'application/x-tar',
- '7z' => 'application/x-7z-compressed',
- // texts
- 'txt' => 'text/plain',
- 'php' => 'text/x-php',
- 'html' => 'text/html',
- 'htm' => 'text/html',
- 'js' => 'text/javascript',
- 'css' => 'text/css',
- 'rtf' => 'text/rtf',
- 'rtfd' => 'text/rtfd',
- 'py' => 'text/x-python',
- 'java' => 'text/x-java-source',
- 'rb' => 'text/x-ruby',
- 'sh' => 'text/x-shellscript',
- 'pl' => 'text/x-perl',
- 'xml' => 'text/xml',
- 'sql' => 'text/x-sql',
- 'c' => 'text/x-csrc',
- 'h' => 'text/x-chdr',
- 'cpp' => 'text/x-c++src',
- 'hh' => 'text/x-c++hdr',
- 'log' => 'text/plain',
- 'csv' => 'text/x-comma-separated-values',
- // images
- 'bmp' => 'image/x-ms-bmp',
- 'jpg' => 'image/jpeg',
- 'jpeg' => 'image/jpeg',
- 'gif' => 'image/gif',
- 'png' => 'image/png',
- 'tif' => 'image/tiff',
- 'tiff' => 'image/tiff',
- 'tga' => 'image/x-targa',
- 'psd' => 'image/vnd.adobe.photoshop',
- 'ai' => 'image/vnd.adobe.photoshop',
- 'xbm' => 'image/xbm',
- 'pxm' => 'image/pxm',
- //audio
- 'mp3' => 'audio/mpeg',
- 'mid' => 'audio/midi',
- 'ogg' => 'audio/ogg',
- 'oga' => 'audio/ogg',
- 'm4a' => 'audio/x-m4a',
- 'wav' => 'audio/wav',
- 'wma' => 'audio/x-ms-wma',
- // video
- 'avi' => 'video/x-msvideo',
- 'dv' => 'video/x-dv',
- 'mp4' => 'video/mp4',
- 'mpeg' => 'video/mpeg',
- 'mpg' => 'video/mpeg',
- 'mov' => 'video/quicktime',
- 'wm' => 'video/x-ms-wmv',
- 'flv' => 'video/x-flv',
- 'mkv' => 'video/x-matroska',
- 'webm' => 'video/webm',
- 'ogv' => 'video/ogg',
- 'ogm' => 'video/ogg'
- );
- /**
- * Directory separator - required by client
- *
- * @var string
- **/
- protected $separator = DIRECTORY_SEPARATOR;
- /**
- * Mimetypes allowed to display
- *
- * @var array
- **/
- protected $onlyMimes = array();
- /**
- * Store files moved or overwrited files info
- *
- * @var array
- **/
- protected $removed = array();
- /**
- * Cache storage
- *
- * @var array
- **/
- protected $cache = array();
- /**
- * Cache by folders
- *
- * @var array
- **/
- protected $dirsCache = array();
- /*********************************************************************/
- /* INITIALIZATION */
- /*********************************************************************/
- /**
- * Prepare driver before mount volume.
- * Return true if volume is ready.
- *
- * @return bool
- * @author Dmitry (dio) Levashov
- **/
- protected function init() {
- return true;
- }
- /**
- * Configure after successfull mount.
- * By default set thumbnails path and image manipulation library.
- *
- * @return void
- * @author Dmitry (dio) Levashov
- **/
- protected function configure() {
- // set thumbnails path
- $path = $this->options['tmbPath'];
- if ($path) {
- if (!file_exists($path)) {
- if (@mkdir($path)) {
- chmod($path, $this->options['tmbPathMode']);
- } else {
- $path = '';
- }
- }
- if (is_dir($path) && is_readable($path)) {
- $this->tmbPath = $path;
- $this->tmbPathWritable = is_writable($path);
- }
- }
- // set image manipulation library
- $type = preg_match('/^(imagick|gd|auto)$/i', $this->options['imgLib'])
- ? strtolower($this->options['imgLib'])
- : 'auto';
- if (($type == 'imagick' || $type == 'auto') && extension_loaded('imagick')) {
- $this->imgLib = 'imagick';
- } else {
- $this->imgLib = function_exists('gd_info') ? 'gd' : '';
- }
- }
- /*********************************************************************/
- /* PUBLIC API */
- /*********************************************************************/
- /**
- * Return driver id. Used as a part of volume id.
- *
- * @return string
- * @author Dmitry (dio) Levashov
- **/
- public function driverId() {
- return $this->driverId;
- }
- /**
- * Return volume id
- *
- * @return string
- * @author Dmitry (dio) Levashov
- **/
- public function id() {
- return $this->id;
- }
- /**
- * Return debug info for client
- *
- * @return array
- * @author Dmitry (dio) Levashov
- **/
- public function debug() {
- return array(
- 'id' => $this->id(),
- 'name' => strtolower(substr(get_class($this), strlen('elfinderdriver'))),
- 'mimeDetect' => $this->mimeDetect,
- 'imgLib' => $this->imgLib
- );
- }
- /**
- * "Mount" volume.
- * Return true if volume available for read or write,
- * false - otherwise
- *
- * @return bool
- * @author Dmitry (dio) Levashov
- * @author Alexey Sukhotin
- **/
- public function mount(array $opts) {
- if (!isset($opts['path']) || $opts['path'] === '') {
- return $this->setError('Path undefined.');;
- }
- $this->options = array_merge($this->options, $opts);
- $this->id = $this->driverId.(!empty($this->options['id']) ? $this->options['id'] : elFinder::$volumesCnt++).'_';
- $this->root = $this->_normpath($this->options['path']);
- $this->separator = isset($this->options['separator']) ? $this->options['separator'] : DIRECTORY_SEPARATOR;
- // default file attribute
- $this->defaults = array(
- 'read' => isset($this->options['defaults']['read']) ? !!$this->options['defaults']['read'] : true,
- 'write' => isset($this->options['defaults']['write']) ? !!$this->options['defaults']['write'] : true,
- 'locked' => false,
- 'hidden' => false
- );
- // root attributes
- $this->attributes[] = array(
- 'pattern' => '~^'.preg_quote(DIRECTORY_SEPARATOR).'$~',
- 'locked' => true,
- 'hidden' => false
- );
- // set files attributes
- if (!empty($this->options['attributes']) && is_array($this->options['attributes'])) {
- foreach ($this->options['attributes'] as $a) {
- // attributes must contain pattern and at least one rule
- if (!empty($a['pattern']) || count($a) > 1) {
- $this->attributes[] = $a;
- }
- }
- }
- if (!empty($this->options['accessControl']) && is_callable($this->options['accessControl'])) {
- $this->access = $this->options['accessControl'];
- }
- $this->today = mktime(0,0,0, date('m'), date('d'), date('Y'));
- $this->yesterday = $this->today-86400;
- // debug($this->attributes);
- if (!$this->init()) {
- return false;
- }
- // check some options is arrays
- $this->uploadAllow = isset($this->options['uploadAllow']) && is_array($this->options['uploadAllow'])
- ? $this->options['uploadAllow']
- : array();
- $this->uploadDeny = isset($this->options['uploadDeny']) && is_array($this->options['uploadDeny'])
- ? $this->options['uploadDeny']
- : array();
- if (is_string($this->options['uploadOrder'])) { // telephat_mode on, compatibility with 1.x
- $parts = explode(',', isset($this->options['uploadOrder']) ? $this->options['uploadOrder'] : 'deny,allow');
- $this->uploadOrder = array(trim($parts[0]), trim($parts[1]));
- } else { // telephat_mode off
- $this->uploadOrder = $this->options['uploadOrder'];
- }
- if (!empty($this->options['uploadMaxSize'])) {
- $size = ''.$this->options['uploadMaxSize'];
- $unit = strtolower(substr($size, strlen($size) - 1));
- $n = 1;
- switch ($unit) {
- case 'k':
- $n = 1024;
- break;
- case 'm':
- $n = 1048576;
- break;
- case 'g':
- $n = 1073741824;
- }
- $this->uploadMaxSize = intval($size)*$n;
- }
- $this->disabled = isset($this->options['disabled']) && is_array($this->options['disabled'])
- ? $this->options['disabled']
- : array();
- $this->cryptLib = $this->options['cryptLib'];
- $this->mimeDetect = $this->options['mimeDetect'];
- // find available mimetype detect method
- $type = strtolower($this->options['mimeDetect']);
- $type = preg_match('/^(finfo|mime_content_type|internal|auto)$/i', $type) ? $type : 'auto';
- $regexp = '/text\/x\-(php|c\+\+)/';
- if (($type == 'finfo' || $type == 'auto')
- && class_exists('finfo')) {
- $tmpFileInfo = @explode(';', @finfo_file(finfo_open(FILEINFO_MIME), __FILE__));
- } else {
- $tmpFileInfo = false;
- }
- if ($tmpFileInfo && preg_match($regexp, array_shift($tmpFileInfo))) {
- $type = 'finfo';
- $this->finfo = finfo_open(FILEINFO_MIME);
- } elseif (($type == 'mime_content_type' || $type == 'auto')
- && function_exists('mime_content_type')
- && preg_match($regexp, array_shift(explode(';', mime_content_type(__FILE__))))) {
- $type = 'mime_content_type';
- } else {
- $type = 'internal';
- }
- $this->mimeDetect = $type;
- // load mimes from external file for mimeDetect == 'internal'
- // based on Alexey Sukhotin idea and patch: http://elrte.org/redmine/issues/163
- // file must be in file directory or in parent one
- if ($this->mimeDetect == 'internal' && !self::$mimetypesLoaded) {
- self::$mimetypesLoaded = true;
- $this->mimeDetect = 'internal';
- $file = false;
- if (!empty($this->options['mimefile']) && file_exists($this->options['mimefile'])) {
- $file = $this->options['mimefile'];
- } elseif (file_exists(dirname(__FILE__).DIRECTORY_SEPARATOR.'mime.types')) {
- $file = dirname(__FILE__).DIRECTORY_SEPARATOR.'mime.types';
- } elseif (file_exists(dirname(dirname(__FILE__)).DIRECTORY_SEPARATOR.'mime.types')) {
- $file = dirname(dirname(__FILE__)).DIRECTORY_SEPARATOR.'mime.types';
- }
- if ($file && file_exists($file)) {
- $mimecf = file($file);
- foreach ($mimecf as $line_num => $line) {
- if (!preg_match('/^\s*#/', $line)) {
- $mime = preg_split('/\s+/', $line, -1, PREG_SPLIT_NO_EMPTY);
- for ($i = 1, $size = count($mime); $i < $size ; $i++) {
- if (!isset(self::$mimetypes[$mime[$i]])) {
- self::$mimetypes[$mime[$i]] = $mime[0];
- }
- }
- }
- }
- }
- }
- $this->rootName = empty($this->options['alias']) ? $this->_basename($this->root) : $this->options['alias'];
- $root = $this->stat($this->root);
- if (!$root) {
- return $this->setError('Root folder does not exists.');
- }
- if (!$root['read'] && !$root['write']) {
- return $this->setError('Root folder has not read and write permissions.');
- }
- // debug($root);
- if ($root['read']) {
- // check startPath - path to open by default instead of root
- if ($this->options['startPath']) {
- $start = $this->stat($this->options['startPath']);
- if (!empty($start)
- && $start['mime'] == 'directory'
- && $start['read']
- && empty($start['hidden'])
- && $this->_inpath($this->options['startPath'], $this->root)) {
- $this->startPath = $this->options['startPath'];
- if (substr($this->startPath, -1, 1) == $this->options['separator']) {
- $this->startPath = substr($this->startPath, 0, -1);
- }
- }
- }
- } else {
- $this->options['URL'] = '';
- $this->options['tmbURL'] = '';
- $this->options['tmbPath'] = '';
- // read only volume
- array_unshift($this->attributes, array(
- 'pattern' => '/.*/',
- 'read' => false
- ));
- }
- $this->treeDeep = $this->options['treeDeep'] > 0 ? (int)$this->options['treeDeep'] : 1;
- $this->tmbSize = $this->options['tmbSize'] > 0 ? (int)$this->options['tmbSize'] : 48;
- $this->URL = $this->options['URL'];
- if ($this->URL && preg_match("|[^/?&=]$|", $this->URL)) {
- $this->URL .= '/';
- }
- $this->tmbURL = !empty($this->options['tmbURL']) ? $this->options['tmbURL'] : '';
- if ($this->tmbURL && preg_match("|[^/?&=]$|", $this->tmbURL)) {
- $this->tmbURL .= '/';
- }
- $this->nameValidator = is_string($this->options['acceptedName']) && !empty($this->options['acceptedName'])
- ? $this->options['acceptedName']
- : '';
- $this->_checkArchivers();
- // manual control archive types to create
- if (!empty($this->options['archiveMimes']) && is_array($this->options['archiveMimes'])) {
- foreach ($this->archivers['create'] as $mime => $v) {
- if (!in_array($mime, $this->options['archiveMimes'])) {
- unset($this->archivers['create'][$mime]);
- }
- }
- }
- // manualy add archivers
- if (!empty($this->options['archivers']['create']) && is_array($this->options['archivers']['create'])) {
- foreach ($this->options['archivers']['create'] as $mime => $conf) {
- if (strpos($mime, 'application/') === 0
- && !empty($conf['cmd'])
- && isset($conf['argc'])
- && !empty($conf['ext'])
- && !isset($this->archivers['create'][$mime])) {
- $this->archivers['create'][$mime] = $conf;
- }
- }
- }
- if (!empty($this->options['archivers']['extract']) && is_array($this->options['archivers']['extract'])) {
- foreach ($this->options['archivers']['extract'] as $mime => $conf) {
- if (strpos($mime, 'application/') === 0
- && !empty($conf['cmd'])
- && isset($conf['argc'])
- && !empty($conf['ext'])
- && !isset($this->archivers['extract'][$mime])) {
- $this->archivers['extract'][$mime] = $conf;
- }
- }
- }
- $this->configure();
- // echo $this->uploadMaxSize;
- // echo $this->options['uploadMaxSize'];
- return $this->mounted = true;
- }
- /**
- * Some "unmount" stuffs - may be required by virtual fs
- *
- * @return void
- * @author Dmitry (dio) Levashov
- **/
- public function umount() {
- }
- /**
- * Return error message from last failed action
- *
- * @return array
- * @author Dmitry (dio) Levashov
- **/
- public function error() {
- return $this->error;
- }
- /**
- * Return Extention/MIME Table (elFinderVolumeDriver::$mimetypes)
- *
- * @return array
- * @author Naoki Sawada
- */
- public function getMimeTable() {
- return elFinderVolumeDriver::$mimetypes;
- }
- /**
- * Set mimetypes allowed to display to client
- *
- * @param array $mimes
- * @return void
- * @author Dmitry (dio) Levashov
- **/
- public function setMimesFilter($mimes) {
- if (is_array($mimes)) {
- $this->onlyMimes = $mimes;
- }
- }
- /**
- * Return root folder hash
- *
- * @return string
- * @author Dmitry (dio) Levashov
- **/
- public function root() {
- return $this->encode($this->root);
- }
- /**
- * Return root or startPath hash
- *
- * @return string
- * @author Dmitry (dio) Levashov
- **/
- public function defaultPath() {
- return $this->encode($this->startPath ? $this->startPath : $this->root);
- }
- /**
- * Return volume options required by client:
- *
- * @return array
- * @author Dmitry (dio) Levashov
- **/
- public function options($hash) {
- return array(
- 'path' => $this->_path($this->decode($hash)),
- 'url' => $this->URL,
- 'tmbUrl' => $this->tmbURL,
- 'disabled' => $this->disabled,
- 'separator' => $this->separator,
- 'copyOverwrite' => intval($this->options['copyOverwrite']),
- 'uploadMaxSize' => intval($this->uploadMaxSize),
- 'archivers' => array(
- // 'create' => array_keys($this->archivers['create']),
- // 'extract' => array_keys($this->archivers['extract']),
- 'create' => is_array($this->archivers['create']) ? array_keys($this->archivers['create']) : array(),
- 'extract' => is_array($this->archivers['extract']) ? array_keys($this->archivers['extract']) : array()
- )
- );
- }
- /**
- * Get plugin values of this options
- *
- * @param string $name Plugin name
- * @return NULL|array Plugin values
- * @author Naoki Sawada
- */
- public function getOptionsPlugin($name = '') {
- if ($name) {
- return isset($this->options['plugin'][$name])? $this->options['plugin'][$name] : array();
- } else {
- return $this->options['plugin'];
- }
- }
- /**
- * Return true if command disabled in options
- *
- * @param string $cmd command name
- * @return bool
- * @author Dmitry (dio) Levashov
- **/
- public function commandDisabled($cmd) {
- return in_array($cmd, $this->disabled);
- }
- /**
- * Return true if mime is required mimes list
- *
- * @param string $mime mime type to check
- * @param array $mimes allowed mime types list or not set to use client mimes list
- * @param bool|null $empty what to return on empty list
- * @return bool|null
- * @author Dmitry (dio) Levashov
- * @author Troex Nevelin
- **/
- public function mimeAccepted($mime, $mimes = array(), $empty = true) {
- $mimes = !empty($mimes) ? $mimes : $this->onlyMimes;
- if (empty($mimes)) {
- return $empty;
- }
- return $mime == 'directory'
- || in_array('all', $mimes)
- || in_array('All', $mimes)
- || in_array($mime, $mimes)
- || in_array(substr($mime, 0, strpos($mime, '/')), $mimes);
- }
- /**
- * Return true if voume is readable.
- *
- * @return bool
- * @author Dmitry (dio) Levashov
- **/
- public function isReadable() {
- $stat = $this->stat($this->root);
- return $stat['read'];
- }
- /**
- * Return true if copy from this volume allowed
- *
- * @return bool
- * @author Dmitry (dio) Levashov
- **/
- public function copyFromAllowed() {
- return !!$this->options['copyFrom'];
- }
- /**
- * Return file path related to root
- *
- * @param string $hash file hash
- * @return string
- * @author Dmitry (dio) Levashov
- **/
- public function path($hash) {
- return $this->_path($this->decode($hash));
- }
- /**
- * Return file real path if file exists
- *
- * @param string $hash file hash
- * @return string
- * @author Dmitry (dio) Levashov
- **/
- public function realpath($hash) {
- $path = $this->decode($hash);
- return $this->stat($path) ? $path : false;
- }
- /**
- * Return list of moved/overwrited files
- *
- * @return array
- * @author Dmitry (dio) Levashov
- **/
- public function removed() {
- return $this->removed;
- }
- /**
- * Clean removed files list
- *
- * @return void
- * @author Dmitry (dio) Levashov
- **/
- public function resetRemoved() {
- $this->removed = array();
- }
- /**
- * Return file/dir hash or first founded child hash with required attr == $val
- *
- * @param string $hash file hash
- * @param string $attr attribute name
- * @param bool $val attribute value
- * @return string|false
- * @author Dmitry (dio) Levashov
- **/
- public function closest($hash, $attr, $val) {
- return ($path = $this->closestByAttr($this->decode($hash), $attr, $val)) ? $this->encode($path) : false;
- }
- /**
- * Return file info or false on error
- *
- * @param string $hash file hash
- * @param bool $realpath add realpath field to file info
- * @return array|false
- * @author Dmitry (dio) Levashov
- **/
- public function file($hash) {
- $path = $this->decode($hash);
- return ($file = $this->stat($path)) ? $file : $this->setError(elFinder::ERROR_FILE_NOT_FOUND);
- if (($file = $this->stat($path)) != false) {
- if ($realpath) {
- $file['realpath'] = $path;
- }
- return $file;
- }
- return $this->setError(elFinder::ERROR_FILE_NOT_FOUND);
- }
- /**
- * Return folder info
- *
- * @param string $hash folder hash
- * @param bool $hidden return hidden file info
- * @return array|false
- * @author Dmitry (dio) Levashov
- **/
- public function dir($hash, $resolveLink=false) {
- if (($dir = $this->file($hash)) == false) {
- return $this->setError(elFinder::ERROR_DIR_NOT_FOUND);
- }
- if ($resolveLink && !empty($dir['thash'])) {
- $dir = $this->file($dir['thash']);
- }
- return $dir && $dir['mime'] == 'directory' && empty($dir['hidden'])
- ? $dir
- : $this->setError(elFinder::ERROR_NOT_DIR);
- }
- /**
- * Return directory content or false on error
- *
- * @param string $hash file hash
- * @return array|false
- * @author Dmitry (dio) Levashov
- **/
- public function scandir($hash) {
- if (($dir = $this->dir($hash)) == false) {
- return false;
- }
- return $dir['read']
- ? $this->getScandir($this->decode($hash))
- : $this->setError(elFinder::ERROR_PERM_DENIED);
- }
- /**
- * Return dir files names list
- *
- * @param string $hash file hash
- * @return array
- * @author Dmitry (dio) Levashov
- **/
- public function ls($hash) {
- if (($dir = $this->dir($hash)) == false || !$dir['read']) {
- return false;
- }
- $list = array();
- $path = $this->decode($hash);
- foreach ($this->getScandir($path) as $stat) {
- if (empty($stat['hidden']) && $this->mimeAccepted($stat['mime'])) {
- $list[] = $stat['name'];
- }
- }
- return $list;
- }
- /**
- * Return subfolders for required folder or false on error
- *
- * @param string $hash folder hash or empty string to get tree from root folder
- * @param int $deep subdir deep
- * @param string $exclude dir hash which subfolders must be exluded from result, required to not get stat twice on cwd subfolders
- * @return array|false
- * @author Dmitry (dio) Levashov
- **/
- public function tree($hash='', $deep=0, $exclude='') {
- $path = $hash ? $this->decode($hash) : $this->root;
- if (($dir = $this->stat($path)) == false || $dir['mime'] != 'directory') {
- return false;
- }
- $dirs = $this->gettree($path, $deep > 0 ? $deep -1 : $this->treeDeep-1, $exclude ? $this->decode($exclude) : null);
- array_unshift($dirs, $dir);
- return $dirs;
- }
- /**
- * Return part of dirs tree from required dir up to root dir
- *
- * @param string $hash directory hash
- * @return array
- * @author Dmitry (dio) Levashov
- **/
- public function parents($hash) {
- if (($current = $this->dir($hash)) == false) {
- return false;
- }
- $path = $this->decode($hash);
- $tree = array();
- while ($path && $path != $this->root) {
- $path = $this->_dirname($path);
- $stat = $this->stat($path);
- if (!empty($stat['hidden']) || !$stat['read']) {
- return false;
- }
- array_unshift($tree, $stat);
- if ($path != $this->root) {
- foreach ($this->gettree($path, 0) as $dir) {
- if (!in_array($dir, $tree)) {
- $tree[] = $dir;
- }
- }
- }
- }
- return $tree ? $tree : array($current);
- }
- /**
- * Create thumbnail for required file and return its name of false on failed
- *
- * @return string|false
- * @author Dmitry (dio) Levashov
- **/
- public function tmb($hash) {
- $path = $this->decode($hash);
- $stat = $this->stat($path);
- if (isset($stat['tmb'])) {
- return $stat['tmb'] == "1" ? $this->createTmb($path, $stat) : $stat['tmb'];
- }
- return false;
- }
- /**
- * Return file size / total directory size
- *
- * @param string file hash
- * @return int
- * @author Dmitry (dio) Levashov
- **/
- public function size($hash) {
- return $this->countSize($this->decode($hash));
- }
- /**
- * Open file for reading and return file pointer
- *
- * @param string file hash
- * @return Resource
- * @author Dmitry (dio) Levashov
- **/
- public function open($hash) {
- if (($file = $this->file($hash)) == false
- || $file['mime'] == 'directory') {
- return false;
- }
- return $this->_fopen($this->decode($hash), 'rb');
- }
- /**
- * Close file pointer
- *
- * @param Resource $fp file pointer
- * @param string $hash file hash
- * @return void
- * @author Dmitry (dio) Levashov
- **/
- public function close($fp, $hash) {
- $this->_fclose($fp, $this->decode($hash));
- }
- /**
- * Create directory and return dir info
- *
- * @param string $dst destination directory
- * @param string $name directory name
- * @return array|false
- * @author Dmitry (dio) Levashov
- **/
- public function mkdir($dst, $name) {
- if ($this->commandDisabled('mkdir')) {
- return $this->setError(elFinder::ERROR_PERM_DENIED);
- }
- if (!$this->nameAccepted($name)) {
- return $this->setError(elFinder::ERROR_INVALID_NAME);
- }
- if (($dir = $this->dir($dst)) == false) {
- return $this->setError(elFinder::ERROR_TRGDIR_NOT_FOUND, '#'.$dst);
- }
- if (!$dir['write']) {
- return $this->setError(elFinder::ERROR_PERM_DENIED);
- }
- $path = $this->decode($dst);
- $dst = $this->_joinPath($path, $name);
- $stat = $this->stat($dst);
- if (!empty($stat)) {
- return $this->setError(elFinder::ERROR_EXISTS, $name);
- }
- $this->clearcache();
- return ($path = $this->_mkdir($path, $name)) ? $this->stat($path) : false;
- }
- /**
- * Create empty file and return its info
- *
- * @param string $dst destination directory
- * @param string $name file name
- * @return array|false
- * @author Dmitry (dio) Levashov
- **/
- public function mkfile($dst, $name) {
- if ($this->commandDisabled('mkfile')) {
- return $this->setError(elFinder::ERROR_PERM_DENIED);
- }
- if (!$this->nameAccepted($name)) {
- return $this->setError(elFinder::ERROR_INVALID_NAME);
- }
- if (($dir = $this->dir($dst)) == false) {
- return $this->setError(elFinder::ERROR_TRGDIR_NOT_FOUND, '#'.$dst);
- }
- $path = $this->decode($dst);
- if (!$dir['write'] || !$this->allowCreate($path, $name)) {
- return $this->setError(elFinder::ERROR_PERM_DENIED);
- }
- if ($this->stat($this->_joinPath($path, $name))) {
- return $this->setError(elFinder::ERROR_EXISTS, $name);
- }
- $this->clearcache();
- return ($path = $this->_mkfile($path, $name)) ? $this->stat($path) : false;
- }
- /**
- * Rename file and return file info
- *
- * @param string $hash file hash
- * @param string $name new file name
- * @return array|false
- * @author Dmitry (dio) Levashov
- **/
- public function rename($hash, $name) {
- if ($this->commandDisabled('rename')) {
- return $this->setError(elFinder::ERROR_PERM_DENIED);
- }
- if (!$this->nameAccepted($name)) {
- return $this->setError(elFinder::ERROR_INVALID_NAME, $name);
- }
- if (!($file = $this->file($hash))) {
- return $this->setError(elFinder::ERROR_FILE_NOT_FOUND);
- }
- if ($name == $file['name']) {
- return $file;
- }
- if (!empty($file['locked'])) {
- return $this->setError(elFinder::ERROR_LOCKED, $file['name']);
- }
- $path = $this->decode($hash);
- $dir = $this->_dirname($path);
- $stat = $this->stat($this->_joinPath($dir, $name));
- if ($stat) {
- return $this->setError(elFinder::ERROR_EXISTS, $name);
- }
- if (!$this->allowCreate($dir, $name)) {
- return $this->setError(elFinder::ERROR_PERM_DENIED);
- }
- $this->rmTmb($file); // remove old name tmbs, we cannot do this after dir move
- if (($path = $this->_move($path, $dir, $name))) {
- $this->clearcache();
- return $this->stat($path);
- }
- return false;
- }
- /**
- * Create file copy with suffix "copy number" and return its info
- *
- * @param string $hash file hash
- * @param string $suffix suffix to add to file name
- * @return array|false
- * @author Dmitry (dio) Levashov
- **/
- public function duplicate($hash, $suffix='copy') {
- if ($this->commandDisabled('duplicate')) {
- return $this->setError(elFinder::ERROR_COPY, '#'.$hash, elFinder::ERROR_PERM_DENIED);
- }
- if (($file = $this->file($hash)) == false) {
- return $this->setError(elFinder::ERROR_COPY, elFinder::ERROR_FILE_NOT_FOUND);
- }
- $path = $this->decode($hash);
- $dir = $this->_dirname($path);
- $name = $this->uniqueName($dir, $this->_basename($path), ' '.$suffix.' ');
- if (!$this->allowCreate($dir, $name)) {
- return $this->setError(elFinder::ERROR_PERM_DENIED);
- }
- return ($path = $this->copy($path, $dir, $name)) == false
- ? false
- : $this->stat($path);
- }
- /**
- * Save uploaded file.
- * On success return array with new file stat and with removed file hash (if existed file was replaced)
- *
- * @param Resource $fp file pointer
- * @param string $dst destination folder hash
- * @param string $src file name
- * @param string $tmpname file tmp name - required to detect mime type
- * @return array|false
- * @author Dmitry (dio) Levashov
- **/
- public function upload($fp, $dst, $name, $tmpname) {
- if ($this->commandDisabled('upload')) {
- return $this->setError(elFinder::ERROR_PERM_DENIED);
- }
- if (($dir = $this->dir($dst)) == false) {
- return $this->setError(elFinder::ERROR_TRGDIR_NOT_FOUND, '#'.$dst);
- }
- if (!$dir['write']) {
- return $this->setError(elFinder::ERROR_PERM_DENIED);
- }
- if (!$this->nameAccepted($name)) {
- return $this->setError(elFinder::ERROR_INVALID_NAME);
- }
- $mime = $this->mimetype($this->mimeDetect == 'internal' ? $name : $tmpname, $name);
- if ($mime == 'unknown' && $this->mimeDetect == 'internal') {
- $mime = elFinderVolumeDriver::mimetypeInternalDetect($name);
- }
- // logic based on http://httpd.apache.org/docs/2.2/mod/mod_authz_host.html#order
- $allow = $this->mimeAccepted($mime, $this->uploadAllow, null);
- $deny = $this->mimeAccepted($mime, $this->uploadDeny, null);
- $upload = true; // default to allow
- if (strtolower($this->uploadOrder[0]) == 'allow') { // array('allow', 'deny'), default is to 'deny'
- $upload = false; // default is deny
- if (!$deny && ($allow === true)) { // match only allow
- $upload = true;
- }// else (both match | no match | match only deny) { deny }
- } else { // array('deny', 'allow'), default is to 'allow' - this is the default rule
- $upload = true; // default is allow
- if (($deny === true) && !$allow) { // match only deny
- $upload = false;
- } // else (both match | no match | match only allow) { allow }
- }
- if (!$upload) {
- return $this->setError(elFinder::ERROR_UPLOAD_FILE_MIME);
- }
- if ($this->uploadMaxSize > 0 && filesize($tmpname) > $this->uploadMaxSize) {
- return $this->setError(elFinder::ERROR_UPLOAD_FILE_SIZE);
- }
- $dstpath = $this->decode($dst);
- $test = $this->_joinPath($dstpath, $name);
- $file = $this->stat($test);
- $this->clearcache();
- if ($file) { // file exists
- if ($this->options['uploadOverwrite']) {
- if (!$file['write']) {
- return $this->setError(elFinder::ERROR_PERM_DENIED);
- } elseif ($file['mime'] == 'directory') {
- return $this->setError(elFinder::ERROR_NOT_REPLACE, $name);
- }
- $this->remove($test);
- } else {
- $name = $this->uniqueName($dstpath, $name, '-', false);
- }
- }
- $stat = array(
- 'mime' => $mime,
- 'width' => 0,
- 'height' => 0,
- 'size' => filesize($tmpname));
- // $w = $h = 0;
- if (strpos($mime, 'image') === 0 && ($s = getimagesize($tmpname))) {
- $stat['width'] = $s[0];
- $stat['height'] = $s[1];
- }
- // $this->clearcache();
- if (($path = $this->_save($fp, $dstpath, $name, $stat)) == false) {
- return false;
- }
- return $this->stat($path);
- }
- /**
- * Paste files
- *
- * @param Object $volume source volume
- * @param string $source file hash
- * @param string $dst destination dir hash
- * @param bool $rmSrc remove source after copy?
- * @return array|false
- * @author Dmitry (dio) Levashov
- **/
- public function paste($volume, $src, $dst, $rmSrc = false) {
- $err = $rmSrc ? elFinder::ERROR_MOVE : elFinder::ERROR_COPY;
- if ($this->commandDisabled('paste')) {
- return $this->setError($err, '#'.$src, elFinder::ERROR_PERM_DENIED);
- }
- if (($file = $volume->file($src, $rmSrc)) == false) {
- return $this->setError($err, '#'.$src, elFinder::ERROR_FILE_NOT_FOUND);
- }
- $name = $file['name'];
- $errpath = $volume->path($src);
- if (($dir = $this->dir($dst)) == false) {
- return $this->setError($err, $errpath, elFinder::ERROR_TRGDIR_NOT_FOUND, '#'.$dst);
- }
- if (!$dir['write'] || !$file['read']) {
- return $this->setError($err, $errpath, elFinder::ERROR_PERM_DENIED);
- }
- $destination = $this->decode($dst);
- if (($test = $volume->closest($src, $rmSrc ? 'locked' : 'read', $rmSrc))) {
- return $rmSrc
- ? $this->setError($err, $errpath, elFinder::ERROR_LOCKED, $volume->path($test))
- : $this->setError($err, $errpath, elFinder::ERROR_PERM_DENIED);
- }
- $test = $this->_joinPath($destination, $name);
- $stat = $this->stat($test);
- $this->clearcache();
- if ($stat) {
- if ($this->options['copyOverwrite']) {
- // do not replace file with dir or dir with file
- if (!$this->isSameType($file['mime'], $stat['mime'])) {
- return $this->setError(elFinder::ERROR_NOT_REPLACE, $this->_path($test));
- }
- // existed file is not writable
- if (!$stat['write']) {
- return $this->setError($err, $errpath, elFinder::ERROR_PERM_DENIED);
- }
- // existed file locked or has locked child
- if (($locked = $this->closestByAttr($test, 'locked', true))) {
- return $this->setError(elFinder::ERROR_LOCKED, $this->_path($locked));
- }
- // target is entity file of alias
- if ($volume == $this && ($test == @$file['target'] || $test == $this->decode($src))) {
- return $this->setError(elFinder::ERROR_REPLACE, $errpath);
- }
- // remove existed file
- if (!$this->remove($test)) {
- return $this->setError(elFinder::ERROR_REPLACE, $this->_path($test));
- }
- } else {
- $name = $this->uniqueName($destination, $name, ' ', false);
- }
- }
- // copy/move inside current volume
- if ($volume == $this) {
- $source = $this->decode($src);
- // do not copy into itself
- if ($this->_inpath($destination, $source)) {
- return $this->setError(elFinder::ERROR_COPY_INTO_ITSELF, $errpath);
- }
- $method = $rmSrc ? 'move' : 'copy';
- return ($path = $this->$method($source, $destination, $name)) ? $this->stat($path) : false;
- }
- // copy/move from another volume
- if (!$this->options['copyTo'] || !$volume->copyFromAllowed()) {
- return $this->setError(elFinder::ERROR_COPY, $errpath, elFinder::ERROR_PERM_DENIED);
- }
- if (($path = $this->copyFrom($volume, $src, $destination, $name)) == false) {
- return false;
- }
- if ($rmSrc) {
- if ($volume->rm($src)) {
- $this->removed[] = $file;
- } else {
- return $this->setError(elFinder::ERROR_MOVE, $errpath, elFinder::ERROR_RM_SRC);
- }
- }
- return $this->stat($path);
- }
- /**
- * Return file contents
- *
- * @param string $hash file hash
- * @return string|false
- * @author Dmitry (dio) Levashov
- **/
- public function getContents($hash) {
- $file = $this->file($hash);
- if (!$file) {
- return $this->setError(elFinder::ERROR_FILE_NOT_FOUND);
- }
- if ($file['mime'] == 'directory') {
- return $this->setError(elFinder::ERROR_NOT_FILE);
- }
- if (!$file['read']) {
- return $this->setError(elFinder::ERROR_PERM_DENIED);
- }
- return $this->_getContents($this->decode($hash));
- }
- /**
- * Put content in text file and return file info.
- *
- * @param string $hash file hash
- * @param string $content new file content
- * @return array
- * @author Dmitry (dio) Levashov
- **/
- public function putContents($hash, $content) {
- if ($this->commandDisabled('edit')) {
- return $this->setError(elFinder::ERROR_PERM_DENIED);
- }
- $path = $this->decode($hash);
- if (!($file = $this->file($hash))) {
- return $this->setError(elFinder::ERROR_FILE_NOT_FOUND);
- }
- if (!$file['write']) {
- return $this->setError(elFinder::ERROR_PERM_DENIED);
- }
- $this->clearcache();
- return $this->_filePutContents($path, $content) ? $this->stat($path) : false;
- }
- /**
- * Extract files from archive
- *
- * @param string $hash archive hash
- * @return array|bool
- * @author Dmitry (dio) Levashov,
- * @author Alexey Sukhotin
- **/
- public function extract($hash) {
- if ($this->commandDisabled('extract')) {
- return $this->setError(elFinder::ERROR_PERM_DENIED);
- }
- if (($file = $this->file($hash)) == false) {
- return $this->setError(elFinder::ERROR_FILE_NOT_FOUND);
- }
- $archiver = isset($this->archivers['extract'][$file['mime']])
- ? $this->archivers['extract'][$file['mime']]
- : false;
- if (!$archiver) {
- return $this->setError(elFinder::ERROR_NOT_ARCHIVE);
- }
- $path = $this->decode($hash);
- $parent = $this->stat($this->_dirname($path));
- if (!$file['read'] || !$parent['write']) {
- return $this->setError(elFinder::ERROR_PERM_DENIED);
- }
- $this->clearcache();
- return ($path = $this->_extract($path, $archiver)) ? $this->stat($path) : false;
- }
- /**
- * Add files to archive
- *
- * @return void
- **/
- public function archive($hashes, $mime) {
- if ($this->commandDisabled('archive')) {
- return $this->setError(elFinder::ERROR_PERM_DENIED);
- }
- $archiver = isset($this->archivers['create'][$mime])
- ? $this->archivers['create'][$mime]
- : false;
- if (!$archiver) {
- return $this->setError(elFinder::ERROR_ARCHIVE_TYPE);
- }
- $files = array();
- foreach ($hashes as $hash) {
- if (($file = $this->file($hash)) == false) {
- return $this->error(elFinder::ERROR_FILE_NOT_FOUND, '#'+$hash);
- }
- if (!$file['read']) {
- return $this->error(elFinder::ERROR_PERM_DENIED);
- }
- $path = $this->decode($hash);
- if (!isset($dir)) {
- $dir = $this->_dirname($path);
- $stat = $this->stat($dir);
- if (!$stat['write']) {
- return $this->error(elFinder::ERROR_PERM_DENIED);
- }
- }
- $files[] = $this->_basename($path);
- }
- $name = (count($files) == 1 ? $files[0] : 'Archive').'.'.$archiver['ext'];
- $name = $this->uniqueName($dir, $name, '');
- $this->clearcache();
- return ($path = $this->_archive($dir, $files, $name, $archiver)) ? $this->stat($path) : false;
- }
- /**
- * Resize image
- *
- * @param string $hash image file
- * @param int $width new width
- * @param int $height new height
- * @param int $x X start poistion for crop
- * @param int $y Y start poistion for crop
- * @param string $mode action how to mainpulate image
- * @return array|false
- * @author Dmitry (dio) Levashov
- * @author Alexey Sukhotin
- * @author nao-pon
- * @author Troex Nevelin
- **/
- public function resize($hash, $width, $height, $x, $y, $mode = 'resize', $bg = '', $degree = 0) {
- if ($this->commandDisabled('resize')) {
- return $this->setError(elFinder::ERROR_PERM_DENIED);
- }
- if (($file = $this->file($hash)) == false) {
- return $this->setError(elFinder::ERROR_FILE_NOT_FOUND);
- }
- if (!$file['write'] || !$file['read']) {
- return $this->setError(elFinder::ERROR_PERM_DENIED);
- }
- $path = $this->decode($hash);
- if (!$this->canResize($path, $file)) {
- return $this->setError(elFinder::ERROR_UNSUPPORT_TYPE);
- }
- switch($mode) {
- case 'propresize':
- $result = $this->imgResize($path, $width, $height, true, true);
- break;
- case 'crop':
- $result = $this->imgCrop($path, $width, $height, $x, $y);
- break;
- case 'fitsquare':
- $result = $this->imgSquareFit($path, $width, $height, 'center', 'middle', ($bg ? $bg : $this->options['tmbBgColor']));
- break;
- case 'rotate':
- $result = $this->imgRotate($path, $degree, ($bg ? $bg : $this->options['tmbBgColor']));
- break;
- default:
- $result = $this->imgResize($path, $width, $height, false, true);
- break;
- }
- if ($result) {
- $this->rmTmb($file);
- $this->clearcache();
- return $this->stat($path);
- }
- return false;
- }
- /**
- * Remove file/dir
- *
- * @param string $hash file hash
- * @return bool
- * @author Dmitry (dio) Levashov
- **/
- public function rm($hash) {
- return $this->commandDisabled('rm')
- ? array(elFinder::ERROR_ACCESS_DENIED)
- : $this->remove($this->decode($hash));
- }
- /**
- * Search files
- *
- * @param string $q search string
- * @param array $mimes
- * @return array
- * @author Dmitry (dio) Levashov
- **/
- public function search($q, $mimes) {
- return $this->doSearch($this->root, $q, $mimes);
- }
- /**
- * Return image dimensions
- *
- * @param string $hash file hash
- * @return array
- * @author Dmitry (dio) Levashov
- **/
- public function dimensions($hash) {
- if (($file = $this->file($hash)) == false) {
- return false;
- }
- return $this->_dimensions($this->decode($hash), $file['mime']);
- }
- /**
- * Return temp path
- *
- * @return string
- * @author Naoki Sawada
- */
- public function getTempPath() {
- if (@ $this->tmpPath) {
- return $this->tmpPath;
- } else if (@ $this->tmp) {
- return $this->tmp;
- } else if (@ $this->tmbPath) {
- return $this->tmbPath;
- } else {
- return null;
- }
- }
- /**
- * (Make &) Get upload taget dirctory hash
- *
- * @param string $baseTargetHash
- * @param string $path
- * @param array $result
- * @return boolean|string
- * @author Naoki Sawada
- */
- public function getUploadTaget($baseTargetHash, $path, & $result) {
- $base = $this->decode($baseTargetHash);
- $targetHash = $baseTargetHash;
- $path = ltrim($path, '/');
- $dirs = explode('/', $path);
- array_pop($dirs);
- foreach($dirs as $dir) {
- $targetPath = $this->_joinPath($base, $dir);
- if (! $_realpath = $this->realpath($this->encode($targetPath))) {
- if ($stat = $this->mkdir($targetHash, $dir)) {
- $result['added'][] = $stat;
- $targetHash = $stat['hash'];
- $base = $this->decode($targetHash);
- } else {
- return false;
- }
- } else {
- $targetHash = $this->encode($_realpath);
- if ($this->dir($targetHash)) {
- $base = $this->decode($targetHash);
- } else {
- return false;
- }
- }
- }
- return $targetHash;
- }
- /**
- * Save error message
- *
- * @param array error
- * @return false
- * @author Dmitry(dio) Levashov
- **/
- protected function setError($error) {
- $this->error = array();
- foreach (func_get_args() as $err) {
- if (is_array($err)) {
- $this->error = array_merge($this->error, $err);
- } else {
- $this->error[] = $err;
- }
- }
- // $this->error = is_array($error) ? $error : func_get_args();
- return false;
- }
- /*********************************************************************/
- /* FS API */
- /*********************************************************************/
- /***************** paths *******************/
- /**
- * Encode path into hash
- *
- * @param string file path
- * @return string
- * @author Dmitry (dio) Levashov
- * @author Troex Nevelin
- **/
- protected function encode($path) {
- if ($path !== '') {
- // cut ROOT from $path for security reason, even if hacker decodes the path he will not know the root
- $p = $this->_relpath($path);
- // if reqesting root dir $path will be empty, then assign '/' as we cannot leave it blank for crypt
- if ($p === '') {
- $p = DIRECTORY_SEPARATOR;
- }
- // TODO crypt path and return hash
- $hash = $this->crypt($p);
- // hash is used as id in HTML that means it must contain vaild chars
- // make base64 html safe and append prefix in begining
- $hash = strtr(base64_encode($hash), '+/=', '-_.');
- // remove dots '.' at the end, before it was '=' in base64
- $hash = rtrim($hash, '.');
- // append volume id to make hash unique
- return $this->id.$hash;
- }
- }
- /**
- * Decode path from hash
- *
- * @param string file hash
- * @return string
- * @author Dmitry (dio) Levashov
- * @author Troex Nevelin
- **/
- protected function decode($hash) {
- if (strpos($hash, $this->id) === 0) {
- // cut volume id after it was prepended in encode
- $h = substr($hash, strlen($this->id));
- // replace HTML safe base64 to normal
- $h = base64_decode(strtr($h, '-_.', '+/='));
- // TODO uncrypt hash and return path
- $path = $this->uncrypt($h);
- // append ROOT to path after it was cut in encode
- return $this->_abspath($path);//$this->root.($path == DIRECTORY_SEPARATOR ? '' : DIRECTORY_SEPARATOR.$path);
- }
- }
- /**
- * Return crypted path
- * Not implemented
- *
- * @param string path
- * @return mixed
- * @author Dmitry (dio) Levashov
- **/
- protected function crypt($path) {
- return $path;
- }
- /**
- * Return uncrypted path
- * Not implemented
- *
- * @param mixed hash
- * @return mixed
- * @author Dmitry (dio) Levashov
- **/
- protected function uncrypt($hash) {
- return $hash;
- }
- /**
- * Validate file name based on $this->options['acceptedName'] regexp
- *
- * @param string $name file name
- * @return bool
- * @author Dmitry (dio) Levashov
- **/
- protected function nameAccepted($name) {
- if ($this->nameValidator) {
- if (function_exists($this->nameValidator)) {
- $f = $this->nameValidator;
- return $f($name);
- }
- return preg_match($this->nameValidator, $name);
- }
- return true;
- }
- /**
- * Return new unique name based on file name and suffix
- *
- * @param string $path file path
- * @param string $suffix suffix append to name
- * @return string
- * @author Dmitry (dio) Levashov
- **/
- public function uniqueName($dir, $name, $suffix = ' copy', $checkNum=true) {
- $ext = '';
- if (preg_match('/\.((tar\.(gz|bz|bz2|z|lzo))|cpio\.gz|ps\.gz|xcf\.(gz|bz2)|[a-z0-9]{1,4})$/i', $name, $m)) {
- $ext = '.'.$m[1];
- $name = substr($name, 0, strlen($name)-strlen($m[0]));
- }
- if ($checkNum && preg_match('/('.$suffix.')(\d*)$/i', $name, $m)) {
- $i = (int)$m[2];
- $name = substr($name, 0, strlen($name)-strlen($m[2]));
- } else {
- $i = 1;
- $name .= $suffix;
- }
- $max = $i+100000;
- while ($i <= $max) {
- $n = $name.($i > 0 ? $i : '').$ext;
- if (!$this->stat($this->_joinPath($dir, $n))) {
- $this->clearcache();
- return $n;
- }
- $i++;
- }
- return $name.md5($dir).$ext;
- }
- /*********************** file stat *********************/
- /**
- * Check file attribute
- *
- * @param string $path file path
- * @param string $name attribute name (read|write|locked|hidden)
- * @param bool $val attribute value returned by file system
- * @return bool
- * @author Dmitry (dio) Levashov
- **/
- protected function attr($path, $name, $val=null) {
- if (!isset($this->defaults[$name])) {
- return false;
- }
- $perm = null;
- if ($this->access) {
- $perm = call_user_func($this->access, $name, $path, $this->options['accessControlData'], $this);
- if ($perm !== null) {
- return !!$perm;
- }
- }
- if ($this->separator != '/') {
- $path = str_replace($this->separator, '/', $this->_relpath($path));
- } else {
- $path = $this->_relpath($path);
- }
- $path = '/'.$path;
- for ($i = 0, $c = count($this->attributes); $i < $c; $i++) {
- $attrs = $this->attributes[$i];
- if (isset($attrs[$name]) && isset($attrs['pattern']) && preg_match($attrs['pattern'], $path)) {
- $perm = $attrs[$name];
- }
- }
- return $perm === null ? (is_null($val)? $this->defaults[$name] : $val) : !!$perm;
- }
- /**
- * Return true if file with given name can be created in given folder.
- *
- * @param string $dir parent dir path
- * @param string $name new file name
- * @return bool
- * @author Dmitry (dio) Levashov
- **/
- protected function allowCreate($dir, $name) {
- $path = $this->_joinPath($dir, $name);
- $perm = null;
- if ($this->access) {
- $perm = call_user_func($this->access, 'write', $path, $this->options['accessControlData'], $this);
- if ($perm !== null) {
- return !!$perm;
- }
- }
- $testPath = $this->separator.$this->_relpath($path);
- for ($i = 0, $c = count($this->attributes); $i < $c; $i++) {
- $attrs = $this->attributes[$i];
- if (isset($attrs['write']) && isset($attrs['pattern']) && preg_match($attrs['pattern'], $testPath)) {
- $perm = $attrs['write'];
- }
- }
- return $perm === null ? true : $perm;
- }
- /**
- * Return fileinfo
- *
- * @param string $path file cache
- * @return array
- * @author Dmitry (dio) Levashov
- **/
- protected function stat($path) {
- if ($path === false) {
- return false;
- }
- return isset($this->cache[$path])
- ? $this->cache[$path]
- : $this->updateCache($path, $this->_stat($path));
- }
- /**
- * Put file stat in cache and return it
- *
- * @param string $path file path
- * @param array $stat file stat
- * @return array
- * @author Dmitry (dio) Levashov
- **/
- protected function updateCache($path, $stat) {
- if (empty($stat) || !is_array($stat)) {
- return $this->cache[$path] = array();
- }
- $stat['hash'] = $this->encode($path);
- $root = $path == $this->root;
- if ($root) {
- $stat['volumeid'] = $this->id;
- if ($this->rootName) {
- $stat['name'] = $this->rootName;
- }
- } else {
- if (!isset($stat['name']) || !strlen($stat['name'])) {
- $stat['name'] = $this->_basename($path);
- }
- if (empty($stat['phash'])) {
- $stat['phash'] = $this->encode($this->_dirname($path));
- }
- }
- // fix name if required
- if ($this->options['utf8fix'] && $this->options['utf8patterns'] && $this->options['utf8replace']) {
- $stat['name'] = json_decode(str_replace($this->options['utf8patterns'], $this->options['utf8replace'], json_encode($stat['name'])));
- }
- if (empty($stat['mime'])) {
- $stat['mime'] = $this->mimetype($stat['name']);
- }
- // @todo move dateformat to client
- // $stat['date'] = isset($stat['ts'])
- // ? $this->formatDate($stat['ts'])
- // : 'unknown';
- if (!isset($stat['size'])) {
- $stat['size'] = 'unknown';
- }
- $stat['read'] = intval($this->attr($path, 'read', isset($stat['read']) ? !!$stat['read'] : null));
- $stat['write'] = intval($this->attr($path, 'write', isset($stat['write']) ? !!$stat['write'] : null));
- if ($root) {
- $stat['locked'] = 1;
- } elseif ($this->attr($path, 'locked', !empty($stat['locked']))) {
- $stat['locked'] = 1;
- } else {
- unset($stat['locked']);
- }
- if ($root) {
- unset($stat['hidden']);
- } elseif ($this->attr($path, 'hidden', !empty($stat['hidden']))
- || !$this->mimeAccepted($stat['mime'])) {
- $stat['hidden'] = $root ? 0 : 1;
- } else {
- unset($stat['hidden']);
- }
- if ($stat['read'] && empty($stat['hidden'])) {
- if ($stat['mime'] == 'directory') {
- // for dir - check for subdirs
- if ($this->options['checkSubfolders']) {
- if (isset($stat['dirs'])) {
- if ($stat['dirs']) {
- $stat['dirs'] = 1;
- } else {
- unset($stat['dirs']);
- }
- } elseif (!empty($stat['alias']) && !empty($stat['target'])) {
- $stat['dirs'] = isset($this->cache[$stat['target']])
- ? intval(isset($this->cache[$stat['target']]['dirs']))
- : $this->_subdirs($stat['target']);
- } elseif ($this->_subdirs($path)) {
- $stat['dirs'] = 1;
- }
- } else {
- $stat['dirs'] = 1;
- }
- } else {
- // for files - check for thumbnails
- $p = isset($stat['target']) ? $stat['target'] : $path;
- if ($this->tmbURL && !isset($stat['tmb']) && $this->canCreateTmb($p, $stat)) {
- $tmb = $this->gettmb($p, $stat);
- $stat['tmb'] = $tmb ? $tmb : 1;
- }
- }
- }
- if (!empty($stat['alias']) && !empty($stat['target'])) {
- $stat['thash'] = $this->encode($stat['target']);
- unset($stat['target']);
- }
- return $this->cache[$path] = $stat;
- }
- /**
- * Get stat for folder content and put in cache
- *
- * @param string $path
- * @return void
- * @author Dmitry (dio) Levashov
- **/
- protected function cacheDir($path) {
- $this->dirsCache[$path] = array();
- foreach ($this->_scandir($path) as $p) {
- if (($stat = $this->stat($p)) && empty($stat['hidden'])) {
- $this->dirsCache[$path][] = $p;
- }
- }
- }
- /**
- * Clean cache
- *
- * @return void
- * @author Dmitry (dio) Levashov
- **/
- protected function clearcache() {
- $this->cache = $this->dirsCache = array();
- }
- /**
- * Return file mimetype
- *
- * @param string $path file path
- * @return string
- * @author Dmitry (dio) Levashov
- **/
- protected function mimetype($path, $name = '') {
- $type = '';
- if ($this->mimeDetect == 'finfo') {
- if ($type = @finfo_file($this->finfo, $path)) {
- if ($name === '') {
- $name = $path;
- }
- $ext = (false === $pos = strrpos($name, '.')) ? '' : substr($name, $pos + 1);
- if ($ext && preg_match('~^application/(?:octet-stream|(?:x-)?zip)~', $type)) {
- if (isset(elFinderVolumeDriver::$mimetypes[$ext])) $type = elFinderVolumeDriver::$mimetypes[$ext];
- }
- }
- } elseif ($type == 'mime_content_type') {
- $type = mime_content_type($path);
- } else {
- $type = elFinderVolumeDriver::mimetypeInternalDetect($path);
- }
- $type = explode(';', $type);
- $type = trim($type[0]);
- if (in_array($type, array('application/x-empty', 'inode/x-empty'))) {
- // finfo return this mime for empty files
- $type = 'text/plain';
- } elseif ($type == 'application/x-zip') {
- // http://elrte.org/redmine/issues/163
- $type = 'application/zip';
- }
- return $type == 'unknown' && $this->mimeDetect != 'internal'
- ? elFinderVolumeDriver::mimetypeInternalDetect($path)
- : $type;
- }
- /**
- * Detect file mimetype using "internal" method
- *
- * @param string $path file path
- * @return string
- * @author Dmitry (dio) Levashov
- **/
- static protected function mimetypeInternalDetect($path) {
- $pinfo = pathinfo($path);
- $ext = isset($pinfo['extension']) ? strtolower($pinfo['extension']) : '';
- return isset(elFinderVolumeDriver::$mimetypes[$ext]) ? elFinderVolumeDriver::$mimetypes[$ext] : 'unknown';
- }
- /**
- * Return file/total directory size
- *
- * @param string $path file path
- * @return int
- * @author Dmitry (dio) Levashov
- **/
- protected function countSize($path) {
- $stat = $this->stat($path);
- if (empty($stat) || !$stat['read'] || !empty($stat['hidden'])) {
- return 'unknown';
- }
- if ($stat['mime'] != 'directory') {
- return $stat['size'];
- }
- $subdirs = $this->options['checkSubfolders'];
- $this->options['checkSubfolders'] = true;
- $result = 0;
- foreach ($this->getScandir($path) as $stat) {
- $size = $stat['mime'] == 'directory' && $stat['read']
- ? $this->countSize($this->_joinPath($path, $stat['name']))
- : (isset($stat['size']) ? intval($stat['size']) : 0);
- if ($size > 0) {
- $result += $size;
- }
- }
- $this->options['checkSubfolders'] = $subdirs;
- return $result;
- }
- /**
- * Return true if all mimes is directory or files
- *
- * @param string $mime1 mimetype
- * @param string $mime2 mimetype
- * @return bool
- * @author Dmitry (dio) Levashov
- **/
- protected function isSameType($mime1, $mime2) {
- return ($mime1 == 'directory' && $mime1 == $mime2) || ($mime1 != 'directory' && $mime2 != 'directory');
- }
- /**
- * If file has required attr == $val - return file path,
- * If dir has child with has required attr == $val - return child path
- *
- * @param string $path file path
- * @param string $attr attribute name
- * @param bool $val attribute value
- * @return string|false
- * @author Dmitry (dio) Levashov
- **/
- protected function closestByAttr($path, $attr, $val) {
- $stat = $this->stat($path);
- if (empty($stat)) {
- return false;
- }
- $v = isset($stat[$attr]) ? $stat[$attr] : false;
- if ($v == $val) {
- return $path;
- }
- return $stat['mime'] == 'directory'
- ? $this->childsByAttr($path, $attr, $val)
- : false;
- }
- /**
- * Return first found children with required attr == $val
- *
- * @param string $path file path
- * @param string $attr attribute name
- * @param bool $val attribute value
- * @return string|false
- * @author Dmitry (dio) Levashov
- **/
- protected function childsByAttr($path, $attr, $val) {
- foreach ($this->_scandir($path) as $p) {
- if (($_p = $this->closestByAttr($p, $attr, $val)) != false) {
- return $_p;
- }
- }
- return false;
- }
- /***************** get content *******************/
- /**
- * Return required dir's files info.
- * If onlyMimes is set - return only dirs and files of required mimes
- *
- * @param string $path dir path
- * @return array
- * @author Dmitry (dio) Levashov
- **/
- protected function getScandir($path) {
- $files = array();
- !isset($this->dirsCache[$path]) && $this->cacheDir($path);
- foreach ($this->dirsCache[$path] as $p) {
- if (($stat = $this->stat($p)) && empty($stat['hidden'])) {
- $files[] = $stat;
- }
- }
- return $files;
- }
- /**
- * Return subdirs tree
- *
- * @param string $path parent dir path
- * @param int $deep tree deep
- * @return array
- * @author Dmitry (dio) Levashov
- **/
- protected function gettree($path, $deep, $exclude='') {
- $dirs = array();
- !isset($this->dirsCache[$path]) && $this->cacheDir($path);
- foreach ($this->dirsCache[$path] as $p) {
- $stat = $this->stat($p);
- if ($stat && empty($stat['hidden']) && $p != $exclude && $stat['mime'] == 'directory') {
- $dirs[] = $stat;
- if ($deep > 0 && !empty($stat['dirs'])) {
- $dirs = array_merge($dirs, $this->gettree($p, $deep-1));
- }
- }
- }
- return $dirs;
- }
- /**
- * Recursive files search
- *
- * @param string $path dir path
- * @param string $q search string
- * @param array $mimes
- * @return array
- * @author Dmitry (dio) Levashov
- **/
- protected function doSearch($path, $q, $mimes) {
- $result = array();
- foreach($this->_scandir($path) as $p) {
- $stat = $this->stat($p);
- if (!$stat) { // invalid links
- continue;
- }
- if (!empty($stat['hidden']) || !$this->mimeAccepted($stat['mime'])) {
- continue;
- }
- $name = $stat['name'];
- if ($this->stripos($name, $q) !== false) {
- $stat['path'] = $this->_path($p);
- if ($this->URL && !isset($stat['url'])) {
- $stat['url'] = $this->URL . str_replace($this->separator, '/', substr($p, strlen($this->root) + 1));
- }
- $result[] = $stat;
- }
- if ($stat['mime'] == 'directory' && $stat['read'] && !isset($stat['alias'])) {
- $result = array_merge($result, $this->doSearch($p, $q, $mimes));
- }
- }
- return $result;
- }
- /********************** manuipulations ******************/
- /**
- * Copy file/recursive copy dir only in current volume.
- * Return new file path or false.
- *
- * @param string $src source path
- * @param string $dst destination dir path
- * @param string $name new file name (optionaly)
- * @return string|false
- * @author Dmitry (dio) Levashov
- **/
- protected function copy($src, $dst, $name) {
- $srcStat = $this->stat($src);
- $this->clearcache();
- if (!empty($srcStat['thash'])) {
- $target = $this->decode($srcStat['thash']);
- $stat = $this->stat($target);
- $this->clearcache();
- return $stat && $this->_symlink($target, $dst, $name)
- ? $this->_joinPath($dst, $name)
- : $this->setError(elFinder::ERROR_COPY, $this->_path($src));
- }
- if ($srcStat['mime'] == 'directory') {
- $test = $this->stat($this->_joinPath($dst, $name));
- if (($test && $test['mime'] != 'directory') || !$this->_mkdir($dst, $name)) {
- return $this->setError(elFinder::ERROR_COPY, $this->_path($src));
- }
- $dst = $this->_joinPath($dst, $name);
- foreach ($this->getScandir($src) as $stat) {
- if (empty($stat['hidden'])) {
- $name = $stat['name'];
- if (!$this->copy($this->_joinPath($src, $name), $dst, $name)) {
- $this->remove($dst, true); // fall back
- return false;
- }
- }
- }
- $this->clearcache();
- return $dst;
- }
- return $this->_copy($src, $dst, $name)
- ? $this->_joinPath($dst, $name)
- : $this->setError(elFinder::ERROR_COPY, $this->_path($src));
- }
- /**
- * Move file
- * Return new file path or false.
- *
- * @param string $src source path
- * @param string $dst destination dir path
- * @param string $name new file name
- * @return string|false
- * @author Dmitry (dio) Levashov
- **/
- protected function move($src, $dst, $name) {
- $stat = $this->stat($src);
- $stat['realpath'] = $src;
- $this->rmTmb($stat); // can not do rmTmb() after _move()
- $this->clearcache();
- if ($this->_move($src, $dst, $name)) {
- $this->removed[] = $stat;
- return $this->_joinPath($dst, $name);
- }
- return $this->setError(elFinder::ERROR_MOVE, $this->_path($src));
- }
- /**
- * Copy file from another volume.
- * Return new file path or false.
- *
- * @param Object $volume source volume
- * @param string $src source file hash
- * @param string $destination destination dir path
- * @param string $name file name
- * @return string|false
- * @author Dmitry (dio) Levashov
- **/
- protected function copyFrom($volume, $src, $destination, $name) {
- if (($source = $volume->file($src)) == false) {
- return $this->setError(elFinder::ERROR_COPY, '#'.$src, $volume->error());
- }
- $errpath = $volume->path($src);
- if (!$this->nameAccepted($source['name'])) {
- return $this->setError(elFinder::ERROR_COPY, $errpath, elFinder::ERROR_INVALID_NAME);
- }
- if (!$source['read']) {
- return $this->setError(elFinder::ERROR_COPY, $errpath, elFinder::ERROR_PERM_DENIED);
- }
- if ($source['mime'] == 'directory') {
- $stat = $this->stat($this->_joinPath($destination, $name));
- $this->clearcache();
- if ((!$stat || $stat['mime'] != 'directory') && !$this->_mkdir($destination, $name)) {
- return $this->setError(elFinder::ERROR_COPY, $errpath);
- }
- $path = $this->_joinPath($destination, $name);
- foreach ($volume->scandir($src) as $entr) {
- if (!$this->copyFrom($volume, $entr['hash'], $path, $entr['name'])) {
- return false;
- }
- }
- } else {
- // $mime = $source['mime'];
- // $w = $h = 0;
- if (($dim = $volume->dimensions($src))) {
- $s = explode('x', $dim);
- $source['width'] = $s[0];
- $source['height'] = $s[1];
- }
- if (($fp = $volume->open($src)) == false
- || ($path = $this->_save($fp, $destination, $name, $source)) == false) {
- $fp && $volume->close($fp, $src);
- return $this->setError(elFinder::ERROR_COPY, $errpath);
- }
- $volume->close($fp, $src);
- }
- return $path;
- }
- /**
- * Remove file/ recursive remove dir
- *
- * @param string $path file path
- * @param bool $force try to remove even if file locked
- * @return bool
- * @author Dmitry (dio) Levashov
- **/
- protected function remove($path, $force = false) {
- $stat = $this->stat($path);
- if (empty($stat)) {
- return $this->setError(elFinder::ERROR_RM, $this->_path($path), elFinder::ERROR_FILE_NOT_FOUND);
- }
- $stat['realpath'] = $path;
- $this->rmTmb($stat);
- $this->clearcache();
- if (!$force && !empty($stat['locked'])) {
- return $this->setError(elFinder::ERROR_LOCKED, $this->_path($path));
- }
- if ($stat['mime'] == 'directory') {
- foreach ($this->_scandir($path) as $p) {
- $name = $this->_basename($p);
- if ($name != '.' && $name != '..' && !$this->remove($p)) {
- return false;
- }
- }
- if (!$this->_rmdir($path)) {
- return $this->setError(elFinder::ERROR_RM, $this->_path($path));
- }
- } else {
- if (!$this->_unlink($path)) {
- return $this->setError(elFinder::ERROR_RM, $this->_path($path));
- }
- }
- $this->removed[] = $stat;
- return true;
- }
- /************************* thumbnails **************************/
- /**
- * Return thumbnail file name for required file
- *
- * @param array $stat file stat
- * @return string
- * @author Dmitry (dio) Levashov
- **/
- protected function tmbname($stat) {
- return $stat['hash'].$stat['ts'].'.png';
- }
- /**
- * Return thumnbnail name if exists
- *
- * @param string $path file path
- * @param array $stat file stat
- * @return string|false
- * @author Dmitry (dio) Levashov
- **/
- protected function gettmb($path, $stat) {
- if ($this->tmbURL && $this->tmbPath) {
- // file itself thumnbnail
- if (strpos($path, $this->tmbPath) === 0) {
- return basename($path);
- }
- $name = $this->tmbname($stat);
- if (file_exists($this->tmbPath.DIRECTORY_SEPARATOR.$name)) {
- return $name;
- }
- }
- return false;
- }
- /**
- * Return true if thumnbnail for required file can be created
- *
- * @param string $path thumnbnail path
- * @param array $stat file stat
- * @return string|bool
- * @author Dmitry (dio) Levashov
- **/
- protected function canCreateTmb($path, $stat) {
- return $this->tmbPathWritable
- && strpos($path, $this->tmbPath) === false // do not create thumnbnail for thumnbnail
- && $this->imgLib
- && strpos($stat['mime'], 'image') === 0
- && ($this->imgLib == 'gd' ? $stat['mime'] == 'image/jpeg' || $stat['mime'] == 'image/png' || $stat['mime'] == 'image/gif' : true);
- }
- /**
- * Return true if required file can be resized.
- * By default - the same as canCreateTmb
- *
- * @param string $path thumnbnail path
- * @param array $stat file stat
- * @return string|bool
- * @author Dmitry (dio) Levashov
- **/
- protected function canResize($path, $stat) {
- return $this->canCreateTmb($path, $stat);
- }
- /**
- * Create thumnbnail and return it's URL on success
- *
- * @param string $path file path
- * @param string $mime file mime type
- * @return string|false
- * @author Dmitry (dio) Levashov
- **/
- protected function createTmb($path, $stat) {
- if (!$stat || !$this->canCreateTmb($path, $stat)) {
- return false;
- }
- $name = $this->tmbname($stat);
- $tmb = $this->tmbPath.DIRECTORY_SEPARATOR.$name;
- // copy image into tmbPath so some drivers does not store files on local fs
- if (($src = $this->_fopen($path, 'rb')) == false) {
- return false;
- }
- if (($trg = fopen($tmb, 'wb')) == false) {
- $this->_fclose($src, $path);
- return false;
- }
- while (!feof($src)) {
- fwrite($trg, fread($src, 8192));
- }
- $this->_fclose($src, $path);
- fclose($trg);
- $result = false;
- $tmbSize = $this->tmbSize;
- if (($s = getimagesize($tmb)) == false) {
- return false;
- }
- /* If image smaller or equal thumbnail size - just fitting to thumbnail square */
- if ($s[0] <= $tmbSize && $s[1] <= $tmbSize) {
- $result = $this->imgSquareFit($tmb, $tmbSize, $tmbSize, 'center', 'middle', $this->options['tmbBgColor'], 'png' );
- } else {
- if ($this->options['tmbCrop']) {
- /* Resize and crop if image bigger than thumbnail */
- if (!(($s[0] > $tmbSize && $s[1] <= $tmbSize) || ($s[0] <= $tmbSize && $s[1] > $tmbSize) ) || ($s[0] > $tmbSize && $s[1] > $tmbSize)) {
- $result = $this->imgResize($tmb, $tmbSize, $tmbSize, true, false, 'png');
- }
- if (($s = getimagesize($tmb)) != false) {
- $x = $s[0] > $tmbSize ? intval(($s[0] - $tmbSize)/2) : 0;
- $y = $s[1] > $tmbSize ? intval(($s[1] - $tmbSize)/2) : 0;
- $result = $this->imgCrop($tmb, $tmbSize, $tmbSize, $x, $y, 'png');
- }
- } else {
- $result = $this->imgResize($tmb, $tmbSize, $tmbSize, true, true, 'png');
- }
- $result = $this->imgSquareFit($tmb, $tmbSize, $tmbSize, 'center', 'middle', $this->options['tmbBgColor'], 'png' );
- }
- if (!$result) {
- unlink($tmb);
- return false;
- }
- return $name;
- }
- /**
- * Resize image
- *
- * @param string $path image file
- * @param int $width new width
- * @param int $height new height
- * @param bool $keepProportions crop image
- * @param bool $resizeByBiggerSide resize image based on bigger side if true
- * @param string $destformat image destination format
- * @return string|false
- * @author Dmitry (dio) Levashov
- * @author Alexey Sukhotin
- **/
- protected function imgResize($path, $width, $height, $keepProportions = false, $resizeByBiggerSide = true, $destformat = null) {
- if (($s = @getimagesize($path)) == false) {
- return false;
- }
- $result = false;
- list($size_w, $size_h) = array($width, $height);
- if ($keepProportions == true) {
- list($orig_w, $orig_h, $new_w, $new_h) = array($s[0], $s[1], $width, $height);
- /* Calculating image scale width and height */
- $xscale = $orig_w / $new_w;
- $yscale = $orig_h / $new_h;
- /* Resizing by biggest side */
- if ($resizeByBiggerSide) {
- if ($orig_w > $orig_h) {
- $size_h = $orig_h * $width / $orig_w;
- $size_w = $width;
- } else {
- $size_w = $orig_w * $height / $orig_h;
- $size_h = $height;
- }
- } else {
- if ($orig_w > $orig_h) {
- $size_w = $orig_w * $height / $orig_h;
- $size_h = $height;
- } else {
- $size_h = $orig_h * $width / $orig_w;
- $size_w = $width;
- }
- }
- }
- switch ($this->imgLib) {
- case 'imagick':
- try {
- $img = new imagick($path);
- } catch (Exception $e) {
- return false;
- }
- $img->resizeImage($size_w, $size_h, Imagick::FILTER_LANCZOS, true);
- $result = $img->writeImage($path);
- return $result ? $path : false;
- break;
- case 'gd':
- $img = self::gdImageCreate($path,$s['mime']);
- if ($img && false != ($tmp = imagecreatetruecolor($size_w, $size_h))) {
- self::gdImageBackground($tmp,$this->options['tmbBgColor']);
- if (!imagecopyresampled($tmp, $img, 0, 0, 0, 0, $size_w, $size_h, $s[0], $s[1])) {
- return false;
- }
- $result = self::gdImage($tmp, $path, $destformat, $s['mime']);
- imagedestroy($img);
- imagedestroy($tmp);
- return $result ? $path : false;
- }
- break;
- }
- return false;
- }
- /**
- * Crop image
- *
- * @param string $path image file
- * @param int $width crop width
- * @param int $height crop height
- * @param bool $x crop left offset
- * @param bool $y crop top offset
- * @param string $destformat image destination format
- * @return string|false
- * @author Dmitry (dio) Levashov
- * @author Alexey Sukhotin
- **/
- protected function imgCrop($path, $width, $height, $x, $y, $destformat = null) {
- if (($s = @getimagesize($path)) == false) {
- return false;
- }
- $result = false;
- switch ($this->imgLib) {
- case 'imagick':
- try {
- $img = new imagick($path);
- } catch (Exception $e) {
- return false;
- }
- $img->cropImage($width, $height, $x, $y);
- $result = $img->writeImage($path);
- return $result ? $path : false;
- break;
- case 'gd':
- $img = self::gdImageCreate($path,$s['mime']);
- if ($img && false != ($tmp = imagecreatetruecolor($width, $height))) {
- self::gdImageBackground($tmp,$this->options['tmbBgColor']);
- $size_w = $width;
- $size_h = $height;
- if ($s[0] < $width || $s[1] < $height) {
- $size_w = $s[0];
- $size_h = $s[1];
- }
- if (!imagecopy($tmp, $img, 0, 0, $x, $y, $size_w, $size_h)) {
- return false;
- }
- $result = self::gdImage($tmp, $path, $destformat, $s['mime']);
- imagedestroy($img);
- imagedestroy($tmp);
- return $result ? $path : false;
- }
- break;
- }
- return false;
- }
- /**
- * Put image to square
- *
- * @param string $path image file
- * @param int $width square width
- * @param int $height square height
- * @param int $align reserved
- * @param int $valign reserved
- * @param string $bgcolor square background color in #rrggbb format
- * @param string $destformat image destination format
- * @return string|false
- * @author Dmitry (dio) Levashov
- * @author Alexey Sukhotin
- **/
- protected function imgSquareFit($path, $width, $height, $align = 'center', $valign = 'middle', $bgcolor = '#0000ff', $destformat = null) {
- if (($s = @getimagesize($path)) == false) {
- return false;
- }
- $result = false;
- /* Coordinates for image over square aligning */
- $y = ceil(abs($height - $s[1]) / 2);
- $x = ceil(abs($width - $s[0]) / 2);
- switch ($this->imgLib) {
- case 'imagick':
- try {
- $img = new imagick($path);
- } catch (Exception $e) {
- return false;
- }
- $img1 = new Imagick();
- $img1->newImage($width, $height, new ImagickPixel($bgcolor));
- $img1->setImageColorspace($img->getImageColorspace());
- $img1->setImageFormat($destformat != null ? $destformat : $img->getFormat());
- $img1->compositeImage( $img, imagick::COMPOSITE_OVER, $x, $y );
- $result = $img1->writeImage($path);
- return $result ? $path : false;
- break;
- case 'gd':
- $img = self::gdImageCreate($path,$s['mime']);
- if ($img && false != ($tmp = imagecreatetruecolor($width, $height))) {
- self::gdImageBackground($tmp,$bgcolor);
- if (!imagecopy($tmp, $img, $x, $y, 0, 0, $s[0], $s[1])) {
- return false;
- }
- $result = self::gdImage($tmp, $path, $destformat, $s['mime']);
- imagedestroy($img);
- imagedestroy($tmp);
- return $result ? $path : false;
- }
- break;
- }
- return false;
- }
- /**
- * Rotate image
- *
- * @param string $path image file
- * @param int $degree rotete degrees
- * @param string $bgcolor square background color in #rrggbb format
- * @param string $destformat image destination format
- * @return string|false
- * @author nao-pon
- * @author Troex Nevelin
- **/
- protected function imgRotate($path, $degree, $bgcolor = '#ffffff', $destformat = null) {
- if (($s = @getimagesize($path)) == false) {
- return false;
- }
- $result = false;
- switch ($this->imgLib) {
- case 'imagick':
- try {
- $img = new imagick($path);
- } catch (Exception $e) {
- return false;
- }
- $img->rotateImage(new ImagickPixel($bgcolor), $degree);
- $result = $img->writeImage($path);
- return $result ? $path : false;
- break;
- case 'gd':
- $img = self::gdImageCreate($path,$s['mime']);
- $degree = 360 - $degree;
- list($r, $g, $b) = sscanf($bgcolor, "#%02x%02x%02x");
- $bgcolor = imagecolorallocate($img, $r, $g, $b);
- $tmp = imageRotate($img, $degree, (int)$bgcolor);
- $result = self::gdImage($tmp, $path, $destformat, $s['mime']);
- imageDestroy($img);
- imageDestroy($tmp);
- return $result ? $path : false;
- break;
- }
- return false;
- }
- /**
- * Execute shell command
- *
- * @param string $command command line
- * @param array $output stdout strings
- * @param array $return_var process exit code
- * @param array $error_output stderr strings
- * @return int exit code
- * @author Alexey Sukhotin
- **/
- protected function procExec($command , array &$output = null, &$return_var = -1, array &$error_output = null) {
- $descriptorspec = array(
- 0 => array("pipe", "r"), // stdin
- 1 => array("pipe", "w"), // stdout
- 2 => array("pipe", "w") // stderr
- );
- $process = proc_open($command, $descriptorspec, $pipes, null, null);
- if (is_resource($process)) {
- fclose($pipes[0]);
- $tmpout = '';
- $tmperr = '';
- $output = stream_get_contents($pipes[1]);
- $error_output = stream_get_contents($pipes[2]);
- fclose($pipes[1]);
- fclose($pipes[2]);
- $return_var = proc_close($process);
- }
- return $return_var;
- }
- /**
- * Remove thumbnail, also remove recursively if stat is directory
- *
- * @param string $stat file stat
- * @return void
- * @author Dmitry (dio) Levashov
- * @author Naoki Sawada
- * @author Troex Nevelin
- **/
- protected function rmTmb($stat) {
- if ($stat['mime'] === 'directory') {
- foreach ($this->_scandir($this->decode($stat['hash'])) as $p) {
- $name = $this->_basename($p);
- $name != '.' && $name != '..' && $this->rmTmb($this->stat($p));
- }
- } else if (!empty($stat['tmb']) && $stat['tmb'] != "1") {
- $tmb = $this->tmbPath.DIRECTORY_SEPARATOR.$stat['tmb'];
- file_exists($tmb) && @unlink($tmb);
- clearstatcache();
- }
- }
- /**
- * Create an gd image according to the specified mime type
- *
- * @param string $path image file
- * @param string $mime
- * @return gd image resource identifier
- */
- protected function gdImageCreate($path,$mime){
- switch($mime){
- case 'image/jpeg':
- return imagecreatefromjpeg($path);
- case 'image/png':
- return imagecreatefrompng($path);
- case 'image/gif':
- return imagecreatefromgif($path);
- case 'image/xbm':
- return imagecreatefromxbm($path);
- }
- return false;
- }
- /**
- * Output gd image to file
- *
- * @param resource $image gd image resource
- * @param string $filename The path to save the file to.
- * @param string $destformat The Image type to use for $filename
- * @param string $mime The original image mime type
- */
- protected function gdImage($image, $filename, $destformat, $mime ){
- if ($destformat == 'jpg' || ($destformat == null && $mime == 'image/jpeg')) {
- return imagejpeg($image, $filename, 100);
- }
- if ($destformat == 'gif' || ($destformat == null && $mime == 'image/gif')) {
- return imagegif($image, $filename, 7);
- }
- return imagepng($image, $filename, 7);
- }
- /**
- * Assign the proper background to a gd image
- *
- * @param resource $image gd image resource
- * @param string $bgcolor background color in #rrggbb format
- */
- protected function gdImageBackground($image, $bgcolor){
- if( $bgcolor == 'transparent' ){
- imagesavealpha($image,true);
- $bgcolor1 = imagecolorallocatealpha($image, 255, 255, 255, 127);
- }else{
- list($r, $g, $b) = sscanf($bgcolor, "#%02x%02x%02x");
- $bgcolor1 = imagecolorallocate($image, $r, $g, $b);
- }
- imagefill($image, 0, 0, $bgcolor1);
- }
- /*********************** misc *************************/
- /**
- * Return smart formatted date
- *
- * @param int $ts file timestamp
- * @return string
- * @author Dmitry (dio) Levashov
- **/
- // protected function formatDate($ts) {
- // if ($ts > $this->today) {
- // return 'Today '.date($this->options['timeFormat'], $ts);
- // }
- //
- // if ($ts > $this->yesterday) {
- // return 'Yesterday '.date($this->options['timeFormat'], $ts);
- // }
- //
- // return date($this->options['dateFormat'], $ts);
- // }
- /**
- * Find position of first occurrence of string in a string with multibyte support
- *
- * @param string $haystack The string being checked.
- * @param string $needle The string to find in haystack.
- * @param int $offset The search offset. If it is not specified, 0 is used.
- * @return int|bool
- * @author Alexey Sukhotin
- **/
- protected function stripos($haystack , $needle , $offset = 0) {
- if (function_exists('mb_stripos')) {
- return mb_stripos($haystack , $needle , $offset);
- } else if (function_exists('mb_strtolower') && function_exists('mb_strpos')) {
- return mb_strpos(mb_strtolower($haystack), mb_strtolower($needle), $offset);
- }
- return stripos($haystack , $needle , $offset);
- }
- /**
- * Get server side available archivers
- *
- * @param bool $use_cache
- * @return array
- */
- protected function getArchivers($use_cache = true) {
- if (!function_exists('proc_open')) {
- return array();
- }
- if ($use_cache && isset($_SESSION['ELFINDER_ARCHIVERS_CACHE']) && is_array($_SESSION['ELFINDER_ARCHIVERS_CACHE'])) {
- return $_SESSION['ELFINDER_ARCHIVERS_CACHE'];
- }
- $arcs = array(
- 'create' => array(),
- 'extract' => array()
- );
- $this->procExec('tar --version', $o, $ctar);
- if ($ctar == 0) {
- $arcs['create']['application/x-tar'] = array('cmd' => 'tar', 'argc' => '-cf', 'ext' => 'tar');
- $arcs['extract']['application/x-tar'] = array('cmd' => 'tar', 'argc' => '-xf', 'ext' => 'tar');
- unset($o);
- $test = $this->procExec('gzip --version', $o, $c);
- if ($c == 0) {
- $arcs['create']['application/x-gzip'] = array('cmd' => 'tar', 'argc' => '-czf', 'ext' => 'tgz');
- $arcs['extract']['application/x-gzip'] = array('cmd' => 'tar', 'argc' => '-xzf', 'ext' => 'tgz');
- }
- unset($o);
- $test = $this->procExec('bzip2 --version', $o, $c);
- if ($c == 0) {
- $arcs['create']['application/x-bzip2'] = array('cmd' => 'tar', 'argc' => '-cjf', 'ext' => 'tbz');
- $arcs['extract']['application/x-bzip2'] = array('cmd' => 'tar', 'argc' => '-xjf', 'ext' => 'tbz');
- }
- }
- unset($o);
- $this->procExec('zip -v', $o, $c);
- if ($c == 0) {
- $arcs['create']['application/zip'] = array('cmd' => 'zip', 'argc' => '-r9', 'ext' => 'zip');
- }
- unset($o);
- $this->procExec('unzip --help', $o, $c);
- if ($c == 0) {
- $arcs['extract']['application/zip'] = array('cmd' => 'unzip', 'argc' => '', 'ext' => 'zip');
- }
- unset($o);
- $this->procExec('rar --version', $o, $c);
- if ($c == 0 || $c == 7) {
- $arcs['create']['application/x-rar'] = array('cmd' => 'rar', 'argc' => 'a -inul', 'ext' => 'rar');
- $arcs['extract']['application/x-rar'] = array('cmd' => 'rar', 'argc' => 'x -y', 'ext' => 'rar');
- } else {
- unset($o);
- $test = $this->procExec('unrar', $o, $c);
- if ($c==0 || $c == 7) {
- $arcs['extract']['application/x-rar'] = array('cmd' => 'unrar', 'argc' => 'x -y', 'ext' => 'rar');
- }
- }
- unset($o);
- $this->procExec('7za --help', $o, $c);
- if ($c == 0) {
- $arcs['create']['application/x-7z-compressed'] = array('cmd' => '7za', 'argc' => 'a', 'ext' => '7z');
- $arcs['extract']['application/x-7z-compressed'] = array('cmd' => '7za', 'argc' => 'e -y', 'ext' => '7z');
- if (empty($arcs['create']['application/x-gzip'])) {
- $arcs['create']['application/x-gzip'] = array('cmd' => '7za', 'argc' => 'a -tgzip', 'ext' => 'tar.gz');
- }
- if (empty($arcs['extract']['application/x-gzip'])) {
- $arcs['extract']['application/x-gzip'] = array('cmd' => '7za', 'argc' => 'e -tgzip -y', 'ext' => 'tar.gz');
- }
- if (empty($arcs['create']['application/x-bzip2'])) {
- $arcs['create']['application/x-bzip2'] = array('cmd' => '7za', 'argc' => 'a -tbzip2', 'ext' => 'tar.bz');
- }
- if (empty($arcs['extract']['application/x-bzip2'])) {
- $arcs['extract']['application/x-bzip2'] = array('cmd' => '7za', 'argc' => 'a -tbzip2 -y', 'ext' => 'tar.bz');
- }
- if (empty($arcs['create']['application/zip'])) {
- $arcs['create']['application/zip'] = array('cmd' => '7za', 'argc' => 'a -tzip -l', 'ext' => 'zip');
- }
- if (empty($arcs['extract']['application/zip'])) {
- $arcs['extract']['application/zip'] = array('cmd' => '7za', 'argc' => 'e -tzip -y', 'ext' => 'zip');
- }
- if (empty($arcs['create']['application/x-tar'])) {
- $arcs['create']['application/x-tar'] = array('cmd' => '7za', 'argc' => 'a -ttar -l', 'ext' => 'tar');
- }
- if (empty($arcs['extract']['application/x-tar'])) {
- $arcs['extract']['application/x-tar'] = array('cmd' => '7za', 'argc' => 'e -ttar -y', 'ext' => 'tar');
- }
- } else if (substr(PHP_OS,0,3) === 'WIN') {
- // check `7z` for Windows server.
- unset($o);
- $this->procExec('7z', $o, $c);
- if ($c == 0) {
- $arcs['create']['application/x-7z-compressed'] = array('cmd' => '7z', 'argc' => 'a -mx0', 'ext' => '7z');
- $arcs['extract']['application/x-7z-compressed'] = array('cmd' => '7z', 'argc' => 'x -y', 'ext' => '7z');
- if (empty($arcs['create']['application/x-gzip'])) {
- $arcs['create']['application/x-gzip'] = array('cmd' => '7z', 'argc' => 'a -tgzip -mx0', 'ext' => 'tar.gz');
- }
- if (empty($arcs['extract']['application/x-gzip'])) {
- $arcs['extract']['application/x-gzip'] = array('cmd' => '7z', 'argc' => 'x -tgzip -y', 'ext' => 'tar.gz');
- }
- if (empty($arcs['create']['application/x-bzip2'])) {
- $arcs['create']['application/x-bzip2'] = array('cmd' => '7z', 'argc' => 'a -tbzip2 -mx0', 'ext' => 'tar.bz');
- }
- if (empty($arcs['extract']['application/x-bzip2'])) {
- $arcs['extract']['application/x-bzip2'] = array('cmd' => '7z', 'argc' => 'x -tbzip2 -y', 'ext' => 'tar.bz');
- }
- if (empty($arcs['create']['application/zip'])) {
- $arcs['create']['application/zip'] = array('cmd' => '7z', 'argc' => 'a -tzip -l -mx0', 'ext' => 'zip');
- }
- if (empty($arcs['extract']['application/zip'])) {
- $arcs['extract']['application/zip'] = array('cmd' => '7z', 'argc' => 'x -tzip -y', 'ext' => 'zip');
- }
- if (empty($arcs['create']['application/x-tar'])) {
- $arcs['create']['application/x-tar'] = array('cmd' => '7z', 'argc' => 'a -ttar -l -mx0', 'ext' => 'tar');
- }
- if (empty($arcs['extract']['application/x-tar'])) {
- $arcs['extract']['application/x-tar'] = array('cmd' => '7z', 'argc' => 'x -ttar -y', 'ext' => 'tar');
- }
- if (empty($arcs['create']['application/x-rar'])) {
- $arcs['create']['application/x-rar'] = array('cmd' => '7z', 'argc' => 'a -trar -l -mx0', 'ext' => 'rar');
- }
- if (empty($arcs['extract']['application/x-rar'])) {
- $arcs['extract']['application/x-rar'] = array('cmd' => '7z', 'argc' => 'x -trar -y', 'ext' => 'rar');
- }
- }
- }
- $_SESSION['ELFINDER_ARCHIVERS_CACHE'] = $arcs;
- return $arcs;
- }
- /**==================================* abstract methods *====================================**/
- /*********************** paths/urls *************************/
- /**
- * Return parent directory path
- *
- * @param string $path file path
- * @return string
- * @author Dmitry (dio) Levashov
- **/
- abstract protected function _dirname($path);
- /**
- * Return file name
- *
- * @param string $path file path
- * @return string
- * @author Dmitry (dio) Levashov
- **/
- abstract protected function _basename($path);
- /**
- * Join dir name and file name and return full path.
- * Some drivers (db) use int as path - so we give to concat path to driver itself
- *
- * @param string $dir dir path
- * @param string $name file name
- * @return string
- * @author Dmitry (dio) Levashov
- **/
- abstract protected function _joinPath($dir, $name);
- /**
- * Return normalized path
- *
- * @param string $path file path
- * @return string
- * @author Dmitry (dio) Levashov
- **/
- abstract protected function _normpath($path);
- /**
- * Return file path related to root dir
- *
- * @param string $path file path
- * @return string
- * @author Dmitry (dio) Levashov
- **/
- abstract protected function _relpath($path);
- /**
- * Convert path related to root dir into real path
- *
- * @param string $path rel file path
- * @return string
- * @author Dmitry (dio) Levashov
- **/
- abstract protected function _abspath($path);
- /**
- * Return fake path started from root dir.
- * Required to show path on client side.
- *
- * @param string $path file path
- * @return string
- * @author Dmitry (dio) Levashov
- **/
- abstract protected function _path($path);
- /**
- * Return true if $path is children of $parent
- *
- * @param string $path path to check
- * @param string $parent parent path
- * @return bool
- * @author Dmitry (dio) Levashov
- **/
- abstract protected function _inpath($path, $parent);
- /**
- * Return stat for given path.
- * Stat contains following fields:
- * - (int) size file size in b. required
- * - (int) ts file modification time in unix time. required
- * - (string) mime mimetype. required for folders, others - optionally
- * - (bool) read read permissions. required
- * - (bool) write write permissions. required
- * - (bool) locked is object locked. optionally
- * - (bool) hidden is object hidden. optionally
- * - (string) alias for symlinks - link target path relative to root path. optionally
- * - (string) target for symlinks - link target path. optionally
- *
- * If file does not exists - returns empty array or false.
- *
- * @param string $path file path
- * @return array|false
- * @author Dmitry (dio) Levashov
- **/
- abstract protected function _stat($path);
- /***************** file stat ********************/
- /**
- * Return true if path is dir and has at least one childs directory
- *
- * @param string $path dir path
- * @return bool
- * @author Dmitry (dio) Levashov
- **/
- abstract protected function _subdirs($path);
- /**
- * Return object width and height
- * Ususaly used for images, but can be realize for video etc...
- *
- * @param string $path file path
- * @param string $mime file mime type
- * @return string
- * @author Dmitry (dio) Levashov
- **/
- abstract protected function _dimensions($path, $mime);
- /******************** file/dir content *********************/
- /**
- * Return files list in directory
- *
- * @param string $path dir path
- * @return array
- * @author Dmitry (dio) Levashov
- **/
- abstract protected function _scandir($path);
- /**
- * Open file and return file pointer
- *
- * @param string $path file path
- * @param bool $write open file for writing
- * @return resource|false
- * @author Dmitry (dio) Levashov
- **/
- abstract protected function _fopen($path, $mode="rb");
- /**
- * Close opened file
- *
- * @param resource $fp file pointer
- * @param string $path file path
- * @return bool
- * @author Dmitry (dio) Levashov
- **/
- abstract protected function _fclose($fp, $path='');
- /******************** file/dir manipulations *************************/
- /**
- * Create dir and return created dir path or false on failed
- *
- * @param string $path parent dir path
- * @param string $name new directory name
- * @return string|bool
- * @author Dmitry (dio) Levashov
- **/
- abstract protected function _mkdir($path, $name);
- /**
- * Create file and return it's path or false on failed
- *
- * @param string $path parent dir path
- * @param string $name new file name
- * @return string|bool
- * @author Dmitry (dio) Levashov
- **/
- abstract protected function _mkfile($path, $name);
- /**
- * Create symlink
- *
- * @param string $source file to link to
- * @param string $targetDir folder to create link in
- * @param string $name symlink name
- * @return bool
- * @author Dmitry (dio) Levashov
- **/
- abstract protected function _symlink($source, $targetDir, $name);
- /**
- * Copy file into another file (only inside one volume)
- *
- * @param string $source source file path
- * @param string $target target dir path
- * @param string $name file name
- * @return bool
- * @author Dmitry (dio) Levashov
- **/
- abstract protected function _copy($source, $targetDir, $name);
- /**
- * Move file into another parent dir.
- * Return new file path or false.
- *
- * @param string $source source file path
- * @param string $target target dir path
- * @param string $name file name
- * @return string|bool
- * @author Dmitry (dio) Levashov
- **/
- abstract protected function _move($source, $targetDir, $name);
- /**
- * Remove file
- *
- * @param string $path file path
- * @return bool
- * @author Dmitry (dio) Levashov
- **/
- abstract protected function _unlink($path);
- /**
- * Remove dir
- *
- * @param string $path dir path
- * @return bool
- * @author Dmitry (dio) Levashov
- **/
- abstract protected function _rmdir($path);
- /**
- * Create new file and write into it from file pointer.
- * Return new file path or false on error.
- *
- * @param resource $fp file pointer
- * @param string $dir target dir path
- * @param string $name file name
- * @param array $stat file stat (required by some virtual fs)
- * @return bool|string
- * @author Dmitry (dio) Levashov
- **/
- abstract protected function _save($fp, $dir, $name, $stat);
- /**
- * Get file contents
- *
- * @param string $path file path
- * @return string|false
- * @author Dmitry (dio) Levashov
- **/
- abstract protected function _getContents($path);
- /**
- * Write a string to a file
- *
- * @param string $path file path
- * @param string $content new file content
- * @return bool
- * @author Dmitry (dio) Levashov
- **/
- abstract protected function _filePutContents($path, $content);
- /**
- * Extract files from archive
- *
- * @param string $path file path
- * @param array $arc archiver options
- * @return bool
- * @author Dmitry (dio) Levashov,
- * @author Alexey Sukhotin
- **/
- abstract protected function _extract($path, $arc);
- /**
- * Create archive and return its path
- *
- * @param string $dir target dir
- * @param array $files files names list
- * @param string $name archive name
- * @param array $arc archiver options
- * @return string|bool
- * @author Dmitry (dio) Levashov,
- * @author Alexey Sukhotin
- **/
- abstract protected function _archive($dir, $files, $name, $arc);
- /**
- * Detect available archivers
- *
- * @return void
- * @author Dmitry (dio) Levashov,
- * @author Alexey Sukhotin
- **/
- abstract protected function _checkArchivers();
- } // END class
|