From a56b4dc2fc73259abffcfd1d1dde49bc76e3ad1f Mon Sep 17 00:00:00 2001 From: Valentin Date: Tue, 26 Mar 2024 13:31:26 +0100 Subject: [PATCH] first commit --- .dependencies | 34 + .editorconfig | 17 + .github/FUNDING.yml | 8 + .github/workflows/build.yaml | 79 + .github/workflows/tests.yaml | 76 + .github/workflows/trigger-skeletons.yml | 48 + .gitignore | 50 + .htaccess | 78 + .phan/config.php | 44 + .phan/internal_stubs/Redis.phan_php | 5153 +++++++++++++ .phan/internal_stubs/memcache.phan_php | 460 ++ .phan/internal_stubs/memcached.phan_php | 1308 ++++ .travis.yml | 96 + CHANGELOG.md | 4095 +++++++++++ CODE_OF_CONDUCT.md | 133 + CONTRIBUTING.md | 138 + LICENSE.txt | 21 + README.md | 156 + SECURITY.md | 29 + assets/.gitkeep | 1 + backup/.gitkeep | 1 + bin/composer.phar | Bin 0 -> 2862107 bytes bin/gpm | 46 + bin/grav | 42 + bin/plugin | 43 + cache/.gitkeep | 1 + codeception.yml | 16 + composer.json | 131 + composer.lock | 6412 +++++++++++++++++ images/.gitkeep | 1 + index.php | 51 + logs/.gitkeep | 1 + now.json | 4 + robots.txt | 21 + system/assets/debugger/clockwork.css | 2 + system/assets/debugger/clockwork.js | 3 + system/assets/debugger/phpdebugbar.css | 67 + system/assets/grav.png | Bin 0 -> 1612 bytes system/assets/jquery/jquery-2.1.4.min.js | 4 + system/assets/jquery/jquery-2.x.min.js | 4 + system/assets/jquery/jquery-3.x.min.js | 2 + system/assets/responsive-overlays/1x.png | Bin 0 -> 3238 bytes system/assets/responsive-overlays/2x.png | Bin 0 -> 7593 bytes system/assets/responsive-overlays/3x.png | Bin 0 -> 13002 bytes system/assets/responsive-overlays/4x.png | Bin 0 -> 15545 bytes system/assets/responsive-overlays/unknown.png | Bin 0 -> 5241 bytes system/assets/whoops.css | 19 + system/blueprints/config/backups.yaml | 125 + system/blueprints/config/media.yaml | 5 + system/blueprints/config/scheduler.yaml | 78 + system/blueprints/config/security.yaml | 119 + system/blueprints/config/site.yaml | 124 + system/blueprints/config/streams.yaml | 8 + system/blueprints/config/system.yaml | 1872 +++++ system/blueprints/flex/accounts.yaml | 8 + system/blueprints/flex/configure/compat.yaml | 17 + system/blueprints/flex/pages.yaml | 212 + system/blueprints/flex/shared/configure.yaml | 70 + system/blueprints/flex/user-accounts.yaml | 155 + system/blueprints/flex/user-groups.yaml | 124 + system/blueprints/pages/default.yaml | 381 + system/blueprints/pages/external.yaml | 52 + system/blueprints/pages/modular.yaml | 36 + .../blueprints/pages/partials/security.yaml | 67 + system/blueprints/pages/root.yaml | 16 + system/blueprints/user/account.yaml | 157 + system/blueprints/user/account_new.yaml | 18 + system/blueprints/user/group.yaml | 55 + system/blueprints/user/group_new.yaml | 23 + system/config/backups.yaml | 15 + system/config/media.yaml | 223 + system/config/mime.yaml | 1986 +++++ system/config/permissions.yaml | 53 + system/config/security.yaml | 47 + system/config/site.yaml | 35 + system/config/system.yaml | 231 + system/defines.php | 104 + system/images/media/thumb-3dm.png | Bin 0 -> 3013 bytes system/images/media/thumb-3ds.png | Bin 0 -> 3116 bytes system/images/media/thumb-3g2.png | Bin 0 -> 3006 bytes system/images/media/thumb-3gp.png | Bin 0 -> 2853 bytes system/images/media/thumb-7z.png | Bin 0 -> 1648 bytes system/images/media/thumb-aac.png | Bin 0 -> 3218 bytes system/images/media/thumb-ai.png | Bin 0 -> 1595 bytes system/images/media/thumb-aif.png | Bin 0 -> 1691 bytes system/images/media/thumb-apk.png | Bin 0 -> 2557 bytes system/images/media/thumb-app.png | Bin 0 -> 2360 bytes system/images/media/thumb-asf.png | Bin 0 -> 2635 bytes system/images/media/thumb-asp.png | Bin 0 -> 2913 bytes system/images/media/thumb-aspx.png | Bin 0 -> 3726 bytes system/images/media/thumb-asx.png | Bin 0 -> 3287 bytes system/images/media/thumb-avi.png | Bin 0 -> 2448 bytes system/images/media/thumb-bak.png | Bin 0 -> 2814 bytes system/images/media/thumb-bat.png | Bin 0 -> 2182 bytes system/images/media/thumb-bin.png | Bin 0 -> 1841 bytes system/images/media/thumb-bmp.png | Bin 0 -> 2573 bytes system/images/media/thumb-cab.png | Bin 0 -> 3056 bytes system/images/media/thumb-cad.png | Bin 0 -> 3021 bytes system/images/media/thumb-cdr.png | Bin 0 -> 2713 bytes system/images/media/thumb-cer.png | Bin 0 -> 2367 bytes system/images/media/thumb-cfg.png | Bin 0 -> 2764 bytes system/images/media/thumb-cfm.png | Bin 0 -> 2589 bytes system/images/media/thumb-cgi.png | Bin 0 -> 2626 bytes system/images/media/thumb-com.png | Bin 0 -> 3292 bytes system/images/media/thumb-cpl.png | Bin 0 -> 2174 bytes system/images/media/thumb-cpp.png | Bin 0 -> 2425 bytes system/images/media/thumb-crx.png | Bin 0 -> 2965 bytes system/images/media/thumb-csr.png | Bin 0 -> 3158 bytes system/images/media/thumb-css.png | Bin 0 -> 3235 bytes system/images/media/thumb-csv.png | Bin 0 -> 3317 bytes system/images/media/thumb-cue.png | Bin 0 -> 2271 bytes system/images/media/thumb-cur.png | Bin 0 -> 2716 bytes system/images/media/thumb-dat.png | Bin 0 -> 2188 bytes system/images/media/thumb-db.png | Bin 0 -> 1964 bytes system/images/media/thumb-dbf.png | Bin 0 -> 1947 bytes system/images/media/thumb-dds.png | Bin 0 -> 2815 bytes system/images/media/thumb-dem.png | Bin 0 -> 2215 bytes system/images/media/thumb-dll.png | Bin 0 -> 1352 bytes system/images/media/thumb-dmg.png | Bin 0 -> 3064 bytes system/images/media/thumb-dmp.png | Bin 0 -> 2527 bytes system/images/media/thumb-doc.png | Bin 0 -> 3051 bytes system/images/media/thumb-docx.png | Bin 0 -> 3865 bytes system/images/media/thumb-drv.png | Bin 0 -> 2728 bytes system/images/media/thumb-dtd.png | Bin 0 -> 1949 bytes system/images/media/thumb-dwg.png | Bin 0 -> 3530 bytes system/images/media/thumb-dxf.png | Bin 0 -> 2392 bytes system/images/media/thumb-elf.png | Bin 0 -> 663 bytes system/images/media/thumb-eot.png | Bin 0 -> 2002 bytes system/images/media/thumb-eps.png | Bin 0 -> 2276 bytes system/images/media/thumb-exe.png | Bin 0 -> 1813 bytes system/images/media/thumb-fla.png | Bin 0 -> 1724 bytes system/images/media/thumb-flv.png | Bin 0 -> 1720 bytes system/images/media/thumb-fnt.png | Bin 0 -> 1254 bytes system/images/media/thumb-fon.png | Bin 0 -> 2402 bytes system/images/media/thumb-gam.png | Bin 0 -> 3203 bytes system/images/media/thumb-gbr.png | Bin 0 -> 2849 bytes system/images/media/thumb-ged.png | Bin 0 -> 2269 bytes system/images/media/thumb-gif.png | Bin 0 -> 1751 bytes system/images/media/thumb-gpx.png | Bin 0 -> 2972 bytes system/images/media/thumb-gz.png | Bin 0 -> 2134 bytes system/images/media/thumb-gzip.png | Bin 0 -> 2451 bytes system/images/media/thumb-hqz.png | Bin 0 -> 2604 bytes system/images/media/thumb-html.png | Bin 0 -> 1740 bytes system/images/media/thumb-icns.png | Bin 0 -> 3212 bytes system/images/media/thumb-ico.png | Bin 0 -> 2769 bytes system/images/media/thumb-ics.png | Bin 0 -> 2787 bytes system/images/media/thumb-iff.png | Bin 0 -> 601 bytes system/images/media/thumb-indd.png | Bin 0 -> 2475 bytes system/images/media/thumb-iso.png | Bin 0 -> 2864 bytes system/images/media/thumb-jar.png | Bin 0 -> 2583 bytes system/images/media/thumb-jpg.png | Bin 0 -> 2435 bytes system/images/media/thumb-js.png | Bin 0 -> 2046 bytes system/images/media/thumb-json.png | Bin 0 -> 7818 bytes system/images/media/thumb-jsp.png | Bin 0 -> 2498 bytes system/images/media/thumb-key.png | Bin 0 -> 2130 bytes system/images/media/thumb-kml.png | Bin 0 -> 2346 bytes system/images/media/thumb-kmz.png | Bin 0 -> 2701 bytes system/images/media/thumb-lnk.png | Bin 0 -> 1971 bytes system/images/media/thumb-log.png | Bin 0 -> 2762 bytes system/images/media/thumb-lua.png | Bin 0 -> 2117 bytes system/images/media/thumb-m3u.png | Bin 0 -> 2909 bytes system/images/media/thumb-m4a.png | Bin 0 -> 2754 bytes system/images/media/thumb-m4v.png | Bin 0 -> 2738 bytes system/images/media/thumb-max.png | Bin 0 -> 3213 bytes system/images/media/thumb-mdb.png | Bin 0 -> 2691 bytes system/images/media/thumb-mdf.png | Bin 0 -> 2243 bytes system/images/media/thumb-mid.png | Bin 0 -> 2199 bytes system/images/media/thumb-mim.png | Bin 0 -> 2284 bytes system/images/media/thumb-mov.png | Bin 0 -> 3221 bytes system/images/media/thumb-mp3.png | Bin 0 -> 2801 bytes system/images/media/thumb-mp4.png | Bin 0 -> 2221 bytes system/images/media/thumb-mpa.png | Bin 0 -> 2734 bytes system/images/media/thumb-mpe.png | Bin 0 -> 1971 bytes system/images/media/thumb-mpg.png | Bin 0 -> 2811 bytes system/images/media/thumb-msg.png | Bin 0 -> 3319 bytes system/images/media/thumb-msi.png | Bin 0 -> 2594 bytes system/images/media/thumb-nes.png | Bin 0 -> 2320 bytes system/images/media/thumb-obj.png | Bin 0 -> 2716 bytes system/images/media/thumb-odb.png | Bin 0 -> 2912 bytes system/images/media/thumb-odc.png | Bin 0 -> 3239 bytes system/images/media/thumb-odf.png | Bin 0 -> 2496 bytes system/images/media/thumb-odg.png | Bin 0 -> 3069 bytes system/images/media/thumb-odi.png | Bin 0 -> 2453 bytes system/images/media/thumb-odp.png | Bin 0 -> 2871 bytes system/images/media/thumb-ods.png | Bin 0 -> 3257 bytes system/images/media/thumb-odt.png | Bin 0 -> 2414 bytes system/images/media/thumb-odx.png | Bin 0 -> 3133 bytes system/images/media/thumb-ogg.png | Bin 0 -> 3577 bytes system/images/media/thumb-pct.png | Bin 0 -> 2248 bytes system/images/media/thumb-pdb.png | Bin 0 -> 2354 bytes system/images/media/thumb-pdf.png | Bin 0 -> 1823 bytes system/images/media/thumb-pif.png | Bin 0 -> 1103 bytes system/images/media/thumb-pkg.png | Bin 0 -> 2660 bytes system/images/media/thumb-pl.png | Bin 0 -> 1066 bytes system/images/media/thumb-png.png | Bin 0 -> 2530 bytes system/images/media/thumb-pps.png | Bin 0 -> 2497 bytes system/images/media/thumb-ppt.png | Bin 0 -> 1573 bytes system/images/media/thumb-pptx.png | Bin 0 -> 2560 bytes system/images/media/thumb-ps.png | Bin 0 -> 2285 bytes system/images/media/thumb-psd.png | Bin 0 -> 2613 bytes system/images/media/thumb-pub.png | Bin 0 -> 2137 bytes system/images/media/thumb-py.png | Bin 0 -> 1776 bytes system/images/media/thumb-ra.png | Bin 0 -> 2223 bytes system/images/media/thumb-rar.png | Bin 0 -> 2695 bytes system/images/media/thumb-raw.png | Bin 0 -> 3433 bytes system/images/media/thumb-rm.png | Bin 0 -> 2181 bytes system/images/media/thumb-rom.png | Bin 0 -> 3088 bytes system/images/media/thumb-rpm.png | Bin 0 -> 2566 bytes system/images/media/thumb-rss.png | Bin 0 -> 3091 bytes system/images/media/thumb-rtf.png | Bin 0 -> 1364 bytes system/images/media/thumb-sav.png | Bin 0 -> 3204 bytes system/images/media/thumb-sdf.png | Bin 0 -> 2444 bytes system/images/media/thumb-sql.png | Bin 0 -> 2929 bytes system/images/media/thumb-srt.png | Bin 0 -> 2366 bytes system/images/media/thumb-svg.png | Bin 0 -> 3359 bytes system/images/media/thumb-swf.png | Bin 0 -> 3181 bytes system/images/media/thumb-sys.png | Bin 0 -> 3128 bytes system/images/media/thumb-tar.png | Bin 0 -> 2165 bytes system/images/media/thumb-tex.png | Bin 0 -> 1716 bytes system/images/media/thumb-tga.png | Bin 0 -> 2655 bytes system/images/media/thumb-thm.png | Bin 0 -> 1666 bytes system/images/media/thumb-tiff.png | Bin 0 -> 690 bytes system/images/media/thumb-tmp.png | Bin 0 -> 2040 bytes system/images/media/thumb-ttf.png | Bin 0 -> 615 bytes system/images/media/thumb-txt.png | Bin 0 -> 1853 bytes system/images/media/thumb-uue.png | Bin 0 -> 1632 bytes system/images/media/thumb-vb.png | Bin 0 -> 2074 bytes system/images/media/thumb-vcd.png | Bin 0 -> 3040 bytes system/images/media/thumb-vcf.png | Bin 0 -> 2581 bytes system/images/media/thumb-wav.png | Bin 0 -> 3601 bytes system/images/media/thumb-webm.png | Bin 0 -> 3843 bytes system/images/media/thumb-wma.png | Bin 0 -> 3552 bytes system/images/media/thumb-wmv.png | Bin 0 -> 3789 bytes system/images/media/thumb-woff.png | Bin 0 -> 3421 bytes system/images/media/thumb-woff2.png | Bin 0 -> 3927 bytes system/images/media/thumb-wpd.png | Bin 0 -> 3127 bytes system/images/media/thumb-wps.png | Bin 0 -> 3368 bytes system/images/media/thumb-wsf.png | Bin 0 -> 3028 bytes system/images/media/thumb-xls.png | Bin 0 -> 2562 bytes system/images/media/thumb-xlsx.png | Bin 0 -> 3481 bytes system/images/media/thumb-xml.png | Bin 0 -> 2557 bytes system/images/media/thumb-yuv.png | Bin 0 -> 2741 bytes system/images/media/thumb-zip.png | Bin 0 -> 1628 bytes system/images/media/thumb.png | Bin 0 -> 1200 bytes system/images/watermark.png | Bin 0 -> 95789 bytes system/install.php | 15 + system/languages/ar.yaml | 93 + system/languages/bg.yaml | 72 + system/languages/ca.yaml | 87 + system/languages/cs.yaml | 147 + system/languages/da.yaml | 90 + system/languages/de.yaml | 147 + system/languages/el.yaml | 144 + system/languages/en.yaml | 121 + system/languages/eo.yaml | 40 + system/languages/es.yaml | 107 + system/languages/et.yaml | 108 + system/languages/eu.yaml | 62 + system/languages/fa.yaml | 62 + system/languages/fi.yaml | 134 + system/languages/fr.yaml | 147 + system/languages/gl.yaml | 147 + system/languages/he.yaml | 99 + system/languages/hr.yaml | 104 + system/languages/hu.yaml | 97 + system/languages/id.yaml | 147 + system/languages/is.yaml | 80 + system/languages/it.yaml | 147 + system/languages/ja.yaml | 81 + system/languages/ko.yaml | 90 + system/languages/lt.yaml | 78 + system/languages/lv.yaml | 84 + system/languages/mn.yaml | 147 + system/languages/my.yaml | 147 + system/languages/nb.yaml | 4 + system/languages/nl.yaml | 147 + system/languages/no.yaml | 82 + system/languages/pl.yaml | 100 + system/languages/pt.yaml | 147 + system/languages/ro.yaml | 96 + system/languages/ru.yaml | 114 + system/languages/si.yaml | 120 + system/languages/sk.yaml | 144 + system/languages/sl.yaml | 85 + system/languages/sr.yaml | 144 + system/languages/sv.yaml | 100 + system/languages/sw.yaml | 147 + system/languages/th.yaml | 147 + system/languages/tr.yaml | 100 + system/languages/uk.yaml | 63 + system/languages/vi.yaml | 63 + system/languages/zh-cn.yaml | 146 + system/languages/zh-tw.yaml | 79 + system/languages/zh.yaml | 146 + system/pages/notfound.md | 6 + system/router.php | 55 + system/src/DOMLettersIterator.php | 165 + system/src/DOMWordsIterator.php | 158 + system/src/Grav/Common/Assets.php | 595 ++ system/src/Grav/Common/Assets/BaseAsset.php | 283 + system/src/Grav/Common/Assets/BlockAssets.php | 207 + system/src/Grav/Common/Assets/Css.php | 52 + system/src/Grav/Common/Assets/InlineCss.php | 44 + system/src/Grav/Common/Assets/InlineJs.php | 44 + .../src/Grav/Common/Assets/InlineJsModule.php | 46 + system/src/Grav/Common/Assets/Js.php | 48 + system/src/Grav/Common/Assets/JsModule.php | 49 + system/src/Grav/Common/Assets/Link.php | 43 + system/src/Grav/Common/Assets/Pipeline.php | 347 + .../Common/Assets/Traits/AssetUtilsTrait.php | 215 + .../Assets/Traits/LegacyAssetsTrait.php | 137 + .../Assets/Traits/TestingAssetsTrait.php | 350 + system/src/Grav/Common/Backup/Backups.php | 322 + system/src/Grav/Common/Browser.php | 153 + system/src/Grav/Common/Cache.php | 690 ++ system/src/Grav/Common/Composer.php | 67 + .../src/Grav/Common/Config/CompiledBase.php | 269 + .../Grav/Common/Config/CompiledBlueprints.php | 131 + .../src/Grav/Common/Config/CompiledConfig.php | 114 + .../Grav/Common/Config/CompiledLanguages.php | 83 + system/src/Grav/Common/Config/Config.php | 156 + .../Grav/Common/Config/ConfigFileFinder.php | 273 + system/src/Grav/Common/Config/Languages.php | 107 + system/src/Grav/Common/Config/Setup.php | 423 ++ system/src/Grav/Common/Data/Blueprint.php | 594 ++ .../src/Grav/Common/Data/BlueprintSchema.php | 429 ++ system/src/Grav/Common/Data/Blueprints.php | 121 + system/src/Grav/Common/Data/Data.php | 343 + system/src/Grav/Common/Data/DataInterface.php | 84 + system/src/Grav/Common/Data/Validation.php | 1236 ++++ .../Grav/Common/Data/ValidationException.php | 67 + system/src/Grav/Common/Debugger.php | 1144 +++ system/src/Grav/Common/Errors/BareHandler.php | 33 + system/src/Grav/Common/Errors/Errors.php | 85 + .../Grav/Common/Errors/Resources/error.css | 52 + .../Common/Errors/Resources/layout.html.php | 30 + .../Grav/Common/Errors/SimplePageHandler.php | 122 + .../src/Grav/Common/Errors/SystemFacade.php | 67 + system/src/Grav/Common/File/CompiledFile.php | 195 + .../src/Grav/Common/File/CompiledJsonFile.php | 33 + .../Grav/Common/File/CompiledMarkdownFile.php | 21 + .../src/Grav/Common/File/CompiledYamlFile.php | 21 + .../src/Grav/Common/Filesystem/Archiver.php | 108 + system/src/Grav/Common/Filesystem/Folder.php | 548 ++ .../RecursiveDirectoryFilterIterator.php | 82 + .../RecursiveFolderFilterIterator.php | 55 + .../Grav/Common/Filesystem/ZipArchiver.php | 135 + .../src/Grav/Common/Flex/FlexCollection.php | 28 + system/src/Grav/Common/Flex/FlexIndex.php | 29 + system/src/Grav/Common/Flex/FlexObject.php | 74 + .../Flex/Traits/FlexCollectionTrait.php | 51 + .../Common/Flex/Traits/FlexCommonTrait.php | 54 + .../Grav/Common/Flex/Traits/FlexGravTrait.php | 74 + .../Common/Flex/Traits/FlexIndexTrait.php | 20 + .../Common/Flex/Traits/FlexObjectTrait.php | 62 + .../Flex/Types/Generic/GenericCollection.php | 24 + .../Flex/Types/Generic/GenericIndex.php | 24 + .../Flex/Types/Generic/GenericObject.php | 22 + .../Flex/Types/Pages/PageCollection.php | 839 +++ .../Common/Flex/Types/Pages/PageIndex.php | 1198 +++ .../Common/Flex/Types/Pages/PageObject.php | 744 ++ .../Flex/Types/Pages/Storage/PageStorage.php | 700 ++ .../Types/Pages/Traits/PageContentTrait.php | 75 + .../Types/Pages/Traits/PageLegacyTrait.php | 236 + .../Types/Pages/Traits/PageRoutableTrait.php | 122 + .../Types/Pages/Traits/PageTranslateTrait.php | 108 + .../Types/UserGroups/UserGroupCollection.php | 56 + .../Flex/Types/UserGroups/UserGroupIndex.php | 24 + .../Flex/Types/UserGroups/UserGroupObject.php | 134 + .../Types/Users/Storage/UserFileStorage.php | 47 + .../Types/Users/Storage/UserFolderStorage.php | 37 + .../Users/Traits/UserObjectLegacyTrait.php | 94 + .../Flex/Types/Users/UserCollection.php | 135 + .../Common/Flex/Types/Users/UserIndex.php | 206 + .../Common/Flex/Types/Users/UserObject.php | 1059 +++ system/src/Grav/Common/Form/FormFlash.php | 107 + .../Grav/Common/GPM/AbstractCollection.php | 41 + .../GPM/Common/AbstractPackageCollection.php | 50 + .../Common/GPM/Common/CachedCollection.php | 43 + system/src/Grav/Common/GPM/Common/Package.php | 99 + system/src/Grav/Common/GPM/GPM.php | 1270 ++++ system/src/Grav/Common/GPM/Installer.php | 544 ++ system/src/Grav/Common/GPM/Licenses.php | 116 + .../GPM/Local/AbstractPackageCollection.php | 34 + system/src/Grav/Common/GPM/Local/Package.php | 51 + system/src/Grav/Common/GPM/Local/Packages.php | 29 + system/src/Grav/Common/GPM/Local/Plugins.php | 33 + system/src/Grav/Common/GPM/Local/Themes.php | 33 + .../GPM/Remote/AbstractPackageCollection.php | 81 + .../src/Grav/Common/GPM/Remote/GravCore.php | 151 + system/src/Grav/Common/GPM/Remote/Package.php | 66 + .../src/Grav/Common/GPM/Remote/Packages.php | 34 + system/src/Grav/Common/GPM/Remote/Plugins.php | 32 + system/src/Grav/Common/GPM/Remote/Themes.php | 32 + system/src/Grav/Common/GPM/Response.php | 3 + system/src/Grav/Common/GPM/Upgrader.php | 138 + system/src/Grav/Common/Getters.php | 170 + system/src/Grav/Common/Grav.php | 829 +++ system/src/Grav/Common/GravTrait.php | 34 + system/src/Grav/Common/HTTP/Client.php | 130 + system/src/Grav/Common/HTTP/Response.php | 96 + system/src/Grav/Common/Helpers/Base32.php | 141 + system/src/Grav/Common/Helpers/Excerpts.php | 196 + system/src/Grav/Common/Helpers/Exif.php | 48 + system/src/Grav/Common/Helpers/LogViewer.php | 167 + system/src/Grav/Common/Helpers/Truncator.php | 344 + system/src/Grav/Common/Helpers/YamlLinter.php | 122 + system/src/Grav/Common/Inflector.php | 357 + system/src/Grav/Common/Iterator.php | 264 + system/src/Grav/Common/Language/Language.php | 663 ++ .../Grav/Common/Language/LanguageCodes.php | 246 + system/src/Grav/Common/Markdown/Parsedown.php | 43 + .../Grav/Common/Markdown/ParsedownExtra.php | 46 + .../Common/Markdown/ParsedownGravTrait.php | 319 + .../Media/Interfaces/AudioMediaInterface.php | 25 + .../Interfaces/ImageManipulateInterface.php | 120 + .../Media/Interfaces/ImageMediaInterface.php | 17 + .../Interfaces/MediaCollectionInterface.php | 115 + .../Media/Interfaces/MediaFileInterface.php | 53 + .../Media/Interfaces/MediaInterface.php | 17 + .../Media/Interfaces/MediaLinkInterface.php | 17 + .../Media/Interfaces/MediaObjectInterface.php | 227 + .../Media/Interfaces/MediaPlayerInterface.php | 56 + .../Media/Interfaces/MediaUploadInterface.php | 73 + .../Media/Interfaces/VideoMediaInterface.php | 32 + .../Common/Media/Traits/AudioMediaTrait.php | 53 + .../Common/Media/Traits/ImageLoadingTrait.php | 37 + .../Common/Media/Traits/ImageMediaTrait.php | 428 ++ .../Common/Media/Traits/MediaFileTrait.php | 139 + .../Common/Media/Traits/MediaObjectTrait.php | 630 ++ .../Common/Media/Traits/MediaPlayerTrait.php | 113 + .../Grav/Common/Media/Traits/MediaTrait.php | 153 + .../Common/Media/Traits/MediaUploadTrait.php | 680 ++ .../Common/Media/Traits/StaticResizeTrait.php | 40 + .../Media/Traits/ThumbnailMediaTrait.php | 149 + .../Common/Media/Traits/VideoMediaTrait.php | 68 + system/src/Grav/Common/Page/Collection.php | 710 ++ system/src/Grav/Common/Page/Header.php | 38 + .../Interfaces/PageCollectionInterface.php | 310 + .../Page/Interfaces/PageContentInterface.php | 267 + .../Page/Interfaces/PageFormInterface.php | 33 + .../Common/Page/Interfaces/PageInterface.php | 25 + .../Page/Interfaces/PageLegacyInterface.php | 475 ++ .../Page/Interfaces/PageRoutableInterface.php | 180 + .../Interfaces/PageTranslateInterface.php | 38 + .../Page/Interfaces/PagesSourceInterface.php | 56 + .../Grav/Common/Page/Markdown/Excerpts.php | 343 + system/src/Grav/Common/Page/Media.php | 286 + .../Grav/Common/Page/Medium/AbstractMedia.php | 344 + .../Grav/Common/Page/Medium/AudioMedium.php | 36 + .../Grav/Common/Page/Medium/GlobalMedia.php | 150 + .../src/Grav/Common/Page/Medium/ImageFile.php | 212 + .../Grav/Common/Page/Medium/ImageMedium.php | 495 ++ system/src/Grav/Common/Page/Medium/Link.php | 102 + system/src/Grav/Common/Page/Medium/Medium.php | 140 + .../Grav/Common/Page/Medium/MediumFactory.php | 220 + .../Common/Page/Medium/ParsedownHtmlTrait.php | 44 + .../Page/Medium/RenderableInterface.php | 41 + .../Common/Page/Medium/StaticImageMedium.php | 48 + .../Common/Page/Medium/StaticResizeTrait.php | 24 + .../Page/Medium/ThumbnailImageMedium.php | 21 + .../Common/Page/Medium/VectorImageMedium.php | 68 + .../Grav/Common/Page/Medium/VideoMedium.php | 36 + system/src/Grav/Common/Page/Page.php | 2927 ++++++++ system/src/Grav/Common/Page/Pages.php | 2258 ++++++ .../Grav/Common/Page/Traits/PageFormTrait.php | 126 + system/src/Grav/Common/Page/Types.php | 179 + system/src/Grav/Common/Plugin.php | 472 ++ system/src/Grav/Common/Plugins.php | 330 + .../Common/Processors/AssetsProcessor.php | 41 + .../Common/Processors/BackupsProcessor.php | 41 + .../Processors/DebuggerAssetsProcessor.php | 40 + .../Processors/Events/RequestHandlerEvent.php | 82 + .../Common/Processors/InitializeProcessor.php | 461 ++ .../Grav/Common/Processors/PagesProcessor.php | 115 + .../Common/Processors/PluginsProcessor.php | 41 + .../Grav/Common/Processors/ProcessorBase.php | 70 + .../Common/Processors/ProcessorInterface.php | 20 + .../Common/Processors/RenderProcessor.php | 71 + .../Common/Processors/RequestProcessor.php | 66 + .../Common/Processors/SchedulerProcessor.php | 42 + .../Grav/Common/Processors/TasksProcessor.php | 71 + .../Common/Processors/ThemesProcessor.php | 40 + .../Grav/Common/Processors/TwigProcessor.php | 40 + system/src/Grav/Common/Scheduler/Cron.php | 577 ++ .../Grav/Common/Scheduler/IntervalTrait.php | 404 ++ system/src/Grav/Common/Scheduler/Job.php | 566 ++ .../src/Grav/Common/Scheduler/Scheduler.php | 447 ++ system/src/Grav/Common/Security.php | 266 + .../Service/AccountsServiceProvider.php | 157 + .../Common/Service/AssetsServiceProvider.php | 32 + .../Common/Service/BackupsServiceProvider.php | 35 + .../Common/Service/ConfigServiceProvider.php | 206 + .../Common/Service/ErrorServiceProvider.php | 30 + .../Service/FilesystemServiceProvider.php | 32 + .../Common/Service/FlexServiceProvider.php | 121 + .../Service/InflectorServiceProvider.php | 32 + .../Common/Service/LoggerServiceProvider.php | 42 + .../Common/Service/OutputServiceProvider.php | 39 + .../Common/Service/PagesServiceProvider.php | 140 + .../Common/Service/RequestServiceProvider.php | 103 + .../Service/SchedulerServiceProvider.php | 32 + .../Common/Service/SessionServiceProvider.php | 134 + .../Common/Service/StreamsServiceProvider.php | 56 + .../Common/Service/TaskServiceProvider.php | 55 + system/src/Grav/Common/Session.php | 202 + system/src/Grav/Common/Taxonomy.php | 176 + system/src/Grav/Common/Theme.php | 87 + system/src/Grav/Common/Themes.php | 417 ++ .../Common/Twig/Exception/TwigException.php | 21 + .../Twig/Extension/FilesystemExtension.php | 387 + .../Common/Twig/Extension/GravExtension.php | 1756 +++++ .../Grav/Common/Twig/Node/TwigNodeCache.php | 93 + .../Grav/Common/Twig/Node/TwigNodeLink.php | 114 + .../Common/Twig/Node/TwigNodeMarkdown.php | 52 + .../Grav/Common/Twig/Node/TwigNodeRender.php | 84 + .../Grav/Common/Twig/Node/TwigNodeScript.php | 142 + .../Grav/Common/Twig/Node/TwigNodeStyle.php | 133 + .../Grav/Common/Twig/Node/TwigNodeSwitch.php | 88 + .../Grav/Common/Twig/Node/TwigNodeThrow.php | 52 + .../Common/Twig/Node/TwigNodeTryCatch.php | 67 + .../Twig/TokenParser/TwigTokenParserCache.php | 74 + .../Twig/TokenParser/TwigTokenParserLink.php | 109 + .../TokenParser/TwigTokenParserMarkdown.php | 59 + .../TokenParser/TwigTokenParserRender.php | 74 + .../TokenParser/TwigTokenParserScript.php | 132 + .../Twig/TokenParser/TwigTokenParserStyle.php | 119 + .../TokenParser/TwigTokenParserSwitch.php | 132 + .../Twig/TokenParser/TwigTokenParserThrow.php | 55 + .../TokenParser/TwigTokenParserTryCatch.php | 81 + system/src/Grav/Common/Twig/Twig.php | 571 ++ .../Common/Twig/TwigClockworkDataSource.php | 58 + .../Grav/Common/Twig/TwigClockworkDumper.php | 72 + .../src/Grav/Common/Twig/TwigEnvironment.php | 60 + system/src/Grav/Common/Twig/TwigExtension.php | 21 + .../Grav/Common/Twig/WriteCacheFileTrait.php | 56 + system/src/Grav/Common/Uri.php | 1529 ++++ system/src/Grav/Common/User/Access.php | 52 + .../src/Grav/Common/User/Authentication.php | 61 + system/src/Grav/Common/User/DataUser/User.php | 329 + .../Common/User/DataUser/UserCollection.php | 163 + system/src/Grav/Common/User/Group.php | 172 + .../User/Interfaces/AuthorizeInterface.php | 26 + .../Interfaces/UserCollectionInterface.php | 40 + .../User/Interfaces/UserGroupInterface.php | 18 + .../Common/User/Interfaces/UserInterface.php | 189 + .../src/Grav/Common/User/Traits/UserTrait.php | 233 + system/src/Grav/Common/User/User.php | 144 + system/src/Grav/Common/Utils.php | 2213 ++++++ system/src/Grav/Common/Yaml.php | 65 + .../Grav/Console/Application/Application.php | 138 + .../CommandLoader/PluginCommandLoader.php | 95 + .../Console/Application/GpmApplication.php | 42 + .../Console/Application/GravApplication.php | 52 + .../Console/Application/PluginApplication.php | 116 + system/src/Grav/Console/Cli/BackupCommand.php | 138 + system/src/Grav/Console/Cli/CleanCommand.php | 411 ++ .../Grav/Console/Cli/ClearCacheCommand.php | 104 + .../src/Grav/Console/Cli/ComposerCommand.php | 64 + .../src/Grav/Console/Cli/InstallCommand.php | 302 + .../src/Grav/Console/Cli/LogViewerCommand.php | 96 + .../Grav/Console/Cli/NewProjectCommand.php | 75 + .../Cli/PageSystemValidatorCommand.php | 299 + .../src/Grav/Console/Cli/SandboxCommand.php | 347 + .../src/Grav/Console/Cli/SchedulerCommand.php | 223 + .../src/Grav/Console/Cli/SecurityCommand.php | 102 + system/src/Grav/Console/Cli/ServerCommand.php | 154 + .../Grav/Console/Cli/YamlLinterCommand.php | 124 + system/src/Grav/Console/ConsoleCommand.php | 46 + system/src/Grav/Console/ConsoleTrait.php | 338 + .../Grav/Console/Gpm/DirectInstallCommand.php | 321 + system/src/Grav/Console/Gpm/IndexCommand.php | 335 + system/src/Grav/Console/Gpm/InfoCommand.php | 191 + .../src/Grav/Console/Gpm/InstallCommand.php | 726 ++ .../Grav/Console/Gpm/SelfupgradeCommand.php | 344 + .../src/Grav/Console/Gpm/UninstallCommand.php | 312 + system/src/Grav/Console/Gpm/UpdateCommand.php | 289 + .../src/Grav/Console/Gpm/VersionCommand.php | 125 + system/src/Grav/Console/GpmCommand.php | 68 + system/src/Grav/Console/GravCommand.php | 52 + .../Grav/Console/Plugin/PluginListCommand.php | 69 + .../Grav/Console/TerminalObjects/Table.php | 38 + .../Grav/Events/BeforeSessionStartEvent.php | 36 + system/src/Grav/Events/FlexRegisterEvent.php | 45 + system/src/Grav/Events/PageEvent.php | 18 + .../Grav/Events/PermissionsRegisterEvent.php | 45 + system/src/Grav/Events/PluginsLoadedEvent.php | 53 + system/src/Grav/Events/SessionStartEvent.php | 36 + system/src/Grav/Events/TypesEvent.php | 18 + system/src/Grav/Framework/Acl/Access.php | 231 + system/src/Grav/Framework/Acl/Action.php | 204 + system/src/Grav/Framework/Acl/Permissions.php | 249 + .../Grav/Framework/Acl/PermissionsReader.php | 186 + .../Framework/Acl/RecursiveActionIterator.php | 64 + .../Grav/Framework/Cache/AbstractCache.php | 32 + .../Framework/Cache/Adapter/ChainCache.php | 210 + .../Framework/Cache/Adapter/DoctrineCache.php | 118 + .../Framework/Cache/Adapter/FileCache.php | 266 + .../Framework/Cache/Adapter/MemoryCache.php | 83 + .../Framework/Cache/Adapter/SessionCache.php | 107 + .../Grav/Framework/Cache/CacheInterface.php | 71 + .../src/Grav/Framework/Cache/CacheTrait.php | 373 + .../Cache/Exception/CacheException.php | 21 + .../Exception/InvalidArgumentException.php | 20 + .../Collection/AbstractFileCollection.php | 238 + .../Collection/AbstractIndexCollection.php | 574 ++ .../Collection/AbstractLazyCollection.php | 97 + .../Framework/Collection/ArrayCollection.php | 117 + .../Collection/CollectionInterface.php | 69 + .../Framework/Collection/FileCollection.php | 97 + .../Collection/FileCollectionInterface.php | 33 + .../Grav/Framework/Compat/Serializable.php | 47 + .../Framework/ContentBlock/ContentBlock.php | 303 + .../ContentBlock/ContentBlockInterface.php | 90 + .../Grav/Framework/ContentBlock/HtmlBlock.php | 502 ++ .../ContentBlock/HtmlBlockInterface.php | 130 + .../Contracts/Media/MediaObjectInterface.php | 52 + .../Contracts/Object/IdentifierInterface.php | 27 + .../RelationshipIdentifierInterface.php | 28 + .../Relationships/RelationshipInterface.php | 81 + .../Relationships/RelationshipsInterface.php | 53 + .../ToManyRelationshipInterface.php | 55 + .../ToOneRelationshipInterface.php | 37 + .../Traits/ControllerResponseTrait.php | 307 + system/src/Grav/Framework/DI/Container.php | 35 + .../src/Grav/Framework/File/AbstractFile.php | 444 ++ system/src/Grav/Framework/File/CsvFile.php | 40 + system/src/Grav/Framework/File/DataFile.php | 78 + system/src/Grav/Framework/File/File.php | 35 + .../File/Formatter/AbstractFormatter.php | 117 + .../Framework/File/Formatter/CsvFormatter.php | 170 + .../File/Formatter/FormatterInterface.php | 12 + .../Framework/File/Formatter/IniFormatter.php | 68 + .../File/Formatter/JsonFormatter.php | 170 + .../File/Formatter/MarkdownFormatter.php | 161 + .../File/Formatter/SerializeFormatter.php | 98 + .../File/Formatter/YamlFormatter.php | 129 + system/src/Grav/Framework/File/IniFile.php | 40 + .../Interfaces/FileFormatterInterface.php | 72 + .../File/Interfaces/FileInterface.php | 180 + system/src/Grav/Framework/File/JsonFile.php | 31 + .../src/Grav/Framework/File/MarkdownFile.php | 40 + system/src/Grav/Framework/File/YamlFile.php | 40 + .../Grav/Framework/Filesystem/Filesystem.php | 356 + .../Interfaces/FilesystemInterface.php | 84 + system/src/Grav/Framework/Flex/Flex.php | 334 + .../Grav/Framework/Flex/FlexCollection.php | 732 ++ .../src/Grav/Framework/Flex/FlexDirectory.php | 1187 +++ .../Grav/Framework/Flex/FlexDirectoryForm.php | 509 ++ system/src/Grav/Framework/Flex/FlexForm.php | 610 ++ .../src/Grav/Framework/Flex/FlexFormFlash.php | 130 + .../Grav/Framework/Flex/FlexIdentifier.php | 75 + system/src/Grav/Framework/Flex/FlexIndex.php | 930 +++ system/src/Grav/Framework/Flex/FlexObject.php | 1287 ++++ .../Interfaces/FlexAuthorizeInterface.php | 33 + .../Interfaces/FlexCollectionInterface.php | 144 + .../Flex/Interfaces/FlexCommonInterface.php | 79 + .../Interfaces/FlexDirectoryFormInterface.php | 27 + .../Interfaces/FlexDirectoryInterface.php | 228 + .../Flex/Interfaces/FlexFormInterface.php | 51 + .../Flex/Interfaces/FlexIndexInterface.php | 64 + .../Flex/Interfaces/FlexInterface.php | 100 + .../Interfaces/FlexObjectFormInterface.php | 27 + .../Flex/Interfaces/FlexObjectInterface.php | 211 + .../Flex/Interfaces/FlexStorageInterface.php | 138 + .../Interfaces/FlexTranslateInterface.php | 51 + .../Flex/Pages/FlexPageCollection.php | 211 + .../Framework/Flex/Pages/FlexPageIndex.php | 48 + .../Framework/Flex/Pages/FlexPageObject.php | 496 ++ .../Flex/Pages/Traits/PageAuthorsTrait.php | 249 + .../Flex/Pages/Traits/PageContentTrait.php | 842 +++ .../Flex/Pages/Traits/PageLegacyTrait.php | 1124 +++ .../Flex/Pages/Traits/PageRoutableTrait.php | 550 ++ .../Flex/Pages/Traits/PageTranslateTrait.php | 291 + .../Storage/AbstractFilesystemStorage.php | 232 + .../Framework/Flex/Storage/FileStorage.php | 160 + .../Framework/Flex/Storage/FolderStorage.php | 708 ++ .../Framework/Flex/Storage/SimpleStorage.php | 507 ++ .../Flex/Traits/FlexAuthorizeTrait.php | 126 + .../Framework/Flex/Traits/FlexMediaTrait.php | 576 ++ .../Flex/Traits/FlexRelatedDirectoryTrait.php | 59 + .../Flex/Traits/FlexRelationshipsTrait.php | 61 + system/src/Grav/Framework/Form/FormFlash.php | 586 ++ .../src/Grav/Framework/Form/FormFlashFile.php | 266 + .../Form/Interfaces/FormFactoryInterface.php | 42 + .../Form/Interfaces/FormFlashInterface.php | 181 + .../Form/Interfaces/FormInterface.php | 187 + .../Grav/Framework/Form/Traits/FormTrait.php | 897 +++ .../Framework/Interfaces/RenderInterface.php | 38 + .../Logger/Processors/UserProcessor.php | 34 + .../Interfaces/MediaCollectionInterface.php | 23 + .../Media/Interfaces/MediaInterface.php | 37 + .../Interfaces/MediaManipulationInterface.php | 33 + .../Media/Interfaces/MediaObjectInterface.php | 47 + .../Grav/Framework/Media/MediaIdentifier.php | 150 + .../src/Grav/Framework/Media/MediaObject.php | 215 + .../Framework/Media/UploadedMediaObject.php | 172 + system/src/Grav/Framework/Mime/MimeTypes.php | 107 + .../Object/Access/ArrayAccessTrait.php | 66 + .../Object/Access/NestedArrayAccessTrait.php | 66 + .../Access/NestedPropertyCollectionTrait.php | 120 + .../Object/Access/NestedPropertyTrait.php | 180 + .../Object/Access/OverloadedPropertyTrait.php | 66 + .../src/Grav/Framework/Object/ArrayObject.php | 31 + .../Object/Base/ObjectCollectionTrait.php | 377 + .../Framework/Object/Base/ObjectTrait.php | 202 + .../Collection/ObjectExpressionVisitor.php | 240 + .../Object/Identifiers/Identifier.php | 66 + .../NestedObjectCollectionInterface.php | 64 + .../Interfaces/NestedObjectInterface.php | 60 + .../Interfaces/ObjectCollectionInterface.php | 126 + .../Object/Interfaces/ObjectInterface.php | 63 + .../src/Grav/Framework/Object/LazyObject.php | 34 + .../Framework/Object/ObjectCollection.php | 131 + .../src/Grav/Framework/Object/ObjectIndex.php | 281 + .../Object/Property/ArrayPropertyTrait.php | 115 + .../Object/Property/LazyPropertyTrait.php | 114 + .../Object/Property/MixedPropertyTrait.php | 121 + .../Object/Property/ObjectPropertyTrait.php | 213 + .../Grav/Framework/Object/PropertyObject.php | 32 + .../Pagination/AbstractPagination.php | 429 ++ .../Pagination/AbstractPaginationPage.php | 78 + .../Interfaces/PaginationInterface.php | 104 + .../Interfaces/PaginationPageInterface.php | 47 + .../Grav/Framework/Pagination/Pagination.php | 32 + .../Framework/Pagination/PaginationPage.php | 26 + .../src/Grav/Framework/Psr7/AbstractUri.php | 412 ++ system/src/Grav/Framework/Psr7/Request.php | 34 + system/src/Grav/Framework/Psr7/Response.php | 265 + .../src/Grav/Framework/Psr7/ServerRequest.php | 364 + system/src/Grav/Framework/Psr7/Stream.php | 43 + .../Psr7/Traits/MessageDecoratorTrait.php | 140 + .../Psr7/Traits/RequestDecoratorTrait.php | 112 + .../Psr7/Traits/ResponseDecoratorTrait.php | 82 + .../Traits/ServerRequestDecoratorTrait.php | 176 + .../Psr7/Traits/StreamDecoratorTrait.php | 153 + .../Traits/UploadedFileDecoratorTrait.php | 73 + .../Psr7/Traits/UriDecorationTrait.php | 188 + .../src/Grav/Framework/Psr7/UploadedFile.php | 70 + system/src/Grav/Framework/Psr7/Uri.php | 135 + .../Framework/Relationships/Relationships.php | 217 + .../Relationships/ToManyRelationship.php | 259 + .../Relationships/ToOneRelationship.php | 207 + .../Traits/RelationshipTrait.php | 128 + .../Exception/InvalidArgumentException.php | 49 + .../Exception/NotFoundException.php | 37 + .../Exception/NotHandledException.php | 20 + .../Exception/PageExpiredException.php | 32 + .../Exception/RequestException.php | 102 + .../RequestHandler/Middlewares/Exceptions.php | 78 + .../Middlewares/MultipartRequestSupport.php | 123 + .../RequestHandler/RequestHandler.php | 80 + .../Traits/RequestHandlerTrait.php | 64 + system/src/Grav/Framework/Route/Route.php | 452 ++ .../src/Grav/Framework/Route/RouteFactory.php | 236 + .../Session/Exceptions/SessionException.php | 20 + .../src/Grav/Framework/Session/Messages.php | 134 + system/src/Grav/Framework/Session/Session.php | 562 ++ .../Framework/Session/SessionInterface.php | 159 + system/src/Grav/Framework/Uri/Uri.php | 216 + system/src/Grav/Framework/Uri/UriFactory.php | 171 + .../src/Grav/Framework/Uri/UriPartsFilter.php | 145 + system/src/Grav/Installer/Install.php | 400 + .../src/Grav/Installer/InstallException.php | 29 + system/src/Grav/Installer/VersionUpdate.php | 83 + system/src/Grav/Installer/VersionUpdater.php | 133 + system/src/Grav/Installer/Versions.php | 329 + system/src/Grav/Installer/YamlUpdater.php | 431 ++ .../Installer/updates/1.7.0_2020-11-20_1.php | 24 + .../DeferredExtension/DeferredBlockNode.php | 43 + .../DeferredExtension/DeferredDeclareNode.php | 27 + .../DeferredExtension/DeferredExtension.php | 72 + .../DeferredInitializeNode.php | 27 + .../Twig/DeferredExtension/DeferredNode.php | 27 + .../DeferredExtension/DeferredNodeVisitor.php | 50 + .../DeferredNodeVisitorCompat.php | 67 + .../DeferredExtension/DeferredResolveNode.php | 27 + .../DeferredExtension/DeferredTokenParser.php | 77 + system/templates/default.html.twig | 4 + system/templates/external.html.twig | 1 + system/templates/flex/404.html.twig | 4 + .../flex/_default/collection/debug.html.twig | 5 + .../flex/_default/object/debug.html.twig | 4 + system/templates/modular/default.html.twig | 4 + system/templates/partials/messages.html.twig | 14 + system/templates/partials/metadata.html.twig | 3 + tests/_bootstrap.php | 35 + tests/_support/AcceptanceTester.php | 26 + tests/_support/FunctionalTester.php | 26 + tests/_support/Helper/Acceptance.php | 10 + tests/_support/Helper/Functional.php | 10 + tests/_support/Helper/Unit.php | 90 + tests/_support/UnitTester.php | 26 + tests/acceptance.suite.yml | 12 + tests/acceptance/_bootstrap.php | 2 + .../01.item1-1/01.item1-1-1/default.md | 10 + .../01.item1-1/02.item1-1-2/default.md | 10 + .../01.item1-1/03.item1-1-3/default.md | 10 + .../user/pages/01.item1/01.item1-1/default.md | 10 + .../02.item1-2/01.item1-2-1/default.md | 10 + .../02.item1-2/02.item1-2-2/default.md | 10 + .../02.item1-2/03.item1-2-3/default.md | 10 + .../user/pages/01.item1/02.item1-2/default.md | 10 + .../03.item1-3/01.item1-3-1/default.md | 10 + .../03.item1-3/02.item1-3-2/default.md | 10 + .../03.item1-3/03.item1-3-3/default.md | 10 + .../user/pages/01.item1/03.item1-3/default.md | 10 + .../user/pages/01.item1/default.md | 10 + .../user/pages/01.item1/existing-file.zip | Bin 0 -> 451 bytes .../user/pages/01.item1/home-cache-image.jpg | Bin 0 -> 156699 bytes .../user/pages/01.item1/home-sample-image.jpg | Bin 0 -> 156699 bytes .../01.item2-1/01.item2-1-1/default.md | 10 + .../01.item2-1/02.item2-1-2/default.md | 10 + .../01.item2-1/03.item2-1-3/default.md | 10 + .../user/pages/02.item2/01.item2-1/default.md | 10 + .../02.item2-2/01.item2-2-1/default.md | 10 + .../02.item2-2/02.item2-2-2/default.md | 10 + .../02.item2-2/03.item2-2-3/default.md | 10 + .../pages/02.item2/02.item2-2/cache-image.jpg | Bin 0 -> 156699 bytes .../user/pages/02.item2/02.item2-2/default.md | 10 + .../02.item2/02.item2-2/existing-file.zip | Bin 0 -> 451 bytes .../02.item2/02.item2-2/sample-image.jpg | Bin 0 -> 156699 bytes .../03.item2-3/01.item2-3-1/default.md | 10 + .../03.item2-3/02.item2-3-2/default.md | 10 + .../03.item2-3/03.item2-3-3/default.md | 10 + .../user/pages/02.item2/03.item2-3/default.md | 10 + .../user/pages/02.item2/default.md | 10 + .../01.item3-1/01.item3-1-1/default.md | 14 + .../01.item3-1/02.item3-1-2/default.md | 10 + .../01.item3-1/03.item3-1-3/default.md | 10 + .../user/pages/03.item3/01.item3-1/default.md | 10 + .../02.item3-2/01.item3-2-1/default.md | 10 + .../02.item3-2/02.item3-2-2/default.md | 10 + .../02.item3-2/03.item3-2-3/default.md | 10 + .../user/pages/03.item3/02.item3-2/default.md | 10 + .../03.item3-3/01.item3-3-1/default.md | 10 + .../03.item3-3/02.item3-3-2/default.md | 10 + .../03.item3-3/03.item3-3-3/default.md | 10 + .../user/pages/03.item3/03.item3-3/default.md | 10 + .../user/pages/03.item3/default.md | 10 + .../simple-site/user/pages/01.home/default.md | 10 + .../simple-site/user/pages/02.blog/blog.md | 10 + .../user/pages/02.blog/post-one/item.md | 10 + .../user/pages/02.blog/post-two/item.md | 10 + .../user/pages/03.about/default.md | 10 + .../pages/04.page-translated/default.en.md | 0 .../pages/04.page-translated/default.fr.md | 5 + .../05.translatedlong/part2/default.en.md | 0 .../05.translatedlong/part2/default.fr.md | 5 + .../user/pages/01.simple-page/default.en.md | 0 .../user/pages/01.simple-page/default.fr.md | 5 + .../single-pages/01.simple-page/default.md | 5 + tests/functional.suite.yml | 11 + .../Grav/Console/DirectInstallCommandTest.php | 38 + tests/functional/_bootstrap.php | 2 + .../UniformResourceLocatorExtension.php | 51 + tests/phpstan/extension.neon | 5 + tests/phpstan/phpstan-bootstrap.php | 7 + tests/phpstan/phpstan.neon | 175 + tests/phpstan/plugins-bootstrap.php | 64 + tests/phpstan/plugins.neon | 70 + tests/unit.suite.yml | 9 + tests/unit/Grav/Common/AssetsTest.php | 847 +++ tests/unit/Grav/Common/BrowserTest.php | 51 + tests/unit/Grav/Common/ComposerTest.php | 31 + tests/unit/Grav/Common/Data/BlueprintTest.php | 72 + tests/unit/Grav/Common/GPM/GPMTest.php | 329 + .../unit/Grav/Common/Helpers/ExcerptsTest.php | 120 + tests/unit/Grav/Common/InflectorTest.php | 145 + .../Common/Language/LanguageCodesTest.php | 27 + .../Grav/Common/Markdown/ParsedownTest.php | 1260 ++++ tests/unit/Grav/Common/Page/PagesTest.php | 299 + .../Twig/Extensions/GravExtensionTest.php | 202 + tests/unit/Grav/Common/UriTest.php | 1152 +++ tests/unit/Grav/Common/UtilsTest.php | 572 ++ .../Grav/Console/Gpm/InstallCommandTest.php | 28 + .../File/Formatter/CsvFormatterTest.php | 48 + .../Framework/Filesystem/FilesystemTest.php | 338 + tests/unit/_bootstrap.php | 3 + tests/unit/data/blueprints/strict.yaml | 15 + tmp/.gitkeep | 1 + user/accounts/.gitkeep | 1 + user/config/media.yaml | 0 user/config/site.yaml | 19 + user/config/system.yaml | 236 + user/config/themes/ateliers-55.yaml | 3 + user/data/.gitkeep | 1 + user/pages/01.home/default.md | 10 + .../article-1/cat-8436843_1280.jpg | Bin 0 -> 212962 bytes user/pages/02.articles/article-1/default.md | 9 + .../article-1/forsythia-8595521_1280.jpg | Bin 0 -> 113878 bytes .../article-1/labrador-8554882_1280.jpg | Bin 0 -> 147256 bytes .../article-1/lake-8357182_1280.jpg | Bin 0 -> 267148 bytes .../article-1/landscape-8592826_1280.jpg | Bin 0 -> 453685 bytes user/pages/02.articles/article-2/default.md | 9 + .../article-2/mountains-8497575_1280.jpg | Bin 0 -> 335245 bytes .../article-2/nuts-8585063_1280.jpg | Bin 0 -> 242355 bytes .../article-2/sparrow-8387465_1280.jpg | Bin 0 -> 249309 bytes user/pages/02.articles/article-3/default.md | 7 + .../article-3/lake-8357182_1280.jpg | Bin 0 -> 267148 bytes .../article-3/landscape-8592826_1280.jpg | Bin 0 -> 453685 bytes .../article-3/mountains-8497575_1280.jpg | Bin 0 -> 335245 bytes .../article-3/nuts-8585063_1280.jpg | Bin 0 -> 242355 bytes .../article-4/cat-8436843_1280.jpg | Bin 0 -> 212962 bytes user/pages/02.articles/article-4/default.md | 7 + .../article-4/forsythia-8595521_1280.jpg | Bin 0 -> 113878 bytes .../article-4/labrador-8554882_1280.jpg | Bin 0 -> 147256 bytes user/pages/02.articles/article-5/default.md | 7 + .../article-5/lake-8357182_1280.jpg | Bin 0 -> 267148 bytes .../article-5/mountains-8497575_1280.jpg | Bin 0 -> 335245 bytes .../article-5/sparrow-8387465_1280.jpg | Bin 0 -> 249309 bytes user/pages/02.articles/default.md | 9 + user/pages/03.mentions-legales/default.md | 5 + user/pages/04.contact/default.md | 5 + user/plugins/.gitkeep | 1 + user/themes/.gitkeep | 1 + webserver-configs/Caddyfile | 31 + webserver-configs/Caddyfile-0.8.x | 33 + webserver-configs/htaccess.txt | 78 + webserver-configs/lighttpd.conf | 48 + webserver-configs/nginx.conf | 44 + webserver-configs/web.config | 42 + 922 files changed, 133572 insertions(+) create mode 100644 .dependencies create mode 100644 .editorconfig create mode 100644 .github/FUNDING.yml create mode 100644 .github/workflows/build.yaml create mode 100644 .github/workflows/tests.yaml create mode 100644 .github/workflows/trigger-skeletons.yml create mode 100644 .gitignore create mode 100644 .htaccess create mode 100644 .phan/config.php create mode 100644 .phan/internal_stubs/Redis.phan_php create mode 100644 .phan/internal_stubs/memcache.phan_php create mode 100644 .phan/internal_stubs/memcached.phan_php create mode 100644 .travis.yml create mode 100644 CHANGELOG.md create mode 100644 CODE_OF_CONDUCT.md create mode 100644 CONTRIBUTING.md create mode 100644 LICENSE.txt create mode 100644 README.md create mode 100644 SECURITY.md create mode 100644 assets/.gitkeep create mode 100644 backup/.gitkeep create mode 100755 bin/composer.phar create mode 100755 bin/gpm create mode 100755 bin/grav create mode 100755 bin/plugin create mode 100644 cache/.gitkeep create mode 100644 codeception.yml create mode 100644 composer.json create mode 100644 composer.lock create mode 100644 images/.gitkeep create mode 100644 index.php create mode 100644 logs/.gitkeep create mode 100644 now.json create mode 100644 robots.txt create mode 100644 system/assets/debugger/clockwork.css create mode 100644 system/assets/debugger/clockwork.js create mode 100644 system/assets/debugger/phpdebugbar.css create mode 100644 system/assets/grav.png create mode 100644 system/assets/jquery/jquery-2.1.4.min.js create mode 100644 system/assets/jquery/jquery-2.x.min.js create mode 100644 system/assets/jquery/jquery-3.x.min.js create mode 100644 system/assets/responsive-overlays/1x.png create mode 100644 system/assets/responsive-overlays/2x.png create mode 100644 system/assets/responsive-overlays/3x.png create mode 100644 system/assets/responsive-overlays/4x.png create mode 100644 system/assets/responsive-overlays/unknown.png create mode 100644 system/assets/whoops.css create mode 100644 system/blueprints/config/backups.yaml create mode 100644 system/blueprints/config/media.yaml create mode 100644 system/blueprints/config/scheduler.yaml create mode 100644 system/blueprints/config/security.yaml create mode 100644 system/blueprints/config/site.yaml create mode 100644 system/blueprints/config/streams.yaml create mode 100644 system/blueprints/config/system.yaml create mode 100644 system/blueprints/flex/accounts.yaml create mode 100644 system/blueprints/flex/configure/compat.yaml create mode 100644 system/blueprints/flex/pages.yaml create mode 100644 system/blueprints/flex/shared/configure.yaml create mode 100644 system/blueprints/flex/user-accounts.yaml create mode 100644 system/blueprints/flex/user-groups.yaml create mode 100644 system/blueprints/pages/default.yaml create mode 100644 system/blueprints/pages/external.yaml create mode 100644 system/blueprints/pages/modular.yaml create mode 100644 system/blueprints/pages/partials/security.yaml create mode 100644 system/blueprints/pages/root.yaml create mode 100644 system/blueprints/user/account.yaml create mode 100644 system/blueprints/user/account_new.yaml create mode 100644 system/blueprints/user/group.yaml create mode 100644 system/blueprints/user/group_new.yaml create mode 100644 system/config/backups.yaml create mode 100644 system/config/media.yaml create mode 100644 system/config/mime.yaml create mode 100644 system/config/permissions.yaml create mode 100644 system/config/security.yaml create mode 100644 system/config/site.yaml create mode 100644 system/config/system.yaml create mode 100644 system/defines.php create mode 100644 system/images/media/thumb-3dm.png create mode 100644 system/images/media/thumb-3ds.png create mode 100644 system/images/media/thumb-3g2.png create mode 100644 system/images/media/thumb-3gp.png create mode 100644 system/images/media/thumb-7z.png create mode 100644 system/images/media/thumb-aac.png create mode 100644 system/images/media/thumb-ai.png create mode 100644 system/images/media/thumb-aif.png create mode 100644 system/images/media/thumb-apk.png create mode 100644 system/images/media/thumb-app.png create mode 100644 system/images/media/thumb-asf.png create mode 100644 system/images/media/thumb-asp.png create mode 100644 system/images/media/thumb-aspx.png create mode 100644 system/images/media/thumb-asx.png create mode 100644 system/images/media/thumb-avi.png create mode 100644 system/images/media/thumb-bak.png create mode 100644 system/images/media/thumb-bat.png create mode 100644 system/images/media/thumb-bin.png create mode 100644 system/images/media/thumb-bmp.png create mode 100644 system/images/media/thumb-cab.png create mode 100644 system/images/media/thumb-cad.png create mode 100644 system/images/media/thumb-cdr.png create mode 100644 system/images/media/thumb-cer.png create mode 100644 system/images/media/thumb-cfg.png create mode 100644 system/images/media/thumb-cfm.png create mode 100644 system/images/media/thumb-cgi.png create mode 100644 system/images/media/thumb-com.png create mode 100644 system/images/media/thumb-cpl.png create mode 100644 system/images/media/thumb-cpp.png create mode 100644 system/images/media/thumb-crx.png create mode 100644 system/images/media/thumb-csr.png create mode 100644 system/images/media/thumb-css.png create mode 100644 system/images/media/thumb-csv.png create mode 100644 system/images/media/thumb-cue.png create mode 100644 system/images/media/thumb-cur.png create mode 100644 system/images/media/thumb-dat.png create mode 100644 system/images/media/thumb-db.png create mode 100644 system/images/media/thumb-dbf.png create mode 100644 system/images/media/thumb-dds.png create mode 100644 system/images/media/thumb-dem.png create mode 100644 system/images/media/thumb-dll.png create mode 100644 system/images/media/thumb-dmg.png create mode 100644 system/images/media/thumb-dmp.png create mode 100644 system/images/media/thumb-doc.png create mode 100644 system/images/media/thumb-docx.png create mode 100644 system/images/media/thumb-drv.png create mode 100644 system/images/media/thumb-dtd.png create mode 100644 system/images/media/thumb-dwg.png create mode 100644 system/images/media/thumb-dxf.png create mode 100644 system/images/media/thumb-elf.png create mode 100644 system/images/media/thumb-eot.png create mode 100644 system/images/media/thumb-eps.png create mode 100644 system/images/media/thumb-exe.png create mode 100644 system/images/media/thumb-fla.png create mode 100644 system/images/media/thumb-flv.png create mode 100644 system/images/media/thumb-fnt.png create mode 100644 system/images/media/thumb-fon.png create mode 100644 system/images/media/thumb-gam.png create mode 100644 system/images/media/thumb-gbr.png create mode 100644 system/images/media/thumb-ged.png create mode 100644 system/images/media/thumb-gif.png create mode 100644 system/images/media/thumb-gpx.png create mode 100644 system/images/media/thumb-gz.png create mode 100644 system/images/media/thumb-gzip.png create mode 100644 system/images/media/thumb-hqz.png create mode 100644 system/images/media/thumb-html.png create mode 100644 system/images/media/thumb-icns.png create mode 100644 system/images/media/thumb-ico.png create mode 100644 system/images/media/thumb-ics.png create mode 100644 system/images/media/thumb-iff.png create mode 100644 system/images/media/thumb-indd.png create mode 100644 system/images/media/thumb-iso.png create mode 100644 system/images/media/thumb-jar.png create mode 100644 system/images/media/thumb-jpg.png create mode 100644 system/images/media/thumb-js.png create mode 100644 system/images/media/thumb-json.png create mode 100644 system/images/media/thumb-jsp.png create mode 100644 system/images/media/thumb-key.png create mode 100644 system/images/media/thumb-kml.png create mode 100644 system/images/media/thumb-kmz.png create mode 100644 system/images/media/thumb-lnk.png create mode 100644 system/images/media/thumb-log.png create mode 100644 system/images/media/thumb-lua.png create mode 100644 system/images/media/thumb-m3u.png create mode 100644 system/images/media/thumb-m4a.png create mode 100644 system/images/media/thumb-m4v.png create mode 100644 system/images/media/thumb-max.png create mode 100644 system/images/media/thumb-mdb.png create mode 100644 system/images/media/thumb-mdf.png create mode 100644 system/images/media/thumb-mid.png create mode 100644 system/images/media/thumb-mim.png create mode 100644 system/images/media/thumb-mov.png create mode 100644 system/images/media/thumb-mp3.png create mode 100644 system/images/media/thumb-mp4.png create mode 100644 system/images/media/thumb-mpa.png create mode 100644 system/images/media/thumb-mpe.png create mode 100644 system/images/media/thumb-mpg.png create mode 100644 system/images/media/thumb-msg.png create mode 100644 system/images/media/thumb-msi.png create mode 100644 system/images/media/thumb-nes.png create mode 100644 system/images/media/thumb-obj.png create mode 100644 system/images/media/thumb-odb.png create mode 100644 system/images/media/thumb-odc.png create mode 100644 system/images/media/thumb-odf.png create mode 100644 system/images/media/thumb-odg.png create mode 100644 system/images/media/thumb-odi.png create mode 100644 system/images/media/thumb-odp.png create mode 100644 system/images/media/thumb-ods.png create mode 100644 system/images/media/thumb-odt.png create mode 100644 system/images/media/thumb-odx.png create mode 100644 system/images/media/thumb-ogg.png create mode 100644 system/images/media/thumb-pct.png create mode 100644 system/images/media/thumb-pdb.png create mode 100644 system/images/media/thumb-pdf.png create mode 100644 system/images/media/thumb-pif.png create mode 100644 system/images/media/thumb-pkg.png create mode 100644 system/images/media/thumb-pl.png create mode 100644 system/images/media/thumb-png.png create mode 100644 system/images/media/thumb-pps.png create mode 100644 system/images/media/thumb-ppt.png create mode 100644 system/images/media/thumb-pptx.png create mode 100644 system/images/media/thumb-ps.png create mode 100644 system/images/media/thumb-psd.png create mode 100644 system/images/media/thumb-pub.png create mode 100644 system/images/media/thumb-py.png create mode 100644 system/images/media/thumb-ra.png create mode 100644 system/images/media/thumb-rar.png create mode 100644 system/images/media/thumb-raw.png create mode 100644 system/images/media/thumb-rm.png create mode 100644 system/images/media/thumb-rom.png create mode 100644 system/images/media/thumb-rpm.png create mode 100644 system/images/media/thumb-rss.png create mode 100644 system/images/media/thumb-rtf.png create mode 100644 system/images/media/thumb-sav.png create mode 100644 system/images/media/thumb-sdf.png create mode 100644 system/images/media/thumb-sql.png create mode 100644 system/images/media/thumb-srt.png create mode 100644 system/images/media/thumb-svg.png create mode 100644 system/images/media/thumb-swf.png create mode 100644 system/images/media/thumb-sys.png create mode 100644 system/images/media/thumb-tar.png create mode 100644 system/images/media/thumb-tex.png create mode 100644 system/images/media/thumb-tga.png create mode 100644 system/images/media/thumb-thm.png create mode 100644 system/images/media/thumb-tiff.png create mode 100644 system/images/media/thumb-tmp.png create mode 100644 system/images/media/thumb-ttf.png create mode 100644 system/images/media/thumb-txt.png create mode 100644 system/images/media/thumb-uue.png create mode 100644 system/images/media/thumb-vb.png create mode 100644 system/images/media/thumb-vcd.png create mode 100644 system/images/media/thumb-vcf.png create mode 100644 system/images/media/thumb-wav.png create mode 100644 system/images/media/thumb-webm.png create mode 100644 system/images/media/thumb-wma.png create mode 100644 system/images/media/thumb-wmv.png create mode 100644 system/images/media/thumb-woff.png create mode 100644 system/images/media/thumb-woff2.png create mode 100644 system/images/media/thumb-wpd.png create mode 100644 system/images/media/thumb-wps.png create mode 100644 system/images/media/thumb-wsf.png create mode 100644 system/images/media/thumb-xls.png create mode 100644 system/images/media/thumb-xlsx.png create mode 100644 system/images/media/thumb-xml.png create mode 100644 system/images/media/thumb-yuv.png create mode 100644 system/images/media/thumb-zip.png create mode 100644 system/images/media/thumb.png create mode 100644 system/images/watermark.png create mode 100644 system/install.php create mode 100644 system/languages/ar.yaml create mode 100644 system/languages/bg.yaml create mode 100644 system/languages/ca.yaml create mode 100644 system/languages/cs.yaml create mode 100644 system/languages/da.yaml create mode 100644 system/languages/de.yaml create mode 100644 system/languages/el.yaml create mode 100644 system/languages/en.yaml create mode 100644 system/languages/eo.yaml create mode 100644 system/languages/es.yaml create mode 100644 system/languages/et.yaml create mode 100644 system/languages/eu.yaml create mode 100644 system/languages/fa.yaml create mode 100644 system/languages/fi.yaml create mode 100644 system/languages/fr.yaml create mode 100644 system/languages/gl.yaml create mode 100644 system/languages/he.yaml create mode 100644 system/languages/hr.yaml create mode 100644 system/languages/hu.yaml create mode 100644 system/languages/id.yaml create mode 100644 system/languages/is.yaml create mode 100644 system/languages/it.yaml create mode 100644 system/languages/ja.yaml create mode 100644 system/languages/ko.yaml create mode 100644 system/languages/lt.yaml create mode 100644 system/languages/lv.yaml create mode 100644 system/languages/mn.yaml create mode 100644 system/languages/my.yaml create mode 100644 system/languages/nb.yaml create mode 100644 system/languages/nl.yaml create mode 100644 system/languages/no.yaml create mode 100644 system/languages/pl.yaml create mode 100644 system/languages/pt.yaml create mode 100644 system/languages/ro.yaml create mode 100644 system/languages/ru.yaml create mode 100644 system/languages/si.yaml create mode 100644 system/languages/sk.yaml create mode 100644 system/languages/sl.yaml create mode 100644 system/languages/sr.yaml create mode 100644 system/languages/sv.yaml create mode 100644 system/languages/sw.yaml create mode 100644 system/languages/th.yaml create mode 100644 system/languages/tr.yaml create mode 100644 system/languages/uk.yaml create mode 100644 system/languages/vi.yaml create mode 100644 system/languages/zh-cn.yaml create mode 100644 system/languages/zh-tw.yaml create mode 100644 system/languages/zh.yaml create mode 100644 system/pages/notfound.md create mode 100644 system/router.php create mode 100644 system/src/DOMLettersIterator.php create mode 100644 system/src/DOMWordsIterator.php create mode 100644 system/src/Grav/Common/Assets.php create mode 100644 system/src/Grav/Common/Assets/BaseAsset.php create mode 100644 system/src/Grav/Common/Assets/BlockAssets.php create mode 100644 system/src/Grav/Common/Assets/Css.php create mode 100644 system/src/Grav/Common/Assets/InlineCss.php create mode 100644 system/src/Grav/Common/Assets/InlineJs.php create mode 100644 system/src/Grav/Common/Assets/InlineJsModule.php create mode 100644 system/src/Grav/Common/Assets/Js.php create mode 100644 system/src/Grav/Common/Assets/JsModule.php create mode 100644 system/src/Grav/Common/Assets/Link.php create mode 100644 system/src/Grav/Common/Assets/Pipeline.php create mode 100644 system/src/Grav/Common/Assets/Traits/AssetUtilsTrait.php create mode 100644 system/src/Grav/Common/Assets/Traits/LegacyAssetsTrait.php create mode 100644 system/src/Grav/Common/Assets/Traits/TestingAssetsTrait.php create mode 100644 system/src/Grav/Common/Backup/Backups.php create mode 100644 system/src/Grav/Common/Browser.php create mode 100644 system/src/Grav/Common/Cache.php create mode 100644 system/src/Grav/Common/Composer.php create mode 100644 system/src/Grav/Common/Config/CompiledBase.php create mode 100644 system/src/Grav/Common/Config/CompiledBlueprints.php create mode 100644 system/src/Grav/Common/Config/CompiledConfig.php create mode 100644 system/src/Grav/Common/Config/CompiledLanguages.php create mode 100644 system/src/Grav/Common/Config/Config.php create mode 100644 system/src/Grav/Common/Config/ConfigFileFinder.php create mode 100644 system/src/Grav/Common/Config/Languages.php create mode 100644 system/src/Grav/Common/Config/Setup.php create mode 100644 system/src/Grav/Common/Data/Blueprint.php create mode 100644 system/src/Grav/Common/Data/BlueprintSchema.php create mode 100644 system/src/Grav/Common/Data/Blueprints.php create mode 100644 system/src/Grav/Common/Data/Data.php create mode 100644 system/src/Grav/Common/Data/DataInterface.php create mode 100644 system/src/Grav/Common/Data/Validation.php create mode 100644 system/src/Grav/Common/Data/ValidationException.php create mode 100644 system/src/Grav/Common/Debugger.php create mode 100644 system/src/Grav/Common/Errors/BareHandler.php create mode 100644 system/src/Grav/Common/Errors/Errors.php create mode 100644 system/src/Grav/Common/Errors/Resources/error.css create mode 100644 system/src/Grav/Common/Errors/Resources/layout.html.php create mode 100644 system/src/Grav/Common/Errors/SimplePageHandler.php create mode 100644 system/src/Grav/Common/Errors/SystemFacade.php create mode 100644 system/src/Grav/Common/File/CompiledFile.php create mode 100644 system/src/Grav/Common/File/CompiledJsonFile.php create mode 100644 system/src/Grav/Common/File/CompiledMarkdownFile.php create mode 100644 system/src/Grav/Common/File/CompiledYamlFile.php create mode 100644 system/src/Grav/Common/Filesystem/Archiver.php create mode 100644 system/src/Grav/Common/Filesystem/Folder.php create mode 100644 system/src/Grav/Common/Filesystem/RecursiveDirectoryFilterIterator.php create mode 100644 system/src/Grav/Common/Filesystem/RecursiveFolderFilterIterator.php create mode 100644 system/src/Grav/Common/Filesystem/ZipArchiver.php create mode 100644 system/src/Grav/Common/Flex/FlexCollection.php create mode 100644 system/src/Grav/Common/Flex/FlexIndex.php create mode 100644 system/src/Grav/Common/Flex/FlexObject.php create mode 100644 system/src/Grav/Common/Flex/Traits/FlexCollectionTrait.php create mode 100644 system/src/Grav/Common/Flex/Traits/FlexCommonTrait.php create mode 100644 system/src/Grav/Common/Flex/Traits/FlexGravTrait.php create mode 100644 system/src/Grav/Common/Flex/Traits/FlexIndexTrait.php create mode 100644 system/src/Grav/Common/Flex/Traits/FlexObjectTrait.php create mode 100644 system/src/Grav/Common/Flex/Types/Generic/GenericCollection.php create mode 100644 system/src/Grav/Common/Flex/Types/Generic/GenericIndex.php create mode 100644 system/src/Grav/Common/Flex/Types/Generic/GenericObject.php create mode 100644 system/src/Grav/Common/Flex/Types/Pages/PageCollection.php create mode 100644 system/src/Grav/Common/Flex/Types/Pages/PageIndex.php create mode 100644 system/src/Grav/Common/Flex/Types/Pages/PageObject.php create mode 100644 system/src/Grav/Common/Flex/Types/Pages/Storage/PageStorage.php create mode 100644 system/src/Grav/Common/Flex/Types/Pages/Traits/PageContentTrait.php create mode 100644 system/src/Grav/Common/Flex/Types/Pages/Traits/PageLegacyTrait.php create mode 100644 system/src/Grav/Common/Flex/Types/Pages/Traits/PageRoutableTrait.php create mode 100644 system/src/Grav/Common/Flex/Types/Pages/Traits/PageTranslateTrait.php create mode 100644 system/src/Grav/Common/Flex/Types/UserGroups/UserGroupCollection.php create mode 100644 system/src/Grav/Common/Flex/Types/UserGroups/UserGroupIndex.php create mode 100644 system/src/Grav/Common/Flex/Types/UserGroups/UserGroupObject.php create mode 100644 system/src/Grav/Common/Flex/Types/Users/Storage/UserFileStorage.php create mode 100644 system/src/Grav/Common/Flex/Types/Users/Storage/UserFolderStorage.php create mode 100644 system/src/Grav/Common/Flex/Types/Users/Traits/UserObjectLegacyTrait.php create mode 100644 system/src/Grav/Common/Flex/Types/Users/UserCollection.php create mode 100644 system/src/Grav/Common/Flex/Types/Users/UserIndex.php create mode 100644 system/src/Grav/Common/Flex/Types/Users/UserObject.php create mode 100644 system/src/Grav/Common/Form/FormFlash.php create mode 100644 system/src/Grav/Common/GPM/AbstractCollection.php create mode 100644 system/src/Grav/Common/GPM/Common/AbstractPackageCollection.php create mode 100644 system/src/Grav/Common/GPM/Common/CachedCollection.php create mode 100644 system/src/Grav/Common/GPM/Common/Package.php create mode 100644 system/src/Grav/Common/GPM/GPM.php create mode 100644 system/src/Grav/Common/GPM/Installer.php create mode 100644 system/src/Grav/Common/GPM/Licenses.php create mode 100644 system/src/Grav/Common/GPM/Local/AbstractPackageCollection.php create mode 100644 system/src/Grav/Common/GPM/Local/Package.php create mode 100644 system/src/Grav/Common/GPM/Local/Packages.php create mode 100644 system/src/Grav/Common/GPM/Local/Plugins.php create mode 100644 system/src/Grav/Common/GPM/Local/Themes.php create mode 100644 system/src/Grav/Common/GPM/Remote/AbstractPackageCollection.php create mode 100644 system/src/Grav/Common/GPM/Remote/GravCore.php create mode 100644 system/src/Grav/Common/GPM/Remote/Package.php create mode 100644 system/src/Grav/Common/GPM/Remote/Packages.php create mode 100644 system/src/Grav/Common/GPM/Remote/Plugins.php create mode 100644 system/src/Grav/Common/GPM/Remote/Themes.php create mode 100644 system/src/Grav/Common/GPM/Response.php create mode 100644 system/src/Grav/Common/GPM/Upgrader.php create mode 100644 system/src/Grav/Common/Getters.php create mode 100644 system/src/Grav/Common/Grav.php create mode 100644 system/src/Grav/Common/GravTrait.php create mode 100644 system/src/Grav/Common/HTTP/Client.php create mode 100644 system/src/Grav/Common/HTTP/Response.php create mode 100644 system/src/Grav/Common/Helpers/Base32.php create mode 100644 system/src/Grav/Common/Helpers/Excerpts.php create mode 100644 system/src/Grav/Common/Helpers/Exif.php create mode 100644 system/src/Grav/Common/Helpers/LogViewer.php create mode 100644 system/src/Grav/Common/Helpers/Truncator.php create mode 100644 system/src/Grav/Common/Helpers/YamlLinter.php create mode 100644 system/src/Grav/Common/Inflector.php create mode 100644 system/src/Grav/Common/Iterator.php create mode 100644 system/src/Grav/Common/Language/Language.php create mode 100644 system/src/Grav/Common/Language/LanguageCodes.php create mode 100644 system/src/Grav/Common/Markdown/Parsedown.php create mode 100644 system/src/Grav/Common/Markdown/ParsedownExtra.php create mode 100644 system/src/Grav/Common/Markdown/ParsedownGravTrait.php create mode 100644 system/src/Grav/Common/Media/Interfaces/AudioMediaInterface.php create mode 100644 system/src/Grav/Common/Media/Interfaces/ImageManipulateInterface.php create mode 100644 system/src/Grav/Common/Media/Interfaces/ImageMediaInterface.php create mode 100644 system/src/Grav/Common/Media/Interfaces/MediaCollectionInterface.php create mode 100644 system/src/Grav/Common/Media/Interfaces/MediaFileInterface.php create mode 100644 system/src/Grav/Common/Media/Interfaces/MediaInterface.php create mode 100644 system/src/Grav/Common/Media/Interfaces/MediaLinkInterface.php create mode 100644 system/src/Grav/Common/Media/Interfaces/MediaObjectInterface.php create mode 100644 system/src/Grav/Common/Media/Interfaces/MediaPlayerInterface.php create mode 100644 system/src/Grav/Common/Media/Interfaces/MediaUploadInterface.php create mode 100644 system/src/Grav/Common/Media/Interfaces/VideoMediaInterface.php create mode 100644 system/src/Grav/Common/Media/Traits/AudioMediaTrait.php create mode 100644 system/src/Grav/Common/Media/Traits/ImageLoadingTrait.php create mode 100644 system/src/Grav/Common/Media/Traits/ImageMediaTrait.php create mode 100644 system/src/Grav/Common/Media/Traits/MediaFileTrait.php create mode 100644 system/src/Grav/Common/Media/Traits/MediaObjectTrait.php create mode 100644 system/src/Grav/Common/Media/Traits/MediaPlayerTrait.php create mode 100644 system/src/Grav/Common/Media/Traits/MediaTrait.php create mode 100644 system/src/Grav/Common/Media/Traits/MediaUploadTrait.php create mode 100644 system/src/Grav/Common/Media/Traits/StaticResizeTrait.php create mode 100644 system/src/Grav/Common/Media/Traits/ThumbnailMediaTrait.php create mode 100644 system/src/Grav/Common/Media/Traits/VideoMediaTrait.php create mode 100644 system/src/Grav/Common/Page/Collection.php create mode 100644 system/src/Grav/Common/Page/Header.php create mode 100644 system/src/Grav/Common/Page/Interfaces/PageCollectionInterface.php create mode 100644 system/src/Grav/Common/Page/Interfaces/PageContentInterface.php create mode 100644 system/src/Grav/Common/Page/Interfaces/PageFormInterface.php create mode 100644 system/src/Grav/Common/Page/Interfaces/PageInterface.php create mode 100644 system/src/Grav/Common/Page/Interfaces/PageLegacyInterface.php create mode 100644 system/src/Grav/Common/Page/Interfaces/PageRoutableInterface.php create mode 100644 system/src/Grav/Common/Page/Interfaces/PageTranslateInterface.php create mode 100644 system/src/Grav/Common/Page/Interfaces/PagesSourceInterface.php create mode 100644 system/src/Grav/Common/Page/Markdown/Excerpts.php create mode 100644 system/src/Grav/Common/Page/Media.php create mode 100644 system/src/Grav/Common/Page/Medium/AbstractMedia.php create mode 100644 system/src/Grav/Common/Page/Medium/AudioMedium.php create mode 100644 system/src/Grav/Common/Page/Medium/GlobalMedia.php create mode 100644 system/src/Grav/Common/Page/Medium/ImageFile.php create mode 100644 system/src/Grav/Common/Page/Medium/ImageMedium.php create mode 100644 system/src/Grav/Common/Page/Medium/Link.php create mode 100644 system/src/Grav/Common/Page/Medium/Medium.php create mode 100644 system/src/Grav/Common/Page/Medium/MediumFactory.php create mode 100644 system/src/Grav/Common/Page/Medium/ParsedownHtmlTrait.php create mode 100644 system/src/Grav/Common/Page/Medium/RenderableInterface.php create mode 100644 system/src/Grav/Common/Page/Medium/StaticImageMedium.php create mode 100644 system/src/Grav/Common/Page/Medium/StaticResizeTrait.php create mode 100644 system/src/Grav/Common/Page/Medium/ThumbnailImageMedium.php create mode 100644 system/src/Grav/Common/Page/Medium/VectorImageMedium.php create mode 100644 system/src/Grav/Common/Page/Medium/VideoMedium.php create mode 100644 system/src/Grav/Common/Page/Page.php create mode 100644 system/src/Grav/Common/Page/Pages.php create mode 100644 system/src/Grav/Common/Page/Traits/PageFormTrait.php create mode 100644 system/src/Grav/Common/Page/Types.php create mode 100644 system/src/Grav/Common/Plugin.php create mode 100644 system/src/Grav/Common/Plugins.php create mode 100644 system/src/Grav/Common/Processors/AssetsProcessor.php create mode 100644 system/src/Grav/Common/Processors/BackupsProcessor.php create mode 100644 system/src/Grav/Common/Processors/DebuggerAssetsProcessor.php create mode 100644 system/src/Grav/Common/Processors/Events/RequestHandlerEvent.php create mode 100644 system/src/Grav/Common/Processors/InitializeProcessor.php create mode 100644 system/src/Grav/Common/Processors/PagesProcessor.php create mode 100644 system/src/Grav/Common/Processors/PluginsProcessor.php create mode 100644 system/src/Grav/Common/Processors/ProcessorBase.php create mode 100644 system/src/Grav/Common/Processors/ProcessorInterface.php create mode 100644 system/src/Grav/Common/Processors/RenderProcessor.php create mode 100644 system/src/Grav/Common/Processors/RequestProcessor.php create mode 100644 system/src/Grav/Common/Processors/SchedulerProcessor.php create mode 100644 system/src/Grav/Common/Processors/TasksProcessor.php create mode 100644 system/src/Grav/Common/Processors/ThemesProcessor.php create mode 100644 system/src/Grav/Common/Processors/TwigProcessor.php create mode 100644 system/src/Grav/Common/Scheduler/Cron.php create mode 100644 system/src/Grav/Common/Scheduler/IntervalTrait.php create mode 100644 system/src/Grav/Common/Scheduler/Job.php create mode 100644 system/src/Grav/Common/Scheduler/Scheduler.php create mode 100644 system/src/Grav/Common/Security.php create mode 100644 system/src/Grav/Common/Service/AccountsServiceProvider.php create mode 100644 system/src/Grav/Common/Service/AssetsServiceProvider.php create mode 100644 system/src/Grav/Common/Service/BackupsServiceProvider.php create mode 100644 system/src/Grav/Common/Service/ConfigServiceProvider.php create mode 100644 system/src/Grav/Common/Service/ErrorServiceProvider.php create mode 100644 system/src/Grav/Common/Service/FilesystemServiceProvider.php create mode 100644 system/src/Grav/Common/Service/FlexServiceProvider.php create mode 100644 system/src/Grav/Common/Service/InflectorServiceProvider.php create mode 100644 system/src/Grav/Common/Service/LoggerServiceProvider.php create mode 100644 system/src/Grav/Common/Service/OutputServiceProvider.php create mode 100644 system/src/Grav/Common/Service/PagesServiceProvider.php create mode 100644 system/src/Grav/Common/Service/RequestServiceProvider.php create mode 100644 system/src/Grav/Common/Service/SchedulerServiceProvider.php create mode 100644 system/src/Grav/Common/Service/SessionServiceProvider.php create mode 100644 system/src/Grav/Common/Service/StreamsServiceProvider.php create mode 100644 system/src/Grav/Common/Service/TaskServiceProvider.php create mode 100644 system/src/Grav/Common/Session.php create mode 100644 system/src/Grav/Common/Taxonomy.php create mode 100644 system/src/Grav/Common/Theme.php create mode 100644 system/src/Grav/Common/Themes.php create mode 100644 system/src/Grav/Common/Twig/Exception/TwigException.php create mode 100644 system/src/Grav/Common/Twig/Extension/FilesystemExtension.php create mode 100644 system/src/Grav/Common/Twig/Extension/GravExtension.php create mode 100644 system/src/Grav/Common/Twig/Node/TwigNodeCache.php create mode 100644 system/src/Grav/Common/Twig/Node/TwigNodeLink.php create mode 100644 system/src/Grav/Common/Twig/Node/TwigNodeMarkdown.php create mode 100644 system/src/Grav/Common/Twig/Node/TwigNodeRender.php create mode 100644 system/src/Grav/Common/Twig/Node/TwigNodeScript.php create mode 100644 system/src/Grav/Common/Twig/Node/TwigNodeStyle.php create mode 100644 system/src/Grav/Common/Twig/Node/TwigNodeSwitch.php create mode 100644 system/src/Grav/Common/Twig/Node/TwigNodeThrow.php create mode 100644 system/src/Grav/Common/Twig/Node/TwigNodeTryCatch.php create mode 100644 system/src/Grav/Common/Twig/TokenParser/TwigTokenParserCache.php create mode 100644 system/src/Grav/Common/Twig/TokenParser/TwigTokenParserLink.php create mode 100644 system/src/Grav/Common/Twig/TokenParser/TwigTokenParserMarkdown.php create mode 100644 system/src/Grav/Common/Twig/TokenParser/TwigTokenParserRender.php create mode 100644 system/src/Grav/Common/Twig/TokenParser/TwigTokenParserScript.php create mode 100644 system/src/Grav/Common/Twig/TokenParser/TwigTokenParserStyle.php create mode 100644 system/src/Grav/Common/Twig/TokenParser/TwigTokenParserSwitch.php create mode 100644 system/src/Grav/Common/Twig/TokenParser/TwigTokenParserThrow.php create mode 100644 system/src/Grav/Common/Twig/TokenParser/TwigTokenParserTryCatch.php create mode 100644 system/src/Grav/Common/Twig/Twig.php create mode 100644 system/src/Grav/Common/Twig/TwigClockworkDataSource.php create mode 100644 system/src/Grav/Common/Twig/TwigClockworkDumper.php create mode 100644 system/src/Grav/Common/Twig/TwigEnvironment.php create mode 100644 system/src/Grav/Common/Twig/TwigExtension.php create mode 100644 system/src/Grav/Common/Twig/WriteCacheFileTrait.php create mode 100644 system/src/Grav/Common/Uri.php create mode 100644 system/src/Grav/Common/User/Access.php create mode 100644 system/src/Grav/Common/User/Authentication.php create mode 100644 system/src/Grav/Common/User/DataUser/User.php create mode 100644 system/src/Grav/Common/User/DataUser/UserCollection.php create mode 100644 system/src/Grav/Common/User/Group.php create mode 100644 system/src/Grav/Common/User/Interfaces/AuthorizeInterface.php create mode 100644 system/src/Grav/Common/User/Interfaces/UserCollectionInterface.php create mode 100644 system/src/Grav/Common/User/Interfaces/UserGroupInterface.php create mode 100644 system/src/Grav/Common/User/Interfaces/UserInterface.php create mode 100644 system/src/Grav/Common/User/Traits/UserTrait.php create mode 100644 system/src/Grav/Common/User/User.php create mode 100644 system/src/Grav/Common/Utils.php create mode 100644 system/src/Grav/Common/Yaml.php create mode 100644 system/src/Grav/Console/Application/Application.php create mode 100644 system/src/Grav/Console/Application/CommandLoader/PluginCommandLoader.php create mode 100644 system/src/Grav/Console/Application/GpmApplication.php create mode 100644 system/src/Grav/Console/Application/GravApplication.php create mode 100644 system/src/Grav/Console/Application/PluginApplication.php create mode 100644 system/src/Grav/Console/Cli/BackupCommand.php create mode 100644 system/src/Grav/Console/Cli/CleanCommand.php create mode 100644 system/src/Grav/Console/Cli/ClearCacheCommand.php create mode 100644 system/src/Grav/Console/Cli/ComposerCommand.php create mode 100644 system/src/Grav/Console/Cli/InstallCommand.php create mode 100644 system/src/Grav/Console/Cli/LogViewerCommand.php create mode 100644 system/src/Grav/Console/Cli/NewProjectCommand.php create mode 100644 system/src/Grav/Console/Cli/PageSystemValidatorCommand.php create mode 100644 system/src/Grav/Console/Cli/SandboxCommand.php create mode 100644 system/src/Grav/Console/Cli/SchedulerCommand.php create mode 100644 system/src/Grav/Console/Cli/SecurityCommand.php create mode 100644 system/src/Grav/Console/Cli/ServerCommand.php create mode 100644 system/src/Grav/Console/Cli/YamlLinterCommand.php create mode 100644 system/src/Grav/Console/ConsoleCommand.php create mode 100644 system/src/Grav/Console/ConsoleTrait.php create mode 100644 system/src/Grav/Console/Gpm/DirectInstallCommand.php create mode 100644 system/src/Grav/Console/Gpm/IndexCommand.php create mode 100644 system/src/Grav/Console/Gpm/InfoCommand.php create mode 100644 system/src/Grav/Console/Gpm/InstallCommand.php create mode 100644 system/src/Grav/Console/Gpm/SelfupgradeCommand.php create mode 100644 system/src/Grav/Console/Gpm/UninstallCommand.php create mode 100644 system/src/Grav/Console/Gpm/UpdateCommand.php create mode 100644 system/src/Grav/Console/Gpm/VersionCommand.php create mode 100644 system/src/Grav/Console/GpmCommand.php create mode 100644 system/src/Grav/Console/GravCommand.php create mode 100644 system/src/Grav/Console/Plugin/PluginListCommand.php create mode 100644 system/src/Grav/Console/TerminalObjects/Table.php create mode 100644 system/src/Grav/Events/BeforeSessionStartEvent.php create mode 100644 system/src/Grav/Events/FlexRegisterEvent.php create mode 100644 system/src/Grav/Events/PageEvent.php create mode 100644 system/src/Grav/Events/PermissionsRegisterEvent.php create mode 100644 system/src/Grav/Events/PluginsLoadedEvent.php create mode 100644 system/src/Grav/Events/SessionStartEvent.php create mode 100644 system/src/Grav/Events/TypesEvent.php create mode 100644 system/src/Grav/Framework/Acl/Access.php create mode 100644 system/src/Grav/Framework/Acl/Action.php create mode 100644 system/src/Grav/Framework/Acl/Permissions.php create mode 100644 system/src/Grav/Framework/Acl/PermissionsReader.php create mode 100644 system/src/Grav/Framework/Acl/RecursiveActionIterator.php create mode 100644 system/src/Grav/Framework/Cache/AbstractCache.php create mode 100644 system/src/Grav/Framework/Cache/Adapter/ChainCache.php create mode 100644 system/src/Grav/Framework/Cache/Adapter/DoctrineCache.php create mode 100644 system/src/Grav/Framework/Cache/Adapter/FileCache.php create mode 100644 system/src/Grav/Framework/Cache/Adapter/MemoryCache.php create mode 100644 system/src/Grav/Framework/Cache/Adapter/SessionCache.php create mode 100644 system/src/Grav/Framework/Cache/CacheInterface.php create mode 100644 system/src/Grav/Framework/Cache/CacheTrait.php create mode 100644 system/src/Grav/Framework/Cache/Exception/CacheException.php create mode 100644 system/src/Grav/Framework/Cache/Exception/InvalidArgumentException.php create mode 100644 system/src/Grav/Framework/Collection/AbstractFileCollection.php create mode 100644 system/src/Grav/Framework/Collection/AbstractIndexCollection.php create mode 100644 system/src/Grav/Framework/Collection/AbstractLazyCollection.php create mode 100644 system/src/Grav/Framework/Collection/ArrayCollection.php create mode 100644 system/src/Grav/Framework/Collection/CollectionInterface.php create mode 100644 system/src/Grav/Framework/Collection/FileCollection.php create mode 100644 system/src/Grav/Framework/Collection/FileCollectionInterface.php create mode 100644 system/src/Grav/Framework/Compat/Serializable.php create mode 100644 system/src/Grav/Framework/ContentBlock/ContentBlock.php create mode 100644 system/src/Grav/Framework/ContentBlock/ContentBlockInterface.php create mode 100644 system/src/Grav/Framework/ContentBlock/HtmlBlock.php create mode 100644 system/src/Grav/Framework/ContentBlock/HtmlBlockInterface.php create mode 100644 system/src/Grav/Framework/Contracts/Media/MediaObjectInterface.php create mode 100644 system/src/Grav/Framework/Contracts/Object/IdentifierInterface.php create mode 100644 system/src/Grav/Framework/Contracts/Relationships/RelationshipIdentifierInterface.php create mode 100644 system/src/Grav/Framework/Contracts/Relationships/RelationshipInterface.php create mode 100644 system/src/Grav/Framework/Contracts/Relationships/RelationshipsInterface.php create mode 100644 system/src/Grav/Framework/Contracts/Relationships/ToManyRelationshipInterface.php create mode 100644 system/src/Grav/Framework/Contracts/Relationships/ToOneRelationshipInterface.php create mode 100644 system/src/Grav/Framework/Controller/Traits/ControllerResponseTrait.php create mode 100644 system/src/Grav/Framework/DI/Container.php create mode 100644 system/src/Grav/Framework/File/AbstractFile.php create mode 100644 system/src/Grav/Framework/File/CsvFile.php create mode 100644 system/src/Grav/Framework/File/DataFile.php create mode 100644 system/src/Grav/Framework/File/File.php create mode 100644 system/src/Grav/Framework/File/Formatter/AbstractFormatter.php create mode 100644 system/src/Grav/Framework/File/Formatter/CsvFormatter.php create mode 100644 system/src/Grav/Framework/File/Formatter/FormatterInterface.php create mode 100644 system/src/Grav/Framework/File/Formatter/IniFormatter.php create mode 100644 system/src/Grav/Framework/File/Formatter/JsonFormatter.php create mode 100644 system/src/Grav/Framework/File/Formatter/MarkdownFormatter.php create mode 100644 system/src/Grav/Framework/File/Formatter/SerializeFormatter.php create mode 100644 system/src/Grav/Framework/File/Formatter/YamlFormatter.php create mode 100644 system/src/Grav/Framework/File/IniFile.php create mode 100644 system/src/Grav/Framework/File/Interfaces/FileFormatterInterface.php create mode 100644 system/src/Grav/Framework/File/Interfaces/FileInterface.php create mode 100644 system/src/Grav/Framework/File/JsonFile.php create mode 100644 system/src/Grav/Framework/File/MarkdownFile.php create mode 100644 system/src/Grav/Framework/File/YamlFile.php create mode 100644 system/src/Grav/Framework/Filesystem/Filesystem.php create mode 100644 system/src/Grav/Framework/Filesystem/Interfaces/FilesystemInterface.php create mode 100644 system/src/Grav/Framework/Flex/Flex.php create mode 100644 system/src/Grav/Framework/Flex/FlexCollection.php create mode 100644 system/src/Grav/Framework/Flex/FlexDirectory.php create mode 100644 system/src/Grav/Framework/Flex/FlexDirectoryForm.php create mode 100644 system/src/Grav/Framework/Flex/FlexForm.php create mode 100644 system/src/Grav/Framework/Flex/FlexFormFlash.php create mode 100644 system/src/Grav/Framework/Flex/FlexIdentifier.php create mode 100644 system/src/Grav/Framework/Flex/FlexIndex.php create mode 100644 system/src/Grav/Framework/Flex/FlexObject.php create mode 100644 system/src/Grav/Framework/Flex/Interfaces/FlexAuthorizeInterface.php create mode 100644 system/src/Grav/Framework/Flex/Interfaces/FlexCollectionInterface.php create mode 100644 system/src/Grav/Framework/Flex/Interfaces/FlexCommonInterface.php create mode 100644 system/src/Grav/Framework/Flex/Interfaces/FlexDirectoryFormInterface.php create mode 100644 system/src/Grav/Framework/Flex/Interfaces/FlexDirectoryInterface.php create mode 100644 system/src/Grav/Framework/Flex/Interfaces/FlexFormInterface.php create mode 100644 system/src/Grav/Framework/Flex/Interfaces/FlexIndexInterface.php create mode 100644 system/src/Grav/Framework/Flex/Interfaces/FlexInterface.php create mode 100644 system/src/Grav/Framework/Flex/Interfaces/FlexObjectFormInterface.php create mode 100644 system/src/Grav/Framework/Flex/Interfaces/FlexObjectInterface.php create mode 100644 system/src/Grav/Framework/Flex/Interfaces/FlexStorageInterface.php create mode 100644 system/src/Grav/Framework/Flex/Interfaces/FlexTranslateInterface.php create mode 100644 system/src/Grav/Framework/Flex/Pages/FlexPageCollection.php create mode 100644 system/src/Grav/Framework/Flex/Pages/FlexPageIndex.php create mode 100644 system/src/Grav/Framework/Flex/Pages/FlexPageObject.php create mode 100644 system/src/Grav/Framework/Flex/Pages/Traits/PageAuthorsTrait.php create mode 100644 system/src/Grav/Framework/Flex/Pages/Traits/PageContentTrait.php create mode 100644 system/src/Grav/Framework/Flex/Pages/Traits/PageLegacyTrait.php create mode 100644 system/src/Grav/Framework/Flex/Pages/Traits/PageRoutableTrait.php create mode 100644 system/src/Grav/Framework/Flex/Pages/Traits/PageTranslateTrait.php create mode 100644 system/src/Grav/Framework/Flex/Storage/AbstractFilesystemStorage.php create mode 100644 system/src/Grav/Framework/Flex/Storage/FileStorage.php create mode 100644 system/src/Grav/Framework/Flex/Storage/FolderStorage.php create mode 100644 system/src/Grav/Framework/Flex/Storage/SimpleStorage.php create mode 100644 system/src/Grav/Framework/Flex/Traits/FlexAuthorizeTrait.php create mode 100644 system/src/Grav/Framework/Flex/Traits/FlexMediaTrait.php create mode 100644 system/src/Grav/Framework/Flex/Traits/FlexRelatedDirectoryTrait.php create mode 100644 system/src/Grav/Framework/Flex/Traits/FlexRelationshipsTrait.php create mode 100644 system/src/Grav/Framework/Form/FormFlash.php create mode 100644 system/src/Grav/Framework/Form/FormFlashFile.php create mode 100644 system/src/Grav/Framework/Form/Interfaces/FormFactoryInterface.php create mode 100644 system/src/Grav/Framework/Form/Interfaces/FormFlashInterface.php create mode 100644 system/src/Grav/Framework/Form/Interfaces/FormInterface.php create mode 100644 system/src/Grav/Framework/Form/Traits/FormTrait.php create mode 100644 system/src/Grav/Framework/Interfaces/RenderInterface.php create mode 100644 system/src/Grav/Framework/Logger/Processors/UserProcessor.php create mode 100644 system/src/Grav/Framework/Media/Interfaces/MediaCollectionInterface.php create mode 100644 system/src/Grav/Framework/Media/Interfaces/MediaInterface.php create mode 100644 system/src/Grav/Framework/Media/Interfaces/MediaManipulationInterface.php create mode 100644 system/src/Grav/Framework/Media/Interfaces/MediaObjectInterface.php create mode 100644 system/src/Grav/Framework/Media/MediaIdentifier.php create mode 100644 system/src/Grav/Framework/Media/MediaObject.php create mode 100644 system/src/Grav/Framework/Media/UploadedMediaObject.php create mode 100644 system/src/Grav/Framework/Mime/MimeTypes.php create mode 100644 system/src/Grav/Framework/Object/Access/ArrayAccessTrait.php create mode 100644 system/src/Grav/Framework/Object/Access/NestedArrayAccessTrait.php create mode 100644 system/src/Grav/Framework/Object/Access/NestedPropertyCollectionTrait.php create mode 100644 system/src/Grav/Framework/Object/Access/NestedPropertyTrait.php create mode 100644 system/src/Grav/Framework/Object/Access/OverloadedPropertyTrait.php create mode 100644 system/src/Grav/Framework/Object/ArrayObject.php create mode 100644 system/src/Grav/Framework/Object/Base/ObjectCollectionTrait.php create mode 100644 system/src/Grav/Framework/Object/Base/ObjectTrait.php create mode 100644 system/src/Grav/Framework/Object/Collection/ObjectExpressionVisitor.php create mode 100644 system/src/Grav/Framework/Object/Identifiers/Identifier.php create mode 100644 system/src/Grav/Framework/Object/Interfaces/NestedObjectCollectionInterface.php create mode 100644 system/src/Grav/Framework/Object/Interfaces/NestedObjectInterface.php create mode 100644 system/src/Grav/Framework/Object/Interfaces/ObjectCollectionInterface.php create mode 100644 system/src/Grav/Framework/Object/Interfaces/ObjectInterface.php create mode 100644 system/src/Grav/Framework/Object/LazyObject.php create mode 100644 system/src/Grav/Framework/Object/ObjectCollection.php create mode 100644 system/src/Grav/Framework/Object/ObjectIndex.php create mode 100644 system/src/Grav/Framework/Object/Property/ArrayPropertyTrait.php create mode 100644 system/src/Grav/Framework/Object/Property/LazyPropertyTrait.php create mode 100644 system/src/Grav/Framework/Object/Property/MixedPropertyTrait.php create mode 100644 system/src/Grav/Framework/Object/Property/ObjectPropertyTrait.php create mode 100644 system/src/Grav/Framework/Object/PropertyObject.php create mode 100644 system/src/Grav/Framework/Pagination/AbstractPagination.php create mode 100644 system/src/Grav/Framework/Pagination/AbstractPaginationPage.php create mode 100644 system/src/Grav/Framework/Pagination/Interfaces/PaginationInterface.php create mode 100644 system/src/Grav/Framework/Pagination/Interfaces/PaginationPageInterface.php create mode 100644 system/src/Grav/Framework/Pagination/Pagination.php create mode 100644 system/src/Grav/Framework/Pagination/PaginationPage.php create mode 100644 system/src/Grav/Framework/Psr7/AbstractUri.php create mode 100644 system/src/Grav/Framework/Psr7/Request.php create mode 100644 system/src/Grav/Framework/Psr7/Response.php create mode 100644 system/src/Grav/Framework/Psr7/ServerRequest.php create mode 100644 system/src/Grav/Framework/Psr7/Stream.php create mode 100644 system/src/Grav/Framework/Psr7/Traits/MessageDecoratorTrait.php create mode 100644 system/src/Grav/Framework/Psr7/Traits/RequestDecoratorTrait.php create mode 100644 system/src/Grav/Framework/Psr7/Traits/ResponseDecoratorTrait.php create mode 100644 system/src/Grav/Framework/Psr7/Traits/ServerRequestDecoratorTrait.php create mode 100644 system/src/Grav/Framework/Psr7/Traits/StreamDecoratorTrait.php create mode 100644 system/src/Grav/Framework/Psr7/Traits/UploadedFileDecoratorTrait.php create mode 100644 system/src/Grav/Framework/Psr7/Traits/UriDecorationTrait.php create mode 100644 system/src/Grav/Framework/Psr7/UploadedFile.php create mode 100644 system/src/Grav/Framework/Psr7/Uri.php create mode 100644 system/src/Grav/Framework/Relationships/Relationships.php create mode 100644 system/src/Grav/Framework/Relationships/ToManyRelationship.php create mode 100644 system/src/Grav/Framework/Relationships/ToOneRelationship.php create mode 100644 system/src/Grav/Framework/Relationships/Traits/RelationshipTrait.php create mode 100644 system/src/Grav/Framework/RequestHandler/Exception/InvalidArgumentException.php create mode 100644 system/src/Grav/Framework/RequestHandler/Exception/NotFoundException.php create mode 100644 system/src/Grav/Framework/RequestHandler/Exception/NotHandledException.php create mode 100644 system/src/Grav/Framework/RequestHandler/Exception/PageExpiredException.php create mode 100644 system/src/Grav/Framework/RequestHandler/Exception/RequestException.php create mode 100644 system/src/Grav/Framework/RequestHandler/Middlewares/Exceptions.php create mode 100644 system/src/Grav/Framework/RequestHandler/Middlewares/MultipartRequestSupport.php create mode 100644 system/src/Grav/Framework/RequestHandler/RequestHandler.php create mode 100644 system/src/Grav/Framework/RequestHandler/Traits/RequestHandlerTrait.php create mode 100644 system/src/Grav/Framework/Route/Route.php create mode 100644 system/src/Grav/Framework/Route/RouteFactory.php create mode 100644 system/src/Grav/Framework/Session/Exceptions/SessionException.php create mode 100644 system/src/Grav/Framework/Session/Messages.php create mode 100644 system/src/Grav/Framework/Session/Session.php create mode 100644 system/src/Grav/Framework/Session/SessionInterface.php create mode 100644 system/src/Grav/Framework/Uri/Uri.php create mode 100644 system/src/Grav/Framework/Uri/UriFactory.php create mode 100644 system/src/Grav/Framework/Uri/UriPartsFilter.php create mode 100644 system/src/Grav/Installer/Install.php create mode 100644 system/src/Grav/Installer/InstallException.php create mode 100644 system/src/Grav/Installer/VersionUpdate.php create mode 100644 system/src/Grav/Installer/VersionUpdater.php create mode 100644 system/src/Grav/Installer/Versions.php create mode 100644 system/src/Grav/Installer/YamlUpdater.php create mode 100644 system/src/Grav/Installer/updates/1.7.0_2020-11-20_1.php create mode 100755 system/src/Twig/DeferredExtension/DeferredBlockNode.php create mode 100644 system/src/Twig/DeferredExtension/DeferredDeclareNode.php create mode 100644 system/src/Twig/DeferredExtension/DeferredExtension.php create mode 100644 system/src/Twig/DeferredExtension/DeferredInitializeNode.php create mode 100755 system/src/Twig/DeferredExtension/DeferredNode.php create mode 100644 system/src/Twig/DeferredExtension/DeferredNodeVisitor.php create mode 100644 system/src/Twig/DeferredExtension/DeferredNodeVisitorCompat.php create mode 100644 system/src/Twig/DeferredExtension/DeferredResolveNode.php create mode 100644 system/src/Twig/DeferredExtension/DeferredTokenParser.php create mode 100644 system/templates/default.html.twig create mode 100644 system/templates/external.html.twig create mode 100644 system/templates/flex/404.html.twig create mode 100644 system/templates/flex/_default/collection/debug.html.twig create mode 100644 system/templates/flex/_default/object/debug.html.twig create mode 100644 system/templates/modular/default.html.twig create mode 100644 system/templates/partials/messages.html.twig create mode 100644 system/templates/partials/metadata.html.twig create mode 100644 tests/_bootstrap.php create mode 100644 tests/_support/AcceptanceTester.php create mode 100644 tests/_support/FunctionalTester.php create mode 100644 tests/_support/Helper/Acceptance.php create mode 100644 tests/_support/Helper/Functional.php create mode 100644 tests/_support/Helper/Unit.php create mode 100644 tests/_support/UnitTester.php create mode 100644 tests/acceptance.suite.yml create mode 100644 tests/acceptance/_bootstrap.php create mode 100644 tests/fake/nested-site/user/pages/01.item1/01.item1-1/01.item1-1-1/default.md create mode 100644 tests/fake/nested-site/user/pages/01.item1/01.item1-1/02.item1-1-2/default.md create mode 100644 tests/fake/nested-site/user/pages/01.item1/01.item1-1/03.item1-1-3/default.md create mode 100644 tests/fake/nested-site/user/pages/01.item1/01.item1-1/default.md create mode 100644 tests/fake/nested-site/user/pages/01.item1/02.item1-2/01.item1-2-1/default.md create mode 100644 tests/fake/nested-site/user/pages/01.item1/02.item1-2/02.item1-2-2/default.md create mode 100644 tests/fake/nested-site/user/pages/01.item1/02.item1-2/03.item1-2-3/default.md create mode 100644 tests/fake/nested-site/user/pages/01.item1/02.item1-2/default.md create mode 100644 tests/fake/nested-site/user/pages/01.item1/03.item1-3/01.item1-3-1/default.md create mode 100644 tests/fake/nested-site/user/pages/01.item1/03.item1-3/02.item1-3-2/default.md create mode 100644 tests/fake/nested-site/user/pages/01.item1/03.item1-3/03.item1-3-3/default.md create mode 100644 tests/fake/nested-site/user/pages/01.item1/03.item1-3/default.md create mode 100644 tests/fake/nested-site/user/pages/01.item1/default.md create mode 100644 tests/fake/nested-site/user/pages/01.item1/existing-file.zip create mode 100644 tests/fake/nested-site/user/pages/01.item1/home-cache-image.jpg create mode 100644 tests/fake/nested-site/user/pages/01.item1/home-sample-image.jpg create mode 100644 tests/fake/nested-site/user/pages/02.item2/01.item2-1/01.item2-1-1/default.md create mode 100644 tests/fake/nested-site/user/pages/02.item2/01.item2-1/02.item2-1-2/default.md create mode 100644 tests/fake/nested-site/user/pages/02.item2/01.item2-1/03.item2-1-3/default.md create mode 100644 tests/fake/nested-site/user/pages/02.item2/01.item2-1/default.md create mode 100644 tests/fake/nested-site/user/pages/02.item2/02.item2-2/01.item2-2-1/default.md create mode 100644 tests/fake/nested-site/user/pages/02.item2/02.item2-2/02.item2-2-2/default.md create mode 100644 tests/fake/nested-site/user/pages/02.item2/02.item2-2/03.item2-2-3/default.md create mode 100644 tests/fake/nested-site/user/pages/02.item2/02.item2-2/cache-image.jpg create mode 100644 tests/fake/nested-site/user/pages/02.item2/02.item2-2/default.md create mode 100644 tests/fake/nested-site/user/pages/02.item2/02.item2-2/existing-file.zip create mode 100644 tests/fake/nested-site/user/pages/02.item2/02.item2-2/sample-image.jpg create mode 100644 tests/fake/nested-site/user/pages/02.item2/03.item2-3/01.item2-3-1/default.md create mode 100644 tests/fake/nested-site/user/pages/02.item2/03.item2-3/02.item2-3-2/default.md create mode 100644 tests/fake/nested-site/user/pages/02.item2/03.item2-3/03.item2-3-3/default.md create mode 100644 tests/fake/nested-site/user/pages/02.item2/03.item2-3/default.md create mode 100644 tests/fake/nested-site/user/pages/02.item2/default.md create mode 100644 tests/fake/nested-site/user/pages/03.item3/01.item3-1/01.item3-1-1/default.md create mode 100644 tests/fake/nested-site/user/pages/03.item3/01.item3-1/02.item3-1-2/default.md create mode 100644 tests/fake/nested-site/user/pages/03.item3/01.item3-1/03.item3-1-3/default.md create mode 100644 tests/fake/nested-site/user/pages/03.item3/01.item3-1/default.md create mode 100644 tests/fake/nested-site/user/pages/03.item3/02.item3-2/01.item3-2-1/default.md create mode 100644 tests/fake/nested-site/user/pages/03.item3/02.item3-2/02.item3-2-2/default.md create mode 100644 tests/fake/nested-site/user/pages/03.item3/02.item3-2/03.item3-2-3/default.md create mode 100644 tests/fake/nested-site/user/pages/03.item3/02.item3-2/default.md create mode 100644 tests/fake/nested-site/user/pages/03.item3/03.item3-3/01.item3-3-1/default.md create mode 100644 tests/fake/nested-site/user/pages/03.item3/03.item3-3/02.item3-3-2/default.md create mode 100644 tests/fake/nested-site/user/pages/03.item3/03.item3-3/03.item3-3-3/default.md create mode 100644 tests/fake/nested-site/user/pages/03.item3/03.item3-3/default.md create mode 100644 tests/fake/nested-site/user/pages/03.item3/default.md create mode 100644 tests/fake/simple-site/user/pages/01.home/default.md create mode 100644 tests/fake/simple-site/user/pages/02.blog/blog.md create mode 100644 tests/fake/simple-site/user/pages/02.blog/post-one/item.md create mode 100644 tests/fake/simple-site/user/pages/02.blog/post-two/item.md create mode 100644 tests/fake/simple-site/user/pages/03.about/default.md create mode 100644 tests/fake/simple-site/user/pages/04.page-translated/default.en.md create mode 100644 tests/fake/simple-site/user/pages/04.page-translated/default.fr.md create mode 100644 tests/fake/simple-site/user/pages/05.translatedlong/part2/default.en.md create mode 100644 tests/fake/simple-site/user/pages/05.translatedlong/part2/default.fr.md create mode 100644 tests/fake/single-page-translated/user/pages/01.simple-page/default.en.md create mode 100644 tests/fake/single-page-translated/user/pages/01.simple-page/default.fr.md create mode 100644 tests/fake/single-pages/01.simple-page/default.md create mode 100644 tests/functional.suite.yml create mode 100644 tests/functional/Grav/Console/DirectInstallCommandTest.php create mode 100644 tests/functional/_bootstrap.php create mode 100644 tests/phpstan/classes/Toolbox/UniformResourceLocatorExtension.php create mode 100644 tests/phpstan/extension.neon create mode 100644 tests/phpstan/phpstan-bootstrap.php create mode 100644 tests/phpstan/phpstan.neon create mode 100644 tests/phpstan/plugins-bootstrap.php create mode 100644 tests/phpstan/plugins.neon create mode 100644 tests/unit.suite.yml create mode 100644 tests/unit/Grav/Common/AssetsTest.php create mode 100644 tests/unit/Grav/Common/BrowserTest.php create mode 100644 tests/unit/Grav/Common/ComposerTest.php create mode 100644 tests/unit/Grav/Common/Data/BlueprintTest.php create mode 100644 tests/unit/Grav/Common/GPM/GPMTest.php create mode 100644 tests/unit/Grav/Common/Helpers/ExcerptsTest.php create mode 100644 tests/unit/Grav/Common/InflectorTest.php create mode 100644 tests/unit/Grav/Common/Language/LanguageCodesTest.php create mode 100644 tests/unit/Grav/Common/Markdown/ParsedownTest.php create mode 100644 tests/unit/Grav/Common/Page/PagesTest.php create mode 100644 tests/unit/Grav/Common/Twig/Extensions/GravExtensionTest.php create mode 100644 tests/unit/Grav/Common/UriTest.php create mode 100644 tests/unit/Grav/Common/UtilsTest.php create mode 100644 tests/unit/Grav/Console/Gpm/InstallCommandTest.php create mode 100644 tests/unit/Grav/Framework/File/Formatter/CsvFormatterTest.php create mode 100644 tests/unit/Grav/Framework/Filesystem/FilesystemTest.php create mode 100644 tests/unit/_bootstrap.php create mode 100644 tests/unit/data/blueprints/strict.yaml create mode 100644 tmp/.gitkeep create mode 100644 user/accounts/.gitkeep create mode 100644 user/config/media.yaml create mode 100644 user/config/site.yaml create mode 100644 user/config/system.yaml create mode 100644 user/config/themes/ateliers-55.yaml create mode 100644 user/data/.gitkeep create mode 100644 user/pages/01.home/default.md create mode 100644 user/pages/02.articles/article-1/cat-8436843_1280.jpg create mode 100644 user/pages/02.articles/article-1/default.md create mode 100644 user/pages/02.articles/article-1/forsythia-8595521_1280.jpg create mode 100644 user/pages/02.articles/article-1/labrador-8554882_1280.jpg create mode 100644 user/pages/02.articles/article-1/lake-8357182_1280.jpg create mode 100644 user/pages/02.articles/article-1/landscape-8592826_1280.jpg create mode 100644 user/pages/02.articles/article-2/default.md create mode 100644 user/pages/02.articles/article-2/mountains-8497575_1280.jpg create mode 100644 user/pages/02.articles/article-2/nuts-8585063_1280.jpg create mode 100644 user/pages/02.articles/article-2/sparrow-8387465_1280.jpg create mode 100644 user/pages/02.articles/article-3/default.md create mode 100644 user/pages/02.articles/article-3/lake-8357182_1280.jpg create mode 100644 user/pages/02.articles/article-3/landscape-8592826_1280.jpg create mode 100644 user/pages/02.articles/article-3/mountains-8497575_1280.jpg create mode 100644 user/pages/02.articles/article-3/nuts-8585063_1280.jpg create mode 100644 user/pages/02.articles/article-4/cat-8436843_1280.jpg create mode 100644 user/pages/02.articles/article-4/default.md create mode 100644 user/pages/02.articles/article-4/forsythia-8595521_1280.jpg create mode 100644 user/pages/02.articles/article-4/labrador-8554882_1280.jpg create mode 100644 user/pages/02.articles/article-5/default.md create mode 100644 user/pages/02.articles/article-5/lake-8357182_1280.jpg create mode 100644 user/pages/02.articles/article-5/mountains-8497575_1280.jpg create mode 100644 user/pages/02.articles/article-5/sparrow-8387465_1280.jpg create mode 100644 user/pages/02.articles/default.md create mode 100644 user/pages/03.mentions-legales/default.md create mode 100644 user/pages/04.contact/default.md create mode 100644 user/plugins/.gitkeep create mode 100644 user/themes/.gitkeep create mode 100644 webserver-configs/Caddyfile create mode 100644 webserver-configs/Caddyfile-0.8.x create mode 100644 webserver-configs/htaccess.txt create mode 100644 webserver-configs/lighttpd.conf create mode 100644 webserver-configs/nginx.conf create mode 100644 webserver-configs/web.config diff --git a/.dependencies b/.dependencies new file mode 100644 index 0000000..86f4a79 --- /dev/null +++ b/.dependencies @@ -0,0 +1,34 @@ +git: + problems: + url: https://github.com/getgrav/grav-plugin-problems + path: user/plugins/problems + branch: master + error: + url: https://github.com/getgrav/grav-plugin-error + path: user/plugins/error + branch: master + markdown-notices: + url: https://github.com/getgrav/grav-plugin-markdown-notices + path: user/plugins/markdown-notices + branch: master + quark: + url: https://github.com/getgrav/grav-theme-quark + path: user/themes/quark + branch: master +links: + problems: + src: grav-plugin-problems + path: user/plugins/problems + scm: github + error: + src: grav-plugin-error + path: user/plugins/error + scm: github + markdown-notices: + src: grav-plugin-markdown-notices + path: user/plugins/markdown-notices + scm: github + quark: + src: grav-theme-quark + path: user/themes/quark + scm: github diff --git a/.editorconfig b/.editorconfig new file mode 100644 index 0000000..bb34874 --- /dev/null +++ b/.editorconfig @@ -0,0 +1,17 @@ +# EditorConfig is awesome: http://EditorConfig.org + +# top-most EditorConfig file +root = true + +# Unix-style newlines with a newline ending every file +[*] +charset = utf-8 +end_of_line = lf +insert_final_newline = true +indent_style = space +indent_size = 4 +trim_trailing_whitespace = true + +# 2 space indentation +[*.{yaml,yml,vue,js,css}] +indent_size = 2 diff --git a/.github/FUNDING.yml b/.github/FUNDING.yml new file mode 100644 index 0000000..e84f52b --- /dev/null +++ b/.github/FUNDING.yml @@ -0,0 +1,8 @@ +# These are supported funding model platforms + +github: # Replace with up to 4 GitHub Sponsors-enabled usernames e.g., [user1, user2] +patreon: # Replace with a single Patreon username +open_collective: grav +ko_fi: # Replace with a single Ko-fi username +tidelift: # Replace with a single Tidelift platform-name/package-name e.g., npm/babel +custom: # Replace with a single custom sponsorship URL diff --git a/.github/workflows/build.yaml b/.github/workflows/build.yaml new file mode 100644 index 0000000..d21bea1 --- /dev/null +++ b/.github/workflows/build.yaml @@ -0,0 +1,79 @@ +name: Release Builds + +on: + release: + types: [published] + +permissions: {} + +jobs: + build: + permissions: + contents: write # for release creation (svenstaro/upload-release-action) + + if: "!github.event.release.prerelease" + runs-on: ubuntu-latest + + steps: + - uses: actions/checkout@v2 + + - name: Extract Tag + run: echo "PACKAGE_VERSION=${{ github.ref }}" >> $GITHUB_ENV + + - name: Setup PHP + uses: shivammathur/setup-php@v2 + with: + php-version: 7.3 + extensions: opcache, gd + tools: composer:v2 + coverage: none + env: + COMPOSER_TOKEN: ${{ secrets.GLOBAL_TOKEN }} + + - name: Install Dependencies + run: | + sudo apt-get -y update -qq < /dev/null > /dev/null + sudo apt-get -y install -qq git zip < /dev/null > /dev/null + + - name: Retrieval of Builder Scripts + run: | + # Real Grav URL + curl --silent -H "Authorization: token ${{ secrets.GLOBAL_TOKEN }}" -H "Accept: application/vnd.github.v3.raw" ${{ secrets.BUILD_SCRIPT_URL }} --output build-grav.sh + + # Development Local URL + # curl ${{ secrets.BUILD_SCRIPT_URL }} --output build-grav.sh + + - name: Grav Builder + run: | + bash ./build-grav.sh + + - name: Upload packages to release + uses: svenstaro/upload-release-action@v2 + with: + repo_token: ${{ secrets.GITHUB_TOKEN }} + tag: ${{ env.PACKAGE_VERSION }} + file: ./grav-dist/*.zip + overwrite: true + file_glob: true + + slack: + permissions: + actions: read # to list jobs for workflow run (technote-space/workflow-conclusion-action) + + name: Slack + needs: build + runs-on: ubuntu-latest + if: always() + steps: + - uses: technote-space/workflow-conclusion-action@v2 + - uses: 8398a7/action-slack@v3 + with: + status: failure + fields: repo,message,author,action + icon_emoji: ':octocat:' + author_name: 'Github Action Build' + text: '🚚 Automated Build Failure' + env: + GITHUB_TOKEN: ${{ secrets.GLOBAL_TOKEN }} + SLACK_WEBHOOK_URL: ${{ secrets.SLACK_WEBHOOK_URL }} + if: env.WORKFLOW_CONCLUSION == 'failure' diff --git a/.github/workflows/tests.yaml b/.github/workflows/tests.yaml new file mode 100644 index 0000000..57101de --- /dev/null +++ b/.github/workflows/tests.yaml @@ -0,0 +1,76 @@ +name: PHP Tests + +on: + push: + branches: [ develop ] + pull_request: + branches: [ develop ] + +permissions: + contents: read # to fetch code (actions/checkout) + +jobs: + + unit-tests: + + runs-on: ${{ matrix.os }} + + strategy: + matrix: + php: [8.3, 8.2, 8.1, 8.0, 7.4, 7.3] + os: [ubuntu-latest] + + steps: + - uses: actions/checkout@v2 + + - name: Setup PHP + uses: shivammathur/setup-php@v2 + with: + php-version: ${{ matrix.php }} + extensions: opcache, gd + tools: composer:v2 + coverage: none + env: + COMPOSER_TOKEN: ${{ secrets.GITHUB_TOKEN }} + +# - name: Update composer +# run: composer update +# +# - name: Validate composer.json and composer.lock +# run: composer validate + + - name: Get composer cache directory + id: composer-cache + run: echo "::set-output name=dir::$(composer config cache-files-dir)" + + - name: Cache dependencies + uses: actions/cache@v2 + with: + path: ${{ steps.composer-cache.outputs.dir }} + key: ${{ runner.os }}-composer-${{ hashFiles('**/composer.lock') }} + restore-keys: ${{ runner.os }}-composer- + + - name: Install dependencies + run: composer install --prefer-dist --no-progress + + - name: Run test suite + run: vendor/bin/codecept run + +# slack: +# name: Slack +# needs: unit-tests +# runs-on: ubuntu-latest +# if: always() +# steps: +# - uses: technote-space/workflow-conclusion-action@v2 +# - uses: 8398a7/action-slack@v3 +# with: +# status: failure +# fields: repo,message,author,action +# icon_emoji: ':octocat:' +# author_name: 'Github Action Tests' +# text: '💥 Automated Test Failure' +# env: +# GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }} +# SLACK_WEBHOOK_URL: ${{ secrets.SLACK_WEBHOOK_URL }} +# if: env.WORKFLOW_CONCLUSION == 'failure' diff --git a/.github/workflows/trigger-skeletons.yml b/.github/workflows/trigger-skeletons.yml new file mode 100644 index 0000000..b42b963 --- /dev/null +++ b/.github/workflows/trigger-skeletons.yml @@ -0,0 +1,48 @@ +name: Trigger Skeletons Build + +on: + workflow_dispatch: + inputs: + version: + description: 'Which Grav release to use' + required: true + default: 'latest' + admin: + description: 'Create also a package with Admin' + required: true + default: true + +permissions: + contents: read # to fetch code (actions/checkout) + +jobs: + build: + runs-on: ubuntu-latest + env: + WORKFLOW: "build-skeleton.yml" + AUTH: ":${{secrets.GLOBAL_TOKEN}}" + steps: + - uses: actions/checkout@v2 + - name: Make it rain ☔️ + run: | + SKELETONS=`curl -s "${{secrets.SKELETONS_JSON_LIST}}"` + echo "$SKELETONS" | jq -cr '.[]' | while read SKELETON; do + KEY=$(echo "$SKELETON" | jq -cr 'keys[0]') + VERSION=$(echo "$SKELETON" | jq -cr '.[]') + URL="https://api.github.com/repos/${KEY}/actions/workflows/${WORKFLOW}/dispatches" + + curl -X POST \ + -u "${AUTH}" \ + -H "Accept: application/vnd.github.everest-preview+json" \ + -H "Content-Type: application/json" \ + -sS \ + ${URL} \ + --data '{ "ref": "develop", + "inputs": { + "tag": "'"$VERSION"'", + "version": "'"$INPUT_VERSION"'", + "admin": "'"$INPUT_ADMIN"'" + } + }' > /dev/null + echo "Dispatched Worfklow for ${KEY}@$VERSION" + done diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..a2a78f5 --- /dev/null +++ b/.gitignore @@ -0,0 +1,50 @@ +# Composer +.composer +vendor/* +!*/vendor/* + +# Sass +.sass-cache + +# Grav Specific +backup/* +!backup/.* +cache/* +!cache/.* +assets/* +!assets/.* +logs/* +!logs/.* +images/* +!images/.* +user/accounts/* +!user/accounts/.* +user/data/* +!user/data/.* +user/plugins/* +!user/plugins/.* +user/themes/* +!user/themes/.* +user/**/config/security.yaml + +# Environments +.env +.gravenv + +# OS Generated +.DS_Store* +ehthumbs.db +Icon? +Thumbs.db +*.swp + +# phpstorm +.idea/* + +# testing stuff +tests/_output/* +tests/_support/_generated/* +tests/cache/* +tests/error.log +system/templates/testing/* +/user/config/versions.yaml diff --git a/.htaccess b/.htaccess new file mode 100644 index 0000000..098c582 --- /dev/null +++ b/.htaccess @@ -0,0 +1,78 @@ + + +RewriteEngine On + +## Begin RewriteBase +# If you are getting 500 or 404 errors on subpages, you may have to uncomment the RewriteBase entry +# You should change the '/' to your appropriate subfolder. For example if you have +# your Grav install at the root of your site '/' should work, else it might be something +# along the lines of: RewriteBase / +## + +# RewriteBase / + +## End - RewriteBase + +## Begin - X-Forwarded-Proto +# In some hosted or load balanced environments, SSL negotiation happens upstream. +# In order for Grav to recognize the connection as secure, you need to uncomment +# the following lines. +# +# RewriteCond %{HTTP:X-Forwarded-Proto} https +# RewriteRule .* - [E=HTTPS:on] +# +## End - X-Forwarded-Proto + +## Begin - Exploits +# If you experience problems on your site block out the operations listed below +# This attempts to block the most common type of exploit `attempts` to Grav +# +# Block out any script trying to use twig tags in URL. +RewriteCond %{REQUEST_URI} ({{|}}|{%|%}) [OR] +RewriteCond %{QUERY_STRING} ({{|}}|{%25|%25}) [OR] +# Block out any script trying to base64_encode data within the URL. +RewriteCond %{QUERY_STRING} base64_encode[^(]*\([^)]*\) [OR] +# Block out any script that includes a \n"; + } +} diff --git a/system/src/Grav/Common/Assets/InlineJsModule.php b/system/src/Grav/Common/Assets/InlineJsModule.php new file mode 100644 index 0000000..17aada4 --- /dev/null +++ b/system/src/Grav/Common/Assets/InlineJsModule.php @@ -0,0 +1,46 @@ + 'js_module', + 'attributes' => ['type' => 'module'], + 'position' => 'after' + ]; + + $merged_attributes = Utils::arrayMergeRecursiveUnique($base_options, $elements); + + parent::__construct($merged_attributes, $key); + } + + /** + * @return string + */ + public function render() + { + return 'renderAttributes(). ">\n" . trim($this->asset) . "\n\n"; + } + +} diff --git a/system/src/Grav/Common/Assets/Js.php b/system/src/Grav/Common/Assets/Js.php new file mode 100644 index 0000000..a66b059 --- /dev/null +++ b/system/src/Grav/Common/Assets/Js.php @@ -0,0 +1,48 @@ + 'js', + ]; + + $merged_attributes = Utils::arrayMergeRecursiveUnique($base_options, $elements); + + parent::__construct($merged_attributes, $key); + } + + /** + * @return string + */ + public function render() + { + if (isset($this->attributes['loading']) && $this->attributes['loading'] === 'inline') { + $buffer = $this->gatherLinks([$this], self::JS_ASSET); + return 'renderAttributes() . ">\n" . trim($buffer) . "\n\n"; + } + + return '\n"; + } +} diff --git a/system/src/Grav/Common/Assets/JsModule.php b/system/src/Grav/Common/Assets/JsModule.php new file mode 100644 index 0000000..55523b0 --- /dev/null +++ b/system/src/Grav/Common/Assets/JsModule.php @@ -0,0 +1,49 @@ + 'js_module', + 'attributes' => ['type' => 'module'] + ]; + + $merged_attributes = Utils::arrayMergeRecursiveUnique($base_options, $elements); + + parent::__construct($merged_attributes, $key); + } + + /** + * @return string + */ + public function render() + { + if (isset($this->attributes['loading']) && $this->attributes['loading'] === 'inline') { + $buffer = $this->gatherLinks([$this], self::JS_MODULE_ASSET); + return 'renderAttributes() . ">\n" . trim($buffer) . "\n\n"; + } + + return '\n"; + } +} diff --git a/system/src/Grav/Common/Assets/Link.php b/system/src/Grav/Common/Assets/Link.php new file mode 100644 index 0000000..f60ee64 --- /dev/null +++ b/system/src/Grav/Common/Assets/Link.php @@ -0,0 +1,43 @@ + 'link', + ]; + + $merged_attributes = Utils::arrayMergeRecursiveUnique($base_options, $elements); + + parent::__construct($merged_attributes, $key); + } + + /** + * @return string + */ + public function render() + { + return 'renderAttributes() . $this->integrityHash($this->asset) . ">\n"; + } +} diff --git a/system/src/Grav/Common/Assets/Pipeline.php b/system/src/Grav/Common/Assets/Pipeline.php new file mode 100644 index 0000000..3fd542e --- /dev/null +++ b/system/src/Grav/Common/Assets/Pipeline.php @@ -0,0 +1,347 @@ +base_url = rtrim($uri->rootUrl($config->get('system.absolute_urls')), '/') . '/'; + $this->assets_dir = $locator->findResource('asset://'); + if (!$this->assets_dir) { + // Attempt to create assets folder if it doesn't exist yet. + $this->assets_dir = $locator->findResource('asset://', true, true); + Folder::mkdir($this->assets_dir); + $locator->clearCache(); + } + + $this->assets_url = $locator->findResource('asset://', false); + } + + /** + * Minify and concatenate CSS + * + * @param array $assets + * @param string $group + * @param array $attributes + * @return bool|string URL or generated content if available, else false + */ + public function renderCss($assets, $group, $attributes = []) + { + // temporary list of assets to pipeline + $inline_group = false; + + if (array_key_exists('loading', $attributes) && $attributes['loading'] === 'inline') { + $inline_group = true; + unset($attributes['loading']); + } + + // Store Attributes + $this->attributes = array_merge(['type' => 'text/css', 'rel' => 'stylesheet'], $attributes); + + // Compute uid based on assets and timestamp + $json_assets = json_encode($assets); + $uid = md5($json_assets . (int)$this->css_minify . (int)$this->css_rewrite . $group); + $file = $uid . '.css'; + $relative_path = "{$this->base_url}{$this->assets_url}/{$file}"; + + $filepath = "{$this->assets_dir}/{$file}"; + if (file_exists($filepath)) { + $buffer = file_get_contents($filepath) . "\n"; + } else { + //if nothing found get out of here! + if (empty($assets)) { + return false; + } + + // Concatenate files + $buffer = $this->gatherLinks($assets, self::CSS_ASSET); + + // Minify if required + if ($this->shouldMinify('css')) { + $minifier = new CSS(); + $minifier->add($buffer); + $buffer = $minifier->minify(); + } + + // Write file + if (trim($buffer) !== '') { + file_put_contents($filepath, $buffer); + } + } + + if ($inline_group) { + $output = "\n"; + } else { + $this->asset = $relative_path; + $output = 'renderAttributes() . BaseAsset::integrityHash($this->asset) . ">\n"; + } + + return $output; + } + + /** + * Minify and concatenate JS files. + * + * @param array $assets + * @param string $group + * @param array $attributes + * @return bool|string URL or generated content if available, else false + */ + public function renderJs($assets, $group, $attributes = [], $type = self::JS_ASSET) + { + // temporary list of assets to pipeline + $inline_group = false; + + if (array_key_exists('loading', $attributes) && $attributes['loading'] === 'inline') { + $inline_group = true; + unset($attributes['loading']); + } + + // Store Attributes + $this->attributes = $attributes; + + // Compute uid based on assets and timestamp + $json_assets = json_encode($assets); + $uid = md5($json_assets . $this->js_minify . $group); + $file = $uid . '.js'; + $relative_path = "{$this->base_url}{$this->assets_url}/{$file}"; + + $filepath = "{$this->assets_dir}/{$file}"; + if (file_exists($filepath)) { + $buffer = file_get_contents($filepath) . "\n"; + } else { + //if nothing found get out of here! + if (empty($assets)) { + return false; + } + + // Concatenate files + $buffer = $this->gatherLinks($assets, $type); + + // Minify if required + if ($this->shouldMinify('js')) { + $minifier = new JS(); + $minifier->add($buffer); + $buffer = $minifier->minify(); + } + + // Write file + if (trim($buffer) !== '') { + file_put_contents($filepath, $buffer); + } + } + + if ($inline_group) { + $output = 'renderAttributes(). ">\n" . $buffer . "\n\n"; + } else { + $this->asset = $relative_path; + $output = '\n"; + } + + return $output; + } + + /** + * Minify and concatenate JS files. + * + * @param array $assets + * @param string $group + * @param array $attributes + * @return bool|string URL or generated content if available, else false + */ + public function renderJs_Module($assets, $group, $attributes = []) + { + $attributes['type'] = 'module'; + return $this->renderJs($assets, $group, $attributes, self::JS_MODULE_ASSET); + } + + /** + * Finds relative CSS urls() and rewrites the URL with an absolute one + * + * @param string $file the css source file + * @param string $dir , $local relative path to the css file + * @param bool $local is this a local or remote asset + * @return string + */ + protected function cssRewrite($file, $dir, $local) + { + // Strip any sourcemap comments + $file = preg_replace(self::CSS_SOURCEMAP_REGEX, '', $file); + + // Find any css url() elements, grab the URLs and calculate an absolute path + // Then replace the old url with the new one + $file = (string)preg_replace_callback(self::CSS_URL_REGEX, function ($matches) use ($dir, $local) { + $isImport = count($matches) > 3 && $matches[3] === '@import'; + + if ($isImport) { + $old_url = $matches[5]; + } else { + $old_url = $matches[2]; + } + + // Ensure link is not rooted to web server, a data URL, or to a remote host + if (preg_match(self::FIRST_FORWARDSLASH_REGEX, $old_url) || Utils::startsWith($old_url, 'data:') || $this->isRemoteLink($old_url)) { + return $matches[0]; + } + + // clean leading / + $old_url = Utils::normalizePath($dir . '/' . $old_url); + if (preg_match(self::FIRST_FORWARDSLASH_REGEX, $old_url)) { + $old_url = ltrim($old_url, '/'); + } + + $new_url = ($local ? $this->base_url : '') . $old_url; + + if ($isImport) { + return str_replace($matches[5], $new_url, $matches[0]); + } else { + return str_replace($matches[2], $new_url, $matches[0]); + } + }, $file); + + return $file; + } + + /** + * Finds relative JS urls() and rewrites the URL with an absolute one + * + * @param string $file the css source file + * @param string $dir local relative path to the css file + * @param bool $local is this a local or remote asset + * @return string + */ + protected function jsRewrite($file, $dir, $local) + { + // Find any js import elements, grab the URLs and calculate an absolute path + // Then replace the old url with the new one + $file = (string)preg_replace_callback(self::JS_IMPORT_REGEX, function ($matches) use ($dir, $local) { + + $old_url = $matches[1]; + + // Ensure link is not rooted to web server, a data URL, or to a remote host + if (preg_match(self::FIRST_FORWARDSLASH_REGEX, $old_url) || $this->isRemoteLink($old_url)) { + return $matches[0]; + } + + // clean leading / + $old_url = Utils::normalizePath($dir . '/' . $old_url); + $old_url = str_replace('/./', '/', $old_url); + if (preg_match(self::FIRST_FORWARDSLASH_REGEX, $old_url)) { + $old_url = ltrim($old_url, '/'); + } + + $new_url = ($local ? $this->base_url : '') . $old_url; + + return str_replace($matches[1], $new_url, $matches[0]); + }, $file); + + return $file; + } + + /** + * @param string $type + * @return bool + */ + private function shouldMinify($type = 'css') + { + $check = $type . '_minify'; + $win_check = $type . '_minify_windows'; + + $minify = (bool) $this->$check; + + // If this is a Windows server, and minify_windows is false (default value) skip the + // minification process because it will cause Apache to die/crash due to insufficient + // ThreadStackSize in httpd.conf - See: https://bugs.php.net/bug.php?id=47689 + if (stripos(php_uname('s'), 'WIN') === 0 && !$this->{$win_check}) { + $minify = false; + } + + return $minify; + } +} diff --git a/system/src/Grav/Common/Assets/Traits/AssetUtilsTrait.php b/system/src/Grav/Common/Assets/Traits/AssetUtilsTrait.php new file mode 100644 index 0000000..874633f --- /dev/null +++ b/system/src/Grav/Common/Assets/Traits/AssetUtilsTrait.php @@ -0,0 +1,215 @@ +rootUrl(true); + + // Sanity check for local URLs with absolute URL's enabled + if (Utils::startsWith($link, $base)) { + return false; + } + + return (0 === strpos($link, 'http://') || 0 === strpos($link, 'https://') || 0 === strpos($link, '//')); + } + + /** + * Download and concatenate the content of several links. + * + * @param array $assets + * @param int $type + * @return string + */ + protected function gatherLinks(array $assets, int $type = self::CSS_ASSET): string + { + $buffer = ''; + foreach ($assets as $asset) { + $local = true; + + $link = $asset->getAsset(); + $relative_path = $link; + + if (static::isRemoteLink($link)) { + $local = false; + if (0 === strpos($link, '//')) { + $link = 'http:' . $link; + } + $relative_dir = dirname($relative_path); + } else { + // Fix to remove relative dir if grav is in one + if (($this->base_url !== '/') && Utils::startsWith($relative_path, $this->base_url)) { + $base_url = '#' . preg_quote($this->base_url, '#') . '#'; + $relative_path = ltrim(preg_replace($base_url, '/', $link, 1), '/'); + } + + $relative_dir = dirname($relative_path); + $link = GRAV_ROOT . '/' . $relative_path; + } + + // TODO: looks like this is not being used. + $file = $this->fetch_command instanceof Closure ? @$this->fetch_command->__invoke($link) : @file_get_contents($link); + + // No file found, skip it... + if ($file === false) { + continue; + } + + // Double check last character being + if ($type === self::JS_ASSET || $type === self::JS_MODULE_ASSET) { + $file = rtrim($file, ' ;') . ';'; + } + + // If this is CSS + the file is local + rewrite enabled + if ($type === self::CSS_ASSET && $this->css_rewrite) { + $file = $this->cssRewrite($file, $relative_dir, $local); + } + + if ($type === self::JS_MODULE_ASSET) { + $file = $this->jsRewrite($file, $relative_dir, $local); + } + + $file = rtrim($file) . PHP_EOL; + $buffer .= $file; + } + + // Pull out @imports and move to top + if ($type === self::CSS_ASSET) { + $buffer = $this->moveImports($buffer); + } + + return $buffer; + } + + /** + * Moves @import statements to the top of the file per the CSS specification + * + * @param string $file the file containing the combined CSS files + * @return string the modified file with any @imports at the top of the file + */ + protected function moveImports($file) + { + $regex = '{@import.*?["\']([^"\']+)["\'].*?;}'; + + $imports = []; + + $file = (string)preg_replace_callback($regex, static function ($matches) use (&$imports) { + $imports[] = $matches[0]; + + return ''; + }, $file); + + return implode("\n", $imports) . "\n\n" . $file; + } + + /** + * + * Build an HTML attribute string from an array. + * + * @return string + */ + protected function renderAttributes() + { + $html = ''; + $no_key = ['loading']; + + foreach ($this->attributes as $key => $value) { + if ($value === null) { + continue; + } + + if (is_numeric($key)) { + $key = $value; + } + if (is_array($value)) { + $value = implode(' ', $value); + } + + if (in_array($key, $no_key, true)) { + $element = htmlentities($value, ENT_QUOTES, 'UTF-8', false); + } else { + $element = $key . '="' . htmlentities($value, ENT_QUOTES, 'UTF-8', false) . '"'; + } + + $html .= ' ' . $element; + } + + return $html; + } + + /** + * Render Querystring + * + * @param string|null $asset + * @return string + */ + protected function renderQueryString($asset = null) + { + $querystring = ''; + + $asset = $asset ?? $this->asset; + $attributes = $this->attributes; + + if (!empty($this->query)) { + if (Utils::contains($asset, '?')) { + $querystring .= '&' . $this->query; + } else { + $querystring .= '?' . $this->query; + } + } + + if ($this->timestamp) { + if ($querystring || Utils::contains($asset, '?')) { + $querystring .= '&' . $this->timestamp; + } else { + $querystring .= '?' . $this->timestamp; + } + } + + return $querystring; + } +} diff --git a/system/src/Grav/Common/Assets/Traits/LegacyAssetsTrait.php b/system/src/Grav/Common/Assets/Traits/LegacyAssetsTrait.php new file mode 100644 index 0000000..08a59e2 --- /dev/null +++ b/system/src/Grav/Common/Assets/Traits/LegacyAssetsTrait.php @@ -0,0 +1,137 @@ + null, 'pipeline' => true, 'loading' => null, 'group' => null]; + $arguments = $this->createArgumentsFromLegacy($args, $defaults); + break; + + case (Assets::INLINE_JS_TYPE): + $defaults = ['priority' => null, 'group' => null, 'attributes' => null]; + $arguments = $this->createArgumentsFromLegacy($args, $defaults); + + // special case to handle old attributes being passed in + if (isset($arguments['attributes'])) { + $old_attributes = $arguments['attributes']; + if (is_array($old_attributes)) { + $arguments = array_merge($arguments, $old_attributes); + } else { + $arguments['type'] = $old_attributes; + } + } + unset($arguments['attributes']); + + break; + + case (Assets::INLINE_CSS_TYPE): + $defaults = ['priority' => null, 'group' => null]; + $arguments = $this->createArgumentsFromLegacy($args, $defaults); + break; + + default: + case (Assets::CSS_TYPE): + $defaults = ['priority' => null, 'pipeline' => true, 'group' => null, 'loading' => null]; + $arguments = $this->createArgumentsFromLegacy($args, $defaults); + } + + return $arguments; + } + + /** + * @param array $args + * @param array $defaults + * @return array + */ + protected function createArgumentsFromLegacy(array $args, array $defaults) + { + // Remove arguments with old default values. + $arguments = []; + foreach ($args as $arg) { + $default = current($defaults); + if ($arg !== $default) { + $arguments[key($defaults)] = $arg; + } + next($defaults); + } + + return $arguments; + } + + /** + * Convenience wrapper for async loading of JavaScript + * + * @param string|array $asset + * @param int $priority + * @param bool $pipeline + * @param string $group name of the group + * @return Assets + * @deprecated Please use dynamic method with ['loading' => 'async']. + */ + public function addAsyncJs($asset, $priority = 10, $pipeline = true, $group = 'head') + { + user_error(__CLASS__ . '::' . __FUNCTION__ . '() is deprecated since Grav 1.6, use dynamic method with [\'loading\' => \'async\']', E_USER_DEPRECATED); + + return $this->addJs($asset, $priority, $pipeline, 'async', $group); + } + + /** + * Convenience wrapper for deferred loading of JavaScript + * + * @param string|array $asset + * @param int $priority + * @param bool $pipeline + * @param string $group name of the group + * @return Assets + * @deprecated Please use dynamic method with ['loading' => 'defer']. + */ + public function addDeferJs($asset, $priority = 10, $pipeline = true, $group = 'head') + { + user_error(__CLASS__ . '::' . __FUNCTION__ . '() is deprecated since Grav 1.6, use dynamic method with [\'loading\' => \'defer\']', E_USER_DEPRECATED); + + return $this->addJs($asset, $priority, $pipeline, 'defer', $group); + } +} diff --git a/system/src/Grav/Common/Assets/Traits/TestingAssetsTrait.php b/system/src/Grav/Common/Assets/Traits/TestingAssetsTrait.php new file mode 100644 index 0000000..c264868 --- /dev/null +++ b/system/src/Grav/Common/Assets/Traits/TestingAssetsTrait.php @@ -0,0 +1,350 @@ +collections[$asset]) || isset($this->assets_css[$asset]) || isset($this->assets_js[$asset]); + } + + /** + * Return the array of all the registered collections + * + * @return array + */ + public function getCollections() + { + return $this->collections; + } + + /** + * Set the array of collections explicitly + * + * @param array $collections + * @return $this + */ + public function setCollection($collections) + { + $this->collections = $collections; + + return $this; + } + + /** + * Return the array of all the registered CSS assets + * If a $key is provided, it will try to return only that asset + * else it will return null + * + * @param string|null $key the asset key + * @return array + */ + public function getCss($key = null) + { + if (null !== $key) { + $asset_key = md5($key); + + return $this->assets_css[$asset_key] ?? null; + } + + return $this->assets_css; + } + + /** + * Return the array of all the registered JS assets + * If a $key is provided, it will try to return only that asset + * else it will return null + * + * @param string|null $key the asset key + * @return array + */ + public function getJs($key = null) + { + if (null !== $key) { + $asset_key = md5($key); + + return $this->assets_js[$asset_key] ?? null; + } + + return $this->assets_js; + } + + /** + * Set the whole array of CSS assets + * + * @param array $css + * @return $this + */ + public function setCss($css) + { + $this->assets_css = $css; + + return $this; + } + + /** + * Set the whole array of JS assets + * + * @param array $js + * @return $this + */ + public function setJs($js) + { + $this->assets_js = $js; + + return $this; + } + + /** + * Removes an item from the CSS array if set + * + * @param string $key The asset key + * @return $this + */ + public function removeCss($key) + { + $asset_key = md5($key); + if (isset($this->assets_css[$asset_key])) { + unset($this->assets_css[$asset_key]); + } + + return $this; + } + + /** + * Removes an item from the JS array if set + * + * @param string $key The asset key + * @return $this + */ + public function removeJs($key) + { + $asset_key = md5($key); + if (isset($this->assets_js[$asset_key])) { + unset($this->assets_js[$asset_key]); + } + + return $this; + } + + /** + * Sets the state of CSS Pipeline + * + * @param bool $value + * @return $this + */ + public function setCssPipeline($value) + { + $this->css_pipeline = (bool)$value; + + return $this; + } + + /** + * Sets the state of JS Pipeline + * + * @param bool $value + * @return $this + */ + public function setJsPipeline($value) + { + $this->js_pipeline = (bool)$value; + + return $this; + } + + /** + * Reset all assets. + * + * @return $this + */ + public function reset() + { + $this->resetCss(); + $this->resetJs(); + $this->setCssPipeline(false); + $this->setJsPipeline(false); + $this->order = []; + + return $this; + } + + /** + * Reset JavaScript assets. + * + * @return $this + */ + public function resetJs() + { + $this->assets_js = []; + + return $this; + } + + /** + * Reset CSS assets. + * + * @return $this + */ + public function resetCss() + { + $this->assets_css = []; + + return $this; + } + + /** + * Explicitly set's a timestamp for assets + * + * @param string|int $value + */ + public function setTimestamp($value) + { + $this->timestamp = $value; + } + + /** + * Get the timestamp for assets + * + * @param bool $include_join + * @return string|null + */ + public function getTimestamp($include_join = true) + { + if ($this->timestamp) { + return $include_join ? '?' . $this->timestamp : $this->timestamp; + } + + return null; + } + + /** + * Add all assets matching $pattern within $directory. + * + * @param string $directory Relative to the Grav root path, or a stream identifier + * @param string $pattern (regex) + * @return $this + */ + public function addDir($directory, $pattern = self::DEFAULT_REGEX) + { + $root_dir = GRAV_ROOT; + + // Check if $directory is a stream. + if (strpos($directory, '://')) { + $directory = Grav::instance()['locator']->findResource($directory, null); + } + + // Get files + $files = $this->rglob($root_dir . DIRECTORY_SEPARATOR . $directory, $pattern, $root_dir . '/'); + + // No luck? Nothing to do + if (!$files) { + return $this; + } + + // Add CSS files + if ($pattern === self::CSS_REGEX) { + foreach ($files as $file) { + $this->addCss($file); + } + + return $this; + } + + // Add JavaScript files + if ($pattern === self::JS_REGEX) { + foreach ($files as $file) { + $this->addJs($file); + } + + return $this; + } + + // Add JavaScript Module files + if ($pattern === self::JS_MODULE_REGEX) { + foreach ($files as $file) { + $this->addJsModule($file); + } + + return $this; + } + + // Unknown pattern. + foreach ($files as $asset) { + $this->add($asset); + } + + return $this; + } + + /** + * Add all JavaScript assets within $directory + * + * @param string $directory Relative to the Grav root path, or a stream identifier + * @return $this + */ + public function addDirJs($directory) + { + return $this->addDir($directory, self::JS_REGEX); + } + + /** + * Add all CSS assets within $directory + * + * @param string $directory Relative to the Grav root path, or a stream identifier + * @return $this + */ + public function addDirCss($directory) + { + return $this->addDir($directory, self::CSS_REGEX); + } + + /** + * Recursively get files matching $pattern within $directory. + * + * @param string $directory + * @param string $pattern (regex) + * @param string|null $ltrim Will be trimmed from the left of the file path + * @return array + */ + protected function rglob($directory, $pattern, $ltrim = null) + { + $iterator = new RegexIterator(new RecursiveIteratorIterator(new RecursiveDirectoryIterator( + $directory, + FilesystemIterator::SKIP_DOTS + )), $pattern); + $offset = strlen($ltrim); + $files = []; + + foreach ($iterator as $file) { + $files[] = substr($file->getPathname(), $offset); + } + + return $files; + } +} diff --git a/system/src/Grav/Common/Backup/Backups.php b/system/src/Grav/Common/Backup/Backups.php new file mode 100644 index 0000000..5114634 --- /dev/null +++ b/system/src/Grav/Common/Backup/Backups.php @@ -0,0 +1,322 @@ +addListener('onSchedulerInitialized', [$this, 'onSchedulerInitialized']); + + $grav->fireEvent('onBackupsInitialized', new Event(['backups' => $this])); + } + + /** + * @return void + */ + public function setup() + { + if (null === static::$backup_dir) { + $grav = Grav::instance(); + static::$backup_dir = $grav['locator']->findResource('backup://', true, true); + Folder::create(static::$backup_dir); + } + } + + /** + * @param Event $event + * @return void + */ + public function onSchedulerInitialized(Event $event) + { + $grav = Grav::instance(); + + /** @var Scheduler $scheduler */ + $scheduler = $event['scheduler']; + + /** @var Inflector $inflector */ + $inflector = $grav['inflector']; + + foreach (static::getBackupProfiles() as $id => $profile) { + $at = $profile['schedule_at']; + $name = $inflector::hyphenize($profile['name']); + $logs = 'logs/backup-' . $name . '.out'; + /** @var Job $job */ + $job = $scheduler->addFunction('Grav\Common\Backup\Backups::backup', [$id], $name); + $job->at($at); + $job->output($logs); + $job->backlink('/tools/backups'); + } + } + + /** + * @param string $backup + * @param string $base_url + * @return string + */ + public function getBackupDownloadUrl($backup, $base_url) + { + $param_sep = Grav::instance()['config']->get('system.param_sep', ':'); + $download = urlencode(base64_encode(Utils::basename($backup))); + $url = rtrim(Grav::instance()['uri']->rootUrl(true), '/') . '/' . trim( + $base_url, + '/' + ) . '/task' . $param_sep . 'backup/download' . $param_sep . $download . '/admin-nonce' . $param_sep . Utils::getNonce('admin-form'); + + return $url; + } + + /** + * @return array + */ + public static function getBackupProfiles() + { + return Grav::instance()['config']->get('backups.profiles'); + } + + /** + * @return array + */ + public static function getPurgeConfig() + { + return Grav::instance()['config']->get('backups.purge'); + } + + /** + * @return array + */ + public function getBackupNames() + { + return array_column(static::getBackupProfiles(), 'name'); + } + + /** + * @return float|int + */ + public static function getTotalBackupsSize() + { + $backups = static::getAvailableBackups(); + + return $backups ? array_sum(array_column($backups, 'size')) : 0; + } + + /** + * @param bool $force + * @return array + */ + public static function getAvailableBackups($force = false) + { + if ($force || null === static::$backups) { + static::$backups = []; + + $grav = Grav::instance(); + $backups_itr = new GlobIterator(static::$backup_dir . '/*.zip', FilesystemIterator::KEY_AS_FILENAME); + $inflector = $grav['inflector']; + $long_date_format = DATE_RFC2822; + + /** + * @var string $name + * @var SplFileInfo $file + */ + foreach ($backups_itr as $name => $file) { + if (preg_match(static::BACKUP_FILENAME_REGEXZ, $name, $matches)) { + $date = DateTime::createFromFormat(static::BACKUP_DATE_FORMAT, $matches[2]); + $timestamp = $date->getTimestamp(); + $backup = new stdClass(); + $backup->title = $inflector->titleize($matches[1]); + $backup->time = $date; + $backup->date = $date->format($long_date_format); + $backup->filename = $name; + $backup->path = $file->getPathname(); + $backup->size = $file->getSize(); + static::$backups[$timestamp] = $backup; + } + } + // Reverse Key Sort to get in reverse date order + krsort(static::$backups); + } + + return static::$backups; + } + + /** + * Backup + * + * @param int $id + * @param callable|null $status + * @return string|null + */ + public static function backup($id = 0, callable $status = null) + { + $grav = Grav::instance(); + + $profiles = static::getBackupProfiles(); + /** @var UniformResourceLocator $locator */ + $locator = $grav['locator']; + + if (isset($profiles[$id])) { + $backup = (object) $profiles[$id]; + } else { + throw new RuntimeException('No backups defined...'); + } + + $name = $grav['inflector']->underscorize($backup->name); + $date = date(static::BACKUP_DATE_FORMAT, time()); + $filename = trim($name, '_') . '--' . $date . '.zip'; + $destination = static::$backup_dir . DS . $filename; + $max_execution_time = ini_set('max_execution_time', '600'); + $backup_root = $backup->root; + + if ($locator->isStream($backup_root)) { + $backup_root = $locator->findResource($backup_root); + } else { + $backup_root = rtrim(GRAV_ROOT . $backup_root, '/'); + } + + if (!$backup_root || !file_exists($backup_root)) { + throw new RuntimeException("Backup location: {$backup_root} does not exist..."); + } + + $options = [ + 'exclude_files' => static::convertExclude($backup->exclude_files ?? ''), + 'exclude_paths' => static::convertExclude($backup->exclude_paths ?? ''), + ]; + + $archiver = Archiver::create('zip'); + $archiver->setArchive($destination)->setOptions($options)->compress($backup_root, $status)->addEmptyFolders($options['exclude_paths'], $status); + + $status && $status([ + 'type' => 'message', + 'message' => 'Done...', + ]); + + $status && $status([ + 'type' => 'progress', + 'complete' => true + ]); + + if ($max_execution_time !== false) { + ini_set('max_execution_time', $max_execution_time); + } + + // Log the backup + $grav['log']->notice('Backup Created: ' . $destination); + + // Fire Finished event + $grav->fireEvent('onBackupFinished', new Event(['backup' => $destination])); + + // Purge anything required + static::purge(); + + // Log + $log = JsonFile::instance($locator->findResource("log://backup.log", true, true)); + $log->content([ + 'time' => time(), + 'location' => $destination + ]); + $log->save(); + + return $destination; + } + + /** + * @return void + * @throws Exception + */ + public static function purge() + { + $purge_config = static::getPurgeConfig(); + $trigger = $purge_config['trigger']; + $backups = static::getAvailableBackups(true); + + switch ($trigger) { + case 'number': + $backups_count = count($backups); + if ($backups_count > $purge_config['max_backups_count']) { + $last = end($backups); + unlink($last->path); + static::purge(); + } + break; + + case 'time': + $last = end($backups); + $now = new DateTime(); + $interval = $now->diff($last->time); + if ($interval->days > $purge_config['max_backups_time']) { + unlink($last->path); + static::purge(); + } + break; + + default: + $used_space = static::getTotalBackupsSize(); + $max_space = $purge_config['max_backups_space'] * 1024 * 1024 * 1024; + if ($used_space > $max_space) { + $last = end($backups); + unlink($last->path); + static::purge(); + } + break; + } + } + + /** + * @param string $exclude + * @return array + */ + protected static function convertExclude($exclude) + { + $lines = preg_split("/[\s,]+/", $exclude); + + return array_map('trim', $lines, array_fill(0, count($lines), '/')); + } +} diff --git a/system/src/Grav/Common/Browser.php b/system/src/Grav/Common/Browser.php new file mode 100644 index 0000000..6a92eee --- /dev/null +++ b/system/src/Grav/Common/Browser.php @@ -0,0 +1,153 @@ +useragent = parse_user_agent(); + } catch (InvalidArgumentException $e) { + $this->useragent = parse_user_agent("Mozilla/5.0 (compatible; Unknown;)"); + } + } + + /** + * Get the current browser identifier + * + * Currently detected browsers: + * + * Android Browser + * BlackBerry Browser + * Camino + * Kindle / Silk + * Firefox / Iceweasel + * Safari + * Internet Explorer + * IEMobile + * Chrome + * Opera + * Midori + * Vivaldi + * TizenBrowser + * Lynx + * Wget + * Curl + * + * @return string the lowercase browser name + */ + public function getBrowser() + { + return strtolower($this->useragent['browser']); + } + + /** + * Get the current platform identifier + * + * Currently detected platforms: + * + * Desktop + * -> Windows + * -> Linux + * -> Macintosh + * -> Chrome OS + * Mobile + * -> Android + * -> iPhone + * -> iPad / iPod Touch + * -> Windows Phone OS + * -> Kindle + * -> Kindle Fire + * -> BlackBerry + * -> Playbook + * -> Tizen + * Console + * -> Nintendo 3DS + * -> New Nintendo 3DS + * -> Nintendo Wii + * -> Nintendo WiiU + * -> PlayStation 3 + * -> PlayStation 4 + * -> PlayStation Vita + * -> Xbox 360 + * -> Xbox One + * + * @return string the lowercase platform name + */ + public function getPlatform() + { + return strtolower($this->useragent['platform']); + } + + /** + * Get the current full version identifier + * + * @return string the browser full version identifier + */ + public function getLongVersion() + { + return $this->useragent['version']; + } + + /** + * Get the current major version identifier + * + * @return int the browser major version identifier + */ + public function getVersion() + { + $version = explode('.', $this->getLongVersion()); + + return (int)$version[0]; + } + + /** + * Determine if the request comes from a human, or from a bot/crawler + * + * @return bool + */ + public function isHuman() + { + $browser = $this->getBrowser(); + if (empty($browser)) { + return false; + } + + if (preg_match('~(bot|crawl)~i', $browser)) { + return false; + } + + return true; + } + + /** + * Determine if “Do Not Track” is set by browser + * @see https://www.w3.org/TR/tracking-dnt/ + * + * @return bool + */ + public function isTrackable(): bool + { + return !(isset($_SERVER['HTTP_DNT']) && $_SERVER['HTTP_DNT'] === '1'); + } +} diff --git a/system/src/Grav/Common/Cache.php b/system/src/Grav/Common/Cache.php new file mode 100644 index 0000000..acb68e0 --- /dev/null +++ b/system/src/Grav/Common/Cache.php @@ -0,0 +1,690 @@ +init($grav); + } + + /** + * Initialization that sets a base key and the driver based on configuration settings + * + * @param Grav $grav + * @return void + */ + public function init(Grav $grav) + { + $this->config = $grav['config']; + $this->now = time(); + + if (null === $this->enabled) { + $this->enabled = (bool)$this->config->get('system.cache.enabled'); + } + + /** @var Uri $uri */ + $uri = $grav['uri']; + + $prefix = $this->config->get('system.cache.prefix'); + $uniqueness = substr(md5($uri->rootUrl(true) . $this->config->key() . GRAV_VERSION), 2, 8); + + // Cache key allows us to invalidate all cache on configuration changes. + $this->key = ($prefix ?: 'g') . '-' . $uniqueness; + $this->cache_dir = $grav['locator']->findResource('cache://doctrine/' . $uniqueness, true, true); + $this->driver_setting = $this->config->get('system.cache.driver'); + $this->driver = $this->getCacheDriver(); + $this->driver->setNamespace($this->key); + + /** @var EventDispatcher $dispatcher */ + $dispatcher = Grav::instance()['events']; + $dispatcher->addListener('onSchedulerInitialized', [$this, 'onSchedulerInitialized']); + } + + /** + * @return CacheInterface + */ + public function getSimpleCache() + { + if (null === $this->simpleCache) { + $cache = new \Grav\Framework\Cache\Adapter\DoctrineCache($this->driver, '', $this->getLifetime()); + + // Disable cache key validation. + $cache->setValidation(false); + + $this->simpleCache = $cache; + } + + return $this->simpleCache; + } + + /** + * Deletes the old out of date file-based caches + * + * @return int + */ + public function purgeOldCache() + { + $cache_dir = dirname($this->cache_dir); + $current = Utils::basename($this->cache_dir); + $count = 0; + + foreach (new DirectoryIterator($cache_dir) as $file) { + $dir = $file->getBasename(); + if ($dir === $current || $file->isDot() || $file->isFile()) { + continue; + } + + Folder::delete($file->getPathname()); + $count++; + } + + return $count; + } + + /** + * Public accessor to set the enabled state of the cache + * + * @param bool|int $enabled + * @return void + */ + public function setEnabled($enabled) + { + $this->enabled = (bool)$enabled; + } + + /** + * Returns the current enabled state + * + * @return bool + */ + public function getEnabled() + { + return $this->enabled; + } + + /** + * Get cache state + * + * @return string + */ + public function getCacheStatus() + { + return 'Cache: [' . ($this->enabled ? 'true' : 'false') . '] Setting: [' . $this->driver_setting . '] Driver: [' . $this->driver_name . ']'; + } + + /** + * Automatically picks the cache mechanism to use. If you pick one manually it will use that + * If there is no config option for $driver in the config, or it's set to 'auto', it will + * pick the best option based on which cache extensions are installed. + * + * @return DoctrineCache\CacheProvider The cache driver to use + */ + public function getCacheDriver() + { + $setting = $this->driver_setting; + $driver_name = 'file'; + + // CLI compatibility requires a non-volatile cache driver + if ($this->config->get('system.cache.cli_compatibility') && ( + $setting === 'auto' || $this->isVolatileDriver($setting))) { + $setting = $driver_name; + } + + if (!$setting || $setting === 'auto') { + if (extension_loaded('apcu')) { + $driver_name = 'apcu'; + } elseif (extension_loaded('wincache')) { + $driver_name = 'wincache'; + } + } else { + $driver_name = $setting; + } + + $this->driver_name = $driver_name; + + switch ($driver_name) { + case 'apc': + case 'apcu': + $driver = new DoctrineCache\ApcuCache(); + break; + + case 'wincache': + $driver = new DoctrineCache\WinCacheCache(); + break; + + case 'memcache': + if (extension_loaded('memcache')) { + $memcache = new \Memcache(); + $memcache->connect( + $this->config->get('system.cache.memcache.server', 'localhost'), + $this->config->get('system.cache.memcache.port', 11211) + ); + $driver = new DoctrineCache\MemcacheCache(); + $driver->setMemcache($memcache); + } else { + throw new LogicException('Memcache PHP extension has not been installed'); + } + break; + + case 'memcached': + if (extension_loaded('memcached')) { + $memcached = new \Memcached(); + $memcached->addServer( + $this->config->get('system.cache.memcached.server', 'localhost'), + $this->config->get('system.cache.memcached.port', 11211) + ); + $driver = new DoctrineCache\MemcachedCache(); + $driver->setMemcached($memcached); + } else { + throw new LogicException('Memcached PHP extension has not been installed'); + } + break; + + case 'redis': + if (extension_loaded('redis')) { + $redis = new \Redis(); + $socket = $this->config->get('system.cache.redis.socket', false); + $password = $this->config->get('system.cache.redis.password', false); + $databaseId = $this->config->get('system.cache.redis.database', 0); + + if ($socket) { + $redis->connect($socket); + } else { + $redis->connect( + $this->config->get('system.cache.redis.server', 'localhost'), + $this->config->get('system.cache.redis.port', 6379) + ); + } + + // Authenticate with password if set + if ($password && !$redis->auth($password)) { + throw new \RedisException('Redis authentication failed'); + } + + // Select alternate ( !=0 ) database ID if set + if ($databaseId && !$redis->select($databaseId)) { + throw new \RedisException('Could not select alternate Redis database ID'); + } + + $driver = new DoctrineCache\RedisCache(); + $driver->setRedis($redis); + } else { + throw new LogicException('Redis PHP extension has not been installed'); + } + break; + + default: + $driver = new DoctrineCache\FilesystemCache($this->cache_dir); + break; + } + + return $driver; + } + + /** + * Gets a cached entry if it exists based on an id. If it does not exist, it returns false + * + * @param string $id the id of the cached entry + * @return mixed|bool returns the cached entry, can be any type, or false if doesn't exist + */ + public function fetch($id) + { + if ($this->enabled) { + return $this->driver->fetch($id); + } + + return false; + } + + /** + * Stores a new cached entry. + * + * @param string $id the id of the cached entry + * @param array|object|int $data the data for the cached entry to store + * @param int|null $lifetime the lifetime to store the entry in seconds + */ + public function save($id, $data, $lifetime = null) + { + if ($this->enabled) { + if ($lifetime === null) { + $lifetime = $this->getLifetime(); + } + $this->driver->save($id, $data, $lifetime); + } + } + + /** + * Deletes an item in the cache based on the id + * + * @param string $id the id of the cached data entry + * @return bool true if the item was deleted successfully + */ + public function delete($id) + { + if ($this->enabled) { + return $this->driver->delete($id); + } + + return false; + } + + /** + * Deletes all cache + * + * @return bool + */ + public function deleteAll() + { + if ($this->enabled) { + return $this->driver->deleteAll(); + } + + return false; + } + + /** + * Returns a boolean state of whether or not the item exists in the cache based on id key + * + * @param string $id the id of the cached data entry + * @return bool true if the cached items exists + */ + public function contains($id) + { + if ($this->enabled) { + return $this->driver->contains(($id)); + } + + return false; + } + + /** + * Getter method to get the cache key + * + * @return string + */ + public function getKey() + { + return $this->key; + } + + /** + * Setter method to set key (Advanced) + * + * @param string $key + * @return void + */ + public function setKey($key) + { + $this->key = $key; + $this->driver->setNamespace($this->key); + } + + /** + * Helper method to clear all Grav caches + * + * @param string $remove standard|all|assets-only|images-only|cache-only + * @return array + */ + public static function clearCache($remove = 'standard') + { + $locator = Grav::instance()['locator']; + $output = []; + $user_config = USER_DIR . 'config/system.yaml'; + + switch ($remove) { + case 'all': + $remove_paths = self::$all_remove; + break; + case 'assets-only': + $remove_paths = self::$assets_remove; + break; + case 'images-only': + $remove_paths = self::$images_remove; + break; + case 'cache-only': + $remove_paths = self::$cache_remove; + break; + case 'tmp-only': + $remove_paths = self::$tmp_remove; + break; + case 'invalidate': + $remove_paths = []; + break; + default: + if (Grav::instance()['config']->get('system.cache.clear_images_by_default')) { + $remove_paths = self::$standard_remove; + } else { + $remove_paths = self::$standard_remove_no_images; + } + } + + // Delete entries in the doctrine cache if required + if (in_array($remove, ['all', 'standard'])) { + $cache = Grav::instance()['cache']; + $cache->driver->deleteAll(); + } + + // Clearing cache event to add paths to clear + Grav::instance()->fireEvent('onBeforeCacheClear', new Event(['remove' => $remove, 'paths' => &$remove_paths])); + + foreach ($remove_paths as $stream) { + // Convert stream to a real path + try { + $path = $locator->findResource($stream, true, true); + if ($path === false) { + continue; + } + + $anything = false; + $files = glob($path . '/*'); + + if (is_array($files)) { + foreach ($files as $file) { + if (is_link($file)) { + $output[] = 'Skipping symlink: ' . $file; + } elseif (is_file($file)) { + if (@unlink($file)) { + $anything = true; + } + } elseif (is_dir($file)) { + if (Folder::delete($file, false)) { + $anything = true; + } + } + } + } + + if ($anything) { + $output[] = 'Cleared: ' . $path . '/*'; + } + } catch (Exception $e) { + // stream not found or another error while deleting files. + $output[] = 'ERROR: ' . $e->getMessage(); + } + } + + $output[] = ''; + + if (($remove === 'all' || $remove === 'standard') && file_exists($user_config)) { + touch($user_config); + + $output[] = 'Touched: ' . $user_config; + $output[] = ''; + } + + // Clear stat cache + @clearstatcache(); + + // Clear opcache + if (function_exists('opcache_reset')) { + @opcache_reset(); + } + + Grav::instance()->fireEvent('onAfterCacheClear', new Event(['remove' => $remove, 'output' => &$output])); + + return $output; + } + + /** + * @return void + */ + public static function invalidateCache() + { + $user_config = USER_DIR . 'config/system.yaml'; + + if (file_exists($user_config)) { + touch($user_config); + } + + // Clear stat cache + @clearstatcache(); + + // Clear opcache + if (function_exists('opcache_reset')) { + @opcache_reset(); + } + } + + /** + * Set the cache lifetime programmatically + * + * @param int $future timestamp + * @return void + */ + public function setLifetime($future) + { + if (!$future) { + return; + } + + $interval = (int)($future - $this->now); + if ($interval > 0 && $interval < $this->getLifetime()) { + $this->lifetime = $interval; + } + } + + + /** + * Retrieve the cache lifetime (in seconds) + * + * @return int + */ + public function getLifetime() + { + if ($this->lifetime === null) { + $this->lifetime = (int)($this->config->get('system.cache.lifetime') ?: 604800); // 1 week default + } + + return $this->lifetime; + } + + /** + * Returns the current driver name + * + * @return string + */ + public function getDriverName() + { + return $this->driver_name; + } + + /** + * Returns the current driver setting + * + * @return string + */ + public function getDriverSetting() + { + return $this->driver_setting; + } + + /** + * is this driver a volatile driver in that it resides in PHP process memory + * + * @param string $setting + * @return bool + */ + public function isVolatileDriver($setting) + { + return in_array($setting, ['apc', 'apcu', 'xcache', 'wincache'], true); + } + + /** + * Static function to call as a scheduled Job to purge old Doctrine files + * + * @param bool $echo + * + * @return string|void + */ + public static function purgeJob($echo = false) + { + /** @var Cache $cache */ + $cache = Grav::instance()['cache']; + $deleted_folders = $cache->purgeOldCache(); + $msg = 'Purged ' . $deleted_folders . ' old cache folders...'; + + if ($echo) { + echo $msg; + } else { + return $msg; + } + } + + /** + * Static function to call as a scheduled Job to clear Grav cache + * + * @param string $type + * @return void + */ + public static function clearJob($type) + { + $result = static::clearCache($type); + static::invalidateCache(); + + echo strip_tags(implode("\n", $result)); + } + + /** + * @param Event $event + * @return void + */ + public function onSchedulerInitialized(Event $event) + { + /** @var Scheduler $scheduler */ + $scheduler = $event['scheduler']; + $config = Grav::instance()['config']; + + // File Cache Purge + $at = $config->get('system.cache.purge_at'); + $name = 'cache-purge'; + $logs = 'logs/' . $name . '.out'; + + $job = $scheduler->addFunction('Grav\Common\Cache::purgeJob', [true], $name); + $job->at($at); + $job->output($logs); + $job->backlink('/config/system#caching'); + + // Cache Clear + $at = $config->get('system.cache.clear_at'); + $clear_type = $config->get('system.cache.clear_job_type'); + $name = 'cache-clear'; + $logs = 'logs/' . $name . '.out'; + + $job = $scheduler->addFunction('Grav\Common\Cache::clearJob', [$clear_type], $name); + $job->at($at); + $job->output($logs); + $job->backlink('/config/system#caching'); + } +} diff --git a/system/src/Grav/Common/Composer.php b/system/src/Grav/Common/Composer.php new file mode 100644 index 0000000..65ba505 --- /dev/null +++ b/system/src/Grav/Common/Composer.php @@ -0,0 +1,67 @@ +path = $path ? rtrim($path, '\\/') . '/' : ''; + $this->cacheFolder = $cacheFolder; + $this->files = $files; + } + + /** + * Get filename for the compiled PHP file. + * + * @param string|null $name + * @return $this + */ + public function name($name = null) + { + if (!$this->name) { + $this->name = $name ?: md5(json_encode(array_keys($this->files))); + } + + return $this; + } + + /** + * Function gets called when cached configuration is saved. + * + * @return void + */ + public function modified() + { + } + + /** + * Get timestamp of compiled configuration + * + * @return int Timestamp of compiled configuration + */ + public function timestamp() + { + return $this->timestamp ?: time(); + } + + /** + * Load the configuration. + * + * @return mixed + */ + public function load() + { + if ($this->object) { + return $this->object; + } + + $filename = $this->createFilename(); + if (!$this->loadCompiledFile($filename) && $this->loadFiles()) { + $this->saveCompiledFile($filename); + } + + return $this->object; + } + + /** + * Returns checksum from the configuration files. + * + * You can set $this->checksum = false to disable this check. + * + * @return bool|string + */ + public function checksum() + { + if (null === $this->checksum) { + $this->checksum = md5(json_encode($this->files) . $this->version); + } + + return $this->checksum; + } + + /** + * @return string + */ + protected function createFilename() + { + return "{$this->cacheFolder}/{$this->name()->name}.php"; + } + + /** + * Create configuration object. + * + * @param array $data + * @return void + */ + abstract protected function createObject(array $data = []); + + /** + * Finalize configuration object. + * + * @return void + */ + abstract protected function finalizeObject(); + + /** + * Load single configuration file and append it to the correct position. + * + * @param string $name Name of the position. + * @param string|string[] $filename File(s) to be loaded. + * @return void + */ + abstract protected function loadFile($name, $filename); + + /** + * Load and join all configuration files. + * + * @return bool + * @internal + */ + protected function loadFiles() + { + $this->createObject(); + + $list = array_reverse($this->files); + foreach ($list as $files) { + foreach ($files as $name => $item) { + $this->loadFile($name, $this->path . $item['file']); + } + } + + $this->finalizeObject(); + + return true; + } + + /** + * Load compiled file. + * + * @param string $filename + * @return bool + * @internal + */ + protected function loadCompiledFile($filename) + { + if (!file_exists($filename)) { + return false; + } + + $cache = include $filename; + if (!is_array($cache) + || !isset($cache['checksum'], $cache['data'], $cache['@class']) + || $cache['@class'] !== get_class($this) + ) { + return false; + } + + // Load real file if cache isn't up to date (or is invalid). + if ($cache['checksum'] !== $this->checksum()) { + return false; + } + + $this->createObject($cache['data']); + $this->timestamp = $cache['timestamp'] ?? 0; + + $this->finalizeObject(); + + return true; + } + + /** + * Save compiled file. + * + * @param string $filename + * @return void + * @throws RuntimeException + * @internal + */ + protected function saveCompiledFile($filename) + { + $file = PhpFile::instance($filename); + + // Attempt to lock the file for writing. + try { + $file->lock(false); + } catch (Exception $e) { + // Another process has locked the file; we will check this in a bit. + } + + if ($file->locked() === false) { + // File was already locked by another process. + return; + } + + $cache = [ + '@class' => get_class($this), + 'timestamp' => time(), + 'checksum' => $this->checksum(), + 'files' => $this->files, + 'data' => $this->getState() + ]; + + $file->save($cache); + $file->unlock(); + $file->free(); + + $this->modified(); + } + + /** + * @return array + */ + protected function getState() + { + return $this->object->toArray(); + } +} diff --git a/system/src/Grav/Common/Config/CompiledBlueprints.php b/system/src/Grav/Common/Config/CompiledBlueprints.php new file mode 100644 index 0000000..ca7173c --- /dev/null +++ b/system/src/Grav/Common/Config/CompiledBlueprints.php @@ -0,0 +1,131 @@ +version = 2; + } + + /** + * Returns checksum from the configuration files. + * + * You can set $this->checksum = false to disable this check. + * + * @return bool|string + */ + public function checksum() + { + if (null === $this->checksum) { + $this->checksum = md5(json_encode($this->files) . json_encode($this->getTypes()) . $this->version); + } + + return $this->checksum; + } + + /** + * Create configuration object. + * + * @param array $data + */ + protected function createObject(array $data = []) + { + $this->object = (new BlueprintSchema($data))->setTypes($this->getTypes()); + } + + /** + * Get list of form field types. + * + * @return array + */ + protected function getTypes() + { + return Grav::instance()['plugins']->formFieldTypes ?: []; + } + + /** + * Finalize configuration object. + * + * @return void + */ + protected function finalizeObject() + { + } + + /** + * Load single configuration file and append it to the correct position. + * + * @param string $name Name of the position. + * @param array $files Files to be loaded. + * @return void + */ + protected function loadFile($name, $files) + { + // Load blueprint file. + $blueprint = new Blueprint($files); + + $this->object->embed($name, $blueprint->load()->toArray(), '/', true); + } + + /** + * Load and join all configuration files. + * + * @return bool + * @internal + */ + protected function loadFiles() + { + $this->createObject(); + + // Convert file list into parent list. + $list = []; + /** @var array $files */ + foreach ($this->files as $files) { + foreach ($files as $name => $item) { + $list[$name][] = $this->path . $item['file']; + } + } + + // Load files. + foreach ($list as $name => $files) { + $this->loadFile($name, $files); + } + + $this->finalizeObject(); + + return true; + } + + /** + * @return array + */ + protected function getState() + { + return $this->object->getState(); + } +} diff --git a/system/src/Grav/Common/Config/CompiledConfig.php b/system/src/Grav/Common/Config/CompiledConfig.php new file mode 100644 index 0000000..85bb5e3 --- /dev/null +++ b/system/src/Grav/Common/Config/CompiledConfig.php @@ -0,0 +1,114 @@ +version = 1; + } + + /** + * Set blueprints for the configuration. + * + * @param callable $blueprints + * @return $this + */ + public function setBlueprints(callable $blueprints) + { + $this->callable = $blueprints; + + return $this; + } + + /** + * @param bool $withDefaults + * @return mixed + */ + public function load($withDefaults = false) + { + $this->withDefaults = $withDefaults; + + return parent::load(); + } + + /** + * Create configuration object. + * + * @param array $data + * @return void + */ + protected function createObject(array $data = []) + { + if ($this->withDefaults && empty($data) && is_callable($this->callable)) { + $blueprints = $this->callable; + $data = $blueprints()->getDefaults(); + } + + $this->object = new Config($data, $this->callable); + } + + /** + * Finalize configuration object. + * + * @return void + */ + protected function finalizeObject() + { + $this->object->checksum($this->checksum()); + $this->object->timestamp($this->timestamp()); + } + + /** + * Function gets called when cached configuration is saved. + * + * @return void + */ + public function modified() + { + $this->object->modified(true); + } + + /** + * Load single configuration file and append it to the correct position. + * + * @param string $name Name of the position. + * @param string $filename File to be loaded. + * @return void + */ + protected function loadFile($name, $filename) + { + $file = CompiledYamlFile::instance($filename); + $this->object->join($name, $file->content(), '/'); + $file->free(); + } +} diff --git a/system/src/Grav/Common/Config/CompiledLanguages.php b/system/src/Grav/Common/Config/CompiledLanguages.php new file mode 100644 index 0000000..7e6692c --- /dev/null +++ b/system/src/Grav/Common/Config/CompiledLanguages.php @@ -0,0 +1,83 @@ +version = 1; + } + + /** + * Create configuration object. + * + * @param array $data + * @return void + */ + protected function createObject(array $data = []) + { + $this->object = new Languages($data); + } + + /** + * Finalize configuration object. + * + * @return void + */ + protected function finalizeObject() + { + $this->object->checksum($this->checksum()); + $this->object->timestamp($this->timestamp()); + } + + + /** + * Function gets called when cached configuration is saved. + * + * @return void + */ + public function modified() + { + $this->object->modified(true); + } + + /** + * Load single configuration file and append it to the correct position. + * + * @param string $name Name of the position. + * @param string $filename File to be loaded. + * @return void + */ + protected function loadFile($name, $filename) + { + $file = CompiledYamlFile::instance($filename); + if (preg_match('|languages\.yaml$|', $filename)) { + $this->object->mergeRecursive((array) $file->content()); + } else { + $this->object->mergeRecursive([$name => $file->content()]); + } + $file->free(); + } +} diff --git a/system/src/Grav/Common/Config/Config.php b/system/src/Grav/Common/Config/Config.php new file mode 100644 index 0000000..17eb117 --- /dev/null +++ b/system/src/Grav/Common/Config/Config.php @@ -0,0 +1,156 @@ +key) { + $this->key = md5($this->checksum . $this->timestamp); + } + + return $this->key; + } + + /** + * @param string|null $checksum + * @return string|null + */ + public function checksum($checksum = null) + { + if ($checksum !== null) { + $this->checksum = $checksum; + } + + return $this->checksum; + } + + /** + * @param bool|null $modified + * @return bool + */ + public function modified($modified = null) + { + if ($modified !== null) { + $this->modified = $modified; + } + + return $this->modified; + } + + /** + * @param int|null $timestamp + * @return int + */ + public function timestamp($timestamp = null) + { + if ($timestamp !== null) { + $this->timestamp = $timestamp; + } + + return $this->timestamp; + } + + /** + * @return $this + */ + public function reload() + { + $grav = Grav::instance(); + + // Load new configuration. + $config = ConfigServiceProvider::load($grav); + + /** @var Debugger $debugger */ + $debugger = $grav['debugger']; + + if ($config->modified()) { + // Update current configuration. + $this->items = $config->toArray(); + $this->checksum($config->checksum()); + $this->modified(true); + + $debugger->addMessage('Configuration was changed and saved.'); + } + + return $this; + } + + /** + * @return void + */ + public function debug() + { + /** @var Debugger $debugger */ + $debugger = Grav::instance()['debugger']; + + $debugger->addMessage('Environment Name: ' . $this->environment); + if ($this->modified()) { + $debugger->addMessage('Configuration reloaded and cached.'); + } + } + + /** + * @return void + */ + public function init() + { + $setup = Grav::instance()['setup']->toArray(); + foreach ($setup as $key => $value) { + if ($key === 'streams' || !is_array($value)) { + // Optimized as streams and simple values are fully defined in setup. + $this->items[$key] = $value; + } else { + $this->joinDefaults($key, $value); + } + } + + // Legacy value - Override the media.upload_limit based on PHP values + $this->items['system']['media']['upload_limit'] = Utils::getUploadLimit(); + } + + /** + * @return mixed + * @deprecated 1.5 Use Grav::instance()['languages'] instead. + */ + public function getLanguages() + { + user_error(__CLASS__ . '::' . __FUNCTION__ . '() is deprecated since Grav 1.5, use Grav::instance()[\'languages\'] instead', E_USER_DEPRECATED); + + return Grav::instance()['languages']; + } +} diff --git a/system/src/Grav/Common/Config/ConfigFileFinder.php b/system/src/Grav/Common/Config/ConfigFileFinder.php new file mode 100644 index 0000000..6381e48 --- /dev/null +++ b/system/src/Grav/Common/Config/ConfigFileFinder.php @@ -0,0 +1,273 @@ +base = $base ? "{$base}/" : ''; + + return $this; + } + + /** + * Return all locations for all the files with a timestamp. + * + * @param array $paths List of folders to look from. + * @param string $pattern Pattern to match the file. Pattern will also be removed from the key. + * @param int $levels Maximum number of recursive directories. + * @return array + */ + public function locateFiles(array $paths, $pattern = '|\.yaml$|', $levels = -1) + { + $list = []; + foreach ($paths as $folder) { + $list += $this->detectRecursive($folder, $pattern, $levels); + } + + return $list; + } + + /** + * Return all locations for all the files with a timestamp. + * + * @param array $paths List of folders to look from. + * @param string $pattern Pattern to match the file. Pattern will also be removed from the key. + * @param int $levels Maximum number of recursive directories. + * @return array + */ + public function getFiles(array $paths, $pattern = '|\.yaml$|', $levels = -1) + { + $list = []; + foreach ($paths as $folder) { + $path = trim(Folder::getRelativePath($folder), '/'); + + $files = $this->detectRecursive($folder, $pattern, $levels); + + $list += $files[trim($path, '/')]; + } + + return $list; + } + + /** + * Return all paths for all the files with a timestamp. + * + * @param array $paths List of folders to look from. + * @param string $pattern Pattern to match the file. Pattern will also be removed from the key. + * @param int $levels Maximum number of recursive directories. + * @return array + */ + public function listFiles(array $paths, $pattern = '|\.yaml$|', $levels = -1) + { + $list = []; + foreach ($paths as $folder) { + $list = array_merge_recursive($list, $this->detectAll($folder, $pattern, $levels)); + } + + return $list; + } + + /** + * Find filename from a list of folders. + * + * Note: Only finds the last override. + * + * @param string $filename + * @param array $folders + * @return array + */ + public function locateFileInFolder($filename, array $folders) + { + $list = []; + foreach ($folders as $folder) { + $list += $this->detectInFolder($folder, $filename); + } + + return $list; + } + + /** + * Find filename from a list of folders. + * + * @param array $folders + * @param string|null $filename + * @return array + */ + public function locateInFolders(array $folders, $filename = null) + { + $list = []; + foreach ($folders as $folder) { + $path = trim(Folder::getRelativePath($folder), '/'); + $list[$path] = $this->detectInFolder($folder, $filename); + } + + return $list; + } + + /** + * Return all existing locations for a single file with a timestamp. + * + * @param array $paths Filesystem paths to look up from. + * @param string $name Configuration file to be located. + * @param string $ext File extension (optional, defaults to .yaml). + * @return array + */ + public function locateFile(array $paths, $name, $ext = '.yaml') + { + $filename = preg_replace('|[.\/]+|', '/', $name) . $ext; + + $list = []; + foreach ($paths as $folder) { + $path = trim(Folder::getRelativePath($folder), '/'); + + if (is_file("{$folder}/{$filename}")) { + $modified = filemtime("{$folder}/{$filename}"); + } else { + $modified = 0; + } + $basename = $this->base . $name; + $list[$path] = [$basename => ['file' => "{$path}/{$filename}", 'modified' => $modified]]; + } + + return $list; + } + + /** + * Detects all directories with a configuration file and returns them with last modification time. + * + * @param string $folder Location to look up from. + * @param string $pattern Pattern to match the file. Pattern will also be removed from the key. + * @param int $levels Maximum number of recursive directories. + * @return array + * @internal + */ + protected function detectRecursive($folder, $pattern, $levels) + { + $path = trim(Folder::getRelativePath($folder), '/'); + + if (is_dir($folder)) { + // Find all system and user configuration files. + $options = [ + 'levels' => $levels, + 'compare' => 'Filename', + 'pattern' => $pattern, + 'filters' => [ + 'pre-key' => $this->base, + 'key' => $pattern, + 'value' => function (RecursiveDirectoryIterator $file) use ($path) { + return ['file' => "{$path}/{$file->getSubPathname()}", 'modified' => $file->getMTime()]; + } + ], + 'key' => 'SubPathname' + ]; + + $list = Folder::all($folder, $options); + + ksort($list); + } else { + $list = []; + } + + return [$path => $list]; + } + + /** + * Detects all directories with the lookup file and returns them with last modification time. + * + * @param string $folder Location to look up from. + * @param string|null $lookup Filename to be located (defaults to directory name). + * @return array + * @internal + */ + protected function detectInFolder($folder, $lookup = null) + { + $folder = rtrim($folder, '/'); + $path = trim(Folder::getRelativePath($folder), '/'); + $base = $path === $folder ? '' : ($path ? substr($folder, 0, -strlen($path)) : $folder . '/'); + + $list = []; + + if (is_dir($folder)) { + $iterator = new DirectoryIterator($folder); + foreach ($iterator as $directory) { + if (!$directory->isDir() || $directory->isDot()) { + continue; + } + + $name = $directory->getFilename(); + $find = ($lookup ?: $name) . '.yaml'; + $filename = "{$path}/{$name}/{$find}"; + + if (file_exists($base . $filename)) { + $basename = $this->base . $name; + $list[$basename] = ['file' => $filename, 'modified' => filemtime($base . $filename)]; + } + } + } + + return $list; + } + + /** + * Detects all plugins with a configuration file and returns them with last modification time. + * + * @param string $folder Location to look up from. + * @param string $pattern Pattern to match the file. Pattern will also be removed from the key. + * @param int $levels Maximum number of recursive directories. + * @return array + * @internal + */ + protected function detectAll($folder, $pattern, $levels) + { + $path = trim(Folder::getRelativePath($folder), '/'); + + if (is_dir($folder)) { + // Find all system and user configuration files. + $options = [ + 'levels' => $levels, + 'compare' => 'Filename', + 'pattern' => $pattern, + 'filters' => [ + 'pre-key' => $this->base, + 'key' => $pattern, + 'value' => function (RecursiveDirectoryIterator $file) use ($path) { + return ["{$path}/{$file->getSubPathname()}" => $file->getMTime()]; + } + ], + 'key' => 'SubPathname' + ]; + + $list = Folder::all($folder, $options); + + ksort($list); + } else { + $list = []; + } + + return $list; + } +} diff --git a/system/src/Grav/Common/Config/Languages.php b/system/src/Grav/Common/Config/Languages.php new file mode 100644 index 0000000..6152a6a --- /dev/null +++ b/system/src/Grav/Common/Config/Languages.php @@ -0,0 +1,107 @@ +checksum = $checksum; + } + + return $this->checksum; + } + + /** + * @param bool|null $modified + * @return bool + */ + public function modified($modified = null) + { + if ($modified !== null) { + $this->modified = $modified; + } + + return $this->modified; + } + + /** + * @param int|null $timestamp + * @return int + */ + public function timestamp($timestamp = null) + { + if ($timestamp !== null) { + $this->timestamp = $timestamp; + } + + return $this->timestamp; + } + + /** + * @return void + */ + public function reformat() + { + if (isset($this->items['plugins'])) { + $this->items = array_merge_recursive($this->items, $this->items['plugins']); + unset($this->items['plugins']); + } + } + + /** + * @param array $data + * @return void + */ + public function mergeRecursive(array $data) + { + $this->items = Utils::arrayMergeRecursiveUnique($this->items, $data); + } + + /** + * @param string $lang + * @return array + */ + public function flattenByLang($lang) + { + $language = $this->items[$lang]; + return Utils::arrayFlattenDotNotation($language); + } + + /** + * @param array $array + * @return array + */ + public function unflatten($array) + { + return Utils::arrayUnflattenDotNotation($array); + } +} diff --git a/system/src/Grav/Common/Config/Setup.php b/system/src/Grav/Common/Config/Setup.php new file mode 100644 index 0000000..ba9b52f --- /dev/null +++ b/system/src/Grav/Common/Config/Setup.php @@ -0,0 +1,423 @@ + 'unknown', + '127.0.0.1' => 'localhost', + '::1' => 'localhost' + ]; + + /** + * @var string|null Current environment normalized to lower case. + */ + public static $environment; + + /** @var string */ + public static $securityFile = 'config://security.yaml'; + + /** @var array */ + protected $streams = [ + 'user' => [ + 'type' => 'ReadOnlyStream', + 'force' => true, + 'prefixes' => [ + '' => [] // Set in constructor + ] + ], + 'cache' => [ + 'type' => 'Stream', + 'force' => true, + 'prefixes' => [ + '' => [], // Set in constructor + 'images' => ['images'] + ] + ], + 'log' => [ + 'type' => 'Stream', + 'force' => true, + 'prefixes' => [ + '' => [] // Set in constructor + ] + ], + 'tmp' => [ + 'type' => 'Stream', + 'force' => true, + 'prefixes' => [ + '' => [] // Set in constructor + ] + ], + 'backup' => [ + 'type' => 'Stream', + 'force' => true, + 'prefixes' => [ + '' => [] // Set in constructor + ] + ], + 'environment' => [ + 'type' => 'ReadOnlyStream' + // If not defined, environment will be set up in the constructor. + ], + 'system' => [ + 'type' => 'ReadOnlyStream', + 'prefixes' => [ + '' => ['system'], + ] + ], + 'asset' => [ + 'type' => 'Stream', + 'prefixes' => [ + '' => ['assets'], + ] + ], + 'blueprints' => [ + 'type' => 'ReadOnlyStream', + 'prefixes' => [ + '' => ['environment://blueprints', 'user://blueprints', 'system://blueprints'], + ] + ], + 'config' => [ + 'type' => 'ReadOnlyStream', + 'prefixes' => [ + '' => ['environment://config', 'user://config', 'system://config'], + ] + ], + 'plugins' => [ + 'type' => 'ReadOnlyStream', + 'prefixes' => [ + '' => ['user://plugins'], + ] + ], + 'plugin' => [ + 'type' => 'ReadOnlyStream', + 'prefixes' => [ + '' => ['user://plugins'], + ] + ], + 'themes' => [ + 'type' => 'ReadOnlyStream', + 'prefixes' => [ + '' => ['user://themes'], + ] + ], + 'languages' => [ + 'type' => 'ReadOnlyStream', + 'prefixes' => [ + '' => ['environment://languages', 'user://languages', 'system://languages'], + ] + ], + 'image' => [ + 'type' => 'Stream', + 'prefixes' => [ + '' => ['user://images', 'system://images'] + ] + ], + 'page' => [ + 'type' => 'ReadOnlyStream', + 'prefixes' => [ + '' => ['user://pages'] + ] + ], + 'user-data' => [ + 'type' => 'Stream', + 'force' => true, + 'prefixes' => [ + '' => ['user://data'] + ] + ], + 'account' => [ + 'type' => 'ReadOnlyStream', + 'prefixes' => [ + '' => ['user://accounts'] + ] + ], + ]; + + /** + * @param Container|array $container + */ + public function __construct($container) + { + // Configure main streams. + $abs = str_starts_with(GRAV_SYSTEM_PATH, '/'); + $this->streams['system']['prefixes'][''] = $abs ? ['system', GRAV_SYSTEM_PATH] : ['system']; + $this->streams['user']['prefixes'][''] = [GRAV_USER_PATH]; + $this->streams['cache']['prefixes'][''] = [GRAV_CACHE_PATH]; + $this->streams['log']['prefixes'][''] = [GRAV_LOG_PATH]; + $this->streams['tmp']['prefixes'][''] = [GRAV_TMP_PATH]; + $this->streams['backup']['prefixes'][''] = [GRAV_BACKUP_PATH]; + + // If environment is not set, look for the environment variable and then the constant. + $environment = static::$environment ?? + (defined('GRAV_ENVIRONMENT') ? GRAV_ENVIRONMENT : (getenv('GRAV_ENVIRONMENT') ?: null)); + + // If no environment is set, make sure we get one (CLI or hostname). + if (null === $environment) { + if (defined('GRAV_CLI')) { + $request = null; + $uri = null; + $environment = 'cli'; + } else { + /** @var ServerRequestInterface $request */ + $request = $container['request']; + $uri = $request->getUri(); + $environment = $uri->getHost(); + } + } + + // Resolve server aliases to the proper environment. + static::$environment = static::$environments[$environment] ?? $environment; + + // Pre-load setup.php which contains our initial configuration. + // Configuration may contain dynamic parts, which is why we need to always load it. + // If GRAV_SETUP_PATH has been defined, use it, otherwise use defaults. + $setupFile = defined('GRAV_SETUP_PATH') ? GRAV_SETUP_PATH : (getenv('GRAV_SETUP_PATH') ?: null); + if (null !== $setupFile) { + // Make sure that the custom setup file exists. Terminates the script if not. + if (!str_starts_with($setupFile, '/')) { + $setupFile = GRAV_WEBROOT . '/' . $setupFile; + } + if (!is_file($setupFile)) { + echo 'GRAV_SETUP_PATH is defined but does not point to existing setup file.'; + exit(1); + } + } else { + $setupFile = GRAV_WEBROOT . '/setup.php'; + if (!is_file($setupFile)) { + $setupFile = GRAV_WEBROOT . '/' . GRAV_USER_PATH . '/setup.php'; + } + if (!is_file($setupFile)) { + $setupFile = null; + } + } + $setup = $setupFile ? (array) include $setupFile : []; + + // Add default streams defined in beginning of the class. + if (!isset($setup['streams']['schemes'])) { + $setup['streams']['schemes'] = []; + } + $setup['streams']['schemes'] += $this->streams; + + // Initialize class. + parent::__construct($setup); + + $this->def('environment', static::$environment); + + // Figure out path for the current environment. + $envPath = defined('GRAV_ENVIRONMENT_PATH') ? GRAV_ENVIRONMENT_PATH : (getenv('GRAV_ENVIRONMENT_PATH') ?: null); + if (null === $envPath) { + // Find common path for all environments and append current environment into it. + $envPath = defined('GRAV_ENVIRONMENTS_PATH') ? GRAV_ENVIRONMENTS_PATH : (getenv('GRAV_ENVIRONMENTS_PATH') ?: null); + if (null !== $envPath) { + $envPath .= '/'; + } else { + // Use default location. Start with Grav 1.7 default. + $envPath = GRAV_WEBROOT. '/' . GRAV_USER_PATH . '/env'; + if (is_dir($envPath)) { + $envPath = 'user://env/'; + } else { + // Fallback to Grav 1.6 default. + $envPath = 'user://'; + } + } + $envPath .= $this->get('environment'); + } + + // Set up environment. + $this->def('environment', static::$environment); + $this->def('streams.schemes.environment.prefixes', ['' => [$envPath]]); + } + + /** + * @return $this + * @throws RuntimeException + * @throws InvalidArgumentException + */ + public function init() + { + $locator = new UniformResourceLocator(GRAV_WEBROOT); + $files = []; + + $guard = 5; + do { + $check = $files; + $this->initializeLocator($locator); + $files = $locator->findResources('config://streams.yaml'); + + if ($check === $files) { + break; + } + + // Update streams. + foreach (array_reverse($files) as $path) { + $file = CompiledYamlFile::instance($path); + $content = (array)$file->content(); + if (!empty($content['schemes'])) { + $this->items['streams']['schemes'] = $content['schemes'] + $this->items['streams']['schemes']; + } + } + } while (--$guard); + + if (!$guard) { + throw new RuntimeException('Setup: Configuration reload loop detected!'); + } + + // Make sure we have valid setup. + $this->check($locator); + + return $this; + } + + /** + * Initialize resource locator by using the configuration. + * + * @param UniformResourceLocator $locator + * @return void + * @throws BadMethodCallException + */ + public function initializeLocator(UniformResourceLocator $locator) + { + $locator->reset(); + + $schemes = (array) $this->get('streams.schemes', []); + + foreach ($schemes as $scheme => $config) { + if (isset($config['paths'])) { + $locator->addPath($scheme, '', $config['paths']); + } + + $override = $config['override'] ?? false; + $force = $config['force'] ?? false; + + if (isset($config['prefixes'])) { + foreach ((array)$config['prefixes'] as $prefix => $paths) { + $locator->addPath($scheme, $prefix, $paths, $override, $force); + } + } + } + } + + /** + * Get available streams and their types from the configuration. + * + * @return array + */ + public function getStreams() + { + $schemes = []; + foreach ((array) $this->get('streams.schemes') as $scheme => $config) { + $type = $config['type'] ?? 'ReadOnlyStream'; + if ($type[0] !== '\\') { + $type = '\\RocketTheme\\Toolbox\\StreamWrapper\\' . $type; + } + + $schemes[$scheme] = $type; + } + + return $schemes; + } + + /** + * @param UniformResourceLocator $locator + * @return void + * @throws InvalidArgumentException + * @throws BadMethodCallException + * @throws RuntimeException + */ + protected function check(UniformResourceLocator $locator) + { + $streams = $this->items['streams']['schemes'] ?? null; + if (!is_array($streams)) { + throw new InvalidArgumentException('Configuration is missing streams.schemes!'); + } + $diff = array_keys(array_diff_key($this->streams, $streams)); + if ($diff) { + throw new InvalidArgumentException( + sprintf('Configuration is missing keys %s from streams.schemes!', implode(', ', $diff)) + ); + } + + try { + // If environment is found, remove all missing override locations (B/C compatibility). + if ($locator->findResource('environment://', true)) { + $force = $this->get('streams.schemes.environment.force', false); + if (!$force) { + $prefixes = $this->get('streams.schemes.environment.prefixes.'); + $update = false; + foreach ($prefixes as $i => $prefix) { + if ($locator->isStream($prefix)) { + if ($locator->findResource($prefix, true)) { + break; + } + } elseif (file_exists($prefix)) { + break; + } + + unset($prefixes[$i]); + $update = true; + } + + if ($update) { + $this->set('streams.schemes.environment.prefixes', ['' => array_values($prefixes)]); + $this->initializeLocator($locator); + } + } + } + + if (!$locator->findResource('environment://config', true)) { + // If environment does not have its own directory, remove it from the lookup. + $prefixes = $this->get('streams.schemes.environment.prefixes'); + $prefixes['config'] = []; + + $this->set('streams.schemes.environment.prefixes', $prefixes); + $this->initializeLocator($locator); + } + + // Create security.yaml salt if it doesn't exist into existing configuration environment if possible. + $securityFile = Utils::basename(static::$securityFile); + $securityFolder = substr(static::$securityFile, 0, -\strlen($securityFile)); + $securityFolder = $locator->findResource($securityFolder, true) ?: $locator->findResource($securityFolder, true, true); + $filename = "{$securityFolder}/{$securityFile}"; + + $security_file = CompiledYamlFile::instance($filename); + $security_content = (array)$security_file->content(); + + if (!isset($security_content['salt'])) { + $security_content = array_merge($security_content, ['salt' => Utils::generateRandomString(14)]); + $security_file->content($security_content); + $security_file->save(); + $security_file->free(); + } + } catch (RuntimeException $e) { + throw new RuntimeException(sprintf('Grav failed to initialize: %s', $e->getMessage()), 500, $e); + } + } +} diff --git a/system/src/Grav/Common/Data/Blueprint.php b/system/src/Grav/Common/Data/Blueprint.php new file mode 100644 index 0000000..3e84dce --- /dev/null +++ b/system/src/Grav/Common/Data/Blueprint.php @@ -0,0 +1,594 @@ +blueprintSchema) { + $this->blueprintSchema = clone $this->blueprintSchema; + } + } + + /** + * @param string $scope + * @return void + */ + public function setScope($scope) + { + $this->scope = $scope; + } + + /** + * @param object $object + * @return void + */ + public function setObject($object) + { + $this->object = $object; + } + + /** + * Set default values for field types. + * + * @param array $types + * @return $this + */ + public function setTypes(array $types) + { + $this->initInternals(); + + $this->blueprintSchema->setTypes($types); + + return $this; + } + + /** + * @param string $name + * @return array|mixed|null + * @since 1.7 + */ + public function getDefaultValue(string $name) + { + $path = explode('.', $name); + $current = $this->getDefaults(); + + foreach ($path as $field) { + if (is_object($current) && isset($current->{$field})) { + $current = $current->{$field}; + } elseif (is_array($current) && isset($current[$field])) { + $current = $current[$field]; + } else { + return null; + } + } + + return $current; + } + + /** + * Get nested structure containing default values defined in the blueprints. + * + * Fields without default value are ignored in the list. + * + * @return array + */ + public function getDefaults() + { + $this->initInternals(); + + if (null === $this->defaults) { + $this->defaults = $this->blueprintSchema->getDefaults(); + } + + return $this->defaults; + } + + /** + * Initialize blueprints with its dynamic fields. + * + * @return $this + */ + public function init() + { + foreach ($this->dynamic as $key => $data) { + // Locate field. + $path = explode('/', $key); + $current = &$this->items; + + foreach ($path as $field) { + if (is_object($current)) { + // Handle objects. + if (!isset($current->{$field})) { + $current->{$field} = []; + } + + $current = &$current->{$field}; + } else { + // Handle arrays and scalars. + if (!is_array($current)) { + $current = [$field => []]; + } elseif (!isset($current[$field])) { + $current[$field] = []; + } + + $current = &$current[$field]; + } + } + + // Set dynamic property. + foreach ($data as $property => $call) { + $action = $call['action']; + $method = 'dynamic' . ucfirst($action); + $call['object'] = $this->object; + + if (isset($this->handlers[$action])) { + $callable = $this->handlers[$action]; + $callable($current, $property, $call); + } elseif (method_exists($this, $method)) { + $this->{$method}($current, $property, $call); + } + } + } + + return $this; + } + + /** + * Extend blueprint with another blueprint. + * + * @param BlueprintForm|array $extends + * @param bool $append + * @return $this + */ + public function extend($extends, $append = false) + { + parent::extend($extends, $append); + + $this->deepInit($this->items); + + return $this; + } + + /** + * @param string $name + * @param mixed $value + * @param string $separator + * @param bool $append + * @return $this + */ + public function embed($name, $value, $separator = '/', $append = false) + { + parent::embed($name, $value, $separator, $append); + + $this->deepInit($this->items); + + return $this; + } + + /** + * Merge two arrays by using blueprints. + * + * @param array $data1 + * @param array $data2 + * @param string|null $name Optional + * @param string $separator Optional + * @return array + */ + public function mergeData(array $data1, array $data2, $name = null, $separator = '.') + { + $this->initInternals(); + + return $this->blueprintSchema->mergeData($data1, $data2, $name, $separator); + } + + /** + * Process data coming from a form. + * + * @param array $data + * @param array $toggles + * @return array + */ + public function processForm(array $data, array $toggles = []) + { + $this->initInternals(); + + return $this->blueprintSchema->processForm($data, $toggles); + } + + /** + * Return data fields that do not exist in blueprints. + * + * @param array $data + * @param string $prefix + * @return array + */ + public function extra(array $data, $prefix = '') + { + $this->initInternals(); + + return $this->blueprintSchema->extra($data, $prefix); + } + + /** + * Validate data against blueprints. + * + * @param array $data + * @param array $options + * @return void + * @throws RuntimeException + */ + public function validate(array $data, array $options = []) + { + $this->initInternals(); + + $this->blueprintSchema->validate($data, $options); + } + + /** + * Filter data by using blueprints. + * + * @param array $data + * @param bool $missingValuesAsNull + * @param bool $keepEmptyValues + * @return array + */ + public function filter(array $data, bool $missingValuesAsNull = false, bool $keepEmptyValues = false) + { + $this->initInternals(); + + return $this->blueprintSchema->filter($data, $missingValuesAsNull, $keepEmptyValues) ?? []; + } + + + /** + * Flatten data by using blueprints. + * + * @param array $data Data to be flattened. + * @param bool $includeAll True if undefined properties should also be included. + * @param string $name Property which will be flattened, useful for flattening repeating data. + * @return array + */ + public function flattenData(array $data, bool $includeAll = false, string $name = '') + { + $this->initInternals(); + + return $this->blueprintSchema->flattenData($data, $includeAll, $name); + } + + + /** + * Return blueprint data schema. + * + * @return BlueprintSchema + */ + public function schema() + { + $this->initInternals(); + + return $this->blueprintSchema; + } + + /** + * @param string $name + * @param callable $callable + * @return void + */ + public function addDynamicHandler(string $name, callable $callable): void + { + $this->handlers[$name] = $callable; + } + + /** + * Initialize validator. + * + * @return void + */ + protected function initInternals() + { + if (null === $this->blueprintSchema) { + $types = Grav::instance()['plugins']->formFieldTypes; + + $this->blueprintSchema = new BlueprintSchema; + + if ($types) { + $this->blueprintSchema->setTypes($types); + } + + $this->blueprintSchema->embed('', $this->items); + $this->blueprintSchema->init(); + $this->defaults = null; + } + } + + /** + * @param string $filename + * @return array + */ + protected function loadFile($filename) + { + $file = CompiledYamlFile::instance($filename); + $content = (array)$file->content(); + $file->free(); + + return $content; + } + + /** + * @param string|array $path + * @param string|null $context + * @return array + */ + protected function getFiles($path, $context = null) + { + /** @var UniformResourceLocator $locator */ + $locator = Grav::instance()['locator']; + + if (is_string($path) && !$locator->isStream($path)) { + if (is_file($path)) { + return [$path]; + } + + // Find path overrides. + if (null === $context) { + $paths = (array) ($this->overrides[$path] ?? null); + } else { + $paths = []; + } + + // Add path pointing to default context. + if ($context === null) { + $context = $this->context; + } + + if ($context && $context[strlen($context)-1] !== '/') { + $context .= '/'; + } + + $path = $context . $path; + + if (!preg_match('/\.yaml$/', $path)) { + $path .= '.yaml'; + } + + $paths[] = $path; + } else { + $paths = (array) $path; + } + + $files = []; + foreach ($paths as $lookup) { + if (is_string($lookup) && strpos($lookup, '://')) { + $files = array_merge($files, $locator->findResources($lookup)); + } else { + $files[] = $lookup; + } + } + + return array_values(array_unique($files)); + } + + /** + * @param array $field + * @param string $property + * @param array $call + * @return void + */ + protected function dynamicData(array &$field, $property, array &$call) + { + $params = $call['params']; + + if (is_array($params)) { + $function = array_shift($params); + } else { + $function = $params; + $params = []; + } + + [$o, $f] = explode('::', $function, 2); + + $data = null; + if (!$f) { + if (function_exists($o)) { + $data = call_user_func_array($o, $params); + } + } else { + if (method_exists($o, $f)) { + $data = call_user_func_array([$o, $f], $params); + } + } + + // If function returns a value, + if (null !== $data) { + if (is_array($data) && isset($field[$property]) && is_array($field[$property])) { + // Combine field and @data-field together. + $field[$property] += $data; + } else { + // Or create/replace field with @data-field. + $field[$property] = $data; + } + } + } + + /** + * @param array $field + * @param string $property + * @param array $call + * @return void + */ + protected function dynamicConfig(array &$field, $property, array &$call) + { + $params = $call['params']; + if (is_array($params)) { + $value = array_shift($params); + $params = array_shift($params); + } else { + $value = $params; + $params = []; + } + + $default = $field[$property] ?? null; + $config = Grav::instance()['config']->get($value, $default); + if (!empty($field['value_only'])) { + $config = array_combine($config, $config); + } + + if (null !== $config) { + if (!empty($params['append']) && is_array($config) && isset($field[$property]) && is_array($field[$property])) { + // Combine field and @config-field together. + $field[$property] += $config; + } else { + // Or create/replace field with @config-field. + $field[$property] = $config; + } + } + } + + /** + * @param array $field + * @param string $property + * @param array $call + * @return void + */ + protected function dynamicSecurity(array &$field, $property, array &$call) + { + if ($property || !empty($field['validate']['ignore'])) { + return; + } + + $grav = Grav::instance(); + $actions = (array)$call['params']; + + /** @var UserInterface|null $user */ + $user = $grav['user'] ?? null; + $success = null !== $user; + if ($success) { + $success = $this->resolveActions($user, $actions); + } + if (!$success) { + static::addPropertyRecursive($field, 'validate', ['ignore' => true]); + } + } + + /** + * @param UserInterface|null $user + * @param array $actions + * @param string $op + * @return bool + */ + protected function resolveActions(?UserInterface $user, array $actions, string $op = 'and') + { + if (null === $user) { + return false; + } + + $c = $i = count($actions); + foreach ($actions as $key => $action) { + if (!is_int($key) && is_array($actions)) { + $i -= $this->resolveActions($user, $action, $key); + } elseif ($user->authorize($action)) { + $i--; + } + } + + if ($op === 'and') { + return $i === 0; + } + + return $c !== $i; + } + + /** + * @param array $field + * @param string $property + * @param array $call + * @return void + */ + protected function dynamicScope(array &$field, $property, array &$call) + { + if ($property && $property !== 'ignore') { + return; + } + + $scopes = (array)$call['params']; + $matches = in_array($this->scope, $scopes, true); + if ($this->scope && $property !== 'ignore') { + $matches = !$matches; + } + + if ($matches) { + static::addPropertyRecursive($field, 'validate', ['ignore' => true]); + return; + } + } + + /** + * @param array $field + * @param string $property + * @param mixed $value + * @return void + */ + public static function addPropertyRecursive(array &$field, $property, $value) + { + if (is_array($value) && isset($field[$property]) && is_array($field[$property])) { + $field[$property] = array_merge_recursive($field[$property], $value); + } else { + $field[$property] = $value; + } + + if (!empty($field['fields'])) { + foreach ($field['fields'] as $key => &$child) { + static::addPropertyRecursive($child, $property, $value); + } + } + } +} diff --git a/system/src/Grav/Common/Data/BlueprintSchema.php b/system/src/Grav/Common/Data/BlueprintSchema.php new file mode 100644 index 0000000..1408cb6 --- /dev/null +++ b/system/src/Grav/Common/Data/BlueprintSchema.php @@ -0,0 +1,429 @@ + true, 'xss_check' => true]; + + /** @var array */ + protected $ignoreFormKeys = [ + 'title' => true, + 'help' => true, + 'placeholder' => true, + 'placeholder_key' => true, + 'placeholder_value' => true, + 'fields' => true + ]; + + /** + * @return array + */ + public function getTypes() + { + return $this->types; + } + + /** + * @param string $name + * @return array + */ + public function getType($name) + { + return $this->types[$name] ?? []; + } + + /** + * @param string $name + * @return array|null + */ + public function getNestedRules(string $name) + { + return $this->getNested($name); + } + + /** + * Validate data against blueprints. + * + * @param array $data + * @param array $options + * @return void + * @throws RuntimeException + */ + public function validate(array $data, array $options = []) + { + try { + $validation = $this->items['']['form']['validation'] ?? 'loose'; + $messages = $this->validateArray($data, $this->nested, $validation === 'strict', $options['xss_check'] ?? true); + } catch (RuntimeException $e) { + throw (new ValidationException($e->getMessage(), $e->getCode(), $e))->setMessages(); + } + + if (!empty($messages)) { + throw (new ValidationException('', 400))->setMessages($messages); + } + } + + /** + * @param array $data + * @param array $toggles + * @return array + */ + public function processForm(array $data, array $toggles = []) + { + return $this->processFormRecursive($data, $toggles, $this->nested) ?? []; + } + + /** + * Filter data by using blueprints. + * + * @param array $data Incoming data, for example from a form. + * @param bool $missingValuesAsNull Include missing values as nulls. + * @param bool $keepEmptyValues Include empty values. + * @return array + */ + public function filter(array $data, $missingValuesAsNull = false, $keepEmptyValues = false) + { + $this->buildIgnoreNested($this->nested); + + return $this->filterArray($data, $this->nested, '', $missingValuesAsNull, $keepEmptyValues) ?? []; + } + + /** + * Flatten data by using blueprints. + * + * @param array $data Data to be flattened. + * @param bool $includeAll True if undefined properties should also be included. + * @param string $name Property which will be flattened, useful for flattening repeating data. + * @return array + */ + public function flattenData(array $data, bool $includeAll = false, string $name = '') + { + $prefix = $name !== '' ? $name . '.' : ''; + + $list = []; + if ($includeAll) { + $items = $name !== '' ? $this->getProperty($name)['fields'] ?? [] : $this->items; + foreach ($items as $key => $rules) { + $type = $rules['type'] ?? ''; + $ignore = (bool) array_filter((array)($rules['validate']['ignore'] ?? [])) ?? false; + if (!str_starts_with($type, '_') && !str_contains($key, '*') && $ignore !== true) { + $list[$prefix . $key] = null; + } + } + } + + $nested = $this->getNestedRules($name); + + return array_replace($list, $this->flattenArray($data, $nested, $prefix)); + } + + /** + * @param array $data + * @param array $rules + * @param string $prefix + * @return array + */ + protected function flattenArray(array $data, array $rules, string $prefix) + { + $array = []; + + foreach ($data as $key => $field) { + $val = $rules[$key] ?? $rules['*'] ?? null; + $rule = is_string($val) ? $this->items[$val] : null; + + if ($rule || isset($val['*'])) { + // Item has been defined in blueprints. + $array[$prefix.$key] = $field; + } elseif (is_array($field) && is_array($val)) { + // Array has been defined in blueprints. + $array += $this->flattenArray($field, $val, $prefix . $key . '.'); + } else { + // Undefined/extra item. + $array[$prefix.$key] = $field; + } + } + + return $array; + } + + /** + * @param array $data + * @param array $rules + * @param bool $strict + * @param bool $xss + * @return array + * @throws RuntimeException + */ + protected function validateArray(array $data, array $rules, bool $strict, bool $xss = true) + { + $messages = $this->checkRequired($data, $rules); + + foreach ($data as $key => $child) { + $val = $rules[$key] ?? $rules['*'] ?? null; + $rule = is_string($val) ? $this->items[$val] : null; + $checkXss = $xss; + + if ($rule) { + // Item has been defined in blueprints. + if (!empty($rule['disabled']) || !empty($rule['validate']['ignore'])) { + // Skip validation in the ignored field. + continue; + } + + $messages += Validation::validate($child, $rule); + + } elseif (is_array($child) && is_array($val)) { + // Array has been defined in blueprints. + $messages += $this->validateArray($child, $val, $strict); + $checkXss = false; + + } elseif ($strict) { + // Undefined/extra item in strict mode. + /** @var Config $config */ + $config = Grav::instance()['config']; + if (!$config->get('system.strict_mode.blueprint_strict_compat', true)) { + throw new RuntimeException(sprintf('%s is not defined in blueprints', $key), 400); + } + + user_error(sprintf('Having extra key %s in your data is deprecated with blueprint having \'validation: strict\'', $key), E_USER_DEPRECATED); + } + + if ($checkXss) { + $messages += Validation::checkSafety($child, $rule ?: ['name' => $key]); + } + } + + return $messages; + } + + /** + * @param array $data + * @param array $rules + * @param string $parent + * @param bool $missingValuesAsNull + * @param bool $keepEmptyValues + * @return array|null + */ + protected function filterArray(array $data, array $rules, string $parent, bool $missingValuesAsNull, bool $keepEmptyValues) + { + $results = []; + + foreach ($data as $key => $field) { + $val = $rules[$key] ?? $rules['*'] ?? null; + $rule = is_string($val) ? $this->items[$val] : $this->items[$parent . $key] ?? null; + + if (!empty($rule['disabled']) || !empty($rule['validate']['ignore'])) { + // Skip any data in the ignored field. + unset($results[$key]); + continue; + } + + if (null === $field) { + if ($missingValuesAsNull) { + $results[$key] = null; + } else { + unset($results[$key]); + } + continue; + } + + $isParent = isset($val['*']); + $type = $rule['type'] ?? null; + + if (!$isParent && $type && $type !== '_parent') { + $field = Validation::filter($field, $rule); + } elseif (is_array($field) && is_array($val)) { + // Array has been defined in blueprints. + $k = $isParent ? '*' : $key; + $field = $this->filterArray($field, $val, $parent . $k . '.', $missingValuesAsNull, $keepEmptyValues); + + if (null === $field) { + // Nested parent has no values. + unset($results[$key]); + continue; + } + } elseif (isset($rules['validation']) && $rules['validation'] === 'strict') { + // Skip any extra data. + continue; + } + + if ($keepEmptyValues || (null !== $field && (!is_array($field) || !empty($field)))) { + $results[$key] = $field; + } + } + + return $results ?: null; + } + + /** + * @param array $nested + * @param string $parent + * @return bool + */ + protected function buildIgnoreNested(array $nested, $parent = '') + { + $ignore = true; + foreach ($nested as $key => $val) { + $key = $parent . $key; + if (is_array($val)) { + $ignore = $this->buildIgnoreNested($val, $key . '.') && $ignore; // Keep the order! + } else { + $child = $this->items[$key] ?? null; + $ignore = $ignore && (!$child || !empty($child['disabled']) || !empty($child['validate']['ignore'])); + } + } + if ($ignore) { + $key = trim($parent, '.'); + $this->items[$key]['validate']['ignore'] = true; + } + + return $ignore; + } + + /** + * @param array|null $data + * @param array $toggles + * @param array $nested + * @return array|null + */ + protected function processFormRecursive(?array $data, array $toggles, array $nested) + { + foreach ($nested as $key => $value) { + if ($key === '') { + continue; + } + if ($key === '*') { + // TODO: Add support to collections. + continue; + } + if (is_array($value)) { + // Special toggle handling for all the nested data. + $toggle = $toggles[$key] ?? []; + if (!is_array($toggle)) { + if (!$toggle) { + $data[$key] = null; + + continue; + } + + $toggle = []; + } + // Recursively fetch the items. + $childData = $data[$key] ?? null; + if (null !== $childData && !is_array($childData)) { + throw new \RuntimeException(sprintf("Bad form data for field collection '%s': %s used instead of an array", $key, gettype($childData))); + } + $data[$key] = $this->processFormRecursive($data[$key] ?? null, $toggle, $value); + } else { + $field = $this->get($value); + // Do not add the field if: + if ( + // Not an input field + !$field + // Field has been disabled + || !empty($field['disabled']) + // Field validation is set to be ignored + || !empty($field['validate']['ignore']) + // Field is overridable and the toggle is turned off + || (!empty($field['overridable']) && empty($toggles[$key])) + ) { + continue; + } + if (!isset($data[$key])) { + $data[$key] = null; + } + } + } + + return $data; + } + + /** + * @param array $data + * @param array $fields + * @return array + */ + protected function checkRequired(array $data, array $fields) + { + $messages = []; + + foreach ($fields as $name => $field) { + if (!is_string($field)) { + continue; + } + + $field = $this->items[$field]; + + // Skip ignored field, it will not be required. + if (!empty($field['disabled']) || !empty($field['validate']['ignore'])) { + continue; + } + + // Skip overridable fields without value. + // TODO: We need better overridable support, which is not just ignoring required values but also looking if defaults are good. + if (!empty($field['overridable']) && !isset($data[$name])) { + continue; + } + + // Check if required. + if (isset($field['validate']['required']) + && $field['validate']['required'] === true) { + if (isset($data[$name])) { + continue; + } + if ($field['type'] === 'file' && isset($data['data']['name'][$name])) { //handle case of file input fields required + continue; + } + + $value = $field['label'] ?? $field['name']; + $language = Grav::instance()['language']; + $message = sprintf($language->translate('GRAV.FORM.MISSING_REQUIRED_FIELD', null, true) . ' %s', $language->translate($value)); + $messages[$field['name']][] = $message; + } + } + + return $messages; + } + + /** + * @param array $field + * @param string $property + * @param array $call + * @return void + */ + protected function dynamicConfig(array &$field, $property, array &$call) + { + $value = $call['params']; + + $default = $field[$property] ?? null; + $config = Grav::instance()['config']->get($value, $default); + + if (null !== $config) { + $field[$property] = $config; + } + } +} diff --git a/system/src/Grav/Common/Data/Blueprints.php b/system/src/Grav/Common/Data/Blueprints.php new file mode 100644 index 0000000..5534a19 --- /dev/null +++ b/system/src/Grav/Common/Data/Blueprints.php @@ -0,0 +1,121 @@ +search = $search; + } + + /** + * Get blueprint. + * + * @param string $type Blueprint type. + * @return Blueprint + * @throws RuntimeException + */ + public function get($type) + { + if (!isset($this->instances[$type])) { + $blueprint = $this->loadFile($type); + $this->instances[$type] = $blueprint; + } + + return $this->instances[$type]; + } + + /** + * Get all available blueprint types. + * + * @return array List of type=>name + */ + public function types() + { + if ($this->types === null) { + $this->types = []; + + $grav = Grav::instance(); + + /** @var UniformResourceLocator $locator */ + $locator = $grav['locator']; + + // Get stream / directory iterator. + if ($locator->isStream($this->search)) { + $iterator = $locator->getIterator($this->search); + } else { + $iterator = new DirectoryIterator($this->search); + } + + foreach ($iterator as $file) { + if (!$file->isFile() || '.' . $file->getExtension() !== YAML_EXT) { + continue; + } + $name = $file->getBasename(YAML_EXT); + $this->types[$name] = ucfirst(str_replace('_', ' ', $name)); + } + } + + return $this->types; + } + + + /** + * Load blueprint file. + * + * @param string $name Name of the blueprint. + * @return Blueprint + */ + protected function loadFile($name) + { + $blueprint = new Blueprint($name); + + if (is_array($this->search) || is_object($this->search)) { + // Page types. + $blueprint->setOverrides($this->search); + $blueprint->setContext('blueprints://pages'); + } else { + $blueprint->setContext($this->search); + } + + try { + $blueprint->load()->init(); + } catch (RuntimeException $e) { + $log = Grav::instance()['log']; + $log->error(sprintf('Blueprint %s cannot be loaded: %s', $name, $e->getMessage())); + + throw $e; + } + + return $blueprint; + } +} diff --git a/system/src/Grav/Common/Data/Data.php b/system/src/Grav/Common/Data/Data.php new file mode 100644 index 0000000..95944b2 --- /dev/null +++ b/system/src/Grav/Common/Data/Data.php @@ -0,0 +1,343 @@ +items = $items; + if (null !== $blueprints) { + $this->blueprints = $blueprints; + } + } + + /** + * @param bool $value + * @return $this + */ + public function setKeepEmptyValues(bool $value) + { + $this->keepEmptyValues = $value; + + return $this; + } + + /** + * @param bool $value + * @return $this + */ + public function setMissingValuesAsNull(bool $value) + { + $this->missingValuesAsNull = $value; + + return $this; + } + + /** + * Get value by using dot notation for nested arrays/objects. + * + * @example $value = $data->value('this.is.my.nested.variable'); + * + * @param string $name Dot separated path to the requested value. + * @param mixed $default Default value (or null). + * @param string $separator Separator, defaults to '.' + * @return mixed Value. + */ + public function value($name, $default = null, $separator = '.') + { + return $this->get($name, $default, $separator); + } + + /** + * Join nested values together by using blueprints. + * + * @param string $name Dot separated path to the requested value. + * @param mixed $value Value to be joined. + * @param string $separator Separator, defaults to '.' + * @return $this + * @throws RuntimeException + */ + public function join($name, $value, $separator = '.') + { + $old = $this->get($name, null, $separator); + if ($old !== null) { + if (!is_array($old)) { + throw new RuntimeException('Value ' . $old); + } + + if (is_object($value)) { + $value = (array) $value; + } elseif (!is_array($value)) { + throw new RuntimeException('Value ' . $value); + } + + $value = $this->blueprints()->mergeData($old, $value, $name, $separator); + } + + $this->set($name, $value, $separator); + + return $this; + } + + /** + * Get nested structure containing default values defined in the blueprints. + * + * Fields without default value are ignored in the list. + + * @return array + */ + public function getDefaults() + { + return $this->blueprints()->getDefaults(); + } + + /** + * Set default values by using blueprints. + * + * @param string $name Dot separated path to the requested value. + * @param mixed $value Value to be joined. + * @param string $separator Separator, defaults to '.' + * @return $this + */ + public function joinDefaults($name, $value, $separator = '.') + { + if (is_object($value)) { + $value = (array) $value; + } + + $old = $this->get($name, null, $separator); + if ($old !== null) { + $value = $this->blueprints()->mergeData($value, $old, $name, $separator); + } + + $this->set($name, $value, $separator); + + return $this; + } + + /** + * Get value from the configuration and join it with given data. + * + * @param string $name Dot separated path to the requested value. + * @param array|object $value Value to be joined. + * @param string $separator Separator, defaults to '.' + * @return array + * @throws RuntimeException + */ + public function getJoined($name, $value, $separator = '.') + { + if (is_object($value)) { + $value = (array) $value; + } elseif (!is_array($value)) { + throw new RuntimeException('Value ' . $value); + } + + $old = $this->get($name, null, $separator); + + if ($old === null) { + // No value set; no need to join data. + return $value; + } + + if (!is_array($old)) { + throw new RuntimeException('Value ' . $old); + } + + // Return joined data. + return $this->blueprints()->mergeData($old, $value, $name, $separator); + } + + + /** + * Merge two configurations together. + * + * @param array $data + * @return $this + */ + public function merge(array $data) + { + $this->items = $this->blueprints()->mergeData($this->items, $data); + + return $this; + } + + /** + * Set default values to the configuration if variables were not set. + * + * @param array $data + * @return $this + */ + public function setDefaults(array $data) + { + $this->items = $this->blueprints()->mergeData($data, $this->items); + + return $this; + } + + /** + * Validate by blueprints. + * + * @return $this + * @throws Exception + */ + public function validate() + { + $this->blueprints()->validate($this->items); + + return $this; + } + + /** + * @return $this + */ + public function filter() + { + $args = func_get_args(); + $missingValuesAsNull = (bool)(array_shift($args) ?? $this->missingValuesAsNull); + $keepEmptyValues = (bool)(array_shift($args) ?? $this->keepEmptyValues); + + $this->items = $this->blueprints()->filter($this->items, $missingValuesAsNull, $keepEmptyValues); + + return $this; + } + + /** + * Get extra items which haven't been defined in blueprints. + * + * @return array + */ + public function extra() + { + return $this->blueprints()->extra($this->items); + } + + /** + * Return blueprints. + * + * @return Blueprint + */ + public function blueprints() + { + if (null === $this->blueprints) { + $this->blueprints = new Blueprint(); + } elseif (is_callable($this->blueprints)) { + // Lazy load blueprints. + $blueprints = $this->blueprints; + $this->blueprints = $blueprints(); + } + + return $this->blueprints; + } + + /** + * Save data if storage has been defined. + * + * @return void + * @throws RuntimeException + */ + public function save() + { + $file = $this->file(); + if ($file) { + $file->save($this->items); + } + } + + /** + * Returns whether the data already exists in the storage. + * + * NOTE: This method does not check if the data is current. + * + * @return bool + */ + public function exists() + { + $file = $this->file(); + + return $file && $file->exists(); + } + + /** + * Return unmodified data as raw string. + * + * NOTE: This function only returns data which has been saved to the storage. + * + * @return string + */ + public function raw() + { + $file = $this->file(); + + return $file ? $file->raw() : ''; + } + + /** + * Set or get the data storage. + * + * @param FileInterface|null $storage Optionally enter a new storage. + * @return FileInterface|null + */ + public function file(FileInterface $storage = null) + { + if ($storage) { + $this->storage = $storage; + } + + return $this->storage; + } + + /** + * @return array + */ + #[\ReturnTypeWillChange] + public function jsonSerialize() + { + return $this->items; + } +} diff --git a/system/src/Grav/Common/Data/DataInterface.php b/system/src/Grav/Common/Data/DataInterface.php new file mode 100644 index 0000000..52469b1 --- /dev/null +++ b/system/src/Grav/Common/Data/DataInterface.php @@ -0,0 +1,84 @@ +value('this.is.my.nested.variable'); + * + * @param string $name Dot separated path to the requested value. + * @param mixed $default Default value (or null). + * @param string $separator Separator, defaults to '.' + * @return mixed Value. + */ + public function value($name, $default = null, $separator = '.'); + + /** + * Merge external data. + * + * @param array $data + * @return mixed + */ + public function merge(array $data); + + /** + * Return blueprints. + * + * @return Blueprint + */ + public function blueprints(); + + /** + * Validate by blueprints. + * + * @return $this + * @throws Exception + */ + public function validate(); + + /** + * Filter all items by using blueprints. + * + * @return $this + */ + public function filter(); + + /** + * Get extra items which haven't been defined in blueprints. + * + * @return array + */ + public function extra(); + + /** + * Save data into the file. + * + * @return void + */ + public function save(); + + /** + * Set or get the data storage. + * + * @param FileInterface|null $storage Optionally enter a new storage. + * @return FileInterface + */ + public function file(FileInterface $storage = null); +} diff --git a/system/src/Grav/Common/Data/Validation.php b/system/src/Grav/Common/Data/Validation.php new file mode 100644 index 0000000..d0f5bff --- /dev/null +++ b/system/src/Grav/Common/Data/Validation.php @@ -0,0 +1,1236 @@ +translate($field['validate']['message']) + : $language->translate('GRAV.FORM.INVALID_INPUT') . ' "' . $language->translate($name) . '"'; + + + // Validate type with fallback type text. + $method = 'type' . str_replace('-', '_', $type); + + // If this is a YAML field validate/filter as such + if (isset($field['yaml']) && $field['yaml'] === true) { + $method = 'typeYaml'; + } + + $messages = []; + + $success = method_exists(__CLASS__, $method) ? self::$method($value, $validate, $field) : true; + if (!$success) { + $messages[$field['name']][] = $message; + } + + // Check individual rules. + foreach ($validate as $rule => $params) { + $method = 'validate' . ucfirst(str_replace('-', '_', $rule)); + + if (method_exists(__CLASS__, $method)) { + $success = self::$method($value, $params); + + if (!$success) { + $messages[$field['name']][] = $message; + } + } + } + + return $messages; + } + + /** + * @param mixed $value + * @param array $field + * @return array + */ + public static function checkSafety($value, array $field) + { + $messages = []; + + $type = $field['validate']['type'] ?? $field['type'] ?? 'text'; + $options = $field['xss_check'] ?? []; + if ($options === false || $type === 'unset') { + return $messages; + } + if (!is_array($options)) { + $options = []; + } + + $name = ucfirst($field['label'] ?? $field['name'] ?? 'UNKNOWN'); + + /** @var UserInterface $user */ + $user = Grav::instance()['user'] ?? null; + /** @var Config $config */ + $config = Grav::instance()['config']; + + $xss_whitelist = $config->get('security.xss_whitelist', 'admin.super'); + + // Get language class. + /** @var Language $language */ + $language = Grav::instance()['language']; + + if (!static::authorize($xss_whitelist, $user)) { + $defaults = Security::getXssDefaults(); + $options += $defaults; + $options['enabled_rules'] += $defaults['enabled_rules']; + if (!empty($options['safe_protocols'])) { + $options['invalid_protocols'] = array_diff($options['invalid_protocols'], $options['safe_protocols']); + } + if (!empty($options['safe_tags'])) { + $options['dangerous_tags'] = array_diff($options['dangerous_tags'], $options['safe_tags']); + } + + if (is_string($value)) { + $violation = Security::detectXss($value, $options); + if ($violation) { + $messages[$name][] = $language->translate(['GRAV.FORM.XSS_ISSUES', $language->translate($name)], null, true); + } + } elseif (is_array($value)) { + $violations = Security::detectXssFromArray($value, "{$name}.", $options); + if ($violations) { + $messages[$name][] = $language->translate(['GRAV.FORM.XSS_ISSUES', $language->translate($name)], null, true); + } + } + } + + return $messages; + } + + /** + * Checks user authorisation to the action. + * + * @param string|string[] $action + * @param UserInterface|null $user + * @return bool + */ + public static function authorize($action, UserInterface $user = null) + { + if (!$user) { + return false; + } + + $action = (array)$action; + foreach ($action as $a) { + // Ignore 'admin.super' if it's not the only value to be checked. + if ($a === 'admin.super' && count($action) > 1 && $user instanceof FlexObjectInterface) { + continue; + } + + if ($user->authorize($a)) { + return true; + } + } + + return false; + } + + /** + * Filter value against a blueprint field definition. + * + * @param mixed $value + * @param array $field + * @return mixed Filtered value. + */ + public static function filter($value, array $field) + { + $validate = (array)($field['filter'] ?? $field['validate'] ?? null); + + // If value isn't required, we will return null if empty value is given. + if (($value === null || $value === '') && empty($validate['required'])) { + return null; + } + + if (!isset($field['type'])) { + $field['type'] = 'text'; + } + $type = $field['filter']['type'] ?? $field['validate']['type'] ?? $field['type']; + + $method = 'filter' . ucfirst(str_replace('-', '_', $type)); + + // If this is a YAML field validate/filter as such + if (isset($field['yaml']) && $field['yaml'] === true) { + $method = 'filterYaml'; + } + + if (!method_exists(__CLASS__, $method)) { + $method = isset($field['array']) && $field['array'] === true ? 'filterArray' : 'filterText'; + } + + return self::$method($value, $validate, $field); + } + + /** + * HTML5 input: text + * + * @param mixed $value Value to be validated. + * @param array $params Validation parameters. + * @param array $field Blueprint for the field. + * @return bool True if validation succeeded. + */ + public static function typeText($value, array $params, array $field) + { + if (!is_string($value) && !is_numeric($value)) { + return false; + } + + $value = (string)$value; + + if (!empty($params['trim'])) { + $value = trim($value); + } + + $value = preg_replace("/\r\n|\r/um", "\n", $value); + $len = mb_strlen($value); + + $min = (int)($params['min'] ?? 0); + if ($min && $len < $min) { + return false; + } + + $multiline = isset($params['multiline']) && $params['multiline']; + + $max = (int)($params['max'] ?? ($multiline ? 65536 : 2048)); + if ($max && $len > $max) { + return false; + } + + $step = (int)($params['step'] ?? 0); + if ($step && ($len - $min) % $step === 0) { + return false; + } + + if (!$multiline && preg_match('/\R/um', $value)) { + return false; + } + + return true; + } + + /** + * @param mixed $value + * @param array $params + * @param array $field + * @return string + */ + protected static function filterText($value, array $params, array $field) + { + if (!is_string($value) && !is_numeric($value)) { + return ''; + } + + $value = (string)$value; + + if (!empty($params['trim'])) { + $value = trim($value); + } + + return preg_replace("/\r\n|\r/um", "\n", $value); + } + + /** + * @param mixed $value + * @param array $params + * @param array $field + * @return string|null + */ + protected static function filterCheckbox($value, array $params, array $field) + { + $value = (string)$value; + $field_value = (string)($field['value'] ?? '1'); + + return $value === $field_value ? $value : null; + } + + /** + * @param mixed $value + * @param array $params + * @param array $field + * @return array|array[]|false|string[] + */ + protected static function filterCommaList($value, array $params, array $field) + { + return is_array($value) ? $value : preg_split('/\s*,\s*/', $value, -1, PREG_SPLIT_NO_EMPTY); + } + + /** + * @param mixed $value + * @param array $params + * @param array $field + * @return bool + */ + public static function typeCommaList($value, array $params, array $field) + { + if (!isset($params['max'])) { + $params['max'] = 2048; + } + + return is_array($value) ? true : self::typeText($value, $params, $field); + } + + /** + * @param mixed $value + * @param array $params + * @param array $field + * @return array|array[]|false|string[] + */ + protected static function filterLines($value, array $params, array $field) + { + return is_array($value) ? $value : preg_split('/\s*[\r\n]+\s*/', $value, -1, PREG_SPLIT_NO_EMPTY); + } + + /** + * @param mixed $value + * @param array $params + * @return string + */ + protected static function filterLower($value, array $params) + { + return mb_strtolower($value); + } + + /** + * @param mixed $value + * @param array $params + * @return string + */ + protected static function filterUpper($value, array $params) + { + return mb_strtoupper($value); + } + + + /** + * HTML5 input: textarea + * + * @param mixed $value Value to be validated. + * @param array $params Validation parameters. + * @param array $field Blueprint for the field. + * @return bool True if validation succeeded. + */ + public static function typeTextarea($value, array $params, array $field) + { + if (!isset($params['multiline'])) { + $params['multiline'] = true; + } + + return self::typeText($value, $params, $field); + } + + /** + * HTML5 input: password + * + * @param mixed $value Value to be validated. + * @param array $params Validation parameters. + * @param array $field Blueprint for the field. + * @return bool True if validation succeeded. + */ + public static function typePassword($value, array $params, array $field) + { + if (!isset($params['max'])) { + $params['max'] = 256; + } + + return self::typeText($value, $params, $field); + } + + /** + * HTML5 input: hidden + * + * @param mixed $value Value to be validated. + * @param array $params Validation parameters. + * @param array $field Blueprint for the field. + * @return bool True if validation succeeded. + */ + public static function typeHidden($value, array $params, array $field) + { + return self::typeText($value, $params, $field); + } + + /** + * Custom input: checkbox list + * + * @param mixed $value Value to be validated. + * @param array $params Validation parameters. + * @param array $field Blueprint for the field. + * @return bool True if validation succeeded. + */ + public static function typeCheckboxes($value, array $params, array $field) + { + // Set multiple: true so checkboxes can easily use min/max counts to control number of options required + $field['multiple'] = true; + + return self::typeArray((array) $value, $params, $field); + } + + /** + * @param mixed $value + * @param array $params + * @param array $field + * @return array|null + */ + protected static function filterCheckboxes($value, array $params, array $field) + { + return self::filterArray($value, $params, $field); + } + + /** + * HTML5 input: checkbox + * + * @param mixed $value Value to be validated. + * @param array $params Validation parameters. + * @param array $field Blueprint for the field. + * @return bool True if validation succeeded. + */ + public static function typeCheckbox($value, array $params, array $field) + { + $value = (string)$value; + $field_value = (string)($field['value'] ?? '1'); + + return $value === $field_value; + } + + /** + * HTML5 input: radio + * + * @param mixed $value Value to be validated. + * @param array $params Validation parameters. + * @param array $field Blueprint for the field. + * @return bool True if validation succeeded. + */ + public static function typeRadio($value, array $params, array $field) + { + return self::typeArray((array) $value, $params, $field); + } + + /** + * Custom input: toggle + * + * @param mixed $value Value to be validated. + * @param array $params Validation parameters. + * @param array $field Blueprint for the field. + * @return bool True if validation succeeded. + */ + public static function typeToggle($value, array $params, array $field) + { + if (is_bool($value)) { + $value = (int)$value; + } + + return self::typeArray((array) $value, $params, $field); + } + + /** + * Custom input: file + * + * @param mixed $value Value to be validated. + * @param array $params Validation parameters. + * @param array $field Blueprint for the field. + * @return bool True if validation succeeded. + */ + public static function typeFile($value, array $params, array $field) + { + return self::typeArray((array)$value, $params, $field); + } + + /** + * @param mixed $value + * @param array $params + * @param array $field + * @return array + */ + protected static function filterFile($value, array $params, array $field) + { + return (array)$value; + } + + /** + * HTML5 input: select + * + * @param mixed $value Value to be validated. + * @param array $params Validation parameters. + * @param array $field Blueprint for the field. + * @return bool True if validation succeeded. + */ + public static function typeSelect($value, array $params, array $field) + { + return self::typeArray((array) $value, $params, $field); + } + + /** + * HTML5 input: number + * + * @param mixed $value Value to be validated. + * @param array $params Validation parameters. + * @param array $field Blueprint for the field. + * @return bool True if validation succeeded. + */ + public static function typeNumber($value, array $params, array $field) + { + if (!is_numeric($value)) { + return false; + } + + $value = (float)$value; + + $min = 0; + if (isset($params['min'])) { + $min = (float)$params['min']; + if ($value < $min) { + return false; + } + } + + if (isset($params['max'])) { + $max = (float)$params['max']; + if ($value > $max) { + return false; + } + } + + if (isset($params['step'])) { + $step = (float)$params['step']; + // Count of how many steps we are above/below the minimum value. + $pos = ($value - $min) / $step; + $pos = round($pos, 10); + return is_int(static::filterNumber($pos, $params, $field)); + } + + return true; + } + + /** + * @param mixed $value + * @param array $params + * @param array $field + * @return float|int + */ + protected static function filterNumber($value, array $params, array $field) + { + return (string)(int)$value !== (string)(float)$value ? (float)$value : (int)$value; + } + + /** + * @param mixed $value + * @param array $params + * @param array $field + * @return string + */ + protected static function filterDateTime($value, array $params, array $field) + { + $format = Grav::instance()['config']->get('system.pages.dateformat.default'); + if ($format) { + $converted = new DateTime($value); + return $converted->format($format); + } + return $value; + } + + /** + * HTML5 input: range + * + * @param mixed $value Value to be validated. + * @param array $params Validation parameters. + * @param array $field Blueprint for the field. + * @return bool True if validation succeeded. + */ + public static function typeRange($value, array $params, array $field) + { + return self::typeNumber($value, $params, $field); + } + + /** + * @param mixed $value + * @param array $params + * @param array $field + * @return float|int + */ + protected static function filterRange($value, array $params, array $field) + { + return self::filterNumber($value, $params, $field); + } + + /** + * HTML5 input: color + * + * @param mixed $value Value to be validated. + * @param array $params Validation parameters. + * @param array $field Blueprint for the field. + * @return bool True if validation succeeded. + */ + public static function typeColor($value, array $params, array $field) + { + return (bool)preg_match('/^\#[0-9a-fA-F]{3}[0-9a-fA-F]{3}?$/u', $value); + } + + /** + * HTML5 input: email + * + * @param mixed $value Value to be validated. + * @param array $params Validation parameters. + * @param array $field Blueprint for the field. + * @return bool True if validation succeeded. + */ + public static function typeEmail($value, array $params, array $field) + { + if (empty($value)) { + return false; + } + + if (!isset($params['max'])) { + $params['max'] = 320; + } + + $values = !is_array($value) ? explode(',', preg_replace('/\s+/', '', $value)) : $value; + + foreach ($values as $val) { + if (!(self::typeText($val, $params, $field) && strpos($val, '@', 1))) { + return false; + } + } + + return true; + } + + /** + * HTML5 input: url + * + * @param mixed $value Value to be validated. + * @param array $params Validation parameters. + * @param array $field Blueprint for the field. + * @return bool True if validation succeeded. + */ + public static function typeUrl($value, array $params, array $field) + { + if (!isset($params['max'])) { + $params['max'] = 2048; + } + + return self::typeText($value, $params, $field) && filter_var($value, FILTER_VALIDATE_URL); + } + + /** + * HTML5 input: datetime + * + * @param mixed $value Value to be validated. + * @param array $params Validation parameters. + * @param array $field Blueprint for the field. + * @return bool True if validation succeeded. + */ + public static function typeDatetime($value, array $params, array $field) + { + if ($value instanceof DateTime) { + return true; + } + if (!is_string($value)) { + return false; + } + if (!isset($params['format'])) { + return false !== strtotime($value); + } + + $dateFromFormat = DateTime::createFromFormat($params['format'], $value); + + return $dateFromFormat && $value === date($params['format'], $dateFromFormat->getTimestamp()); + } + + /** + * HTML5 input: datetime-local + * + * @param mixed $value Value to be validated. + * @param array $params Validation parameters. + * @param array $field Blueprint for the field. + * @return bool True if validation succeeded. + */ + public static function typeDatetimeLocal($value, array $params, array $field) + { + return self::typeDatetime($value, $params, $field); + } + + /** + * HTML5 input: date + * + * @param mixed $value Value to be validated. + * @param array $params Validation parameters. + * @param array $field Blueprint for the field. + * @return bool True if validation succeeded. + */ + public static function typeDate($value, array $params, array $field) + { + if (!isset($params['format'])) { + $params['format'] = 'Y-m-d'; + } + + return self::typeDatetime($value, $params, $field); + } + + /** + * HTML5 input: time + * + * @param mixed $value Value to be validated. + * @param array $params Validation parameters. + * @param array $field Blueprint for the field. + * @return bool True if validation succeeded. + */ + public static function typeTime($value, array $params, array $field) + { + if (!isset($params['format'])) { + $params['format'] = 'H:i'; + } + + return self::typeDatetime($value, $params, $field); + } + + /** + * HTML5 input: month + * + * @param mixed $value Value to be validated. + * @param array $params Validation parameters. + * @param array $field Blueprint for the field. + * @return bool True if validation succeeded. + */ + public static function typeMonth($value, array $params, array $field) + { + if (!isset($params['format'])) { + $params['format'] = 'Y-m'; + } + + return self::typeDatetime($value, $params, $field); + } + + /** + * HTML5 input: week + * + * @param mixed $value Value to be validated. + * @param array $params Validation parameters. + * @param array $field Blueprint for the field. + * @return bool True if validation succeeded. + */ + public static function typeWeek($value, array $params, array $field) + { + if (!isset($params['format']) && !preg_match('/^\d{4}-W\d{2}$/u', $value)) { + return false; + } + + return self::typeDatetime($value, $params, $field); + } + + /** + * Custom input: array + * + * @param mixed $value Value to be validated. + * @param array $params Validation parameters. + * @param array $field Blueprint for the field. + * @return bool True if validation succeeded. + */ + public static function typeArray($value, array $params, array $field) + { + if (!is_array($value)) { + return false; + } + + if (isset($field['multiple'])) { + if (isset($params['min']) && count($value) < $params['min']) { + return false; + } + + if (isset($params['max']) && count($value) > $params['max']) { + return false; + } + + $min = $params['min'] ?? 0; + if (isset($params['step']) && (count($value) - $min) % $params['step'] === 0) { + return false; + } + } + + // If creating new values is allowed, no further checks are needed. + $validateOptions = $field['validate']['options'] ?? null; + if (!empty($field['selectize']['create']) || $validateOptions === 'ignore') { + return true; + } + + $options = $field['options'] ?? []; + $use = $field['use'] ?? 'values'; + + if ($validateOptions) { + // Use custom options structure. + foreach ($options as &$option) { + $option = $option[$validateOptions] ?? null; + } + unset($option); + $options = array_values($options); + } elseif (empty($field['selectize']) || empty($field['multiple'])) { + $options = array_keys($options); + } + if ($use === 'keys') { + $value = array_keys($value); + } + + return !($options && array_diff($value, $options)); + } + + /** + * @param mixed $value + * @param array $params + * @param array $field + * @return array|null + */ + protected static function filterFlatten_array($value, $params, $field) + { + $value = static::filterArray($value, $params, $field); + + return is_array($value) ? Utils::arrayUnflattenDotNotation($value) : null; + } + + /** + * @param mixed $value + * @param array $params + * @param array $field + * @return array|null + */ + protected static function filterArray($value, $params, $field) + { + $values = (array) $value; + $options = isset($field['options']) ? array_keys($field['options']) : []; + $multi = $field['multiple'] ?? false; + + if (count($values) === 1 && isset($values[0]) && $values[0] === '') { + return null; + } + + + if ($options) { + $useKey = isset($field['use']) && $field['use'] === 'keys'; + foreach ($values as $key => $val) { + $values[$key] = $useKey ? (bool) $val : $val; + } + } + + if ($multi) { + foreach ($values as $key => $val) { + if (is_array($val)) { + $val = implode(',', $val); + $values[$key] = array_map('trim', explode(',', $val)); + } else { + $values[$key] = trim($val); + } + } + } + + $ignoreEmpty = isset($field['ignore_empty']) && Utils::isPositive($field['ignore_empty']); + $valueType = $params['value_type'] ?? null; + $keyType = $params['key_type'] ?? null; + if ($ignoreEmpty || $valueType || $keyType) { + $values = static::arrayFilterRecurse($values, ['value_type' => $valueType, 'key_type' => $keyType, 'ignore_empty' => $ignoreEmpty]); + } + + return $values; + } + + /** + * @param array $values + * @param array $params + * @return array + */ + protected static function arrayFilterRecurse(array $values, array $params): array + { + foreach ($values as $key => &$val) { + if ($params['key_type']) { + switch ($params['key_type']) { + case 'int': + $result = is_int($key); + break; + case 'string': + $result = is_string($key); + break; + default: + $result = false; + } + if (!$result) { + unset($values[$key]); + } + } + if (is_array($val)) { + $val = static::arrayFilterRecurse($val, $params); + if ($params['ignore_empty'] && empty($val)) { + unset($values[$key]); + } + } else { + if ($params['value_type'] && $val !== '' && $val !== null) { + switch ($params['value_type']) { + case 'bool': + if (Utils::isPositive($val)) { + $val = true; + } elseif (Utils::isNegative($val)) { + $val = false; + } else { + // Ignore invalid bool values. + $val = null; + } + break; + case 'int': + $val = (int)$val; + break; + case 'float': + $val = (float)$val; + break; + case 'string': + $val = (string)$val; + break; + case 'trim': + $val = trim($val); + break; + } + } + + if ($params['ignore_empty'] && ($val === '' || $val === null)) { + unset($values[$key]); + } + } + } + + return $values; + } + + /** + * @param mixed $value + * @param array $params + * @param array $field + * @return bool + */ + public static function typeList($value, array $params, array $field) + { + if (!is_array($value)) { + return false; + } + + if (isset($field['fields'])) { + foreach ($value as $key => $item) { + foreach ($field['fields'] as $subKey => $subField) { + $subKey = trim($subKey, '.'); + $subValue = $item[$subKey] ?? null; + self::validate($subValue, $subField); + } + } + } + + return true; + } + + /** + * @param mixed $value + * @param array $params + * @param array $field + * @return array + */ + protected static function filterList($value, array $params, array $field) + { + return (array) $value; + } + + /** + * @param mixed $value + * @param array $params + * @return array + */ + public static function filterYaml($value, $params) + { + if (!is_string($value)) { + return $value; + } + + return (array) Yaml::parse($value); + } + + /** + * Custom input: ignore (will not validate) + * + * @param mixed $value Value to be validated. + * @param array $params Validation parameters. + * @param array $field Blueprint for the field. + * @return bool True if validation succeeded. + */ + public static function typeIgnore($value, array $params, array $field) + { + return true; + } + + /** + * @param mixed $value + * @param array $params + * @param array $field + * @return mixed + */ + public static function filterIgnore($value, array $params, array $field) + { + return $value; + } + + /** + * Input value which can be ignored. + * + * @param mixed $value Value to be validated. + * @param array $params Validation parameters. + * @param array $field Blueprint for the field. + * @return bool True if validation succeeded. + */ + public static function typeUnset($value, array $params, array $field) + { + return true; + } + + /** + * @param mixed $value + * @param array $params + * @param array $field + * @return null + */ + public static function filterUnset($value, array $params, array $field) + { + return null; + } + + // HTML5 attributes (min, max and range are handled inside the types) + + /** + * @param mixed $value + * @param bool $params + * @return bool + */ + public static function validateRequired($value, $params) + { + if (is_scalar($value)) { + return (bool) $params !== true || $value !== ''; + } + + return (bool) $params !== true || !empty($value); + } + + /** + * @param mixed $value + * @param string $params + * @return bool + */ + public static function validatePattern($value, $params) + { + return (bool) preg_match("`^{$params}$`u", $value); + } + + // Internal types + + /** + * @param mixed $value + * @param mixed $params + * @return bool + */ + public static function validateAlpha($value, $params) + { + return ctype_alpha($value); + } + + /** + * @param mixed $value + * @param mixed $params + * @return bool + */ + public static function validateAlnum($value, $params) + { + return ctype_alnum($value); + } + + /** + * @param mixed $value + * @param mixed $params + * @return bool + */ + public static function typeBool($value, $params) + { + return is_bool($value) || $value == 1 || $value == 0; + } + + /** + * @param mixed $value + * @param mixed $params + * @return bool + */ + public static function validateBool($value, $params) + { + return is_bool($value) || $value == 1 || $value == 0; + } + + /** + * @param mixed $value + * @param mixed $params + * @return bool + */ + protected static function filterBool($value, $params) + { + return (bool) $value; + } + + /** + * @param mixed $value + * @param mixed $params + * @return bool + */ + public static function validateDigit($value, $params) + { + return ctype_digit($value); + } + + /** + * @param mixed $value + * @param mixed $params + * @return bool + */ + public static function validateFloat($value, $params) + { + return is_float(filter_var($value, FILTER_VALIDATE_FLOAT)); + } + + /** + * @param mixed $value + * @param mixed $params + * @return float + */ + protected static function filterFloat($value, $params) + { + return (float) $value; + } + + /** + * @param mixed $value + * @param mixed $params + * @return bool + */ + public static function validateHex($value, $params) + { + return ctype_xdigit($value); + } + + /** + * Custom input: int + * + * @param mixed $value Value to be validated. + * @param array $params Validation parameters. + * @param array $field Blueprint for the field. + * @return bool True if validation succeeded. + */ + public static function typeInt($value, array $params, array $field) + { + $params['step'] = max(1, (int)($params['step'] ?? 0)); + + return self::typeNumber($value, $params, $field); + } + + /** + * @param mixed $value + * @param mixed $params + * @return bool + */ + public static function validateInt($value, $params) + { + return is_numeric($value) && (int)$value == $value; + } + + /** + * @param mixed $value + * @param mixed $params + * @return int + */ + protected static function filterInt($value, $params) + { + return (int)$value; + } + + /** + * @param mixed $value + * @param mixed $params + * @return bool + */ + public static function validateArray($value, $params) + { + return is_array($value) || ($value instanceof ArrayAccess && $value instanceof Traversable && $value instanceof Countable); + } + + /** + * @param mixed $value + * @param mixed $params + * @return array + */ + public static function filterItem_List($value, $params) + { + return array_values(array_filter($value, static function ($v) { + return !empty($v); + })); + } + + /** + * @param mixed $value + * @param mixed $params + * @return bool + */ + public static function validateJson($value, $params) + { + return (bool) (@json_decode($value)); + } +} diff --git a/system/src/Grav/Common/Data/ValidationException.php b/system/src/Grav/Common/Data/ValidationException.php new file mode 100644 index 0000000..72570a1 --- /dev/null +++ b/system/src/Grav/Common/Data/ValidationException.php @@ -0,0 +1,67 @@ +messages = $messages; + + $language = Grav::instance()['language']; + $this->message = $language->translate('GRAV.FORM.VALIDATION_FAIL', null, true) . ' ' . $this->message; + + foreach ($messages as $list) { + $list = array_unique($list); + foreach ($list as $message) { + $this->message .= '
' . htmlspecialchars($message, ENT_QUOTES | ENT_HTML5, 'UTF-8'); + } + } + + return $this; + } + + public function setSimpleMessage(bool $escape = true): void + { + $first = reset($this->messages); + $message = reset($first); + + $this->message = $escape ? htmlspecialchars($message, ENT_QUOTES | ENT_HTML5, 'UTF-8') : $message; + } + + /** + * @return array + */ + public function getMessages(): array + { + return $this->messages; + } + + public function jsonSerialize(): array + { + return ['validation' => $this->messages]; + } +} diff --git a/system/src/Grav/Common/Debugger.php b/system/src/Grav/Common/Debugger.php new file mode 100644 index 0000000..49e26b2 --- /dev/null +++ b/system/src/Grav/Common/Debugger.php @@ -0,0 +1,1144 @@ +currentTime = microtime(true); + + if (!defined('GRAV_REQUEST_TIME')) { + define('GRAV_REQUEST_TIME', $this->currentTime); + } + + $this->requestTime = $_SERVER['REQUEST_TIME_FLOAT'] ?? GRAV_REQUEST_TIME; + + // Set deprecation collector. + $this->setErrorHandler(); + } + + /** + * @return Clockwork|null + */ + public function getClockwork(): ?Clockwork + { + return $this->enabled ? $this->clockwork : null; + } + + /** + * Initialize the debugger + * + * @return $this + * @throws DebugBarException + */ + public function init() + { + if ($this->initialized) { + return $this; + } + + $this->grav = Grav::instance(); + $this->config = $this->grav['config']; + + // Enable/disable debugger based on configuration. + $this->enabled = (bool)$this->config->get('system.debugger.enabled'); + $this->censored = (bool)$this->config->get('system.debugger.censored', false); + + if ($this->enabled) { + $this->initialized = true; + + $clockwork = $debugbar = null; + + switch ($this->config->get('system.debugger.provider', 'debugbar')) { + case 'clockwork': + $this->clockwork = $clockwork = new Clockwork(); + break; + default: + $this->debugbar = $debugbar = new DebugBar(); + } + + $plugins_config = (array)$this->config->get('plugins'); + ksort($plugins_config); + + if ($clockwork) { + $log = $this->grav['log']; + $clockwork->setStorage(new FileStorage('cache://clockwork')); + if (extension_loaded('xdebug')) { + $clockwork->addDataSource(new XdebugDataSource()); + } + if ($log instanceof Logger) { + $clockwork->addDataSource(new MonologDataSource($log)); + } + + $timeline = $clockwork->timeline(); + if ($this->requestTime !== GRAV_REQUEST_TIME) { + $event = $timeline->event('Server'); + $event->finalize($this->requestTime, GRAV_REQUEST_TIME); + } + if ($this->currentTime !== GRAV_REQUEST_TIME) { + $event = $timeline->event('Loading'); + $event->finalize(GRAV_REQUEST_TIME, $this->currentTime); + } + $event = $timeline->event('Site Setup'); + $event->finalize($this->currentTime, microtime(true)); + } + + if ($this->censored) { + $censored = ['CENSORED' => true]; + } + + if ($debugbar) { + $debugbar->addCollector(new PhpInfoCollector()); + $debugbar->addCollector(new MessagesCollector()); + if (!$this->censored) { + $debugbar->addCollector(new RequestDataCollector()); + } + $debugbar->addCollector(new TimeDataCollector($this->requestTime)); + $debugbar->addCollector(new MemoryCollector()); + $debugbar->addCollector(new ExceptionsCollector()); + $debugbar->addCollector(new ConfigCollector($censored ?? (array)$this->config->get('system'), 'Config')); + $debugbar->addCollector(new ConfigCollector($censored ?? $plugins_config, 'Plugins')); + $debugbar->addCollector(new ConfigCollector($this->config->get('streams.schemes'), 'Streams')); + + if ($this->requestTime !== GRAV_REQUEST_TIME) { + $debugbar['time']->addMeasure('Server', $debugbar['time']->getRequestStartTime(), GRAV_REQUEST_TIME); + } + if ($this->currentTime !== GRAV_REQUEST_TIME) { + $debugbar['time']->addMeasure('Loading', GRAV_REQUEST_TIME, $this->currentTime); + } + $debugbar['time']->addMeasure('Site Setup', $this->currentTime, microtime(true)); + } + + $this->addMessage('Grav v' . GRAV_VERSION . ' - PHP ' . PHP_VERSION); + $this->config->debug(); + + if ($clockwork) { + $clockwork->info('System Configuration', $censored ?? $this->config->get('system')); + $clockwork->info('Plugins Configuration', $censored ?? $plugins_config); + $clockwork->info('Streams', $this->config->get('streams.schemes')); + } + } + + return $this; + } + + public function finalize(): void + { + if ($this->clockwork && $this->enabled) { + $this->stopProfiling('Profiler Analysis'); + $this->addMeasures(); + + $deprecations = $this->getDeprecations(); + $count = count($deprecations); + if (!$count) { + return; + } + + /** @var UserData $userData */ + $userData = $this->clockwork->userData('Deprecated'); + $userData->counters([ + 'Deprecated' => count($deprecations) + ]); + /* + foreach ($deprecations as &$deprecation) { + $d = $deprecation; + unset($d['message']); + $this->clockwork->log('deprecated', $deprecation['message'], $d); + } + unset($deprecation); + */ + + $userData->table('Your site is using following deprecated features', $deprecations); + } + } + + public function logRequest(ServerRequestInterface $request, ResponseInterface $response): ResponseInterface + { + if (!$this->enabled || !$this->clockwork) { + return $response; + } + + $clockwork = $this->clockwork; + + $this->finalize(); + + $clockwork->timeline()->finalize($request->getAttribute('request_time')); + + if ($this->censored) { + $censored = 'CENSORED'; + $request = $request + ->withCookieParams([$censored => '']) + ->withUploadedFiles([]) + ->withHeader('cookie', $censored); + $request = $request->withParsedBody([$censored => '']); + } + + $clockwork->addDataSource(new PsrMessageDataSource($request, $response)); + + $clockwork->resolveRequest(); + $clockwork->storeRequest(); + + $clockworkRequest = $clockwork->getRequest(); + + $response = $response + ->withHeader('X-Clockwork-Id', $clockworkRequest->id) + ->withHeader('X-Clockwork-Version', $clockwork::VERSION); + + $grav = Grav::instance(); + $basePath = $this->grav['base_url_relative'] . $grav['pages']->base(); + if ($basePath) { + $response = $response->withHeader('X-Clockwork-Path', $basePath . '/__clockwork/'); + } + + return $response->withHeader('Server-Timing', ServerTiming::fromRequest($clockworkRequest)->value()); + } + + + public function debuggerRequest(RequestInterface $request): Response + { + $clockwork = $this->clockwork; + + $headers = [ + 'Content-Type' => 'application/json', + 'Grav-Internal-SkipShutdown' => 1 + ]; + + $path = $request->getUri()->getPath(); + $clockworkDataUri = '#/__clockwork(?:/(?[0-9-]+))?(?:/(?(?:previous|next)))?(?:/(?\d+))?#'; + if (preg_match($clockworkDataUri, $path, $matches) === false) { + $response = ['message' => 'Bad Input']; + + return new Response(400, $headers, json_encode($response)); + } + + $id = $matches['id'] ?? null; + $direction = $matches['direction'] ?? null; + $count = $matches['count'] ?? null; + + $storage = $clockwork->getStorage(); + + if ($direction === 'previous') { + $data = $storage->previous($id, $count); + } elseif ($direction === 'next') { + $data = $storage->next($id, $count); + } elseif ($id === 'latest') { + $data = $storage->latest(); + } else { + $data = $storage->find($id); + } + + if (preg_match('#(?[0-9-]+|latest)/extended#', $path)) { + $clockwork->extendRequest($data); + } + + if (!$data) { + $response = ['message' => 'Not Found']; + + return new Response(404, $headers, json_encode($response)); + } + + $data = is_array($data) ? array_map(static function ($item) { + return $item->toArray(); + }, $data) : $data->toArray(); + + return new Response(200, $headers, json_encode($data)); + } + + /** + * @return void + */ + protected function addMeasures(): void + { + if (!$this->enabled) { + return; + } + + $nowTime = microtime(true); + $clkTimeLine = $this->clockwork ? $this->clockwork->timeline() : null; + $debTimeLine = $this->debugbar ? $this->debugbar['time'] : null; + foreach ($this->timers as $name => $data) { + $description = $data[0]; + $startTime = $data[1] ?? null; + $endTime = $data[2] ?? $nowTime; + if ($clkTimeLine) { + $event = $clkTimeLine->event($description); + $event->finalize($startTime, $endTime); + } elseif ($debTimeLine) { + if ($endTime - $startTime < 0.001) { + continue; + } + + $debTimeLine->addMeasure($description ?? $name, $startTime, $endTime); + } + } + $this->timers = []; + } + + /** + * Set/get the enabled state of the debugger + * + * @param bool|null $state If null, the method returns the enabled value. If set, the method sets the enabled state + * @return bool + */ + public function enabled($state = null) + { + if ($state !== null) { + $this->enabled = (bool)$state; + } + + return $this->enabled; + } + + /** + * Add the debugger assets to the Grav Assets + * + * @return $this + */ + public function addAssets() + { + if ($this->enabled) { + // Only add assets if Page is HTML + $page = $this->grav['page']; + if ($page->templateFormat() !== 'html') { + return $this; + } + + /** @var Assets $assets */ + $assets = $this->grav['assets']; + + // Clockwork specific assets + if ($this->clockwork) { + $assets->addCss('/system/assets/debugger/clockwork.css', ['loading' => 'inline']); + $assets->addJs('/system/assets/debugger/clockwork.js', ['loading' => 'inline']); + } + + + // Debugbar specific assets + if ($this->debugbar) { + // Add jquery library + $assets->add('jquery', 101); + + $this->renderer = $this->debugbar->getJavascriptRenderer(); + $this->renderer->setIncludeVendors(false); + + [$css_files, $js_files] = $this->renderer->getAssets(null, JavascriptRenderer::RELATIVE_URL); + + foreach ((array)$css_files as $css) { + $assets->addCss($css); + } + + $assets->addCss('/system/assets/debugger/phpdebugbar.css', ['loading' => 'inline']); + + foreach ((array)$js_files as $js) { + $assets->addJs($js); + } + } + } + + return $this; + } + + /** + * @param int $limit + * @return array + */ + public function getCaller($limit = 2) + { + $trace = debug_backtrace(false, $limit); + + return array_pop($trace); + } + + /** + * Adds a data collector + * + * @param DataCollectorInterface $collector + * @return $this + * @throws DebugBarException + */ + public function addCollector($collector) + { + if ($this->debugbar && !$this->debugbar->hasCollector($collector->getName())) { + $this->debugbar->addCollector($collector); + } + + return $this; + } + + /** + * Returns a data collector + * + * @param string $name + * @return DataCollectorInterface|null + * @throws DebugBarException + */ + public function getCollector($name) + { + if ($this->debugbar && $this->debugbar->hasCollector($name)) { + return $this->debugbar->getCollector($name); + } + + return null; + } + + /** + * Displays the debug bar + * + * @return $this + */ + public function render() + { + if ($this->enabled && $this->debugbar) { + // Only add assets if Page is HTML + $page = $this->grav['page']; + if (!$this->renderer || $page->templateFormat() !== 'html') { + return $this; + } + + $this->addMeasures(); + $this->addDeprecations(); + + echo $this->renderer->render(); + } + + return $this; + } + + /** + * Sends the data through the HTTP headers + * + * @return $this + */ + public function sendDataInHeaders() + { + if ($this->enabled && $this->debugbar) { + $this->addMeasures(); + $this->addDeprecations(); + $this->debugbar->sendDataInHeaders(); + } + + return $this; + } + + /** + * Returns collected debugger data. + * + * @return array|null + */ + public function getData() + { + if (!$this->enabled || !$this->debugbar) { + return null; + } + + $this->addMeasures(); + $this->addDeprecations(); + $this->timers = []; + + return $this->debugbar->getData(); + } + + /** + * Hierarchical Profiler support. + * + * @param callable $callable + * @param string|null $message + * @return mixed + */ + public function profile(callable $callable, string $message = null) + { + $this->startProfiling(); + $response = $callable(); + $this->stopProfiling($message); + + return $response; + } + + public function addTwigProfiler(Environment $twig): void + { + $clockwork = $this->getClockwork(); + if ($clockwork) { + $source = new TwigClockworkDataSource($twig); + $source->listenToEvents(); + $clockwork->addDataSource($source); + } + } + + /** + * Start profiling code. + * + * @return void + */ + public function startProfiling(): void + { + if ($this->enabled && extension_loaded('tideways_xhprof')) { + $this->profiling++; + if ($this->profiling === 1) { + // @phpstan-ignore-next-line + \tideways_xhprof_enable(TIDEWAYS_XHPROF_FLAGS_NO_BUILTINS); + } + } + } + + /** + * Stop profiling code. Returns profiling array or null if profiling couldn't be done. + * + * @param string|null $message + * @return array|null + */ + public function stopProfiling(string $message = null): ?array + { + $timings = null; + if ($this->enabled && extension_loaded('tideways_xhprof')) { + $profiling = $this->profiling - 1; + if ($profiling === 0) { + // @phpstan-ignore-next-line + $timings = \tideways_xhprof_disable(); + $timings = $this->buildProfilerTimings($timings); + + if ($this->clockwork) { + /** @var UserData $userData */ + $userData = $this->clockwork->userData('Profiler'); + $userData->counters([ + 'Calls' => count($timings) + ]); + $userData->table('Profiler', $timings); + } else { + $this->addMessage($message ?? 'Profiler Analysis', 'debug', $timings); + } + } + $this->profiling = max(0, $profiling); + } + + return $timings; + } + + /** + * @param array $timings + * @return array + */ + protected function buildProfilerTimings(array $timings): array + { + // Filter method calls which take almost no time. + $timings = array_filter($timings, function ($value) { + return $value['wt'] > 50; + }); + + uasort($timings, function (array $a, array $b) { + return $b['wt'] <=> $a['wt']; + }); + + $table = []; + foreach ($timings as $key => $timing) { + $parts = explode('==>', $key); + $method = $this->parseProfilerCall(array_pop($parts)); + $context = $this->parseProfilerCall(array_pop($parts)); + + // Skip redundant method calls. + if ($context === 'Grav\Framework\RequestHandler\RequestHandler::handle()') { + continue; + } + + // Do not profile library calls. + if (strpos($context, 'Grav\\') !== 0) { + continue; + } + + $table[] = [ + 'Context' => $context, + 'Method' => $method, + 'Calls' => $timing['ct'], + 'Time (ms)' => $timing['wt'] / 1000, + ]; + } + + return $table; + } + + /** + * @param string|null $call + * @return mixed|string|null + */ + protected function parseProfilerCall(?string $call) + { + if (null === $call) { + return ''; + } + if (strpos($call, '@')) { + [$call,] = explode('@', $call); + } + if (strpos($call, '::')) { + [$class, $call] = explode('::', $call); + } + + if (!isset($class)) { + return $call; + } + + // It is also possible to display twig files, but they are being logged in views. + /* + if (strpos($class, '__TwigTemplate_') === 0 && class_exists($class)) { + $env = new Environment(); + / ** @var Template $template * / + $template = new $class($env); + + return $template->getTemplateName(); + } + */ + + return "{$class}::{$call}()"; + } + + /** + * Start a timer with an associated name and description + * + * @param string $name + * @param string|null $description + * @return $this + */ + public function startTimer($name, $description = null) + { + $this->timers[$name] = [$description, microtime(true)]; + + return $this; + } + + /** + * Stop the named timer + * + * @param string $name + * @return $this + */ + public function stopTimer($name) + { + if (isset($this->timers[$name])) { + $endTime = microtime(true); + $this->timers[$name][] = $endTime; + } + + return $this; + } + + /** + * Dump variables into the Messages tab of the Debug Bar + * + * @param mixed $message + * @param string $label + * @param mixed|bool $isString + * @return $this + */ + public function addMessage($message, $label = 'info', $isString = true) + { + if ($this->enabled) { + if ($this->censored) { + if (!is_scalar($message)) { + $message = 'CENSORED'; + } + if (!is_scalar($isString)) { + $isString = ['CENSORED']; + } + } + + if ($this->debugbar) { + if (is_array($isString)) { + $message = $isString; + $isString = false; + } elseif (is_string($isString)) { + $message = $isString; + $isString = true; + } + $this->debugbar['messages']->addMessage($message, $label, $isString); + } + + if ($this->clockwork) { + $context = $isString; + if (!is_scalar($message)) { + $context = $message; + $message = gettype($context); + } + if (is_bool($context)) { + $context = []; + } elseif (!is_array($context)) { + $type = gettype($context); + $context = [$type => $context]; + } + + $this->clockwork->log($label, $message, $context); + } + } + + return $this; + } + + /** + * @param string $name + * @param object $event + * @param EventDispatcherInterface $dispatcher + * @param float|null $time + * @return $this + */ + public function addEvent(string $name, $event, EventDispatcherInterface $dispatcher, float $time = null) + { + if ($this->enabled && $this->clockwork) { + $time = $time ?? microtime(true); + $duration = (microtime(true) - $time) * 1000; + + $data = null; + if ($event && method_exists($event, '__debugInfo')) { + $data = $event; + } + + $listeners = []; + foreach ($dispatcher->getListeners($name) as $listener) { + $listeners[] = $this->resolveCallable($listener); + } + + $this->clockwork->addEvent($name, $data, $time, ['listeners' => $listeners, 'duration' => $duration]); + } + + return $this; + } + + /** + * Dump exception into the Messages tab of the Debug Bar + * + * @param Throwable $e + * @return Debugger + */ + public function addException(Throwable $e) + { + if ($this->initialized && $this->enabled) { + if ($this->debugbar) { + $this->debugbar['exceptions']->addThrowable($e); + } + + if ($this->clockwork) { + /** @var UserData $exceptions */ + $exceptions = $this->clockwork->userData('Exceptions'); + $exceptions->data(['message' => $e->getMessage()]); + + $this->clockwork->alert($e->getMessage(), ['exception' => $e]); + } + } + + return $this; + } + + /** + * @return void + */ + public function setErrorHandler() + { + $this->errorHandler = set_error_handler( + [$this, 'deprecatedErrorHandler'] + ); + } + + /** + * @param int $errno + * @param string $errstr + * @param string $errfile + * @param int $errline + * @return bool + */ + public function deprecatedErrorHandler($errno, $errstr, $errfile, $errline) + { + if ($errno !== E_USER_DEPRECATED && $errno !== E_DEPRECATED) { + if ($this->errorHandler) { + return call_user_func($this->errorHandler, $errno, $errstr, $errfile, $errline); + } + + return true; + } + + if (!$this->enabled) { + return true; + } + + // Figure out error scope from the error. + $scope = 'unknown'; + if (stripos($errstr, 'grav') !== false) { + $scope = 'grav'; + } elseif (strpos($errfile, '/twig/') !== false) { + $scope = 'twig'; + // TODO: remove when upgrading to Twig 2+ + if (str_contains($errstr, '#[\ReturnTypeWillChange]') || str_contains($errstr, 'Passing null to parameter')) { + return true; + } + } elseif (stripos($errfile, '/yaml/') !== false) { + $scope = 'yaml'; + } elseif (strpos($errfile, '/vendor/') !== false) { + $scope = 'vendor'; + } + + // Clean up backtrace to make it more useful. + $backtrace = debug_backtrace(DEBUG_BACKTRACE_PROVIDE_OBJECT); + + // Skip current call. + array_shift($backtrace); + + // Find yaml file where the error happened. + if ($scope === 'yaml') { + foreach ($backtrace as $current) { + if (isset($current['args'])) { + foreach ($current['args'] as $arg) { + if ($arg instanceof SplFileInfo) { + $arg = $arg->getPathname(); + } + if (is_string($arg) && preg_match('/.+\.(yaml|md)$/i', $arg)) { + $errfile = $arg; + $errline = 0; + + break 2; + } + } + } + } + } + + // Filter arguments. + $cut = 0; + $previous = null; + foreach ($backtrace as $i => &$current) { + if (isset($current['args'])) { + $args = []; + foreach ($current['args'] as $arg) { + if (is_string($arg)) { + $arg = "'" . $arg . "'"; + if (mb_strlen($arg) > 100) { + $arg = 'string'; + } + } elseif (is_bool($arg)) { + $arg = $arg ? 'true' : 'false'; + } elseif (is_scalar($arg)) { + $arg = $arg; + } elseif (is_object($arg)) { + $arg = get_class($arg) . ' $object'; + } elseif (is_array($arg)) { + $arg = '$array'; + } else { + $arg = '$object'; + } + + $args[] = $arg; + } + $current['args'] = $args; + } + + $object = $current['object'] ?? null; + unset($current['object']); + + $reflection = null; + if ($object instanceof TemplateWrapper) { + $reflection = new ReflectionObject($object); + $property = $reflection->getProperty('template'); + $property->setAccessible(true); + $object = $property->getValue($object); + } + + if ($object instanceof Template) { + $file = $current['file'] ?? null; + + if (preg_match('`(Template.php|TemplateWrapper.php)$`', $file)) { + $current = null; + continue; + } + + $debugInfo = $object->getDebugInfo(); + + $line = 1; + if (!$reflection) { + foreach ($debugInfo as $codeLine => $templateLine) { + if ($codeLine <= $current['line']) { + $line = $templateLine; + break; + } + } + } + + $src = $object->getSourceContext(); + //$code = preg_split('/\r\n|\r|\n/', $src->getCode()); + //$current['twig']['twig'] = trim($code[$line - 1]); + $current['twig']['file'] = $src->getPath(); + $current['twig']['line'] = $line; + + $prevFile = $previous['file'] ?? null; + if ($prevFile && $file === $prevFile) { + $prevLine = $previous['line']; + + $line = 1; + foreach ($debugInfo as $codeLine => $templateLine) { + if ($codeLine <= $prevLine) { + $line = $templateLine; + break; + } + } + + //$previous['twig']['twig'] = trim($code[$line - 1]); + $previous['twig']['file'] = $src->getPath(); + $previous['twig']['line'] = $line; + } + + $cut = $i; + } elseif ($object instanceof ProcessorInterface) { + $cut = $cut ?: $i; + break; + } + + $previous = &$backtrace[$i]; + } + unset($current); + + if ($cut) { + $backtrace = array_slice($backtrace, 0, $cut + 1); + } + $backtrace = array_values(array_filter($backtrace)); + + // Skip vendor libraries and the method where error was triggered. + foreach ($backtrace as $i => $current) { + if (!isset($current['file'])) { + continue; + } + if (strpos($current['file'], '/vendor/') !== false) { + $cut = $i + 1; + continue; + } + if (isset($current['function']) && ($current['function'] === 'user_error' || $current['function'] === 'trigger_error')) { + $cut = $i + 1; + continue; + } + + break; + } + + if ($cut) { + $backtrace = array_slice($backtrace, $cut); + } + $backtrace = array_values(array_filter($backtrace)); + + $current = reset($backtrace); + + // If the issue happened inside twig file, change the file and line to match that file. + $file = $current['twig']['file'] ?? ''; + if ($file) { + $errfile = $file; + $errline = $current['twig']['line'] ?? 0; + } + + $deprecation = [ + 'scope' => $scope, + 'message' => $errstr, + 'file' => $errfile, + 'line' => $errline, + 'trace' => $backtrace, + 'count' => 1 + ]; + + $this->deprecations[] = $deprecation; + + // Do not pass forward. + return true; + } + + /** + * @return array + */ + protected function getDeprecations(): array + { + if (!$this->deprecations) { + return []; + } + + $list = []; + /** @var array $deprecated */ + foreach ($this->deprecations as $deprecated) { + $list[] = $this->getDepracatedMessage($deprecated)[0]; + } + + return $list; + } + + /** + * @return void + * @throws DebugBarException + */ + protected function addDeprecations() + { + if (!$this->deprecations) { + return; + } + + $collector = new MessagesCollector('deprecated'); + $this->addCollector($collector); + $collector->addMessage('Your site is using following deprecated features:'); + + /** @var array $deprecated */ + foreach ($this->deprecations as $deprecated) { + list($message, $scope) = $this->getDepracatedMessage($deprecated); + + $collector->addMessage($message, $scope); + } + } + + /** + * @param array $deprecated + * @return array + */ + protected function getDepracatedMessage($deprecated) + { + $scope = $deprecated['scope']; + + $trace = []; + if (isset($deprecated['trace'])) { + foreach ($deprecated['trace'] as $current) { + $class = $current['class'] ?? ''; + $type = $current['type'] ?? ''; + $function = $this->getFunction($current); + if (isset($current['file'])) { + $current['file'] = str_replace(GRAV_ROOT . '/', '', $current['file']); + } + + unset($current['class'], $current['type'], $current['function'], $current['args']); + + if (isset($current['twig'])) { + $trace[] = $current['twig']; + } else { + $trace[] = ['call' => $class . $type . $function] + $current; + } + } + } + + $array = [ + 'message' => $deprecated['message'], + 'file' => $deprecated['file'], + 'line' => $deprecated['line'], + 'trace' => $trace + ]; + + return [ + array_filter($array), + $scope + ]; + } + + /** + * @param array $trace + * @return string + */ + protected function getFunction($trace) + { + if (!isset($trace['function'])) { + return ''; + } + + return $trace['function'] . '(' . implode(', ', $trace['args'] ?? []) . ')'; + } + + /** + * @param callable $callable + * @return string + */ + protected function resolveCallable(callable $callable) + { + if (is_array($callable)) { + return get_class($callable[0]) . '->' . $callable[1] . '()'; + } + + return 'unknown'; + } +} diff --git a/system/src/Grav/Common/Errors/BareHandler.php b/system/src/Grav/Common/Errors/BareHandler.php new file mode 100644 index 0000000..fa5a095 --- /dev/null +++ b/system/src/Grav/Common/Errors/BareHandler.php @@ -0,0 +1,33 @@ +getInspector(); + $code = $inspector->getException()->getCode(); + if (($code >= 400) && ($code < 600)) { + $this->getRun()->sendHttpCode($code); + } + + return Handler::QUIT; + } +} diff --git a/system/src/Grav/Common/Errors/Errors.php b/system/src/Grav/Common/Errors/Errors.php new file mode 100644 index 0000000..eec79f4 --- /dev/null +++ b/system/src/Grav/Common/Errors/Errors.php @@ -0,0 +1,85 @@ +get('system.errors'); + $jsonRequest = $_SERVER && isset($_SERVER['HTTP_ACCEPT']) && $_SERVER['HTTP_ACCEPT'] === 'application/json'; + + // Setup Whoops-based error handler + $system = new SystemFacade; + $whoops = new Run($system); + + $verbosity = 1; + + if (isset($config['display'])) { + if (is_int($config['display'])) { + $verbosity = $config['display']; + } else { + $verbosity = $config['display'] ? 1 : 0; + } + } + + switch ($verbosity) { + case 1: + $error_page = new PrettyPageHandler(); + $error_page->setPageTitle('Crikey! There was an error...'); + $error_page->addResourcePath(GRAV_ROOT . '/system/assets'); + $error_page->addCustomCss('whoops.css'); + $whoops->prependHandler($error_page); + break; + case -1: + $whoops->prependHandler(new BareHandler); + break; + default: + $whoops->prependHandler(new SimplePageHandler); + break; + } + + if ($jsonRequest || Misc::isAjaxRequest()) { + $whoops->prependHandler(new JsonResponseHandler()); + } + + if (isset($config['log']) && $config['log']) { + $logger = $grav['log']; + $whoops->pushHandler(function ($exception, $inspector, $run) use ($logger) { + try { + $logger->addCritical($exception->getMessage() . ' - Trace: ' . $exception->getTraceAsString()); + } catch (Exception $e) { + echo $e; + } + }); + } + + $whoops->register(); + + // Re-register deprecation handler. + $grav['debugger']->setErrorHandler(); + } +} diff --git a/system/src/Grav/Common/Errors/Resources/error.css b/system/src/Grav/Common/Errors/Resources/error.css new file mode 100644 index 0000000..11ce3fd --- /dev/null +++ b/system/src/Grav/Common/Errors/Resources/error.css @@ -0,0 +1,52 @@ +html, body { + height: 100% +} +body { + margin:0 3rem; + padding:0; + font-family: "Helvetica Neue", Helvetica, Arial, sans-serif; + font-size: 1.5rem; + line-height: 1.4; + display: -webkit-box; /* OLD - iOS 6-, Safari 3.1-6 */ + display: -moz-box; /* OLD - Firefox 19- (buggy but mostly works) */ + display: -ms-flexbox; /* TWEENER - IE 10 */ + display: -webkit-flex; /* NEW - Chrome */ + display: flex; + -webkit-align-items: center; + align-items: center; + -webkit-justify-content: center; + justify-content: center; +} +.container { + margin: 0rem; + max-width: 600px; + padding-bottom:5rem; +} + +header { + color: #000; + font-size: 4rem; + letter-spacing: 2px; + line-height: 1.1; + margin-bottom: 2rem; +} +p { + font-family: Optima, Segoe, "Segoe UI", Candara, Calibri, Arial, sans-serif; + color: #666; +} + +h5 { + font-weight: normal; + color: #999; + font-size: 1rem; +} + +h6 { + font-weight: normal; + color: #999; +} + +code { + font-weight: bold; + font-family: Menlo, Monaco, Consolas, "Courier New", monospace; +} diff --git a/system/src/Grav/Common/Errors/Resources/layout.html.php b/system/src/Grav/Common/Errors/Resources/layout.html.php new file mode 100644 index 0000000..6699959 --- /dev/null +++ b/system/src/Grav/Common/Errors/Resources/layout.html.php @@ -0,0 +1,30 @@ + + + + + + Whoops there was an error! + + + +
+
+
+ Server Error +
+ + + +

Sorry, something went terribly wrong!

+ +

-

+ +
For further details please review your logs/ folder, or enable displaying of errors in your system configuration.
+
+
+ + diff --git a/system/src/Grav/Common/Errors/SimplePageHandler.php b/system/src/Grav/Common/Errors/SimplePageHandler.php new file mode 100644 index 0000000..4f11fdd --- /dev/null +++ b/system/src/Grav/Common/Errors/SimplePageHandler.php @@ -0,0 +1,122 @@ +searchPaths[] = __DIR__ . '/Resources'; + } + + /** + * @return int + */ + public function handle() + { + $inspector = $this->getInspector(); + + $helper = new TemplateHelper(); + $templateFile = $this->getResource('layout.html.php'); + $cssFile = $this->getResource('error.css'); + + $code = $inspector->getException()->getCode(); + if (($code >= 400) && ($code < 600)) { + $this->getRun()->sendHttpCode($code); + } + $message = $inspector->getException()->getMessage(); + + if ($inspector->getException() instanceof ErrorException) { + $code = Misc::translateErrorCode($code); + } + + $vars = array( + 'stylesheet' => file_get_contents($cssFile), + 'code' => $code, + 'message' => htmlspecialchars(strip_tags(rawurldecode($message)), ENT_QUOTES, 'UTF-8'), + ); + + $helper->setVariables($vars); + $helper->render($templateFile); + + return Handler::QUIT; + } + + /** + * @param string $resource + * @return string + * @throws RuntimeException + */ + protected function getResource($resource) + { + // If the resource was found before, we can speed things up + // by caching its absolute, resolved path: + if (isset($this->resourceCache[$resource])) { + return $this->resourceCache[$resource]; + } + + // Search through available search paths, until we find the + // resource we're after: + foreach ($this->searchPaths as $path) { + $fullPath = "{$path}/{$resource}"; + + if (is_file($fullPath)) { + // Cache the result: + $this->resourceCache[$resource] = $fullPath; + return $fullPath; + } + } + + // If we got this far, nothing was found. + throw new RuntimeException( + "Could not find resource '{$resource}' in any resource paths (searched: " . implode(', ', $this->searchPaths). ')' + ); + } + + /** + * @param string $path + * @return void + */ + public function addResourcePath($path) + { + if (!is_dir($path)) { + throw new InvalidArgumentException( + "'{$path}' is not a valid directory" + ); + } + + array_unshift($this->searchPaths, $path); + } + + /** + * @return array + */ + public function getResourcePaths() + { + return $this->searchPaths; + } +} diff --git a/system/src/Grav/Common/Errors/SystemFacade.php b/system/src/Grav/Common/Errors/SystemFacade.php new file mode 100644 index 0000000..24c2c31 --- /dev/null +++ b/system/src/Grav/Common/Errors/SystemFacade.php @@ -0,0 +1,67 @@ +whoopsShutdownHandler = $function; + register_shutdown_function([$this, 'handleShutdown']); + } + + /** + * Special case to deal with Fatal errors and the like. + * + * @return void + */ + public function handleShutdown() + { + $error = $this->getLastError(); + + // Ignore core warnings and errors. + if ($error && !($error['type'] & (E_CORE_WARNING | E_CORE_ERROR))) { + $handler = $this->whoopsShutdownHandler; + $handler(); + } + } + + + /** + * @param int $httpCode + * + * @return int + */ + public function setHttpResponseCode($httpCode) + { + if (!headers_sent()) { + // Ensure that no 'location' header is present as otherwise this + // will override the HTTP code being set here, and mask the + // expected error page. + header_remove('location'); + + // Work around PHP bug #8218 (8.0.17 & 8.1.4). + header_remove('Content-Encoding'); + } + + return http_response_code($httpCode); + } +} diff --git a/system/src/Grav/Common/File/CompiledFile.php b/system/src/Grav/Common/File/CompiledFile.php new file mode 100644 index 0000000..1266e9d --- /dev/null +++ b/system/src/Grav/Common/File/CompiledFile.php @@ -0,0 +1,195 @@ +filename; + // If nothing has been loaded, attempt to get pre-compiled version of the file first. + if ($var === null && $this->raw === null && $this->content === null) { + $key = md5($filename); + $file = PhpFile::instance(CACHE_DIR . "compiled/files/{$key}{$this->extension}.php"); + + $modified = $this->modified(); + if (!$modified) { + try { + return $this->decode($this->raw()); + } catch (Throwable $e) { + // If the compiled file is broken, we can safely ignore the error and continue. + } + } + + $class = get_class($this); + + $size = filesize($filename); + $cache = $file->exists() ? $file->content() : null; + + // Load real file if cache isn't up to date (or is invalid). + if (!isset($cache['@class']) + || $cache['@class'] !== $class + || $cache['modified'] !== $modified + || ($cache['size'] ?? null) !== $size + || $cache['filename'] !== $filename + ) { + // Attempt to lock the file for writing. + try { + $locked = $file->lock(false); + } catch (Exception $e) { + $locked = false; + + /** @var Debugger $debugger */ + $debugger = Grav::instance()['debugger']; + $debugger->addMessage(sprintf('%s(): Cannot obtain a lock for compiling cache file for %s: %s', __METHOD__, $this->filename, $e->getMessage()), 'warning'); + } + + // Decode RAW file into compiled array. + $data = (array)$this->decode($this->raw()); + $cache = [ + '@class' => $class, + 'filename' => $filename, + 'modified' => $modified, + 'size' => $size, + 'data' => $data + ]; + + // If compiled file wasn't already locked by another process, save it. + if ($locked) { + $file->save($cache); + $file->unlock(); + + // Compile cached file into bytecode cache + if (function_exists('opcache_invalidate') && filter_var(ini_get('opcache.enable'), \FILTER_VALIDATE_BOOLEAN)) { + $lockName = $file->filename(); + + // Silence error if function exists, but is restricted. + @opcache_invalidate($lockName, true); + @opcache_compile_file($lockName); + } + } + } + $file->free(); + + $this->content = $cache['data']; + } + } catch (Exception $e) { + throw new RuntimeException(sprintf('Failed to read %s: %s', Utils::basename($filename), $e->getMessage()), 500, $e); + } + + return parent::content($var); + } + + /** + * Save file. + * + * @param mixed $data Optional data to be saved, usually array. + * @return void + * @throws RuntimeException + */ + public function save($data = null) + { + // Make sure that the cache file is always up to date! + $key = md5($this->filename); + $file = PhpFile::instance(CACHE_DIR . "compiled/files/{$key}{$this->extension}.php"); + try { + $locked = $file->lock(); + } catch (Exception $e) { + $locked = false; + + /** @var Debugger $debugger */ + $debugger = Grav::instance()['debugger']; + $debugger->addMessage(sprintf('%s(): Cannot obtain a lock for compiling cache file for %s: %s', __METHOD__, $this->filename, $e->getMessage()), 'warning'); + } + + parent::save($data); + + if ($locked) { + $modified = $this->modified(); + $filename = $this->filename; + $class = get_class($this); + $size = filesize($filename); + + // windows doesn't play nicely with this as it can't read when locked + if (!Utils::isWindows()) { + // Reload data from the filesystem. This ensures that we always cache the correct data (see issue #2282). + $this->raw = $this->content = null; + $data = (array)$this->decode($this->raw()); + } + + // Decode data into compiled array. + $cache = [ + '@class' => $class, + 'filename' => $filename, + 'modified' => $modified, + 'size' => $size, + 'data' => $data + ]; + + $file->save($cache); + $file->unlock(); + + // Compile cached file into bytecode cache + if (function_exists('opcache_invalidate') && filter_var(ini_get('opcache.enable'), \FILTER_VALIDATE_BOOLEAN)) { + $lockName = $file->filename(); + // Silence error if function exists, but is restricted. + @opcache_invalidate($lockName, true); + @opcache_compile_file($lockName); + } + } + } + + /** + * Serialize file. + * + * @return array + */ + public function __sleep() + { + return [ + 'filename', + 'extension', + 'raw', + 'content', + 'settings' + ]; + } + + /** + * Unserialize file. + */ + public function __wakeup() + { + if (!isset(static::$instances[$this->filename])) { + static::$instances[$this->filename] = $this; + } + } +} diff --git a/system/src/Grav/Common/File/CompiledJsonFile.php b/system/src/Grav/Common/File/CompiledJsonFile.php new file mode 100644 index 0000000..ed5787e --- /dev/null +++ b/system/src/Grav/Common/File/CompiledJsonFile.php @@ -0,0 +1,33 @@ + ['.DS_Store'], + 'exclude_paths' => [] + ]; + + /** @var string */ + protected $archive_file; + + /** + * @param string $compression + * @return ZipArchiver + */ + public static function create($compression) + { + if ($compression === 'zip') { + return new ZipArchiver(); + } + + return new ZipArchiver(); + } + + /** + * @param string $archive_file + * @return $this + */ + public function setArchive($archive_file) + { + $this->archive_file = $archive_file; + + return $this; + } + + /** + * @param array $options + * @return $this + */ + public function setOptions($options) + { + // Set infinite PHP execution time if possible. + if (Utils::functionExists('set_time_limit')) { + @set_time_limit(0); + } + + $this->options = $options + $this->options; + + return $this; + } + + /** + * @param string $folder + * @param callable|null $status + * @return $this + */ + abstract public function compress($folder, callable $status = null); + + /** + * @param string $destination + * @param callable|null $status + * @return $this + */ + abstract public function extract($destination, callable $status = null); + + /** + * @param array $folders + * @param callable|null $status + * @return $this + */ + abstract public function addEmptyFolders($folders, callable $status = null); + + /** + * @param string $rootPath + * @return RecursiveIteratorIterator + */ + protected function getArchiveFiles($rootPath) + { + $exclude_paths = $this->options['exclude_paths']; + $exclude_files = $this->options['exclude_files']; + $dirItr = new RecursiveDirectoryIterator($rootPath, RecursiveDirectoryIterator::SKIP_DOTS | FilesystemIterator::FOLLOW_SYMLINKS | FilesystemIterator::UNIX_PATHS); + $filterItr = new RecursiveDirectoryFilterIterator($dirItr, $rootPath, $exclude_paths, $exclude_files); + $files = new RecursiveIteratorIterator($filterItr, RecursiveIteratorIterator::SELF_FIRST); + + return $files; + } +} diff --git a/system/src/Grav/Common/Filesystem/Folder.php b/system/src/Grav/Common/Filesystem/Folder.php new file mode 100644 index 0000000..06f489d --- /dev/null +++ b/system/src/Grav/Common/Filesystem/Folder.php @@ -0,0 +1,548 @@ +isStream($path)) { + $directory = $locator->getRecursiveIterator($path, $flags); + } else { + $directory = new RecursiveDirectoryIterator($path, $flags); + } + $filter = new RecursiveFolderFilterIterator($directory); + $iterator = new RecursiveIteratorIterator($filter, RecursiveIteratorIterator::SELF_FIRST); + + foreach ($iterator as $dir) { + $dir_modified = $dir->getMTime(); + if ($dir_modified > $last_modified) { + $last_modified = $dir_modified; + } + } + } + + return $last_modified; + } + + /** + * Recursively find the last modified time under given path by file. + * + * @param array $paths + * @param string $extensions which files to search for specifically + * @return int + */ + public static function lastModifiedFile(array $paths, $extensions = 'md|yaml'): int + { + $last_modified = 0; + + /** @var UniformResourceLocator $locator */ + $locator = Grav::instance()['locator']; + $flags = RecursiveDirectoryIterator::SKIP_DOTS; + + foreach($paths as $path) { + if (!file_exists($path)) { + return 0; + } + if ($locator->isStream($path)) { + $directory = $locator->getRecursiveIterator($path, $flags); + } else { + $directory = new RecursiveDirectoryIterator($path, $flags); + } + $recursive = new RecursiveIteratorIterator($directory, RecursiveIteratorIterator::SELF_FIRST); + $iterator = new RegexIterator($recursive, '/^.+\.'.$extensions.'$/i'); + + /** @var RecursiveDirectoryIterator $file */ + foreach ($iterator as $file) { + try { + $file_modified = $file->getMTime(); + if ($file_modified > $last_modified) { + $last_modified = $file_modified; + } + } catch (Exception $e) { + Grav::instance()['log']->error('Could not process file: ' . $e->getMessage()); + } + } + } + + return $last_modified; + } + + /** + * Recursively md5 hash all files in a path + * + * @param array $paths + * @return string + */ + public static function hashAllFiles(array $paths): string + { + $files = []; + + foreach ($paths as $path) { + if (file_exists($path)) { + $flags = RecursiveDirectoryIterator::SKIP_DOTS; + + /** @var UniformResourceLocator $locator */ + $locator = Grav::instance()['locator']; + if ($locator->isStream($path)) { + $directory = $locator->getRecursiveIterator($path, $flags); + } else { + $directory = new RecursiveDirectoryIterator($path, $flags); + } + + $iterator = new RecursiveIteratorIterator($directory, RecursiveIteratorIterator::SELF_FIRST); + + foreach ($iterator as $file) { + $files[] = $file->getPathname() . '?'. $file->getMTime(); + } + } + } + + return md5(serialize($files)); + } + + /** + * Get relative path between target and base path. If path isn't relative, return full path. + * + * @param string $path + * @param string $base + * @return string + */ + public static function getRelativePath($path, $base = GRAV_ROOT) + { + if ($base) { + $base = preg_replace('![\\\/]+!', '/', $base); + $path = preg_replace('![\\\/]+!', '/', $path); + if (strpos($path, $base) === 0) { + $path = ltrim(substr($path, strlen($base)), '/'); + } + } + + return $path; + } + + /** + * Get relative path between target and base path. If path isn't relative, return full path. + * + * @param string $path + * @param string $base + * @return string + */ + public static function getRelativePathDotDot($path, $base) + { + // Normalize paths. + $base = preg_replace('![\\\/]+!', '/', $base); + $path = preg_replace('![\\\/]+!', '/', $path); + + if ($path === $base) { + return ''; + } + + $baseParts = explode('/', ltrim($base, '/')); + $pathParts = explode('/', ltrim($path, '/')); + + array_pop($baseParts); + $lastPart = array_pop($pathParts); + foreach ($baseParts as $i => $directory) { + if (isset($pathParts[$i]) && $pathParts[$i] === $directory) { + unset($baseParts[$i], $pathParts[$i]); + } else { + break; + } + } + $pathParts[] = $lastPart; + $path = str_repeat('../', count($baseParts)) . implode('/', $pathParts); + + return '' === $path + || strpos($path, '/') === 0 + || false !== ($colonPos = strpos($path, ':')) && ($colonPos < ($slashPos = strpos($path, '/')) || false === $slashPos) + ? "./$path" : $path; + } + + /** + * Shift first directory out of the path. + * + * @param string $path + * @return string|null + */ + public static function shift(&$path) + { + $parts = explode('/', trim($path, '/'), 2); + $result = array_shift($parts); + $path = array_shift($parts); + + return $result ?: null; + } + + /** + * Return recursive list of all files and directories under given path. + * + * @param string $path + * @param array $params + * @return array + * @throws RuntimeException + */ + public static function all($path, array $params = []) + { + if (!$path) { + throw new RuntimeException("Path doesn't exist."); + } + if (!file_exists($path)) { + return []; + } + + $compare = isset($params['compare']) ? 'get' . $params['compare'] : null; + $pattern = $params['pattern'] ?? null; + $filters = $params['filters'] ?? null; + $recursive = $params['recursive'] ?? true; + $levels = $params['levels'] ?? -1; + $key = isset($params['key']) ? 'get' . $params['key'] : null; + $value = 'get' . ($params['value'] ?? ($recursive ? 'SubPathname' : 'Filename')); + $folders = $params['folders'] ?? true; + $files = $params['files'] ?? true; + + /** @var UniformResourceLocator $locator */ + $locator = Grav::instance()['locator']; + if ($recursive) { + $flags = RecursiveDirectoryIterator::SKIP_DOTS + FilesystemIterator::UNIX_PATHS + + FilesystemIterator::CURRENT_AS_SELF + FilesystemIterator::FOLLOW_SYMLINKS; + if ($locator->isStream($path)) { + $directory = $locator->getRecursiveIterator($path, $flags); + } else { + $directory = new RecursiveDirectoryIterator($path, $flags); + } + $iterator = new RecursiveIteratorIterator($directory, RecursiveIteratorIterator::SELF_FIRST); + $iterator->setMaxDepth(max($levels, -1)); + } else { + if ($locator->isStream($path)) { + $iterator = $locator->getIterator($path); + } else { + $iterator = new FilesystemIterator($path); + } + } + + $results = []; + + /** @var RecursiveDirectoryIterator $file */ + foreach ($iterator as $file) { + // Ignore hidden files. + if (strpos($file->getFilename(), '.') === 0 && $file->isFile()) { + continue; + } + if (!$folders && $file->isDir()) { + continue; + } + if (!$files && $file->isFile()) { + continue; + } + if ($compare && $pattern && !preg_match($pattern, $file->{$compare}())) { + continue; + } + $fileKey = $key ? $file->{$key}() : null; + $filePath = $file->{$value}(); + if ($filters) { + if (isset($filters['key'])) { + $pre = !empty($filters['pre-key']) ? $filters['pre-key'] : ''; + $fileKey = $pre . preg_replace($filters['key'], '', $fileKey); + } + if (isset($filters['value'])) { + $filter = $filters['value']; + if (is_callable($filter)) { + $filePath = $filter($file); + } else { + $filePath = preg_replace($filter, '', $filePath); + } + } + } + + if ($fileKey !== null) { + $results[$fileKey] = $filePath; + } else { + $results[] = $filePath; + } + } + + return $results; + } + + /** + * Recursively copy directory in filesystem. + * + * @param string $source + * @param string $target + * @param string|null $ignore Ignore files matching pattern (regular expression). + * @return void + * @throws RuntimeException + */ + public static function copy($source, $target, $ignore = null) + { + $source = rtrim($source, '\\/'); + $target = rtrim($target, '\\/'); + + if (!is_dir($source)) { + throw new RuntimeException('Cannot copy non-existing folder.'); + } + + // Make sure that path to the target exists before copying. + self::create($target); + + $success = true; + + // Go through all sub-directories and copy everything. + $files = self::all($source); + foreach ($files as $file) { + if ($ignore && preg_match($ignore, $file)) { + continue; + } + $src = $source .'/'. $file; + $dst = $target .'/'. $file; + + if (is_dir($src)) { + // Create current directory (if it doesn't exist). + if (!is_dir($dst)) { + $success &= @mkdir($dst, 0777, true); + } + } else { + // Or copy current file. + $success &= @copy($src, $dst); + } + } + + if (!$success) { + $error = error_get_last(); + throw new RuntimeException($error['message'] ?? 'Unknown error'); + } + + // Make sure that the change will be detected when caching. + @touch(dirname($target)); + } + + /** + * Move directory in filesystem. + * + * @param string $source + * @param string $target + * @return void + * @throws RuntimeException + */ + public static function move($source, $target) + { + if (!file_exists($source) || !is_dir($source)) { + // Rename fails if source folder does not exist. + throw new RuntimeException('Cannot move non-existing folder.'); + } + + // Don't do anything if the source is the same as the new target + if ($source === $target) { + return; + } + + if (strpos($target, $source . '/') === 0) { + throw new RuntimeException('Cannot move folder to itself'); + } + + if (file_exists($target)) { + // Rename fails if target folder exists. + throw new RuntimeException('Cannot move files to existing folder/file.'); + } + + // Make sure that path to the target exists before moving. + self::create(dirname($target)); + + // Silence warnings (chmod failed etc). + @rename($source, $target); + + // Rename function can fail while still succeeding, so let's check if the folder exists. + if (is_dir($source)) { + // Rename doesn't support moving folders across filesystems. Use copy instead. + self::copy($source, $target); + self::delete($source); + } + + // Make sure that the change will be detected when caching. + @touch(dirname($source)); + @touch(dirname($target)); + @touch($target); + } + + /** + * Recursively delete directory from filesystem. + * + * @param string $target + * @param bool $include_target + * @return bool + * @throws RuntimeException + */ + public static function delete($target, $include_target = true) + { + if (!is_dir($target)) { + return false; + } + + $success = self::doDelete($target, $include_target); + + if (!$success) { + $error = error_get_last(); + + throw new RuntimeException($error['message'] ?? 'Unknown error'); + } + + // Make sure that the change will be detected when caching. + if ($include_target) { + @touch(dirname($target)); + } else { + @touch($target); + } + + return $success; + } + + /** + * @param string $folder + * @return void + * @throws RuntimeException + */ + public static function mkdir($folder) + { + self::create($folder); + } + + /** + * @param string $folder + * @return void + * @throws RuntimeException + */ + public static function create($folder) + { + // Silence error for open_basedir; should fail in mkdir instead. + if (@is_dir($folder)) { + return; + } + + $success = @mkdir($folder, 0777, true); + + if (!$success) { + // Take yet another look, make sure that the folder doesn't exist. + clearstatcache(true, $folder); + if (!@is_dir($folder)) { + throw new RuntimeException(sprintf('Unable to create directory: %s', $folder)); + } + } + } + + /** + * Recursive copy of one directory to another + * + * @param string $src + * @param string $dest + * @return bool + * @throws RuntimeException + */ + public static function rcopy($src, $dest) + { + + // If the src is not a directory do a simple file copy + if (!is_dir($src)) { + copy($src, $dest); + return true; + } + + // If the destination directory does not exist create it + if (!is_dir($dest)) { + static::create($dest); + } + + // Open the source directory to read in files + $i = new DirectoryIterator($src); + foreach ($i as $f) { + if ($f->isFile()) { + copy($f->getRealPath(), "{$dest}/" . $f->getFilename()); + } else { + if (!$f->isDot() && $f->isDir()) { + static::rcopy($f->getRealPath(), "{$dest}/{$f}"); + } + } + } + return true; + } + + /** + * Does a directory contain children + * + * @param string $directory + * @return int|false + */ + public static function countChildren($directory) + { + if (!is_dir($directory)) { + return false; + } + $directories = glob($directory . '/*', GLOB_ONLYDIR); + + return $directories ? count($directories) : false; + } + + /** + * @param string $folder + * @param bool $include_target + * @return bool + * @internal + */ + protected static function doDelete($folder, $include_target = true) + { + // Special case for symbolic links. + if ($include_target && is_link($folder)) { + return @unlink($folder); + } + + // Go through all items in filesystem and recursively remove everything. + $files = scandir($folder, SCANDIR_SORT_NONE); + $files = $files ? array_diff($files, ['.', '..']) : []; + foreach ($files as $file) { + $path = "{$folder}/{$file}"; + is_dir($path) ? self::doDelete($path) : @unlink($path); + } + + return $include_target ? @rmdir($folder) : true; + } +} diff --git a/system/src/Grav/Common/Filesystem/RecursiveDirectoryFilterIterator.php b/system/src/Grav/Common/Filesystem/RecursiveDirectoryFilterIterator.php new file mode 100644 index 0000000..e41a32f --- /dev/null +++ b/system/src/Grav/Common/Filesystem/RecursiveDirectoryFilterIterator.php @@ -0,0 +1,82 @@ +current(); + $filename = $file->getFilename(); + $relative_filename = str_replace($this::$root . '/', '', $file->getPathname()); + + if ($file->isDir()) { + if (in_array($relative_filename, $this::$ignore_folders, true)) { + return false; + } + if (!in_array($filename, $this::$ignore_files, true)) { + return true; + } + } elseif ($file->isFile() && !in_array($filename, $this::$ignore_files, true)) { + return true; + } + return false; + } + + /** + * @return RecursiveDirectoryFilterIterator|RecursiveFilterIterator + */ + public function getChildren() + { + /** @var RecursiveDirectoryFilterIterator $iterator */ + $iterator = $this->getInnerIterator(); + + return new self($iterator->getChildren(), $this::$root, $this::$ignore_folders, $this::$ignore_files); + } +} diff --git a/system/src/Grav/Common/Filesystem/RecursiveFolderFilterIterator.php b/system/src/Grav/Common/Filesystem/RecursiveFolderFilterIterator.php new file mode 100644 index 0000000..66d9172 --- /dev/null +++ b/system/src/Grav/Common/Filesystem/RecursiveFolderFilterIterator.php @@ -0,0 +1,55 @@ +get('system.pages.ignore_folders'); + } + + $this::$ignore_folders = $ignore_folders; + } + + /** + * Check whether the current element of the iterator is acceptable + * + * @return bool true if the current element is acceptable, otherwise false. + */ + public function accept() + { + /** @var SplFileInfo $current */ + $current = $this->current(); + + return $current->isDir() && !in_array($current->getFilename(), $this::$ignore_folders, true); + } +} diff --git a/system/src/Grav/Common/Filesystem/ZipArchiver.php b/system/src/Grav/Common/Filesystem/ZipArchiver.php new file mode 100644 index 0000000..8e61a5d --- /dev/null +++ b/system/src/Grav/Common/Filesystem/ZipArchiver.php @@ -0,0 +1,135 @@ +open($this->archive_file); + + if ($archive === true) { + Folder::create($destination); + + if (!$zip->extractTo($destination)) { + throw new RuntimeException('ZipArchiver: ZIP failed to extract ' . $this->archive_file . ' to ' . $destination); + } + + $zip->close(); + + return $this; + } + + throw new RuntimeException('ZipArchiver: Failed to open ' . $this->archive_file); + } + + /** + * @param string $source + * @param callable|null $status + * @return $this + */ + public function compress($source, callable $status = null) + { + if (!extension_loaded('zip')) { + throw new InvalidArgumentException('ZipArchiver: Zip PHP module not installed...'); + } + + // Get real path for our folder + $rootPath = realpath($source); + if (!$rootPath) { + throw new InvalidArgumentException('ZipArchiver: ' . $source . ' cannot be found...'); + } + + $zip = new ZipArchive(); + if (!$zip->open($this->archive_file, ZipArchive::CREATE)) { + throw new InvalidArgumentException('ZipArchiver:' . $this->archive_file . ' cannot be created...'); + } + + $files = $this->getArchiveFiles($rootPath); + + $status && $status([ + 'type' => 'count', + 'steps' => iterator_count($files), + ]); + + foreach ($files as $file) { + $filePath = $file->getPathname(); + $relativePath = ltrim(substr($filePath, strlen($rootPath)), '/'); + + if ($file->isDir()) { + $zip->addEmptyDir($relativePath); + } else { + $zip->addFile($filePath, $relativePath); + } + + $status && $status([ + 'type' => 'progress', + ]); + } + + $status && $status([ + 'type' => 'message', + 'message' => 'Compressing...' + ]); + + $zip->close(); + + return $this; + } + + /** + * @param array $folders + * @param callable|null $status + * @return $this + */ + public function addEmptyFolders($folders, callable $status = null) + { + if (!extension_loaded('zip')) { + throw new InvalidArgumentException('ZipArchiver: Zip PHP module not installed...'); + } + + $zip = new ZipArchive(); + if (!$zip->open($this->archive_file)) { + throw new InvalidArgumentException('ZipArchiver: ' . $this->archive_file . ' cannot be opened...'); + } + + $status && $status([ + 'type' => 'message', + 'message' => 'Adding empty folders...' + ]); + + foreach ($folders as $folder) { + $zip->addEmptyDir($folder); + $status && $status([ + 'type' => 'progress', + ]); + } + + $zip->close(); + + return $this; + } +} diff --git a/system/src/Grav/Common/Flex/FlexCollection.php b/system/src/Grav/Common/Flex/FlexCollection.php new file mode 100644 index 0000000..9e43e27 --- /dev/null +++ b/system/src/Grav/Common/Flex/FlexCollection.php @@ -0,0 +1,28 @@ + + */ +abstract class FlexCollection extends \Grav\Framework\Flex\FlexCollection +{ + use FlexGravTrait; + use FlexCollectionTrait; +} diff --git a/system/src/Grav/Common/Flex/FlexIndex.php b/system/src/Grav/Common/Flex/FlexIndex.php new file mode 100644 index 0000000..2fe02f0 --- /dev/null +++ b/system/src/Grav/Common/Flex/FlexIndex.php @@ -0,0 +1,29 @@ + + */ +abstract class FlexIndex extends \Grav\Framework\Flex\FlexIndex +{ + use FlexGravTrait; + use FlexIndexTrait; +} diff --git a/system/src/Grav/Common/Flex/FlexObject.php b/system/src/Grav/Common/Flex/FlexObject.php new file mode 100644 index 0000000..870bc05 --- /dev/null +++ b/system/src/Grav/Common/Flex/FlexObject.php @@ -0,0 +1,74 @@ +getNestedProperty($name, null, $separator); + + // Handle media order field. + if (null === $value && $name === 'media_order') { + return implode(',', $this->getMediaOrder()); + } + + // Handle media fields. + $settings = $this->getFieldSettings($name); + if (($settings['media_field'] ?? false) === true) { + return $this->parseFileProperty($value, $settings); + } + + return $value ?? $default; + } + + /** + * {@inheritdoc} + * @see FlexObjectInterface::prepareStorage() + */ + public function prepareStorage(): array + { + // Remove extra content from media fields. + $fields = $this->getMediaFields(); + foreach ($fields as $field) { + $data = $this->getNestedProperty($field); + if (is_array($data)) { + foreach ($data as $name => &$image) { + unset($image['image_url'], $image['thumb_url']); + } + unset($image); + $this->setNestedProperty($field, $data); + } + } + + return parent::prepareStorage(); + } +} diff --git a/system/src/Grav/Common/Flex/Traits/FlexCollectionTrait.php b/system/src/Grav/Common/Flex/Traits/FlexCollectionTrait.php new file mode 100644 index 0000000..ba1b8a1 --- /dev/null +++ b/system/src/Grav/Common/Flex/Traits/FlexCollectionTrait.php @@ -0,0 +1,51 @@ + 'flex', + 'directory' => $this->getFlexDirectory(), + 'collection' => $this + ]); + } + if (strpos($name, 'onFlexCollection') !== 0 && strpos($name, 'on') === 0) { + $name = 'onFlexCollection' . substr($name, 2); + } + + $container = $this->getContainer(); + if ($event instanceof Event) { + $container->fireEvent($name, $event); + } else { + $container->dispatchEvent($event); + } + + return $this; + } +} diff --git a/system/src/Grav/Common/Flex/Traits/FlexCommonTrait.php b/system/src/Grav/Common/Flex/Traits/FlexCommonTrait.php new file mode 100644 index 0000000..4647dfc --- /dev/null +++ b/system/src/Grav/Common/Flex/Traits/FlexCommonTrait.php @@ -0,0 +1,54 @@ +getContainer(); + + /** @var Twig $twig */ + $twig = $container['twig']; + + try { + return $twig->twig()->resolveTemplate($this->getTemplatePaths($layout)); + } catch (LoaderError $e) { + /** @var Debugger $debugger */ + $debugger = Grav::instance()['debugger']; + $debugger->addException($e); + + return $twig->twig()->resolveTemplate(['flex/404.html.twig']); + } + } + + abstract protected function getTemplatePaths(string $layout): array; + abstract protected function getContainer(): Grav; +} diff --git a/system/src/Grav/Common/Flex/Traits/FlexGravTrait.php b/system/src/Grav/Common/Flex/Traits/FlexGravTrait.php new file mode 100644 index 0000000..1272d5d --- /dev/null +++ b/system/src/Grav/Common/Flex/Traits/FlexGravTrait.php @@ -0,0 +1,74 @@ +getContainer(); + + /** @var Flex $flex */ + $flex = $container['flex']; + + return $flex; + } + + /** + * @return UserInterface|null + */ + protected function getActiveUser(): ?UserInterface + { + $container = $this->getContainer(); + + /** @var UserInterface|null $user */ + $user = $container['user'] ?? null; + + return $user; + } + + /** + * @return bool + */ + protected function isAdminSite(): bool + { + $container = $this->getContainer(); + + return isset($container['admin']); + } + + /** + * @return string + */ + protected function getAuthorizeScope(): string + { + return $this->isAdminSite() ? 'admin' : 'site'; + } +} diff --git a/system/src/Grav/Common/Flex/Traits/FlexIndexTrait.php b/system/src/Grav/Common/Flex/Traits/FlexIndexTrait.php new file mode 100644 index 0000000..418b769 --- /dev/null +++ b/system/src/Grav/Common/Flex/Traits/FlexIndexTrait.php @@ -0,0 +1,20 @@ + 'onFlexObjectRender', + 'onBeforeSave' => 'onFlexObjectBeforeSave', + 'onAfterSave' => 'onFlexObjectAfterSave', + 'onBeforeDelete' => 'onFlexObjectBeforeDelete', + 'onAfterDelete' => 'onFlexObjectAfterDelete' + ]; + + if (null === $event) { + $event = new Event([ + 'type' => 'flex', + 'directory' => $this->getFlexDirectory(), + 'object' => $this + ]); + } + + if (isset($events['name'])) { + $name = $events['name']; + } elseif (strpos($name, 'onFlexObject') !== 0 && strpos($name, 'on') === 0) { + $name = 'onFlexObject' . substr($name, 2); + } + + $container = $this->getContainer(); + if ($event instanceof Event) { + $container->fireEvent($name, $event); + } else { + $container->dispatchEvent($event); + } + + return $this; + } +} diff --git a/system/src/Grav/Common/Flex/Types/Generic/GenericCollection.php b/system/src/Grav/Common/Flex/Types/Generic/GenericCollection.php new file mode 100644 index 0000000..6cb2874 --- /dev/null +++ b/system/src/Grav/Common/Flex/Types/Generic/GenericCollection.php @@ -0,0 +1,24 @@ + + */ +class GenericCollection extends FlexCollection +{ +} diff --git a/system/src/Grav/Common/Flex/Types/Generic/GenericIndex.php b/system/src/Grav/Common/Flex/Types/Generic/GenericIndex.php new file mode 100644 index 0000000..a3b2f71 --- /dev/null +++ b/system/src/Grav/Common/Flex/Types/Generic/GenericIndex.php @@ -0,0 +1,24 @@ + + */ +class GenericIndex extends FlexIndex +{ +} diff --git a/system/src/Grav/Common/Flex/Types/Generic/GenericObject.php b/system/src/Grav/Common/Flex/Types/Generic/GenericObject.php new file mode 100644 index 0000000..ae03d68 --- /dev/null +++ b/system/src/Grav/Common/Flex/Types/Generic/GenericObject.php @@ -0,0 +1,22 @@ + + * @implements PageCollectionInterface + * + * Incompatibilities with Grav\Common\Page\Collection: + * $page = $collection->key() will not work at all + * $clone = clone $collection does not clone objects inside the collection, does it matter? + * $string = (string)$collection returns collection id instead of comma separated list + * $collection->add() incompatible method signature + * $collection->remove() incompatible method signature + * $collection->filter() incompatible method signature (takes closure instead of callable) + * $collection->prev() does not rewind the internal pointer + * AND most methods are immutable; they do not update the current collection, but return updated one + * + * @method PageIndex getIndex() + */ +class PageCollection extends FlexPageCollection implements PageCollectionInterface +{ + use FlexGravTrait; + use FlexCollectionTrait; + + /** @var array|null */ + protected $_params; + + /** + * @return array + */ + public static function getCachedMethods(): array + { + return [ + // Collection specific methods + 'getRoot' => false, + 'getParams' => false, + 'setParams' => false, + 'params' => false, + 'addPage' => false, + 'merge' => false, + 'intersect' => false, + 'prev' => false, + 'nth' => false, + 'random' => false, + 'append' => false, + 'batch' => false, + 'order' => false, + + // Collection filtering + 'dateRange' => true, + 'visible' => true, + 'nonVisible' => true, + 'pages' => true, + 'modules' => true, + 'modular' => true, + 'nonModular' => true, + 'published' => true, + 'nonPublished' => true, + 'routable' => true, + 'nonRoutable' => true, + 'ofType' => true, + 'ofOneOfTheseTypes' => true, + 'ofOneOfTheseAccessLevels' => true, + 'withOrdered' => true, + 'withModules' => true, + 'withPages' => true, + 'withTranslation' => true, + 'filterBy' => true, + + 'toExtendedArray' => false, + 'getLevelListing' => false, + ] + parent::getCachedMethods(); + } + + /** + * @return PageInterface + */ + public function getRoot() + { + return $this->getIndex()->getRoot(); + } + + /** + * Get the collection params + * + * @return array + */ + public function getParams(): array + { + return $this->_params ?? []; + } + + /** + * Set parameters to the Collection + * + * @param array $params + * @return $this + */ + public function setParams(array $params) + { + $this->_params = $this->_params ? array_merge($this->_params, $params) : $params; + + return $this; + } + + /** + * Get the collection params + * + * @return array + */ + public function params(): array + { + return $this->getParams(); + } + + /** + * Add a single page to a collection + * + * @param PageInterface $page + * @return $this + */ + public function addPage(PageInterface $page) + { + if (!$page instanceof PageObject) { + throw new InvalidArgumentException('$page is not a flex page.'); + } + + // FIXME: support other keys. + $this->set($page->getKey(), $page); + + return $this; + } + + /** + * + * Merge another collection with the current collection + * + * @param PageCollectionInterface $collection + * @return static + * @phpstan-return static + */ + public function merge(PageCollectionInterface $collection) + { + throw new RuntimeException(__METHOD__ . '(): Not Implemented'); + } + + /** + * Intersect another collection with the current collection + * + * @param PageCollectionInterface $collection + * @return static + * @phpstan-return static + */ + public function intersect(PageCollectionInterface $collection) + { + throw new RuntimeException(__METHOD__ . '(): Not Implemented'); + } + + /** + * Set current page. + */ + public function setCurrent(string $path): void + { + throw new RuntimeException(__METHOD__ . '(): Not Implemented'); + } + + /** + * Return previous item. + * + * @return PageInterface|false + * @phpstan-return T|false + */ + public function prev() + { + // FIXME: this method does not rewind the internal pointer! + $key = (string)$this->key(); + $prev = $this->prevSibling($key); + + return $prev !== $this->current() ? $prev : false; + } + + /** + * Return nth item. + * @param int $key + * @return PageInterface|bool + * @phpstan-return T|false + */ + public function nth($key) + { + return $this->slice($key, 1)[0] ?? false; + } + + /** + * Pick one or more random entries. + * + * @param int $num Specifies how many entries should be picked. + * @return static + * @phpstan-return static + */ + public function random($num = 1) + { + return $this->createFrom($this->shuffle()->slice(0, $num)); + } + + /** + * Append new elements to the list. + * + * @param array $items Items to be appended. Existing keys will be overridden with the new values. + * @return static + * @phpstan-return static + */ + public function append($items) + { + throw new RuntimeException(__METHOD__ . '(): Not Implemented'); + } + + /** + * Split collection into array of smaller collections. + * + * @param int $size + * @return static[] + * @phpstan-return static[] + */ + public function batch($size): array + { + $chunks = $this->chunk($size); + + $list = []; + foreach ($chunks as $chunk) { + $list[] = $this->createFrom($chunk); + } + + return $list; + } + + /** + * Reorder collection. + * + * @param string $by + * @param string $dir + * @param array|null $manual + * @param int|null $sort_flags + * @return static + * @phpstan-return static + */ + public function order($by, $dir = 'asc', $manual = null, $sort_flags = null) + { + if (!$this->count()) { + return $this; + } + + if ($by === 'random') { + return $this->shuffle(); + } + + $keys = $this->buildSort($by, $dir, $manual, $sort_flags); + + return $this->createFrom(array_replace(array_flip($keys), $this->toArray()) ?? []); + } + + /** + * @param string $order_by + * @param string $order_dir + * @param array|null $manual + * @param int|null $sort_flags + * @return array + */ + protected function buildSort($order_by = 'default', $order_dir = 'asc', $manual = null, $sort_flags = null): array + { + // do this header query work only once + $header_query = null; + $header_default = null; + if (strpos($order_by, 'header.') === 0) { + $query = explode('|', str_replace('header.', '', $order_by), 2); + $header_query = array_shift($query) ?? ''; + $header_default = array_shift($query); + } + + $list = []; + foreach ($this as $key => $child) { + switch ($order_by) { + case 'title': + $list[$key] = $child->title(); + break; + case 'date': + $list[$key] = $child->date(); + $sort_flags = SORT_REGULAR; + break; + case 'modified': + $list[$key] = $child->modified(); + $sort_flags = SORT_REGULAR; + break; + case 'publish_date': + $list[$key] = $child->publishDate(); + $sort_flags = SORT_REGULAR; + break; + case 'unpublish_date': + $list[$key] = $child->unpublishDate(); + $sort_flags = SORT_REGULAR; + break; + case 'slug': + $list[$key] = $child->slug(); + break; + case 'basename': + $list[$key] = Utils::basename($key); + break; + case 'folder': + $list[$key] = $child->folder(); + break; + case 'manual': + case 'default': + default: + if (is_string($header_query)) { + /** @var Header $child_header */ + $child_header = $child->header(); + $header_value = $child_header->get($header_query); + if (is_array($header_value)) { + $list[$key] = implode(',', $header_value); + } elseif ($header_value) { + $list[$key] = $header_value; + } else { + $list[$key] = $header_default ?: $key; + } + $sort_flags = $sort_flags ?: SORT_REGULAR; + break; + } + $list[$key] = $key; + $sort_flags = $sort_flags ?: SORT_REGULAR; + } + } + + if (null === $sort_flags) { + $sort_flags = SORT_NATURAL | SORT_FLAG_CASE; + } + + // else just sort the list according to specified key + if (extension_loaded('intl') && Grav::instance()['config']->get('system.intl_enabled')) { + $locale = setlocale(LC_COLLATE, '0'); //`setlocale` with a '0' param returns the current locale set + $col = Collator::create($locale); + if ($col) { + $col->setAttribute(Collator::NUMERIC_COLLATION, Collator::ON); + if (($sort_flags & SORT_NATURAL) === SORT_NATURAL) { + $list = preg_replace_callback('~([0-9]+)\.~', static function ($number) { + return sprintf('%032d.', $number[0]); + }, $list); + if (!is_array($list)) { + throw new RuntimeException('Internal Error'); + } + + $list_vals = array_values($list); + if (is_numeric(array_shift($list_vals))) { + $sort_flags = Collator::SORT_REGULAR; + } else { + $sort_flags = Collator::SORT_STRING; + } + } + + $col->asort($list, $sort_flags); + } else { + asort($list, $sort_flags); + } + } else { + asort($list, $sort_flags); + } + + // Move manually ordered items into the beginning of the list. Order of the unlisted items does not change. + if (is_array($manual) && !empty($manual)) { + $i = count($manual); + $new_list = []; + foreach ($list as $key => $dummy) { + $child = $this[$key] ?? null; + $order = $child ? array_search($child->slug, $manual, true) : false; + if ($order === false) { + $order = $i++; + } + $new_list[$key] = (int)$order; + } + + $list = $new_list; + + // Apply manual ordering to the list. + asort($list, SORT_NUMERIC); + } + + if ($order_dir !== 'asc') { + $list = array_reverse($list); + } + + return array_keys($list); + } + + /** + * Mimicks Pages class. + * + * @return $this + * @deprecated 1.7 Not needed anymore in Flex Pages (does nothing). + */ + public function all() + { + return $this; + } + + /** + * Returns the items between a set of date ranges of either the page date field (default) or + * an arbitrary datetime page field where start date and end date are optional + * Dates must be passed in as text that strtotime() can process + * http://php.net/manual/en/function.strtotime.php + * + * @param string|null $startDate + * @param string|null $endDate + * @param string|null $field + * @return static + * @phpstan-return static + * @throws Exception + */ + public function dateRange($startDate = null, $endDate = null, $field = null) + { + $start = $startDate ? Utils::date2timestamp($startDate) : null; + $end = $endDate ? Utils::date2timestamp($endDate) : null; + + $entries = []; + foreach ($this as $key => $object) { + if (!$object) { + continue; + } + + $date = $field ? strtotime($object->getNestedProperty($field)) : $object->date(); + + if ((!$start || $date >= $start) && (!$end || $date <= $end)) { + $entries[$key] = $object; + } + } + + return $this->createFrom($entries); + } + + /** + * Creates new collection with only visible pages + * + * @return static The collection with only visible pages + * @phpstan-return static + */ + public function visible() + { + $entries = []; + foreach ($this as $key => $object) { + if ($object && $object->visible()) { + $entries[$key] = $object; + } + } + + return $this->createFrom($entries); + } + + /** + * Creates new collection with only non-visible pages + * + * @return static The collection with only non-visible pages + * @phpstan-return static + */ + public function nonVisible() + { + $entries = []; + foreach ($this as $key => $object) { + if ($object && !$object->visible()) { + $entries[$key] = $object; + } + } + + return $this->createFrom($entries); + } + + /** + * Creates new collection with only pages + * + * @return static The collection with only pages + * @phpstan-return static + */ + public function pages() + { + $entries = []; + /** + * @var int|string $key + * @var PageInterface|null $object + */ + foreach ($this as $key => $object) { + if ($object && !$object->isModule()) { + $entries[$key] = $object; + } + } + + return $this->createFrom($entries); + } + + /** + * Creates new collection with only modules + * + * @return static The collection with only modules + * @phpstan-return static + */ + public function modules() + { + $entries = []; + /** + * @var int|string $key + * @var PageInterface|null $object + */ + foreach ($this as $key => $object) { + if ($object && $object->isModule()) { + $entries[$key] = $object; + } + } + + return $this->createFrom($entries); + } + + /** + * Alias of modules() + * + * @return static + * @phpstan-return static + */ + public function modular() + { + return $this->modules(); + } + + /** + * Alias of pages() + * + * @return static + * @phpstan-return static + */ + public function nonModular() + { + return $this->pages(); + } + + /** + * Creates new collection with only published pages + * + * @return static The collection with only published pages + * @phpstan-return static + */ + public function published() + { + $entries = []; + foreach ($this as $key => $object) { + if ($object && $object->published()) { + $entries[$key] = $object; + } + } + + return $this->createFrom($entries); + } + + /** + * Creates new collection with only non-published pages + * + * @return static The collection with only non-published pages + * @phpstan-return static + */ + public function nonPublished() + { + $entries = []; + foreach ($this as $key => $object) { + if ($object && !$object->published()) { + $entries[$key] = $object; + } + } + + return $this->createFrom($entries); + } + + /** + * Creates new collection with only routable pages + * + * @return static The collection with only routable pages + * @phpstan-return static + */ + public function routable() + { + $entries = []; + foreach ($this as $key => $object) { + if ($object && $object->routable()) { + $entries[$key] = $object; + } + } + + return $this->createFrom($entries); + } + + /** + * Creates new collection with only non-routable pages + * + * @return static The collection with only non-routable pages + * @phpstan-return static + */ + public function nonRoutable() + { + $entries = []; + foreach ($this as $key => $object) { + if ($object && !$object->routable()) { + $entries[$key] = $object; + } + } + + return $this->createFrom($entries); + } + + /** + * Creates new collection with only pages of the specified type + * + * @param string $type + * @return static The collection + * @phpstan-return static + */ + public function ofType($type) + { + $entries = []; + foreach ($this as $key => $object) { + if ($object && $object->template() === $type) { + $entries[$key] = $object; + } + } + + return $this->createFrom($entries); + } + + /** + * Creates new collection with only pages of one of the specified types + * + * @param string[] $types + * @return static The collection + * @phpstan-return static + */ + public function ofOneOfTheseTypes($types) + { + $entries = []; + foreach ($this as $key => $object) { + if ($object && in_array($object->template(), $types, true)) { + $entries[$key] = $object; + } + } + + return $this->createFrom($entries); + } + + /** + * Creates new collection with only pages of one of the specified access levels + * + * @param array $accessLevels + * @return static The collection + * @phpstan-return static + */ + public function ofOneOfTheseAccessLevels($accessLevels) + { + $entries = []; + foreach ($this as $key => $object) { + if ($object && isset($object->header()->access)) { + if (is_array($object->header()->access)) { + //Multiple values for access + $valid = false; + + foreach ($object->header()->access as $index => $accessLevel) { + if (is_array($accessLevel)) { + foreach ($accessLevel as $innerIndex => $innerAccessLevel) { + if (in_array($innerAccessLevel, $accessLevels)) { + $valid = true; + } + } + } else { + if (in_array($index, $accessLevels)) { + $valid = true; + } + } + } + if ($valid) { + $entries[$key] = $object; + } + } else { + //Single value for access + if (in_array($object->header()->access, $accessLevels)) { + $entries[$key] = $object; + } + } + } + } + + return $this->createFrom($entries); + } + + /** + * @param bool $bool + * @return static + * @phpstan-return static + */ + public function withOrdered(bool $bool = true) + { + $list = array_keys(array_filter($this->call('isOrdered', [$bool]))); + + return $this->select($list); + } + + /** + * @param bool $bool + * @return static + * @phpstan-return static + */ + public function withModules(bool $bool = true) + { + $list = array_keys(array_filter($this->call('isModule', [$bool]))); + + return $this->select($list); + } + + /** + * @param bool $bool + * @return static + * @phpstan-return static + */ + public function withPages(bool $bool = true) + { + $list = array_keys(array_filter($this->call('isPage', [$bool]))); + + return $this->select($list); + } + + /** + * @param bool $bool + * @param string|null $languageCode + * @param bool|null $fallback + * @return static + * @phpstan-return static + */ + public function withTranslation(bool $bool = true, string $languageCode = null, bool $fallback = null) + { + $list = array_keys(array_filter($this->call('hasTranslation', [$languageCode, $fallback]))); + + return $bool ? $this->select($list) : $this->unselect($list); + } + + /** + * @param string|null $languageCode + * @param bool|null $fallback + * @return PageIndex + */ + public function withTranslated(string $languageCode = null, bool $fallback = null) + { + return $this->getIndex()->withTranslated($languageCode, $fallback); + } + + /** + * Filter pages by given filters. + * + * - search: string + * - page_type: string|string[] + * - modular: bool + * - visible: bool + * - routable: bool + * - published: bool + * - page: bool + * - translated: bool + * + * @param array $filters + * @param bool $recursive + * @return static + * @phpstan-return static + */ + public function filterBy(array $filters, bool $recursive = false) + { + $list = array_keys(array_filter($this->call('filterBy', [$filters, $recursive]))); + + return $this->select($list); + } + + /** + * Get the extended version of this Collection with each page keyed by route + * + * @return array + * @throws Exception + */ + public function toExtendedArray(): array + { + $entries = []; + foreach ($this as $key => $object) { + if ($object) { + $entries[$object->route()] = $object->toArray(); + } + } + + return $entries; + } + + /** + * @param array $options + * @return array + */ + public function getLevelListing(array $options): array + { + /** @var PageIndex $index */ + $index = $this->getIndex(); + + return method_exists($index, 'getLevelListing') ? $index->getLevelListing($options) : []; + } +} diff --git a/system/src/Grav/Common/Flex/Types/Pages/PageIndex.php b/system/src/Grav/Common/Flex/Types/Pages/PageIndex.php new file mode 100644 index 0000000..21e02ab --- /dev/null +++ b/system/src/Grav/Common/Flex/Types/Pages/PageIndex.php @@ -0,0 +1,1198 @@ + + * @implements PageCollectionInterface + * + * @method PageIndex withModules(bool $bool = true) + * @method PageIndex withPages(bool $bool = true) + * @method PageIndex withTranslation(bool $bool = true, string $languageCode = null, bool $fallback = null) + */ +class PageIndex extends FlexPageIndex implements PageCollectionInterface +{ + use FlexGravTrait; + use FlexIndexTrait; + + public const VERSION = parent::VERSION . '.5'; + public const ORDER_LIST_REGEX = '/(\/\d+)\.[^\/]+/u'; + public const PAGE_ROUTE_REGEX = '/\/\d+\./u'; + + /** @var PageObject|array */ + protected $_root; + /** @var array|null */ + protected $_params; + + /** + * @param array $entries + * @param FlexDirectory|null $directory + */ + public function __construct(array $entries = [], FlexDirectory $directory = null) + { + // Remove root if it's taken. + if (isset($entries[''])) { + $this->_root = $entries['']; + unset($entries['']); + } + + parent::__construct($entries, $directory); + } + + /** + * @param FlexStorageInterface $storage + * @return array + */ + public static function loadEntriesFromStorage(FlexStorageInterface $storage): array + { + // Load saved index. + $index = static::loadIndex($storage); + + $version = $index['version'] ?? 0; + $force = static::VERSION !== $version; + + // TODO: Following check flex index to be out of sync after some saves, disabled until better solution is found. + //$timestamp = $index['timestamp'] ?? 0; + //if (!$force && $timestamp && $timestamp > time() - 1) { + // return $index['index']; + //} + + // Load up to date index. + $entries = parent::loadEntriesFromStorage($storage); + + return static::updateIndexFile($storage, $index['index'], $entries, ['include_missing' => true, 'force_update' => $force]); + } + + /** + * @param string $key + * @return PageObject|null + * @phpstan-return T|null + */ + public function get($key) + { + if (mb_strpos($key, '|') !== false) { + [$key, $params] = explode('|', $key, 2); + } + + $element = parent::get($key); + if (null === $element) { + return null; + } + + if (isset($params)) { + $element = $element->getTranslation(ltrim($params, '.')); + } + + \assert(null === $element || $element instanceof PageObject); + + return $element; + } + + /** + * @return PageInterface + */ + public function getRoot() + { + $root = $this->_root; + if (is_array($root)) { + $directory = $this->getFlexDirectory(); + $storage = $directory->getStorage(); + + $defaults = [ + 'header' => [ + 'routable' => false, + 'permissions' => [ + 'inherit' => false + ] + ] + ]; + + $row = $storage->readRows(['' => null])[''] ?? null; + if (null !== $row) { + if (isset($row['__ERROR'])) { + /** @var Debugger $debugger */ + $debugger = Grav::instance()['debugger']; + $message = sprintf('Flex Pages: root page is broken in storage: %s', $row['__ERROR']); + + $debugger->addException(new RuntimeException($message)); + $debugger->addMessage($message, 'error'); + + $row = ['__META' => $root]; + } + + } else { + $row = ['__META' => $root]; + } + + $row = array_merge_recursive($defaults, $row); + + /** @var PageObject $root */ + $root = $this->getFlexDirectory()->createObject($row, '/', false); + $root->name('root.md'); + $root->root(true); + + $this->_root = $root; + } + + return $root; + } + + /** + * @param string|null $languageCode + * @param bool|null $fallback + * @return static + * @phpstan-return static + */ + public function withTranslated(string $languageCode = null, bool $fallback = null) + { + if (null === $languageCode) { + return $this; + } + + $entries = $this->translateEntries($this->getEntries(), $languageCode, $fallback); + $params = ['language' => $languageCode, 'language_fallback' => $fallback] + $this->getParams(); + + return $this->createFrom($entries)->setParams($params); + } + + /** + * @return string|null + */ + public function getLanguage(): ?string + { + return $this->_params['language'] ?? null; + } + + /** + * Get the collection params + * + * @return array + */ + public function getParams(): array + { + return $this->_params ?? []; + } + + /** + * Get the collection param + * + * @param string $name + * @return mixed + */ + public function getParam(string $name) + { + return $this->_params[$name] ?? null; + } + + /** + * Set parameters to the Collection + * + * @param array $params + * @return $this + */ + public function setParams(array $params) + { + $this->_params = $this->_params ? array_merge($this->_params, $params) : $params; + + return $this; + } + + /** + * Set a parameter to the Collection + * + * @param string $name + * @param mixed $value + * @return $this + */ + public function setParam(string $name, $value) + { + $this->_params[$name] = $value; + + return $this; + } + + /** + * Get the collection params + * + * @return array + */ + public function params(): array + { + return $this->getParams(); + } + + /** + * {@inheritdoc} + * @see FlexCollectionInterface::getCacheKey() + */ + public function getCacheKey(): string + { + return $this->getTypePrefix() . $this->getFlexType() . '.' . sha1(json_encode($this->getKeys()) . $this->getKeyField() . $this->getLanguage()); + } + + /** + * Filter pages by given filters. + * + * - search: string + * - page_type: string|string[] + * - modular: bool + * - visible: bool + * - routable: bool + * - published: bool + * - page: bool + * - translated: bool + * + * @param array $filters + * @param bool $recursive + * @return static + * @phpstan-return static + */ + public function filterBy(array $filters, bool $recursive = false) + { + if (!$filters) { + return $this; + } + + if ($recursive) { + return $this->__call('filterBy', [$filters, true]); + } + + $list = []; + $index = $this; + foreach ($filters as $key => $value) { + switch ($key) { + case 'search': + $index = $index->search((string)$value); + break; + case 'page_type': + if (!is_array($value)) { + $value = is_string($value) && $value !== '' ? explode(',', $value) : []; + } + $index = $index->ofOneOfTheseTypes($value); + break; + case 'routable': + $index = $index->withRoutable((bool)$value); + break; + case 'published': + $index = $index->withPublished((bool)$value); + break; + case 'visible': + $index = $index->withVisible((bool)$value); + break; + case 'module': + $index = $index->withModules((bool)$value); + break; + case 'page': + $index = $index->withPages((bool)$value); + break; + case 'folder': + $index = $index->withPages(!$value); + break; + case 'translated': + $index = $index->withTranslation((bool)$value); + break; + default: + $list[$key] = $value; + } + } + + return $list ? $index->filterByParent($list) : $index; + } + + /** + * @param array $filters + * @return static + * @phpstan-return static + */ + protected function filterByParent(array $filters) + { + /** @var static $index */ + $index = parent::filterBy($filters); + + return $index; + } + + /** + * @param array $options + * @return array + */ + public function getLevelListing(array $options): array + { + // Undocumented B/C + $order = $options['order'] ?? 'asc'; + if ($order === SORT_ASC) { + $options['order'] = 'asc'; + } elseif ($order === SORT_DESC) { + $options['order'] = 'desc'; + } + + $options += [ + 'field' => null, + 'route' => null, + 'leaf_route' => null, + 'sortby' => null, + 'order' => 'asc', + 'lang' => null, + 'filters' => [], + ]; + + $options['filters'] += [ + 'type' => ['root', 'dir'], + ]; + + $key = 'page.idx.lev.' . sha1(json_encode($options, JSON_THROW_ON_ERROR) . $this->getCacheKey()); + $checksum = $this->getCacheChecksum(); + + $cache = $this->getCache('object'); + + /** @var Debugger $debugger */ + $debugger = Grav::instance()['debugger']; + + $result = null; + try { + $cached = $cache->get($key); + $test = $cached[0] ?? null; + $result = $test === $checksum ? ($cached[1] ?? null) : null; + } catch (\Psr\SimpleCache\InvalidArgumentException $e) { + $debugger->addException($e); + } + + try { + if (null === $result) { + $result = $this->getLevelListingRecurse($options); + $cache->set($key, [$checksum, $result]); + } + } catch (\Psr\SimpleCache\InvalidArgumentException $e) { + $debugger->addException($e); + } + + return $result; + } + + /** + * @param array $entries + * @param string|null $keyField + * @return static + * @phpstan-return static + */ + protected function createFrom(array $entries, string $keyField = null) + { + /** @var static $index */ + $index = parent::createFrom($entries, $keyField); + $index->_root = $this->getRoot(); + + return $index; + } + + /** + * @param array $entries + * @param string $lang + * @param bool|null $fallback + * @return array + */ + protected function translateEntries(array $entries, string $lang, bool $fallback = null): array + { + $languages = $this->getFallbackLanguages($lang, $fallback); + foreach ($entries as $key => &$entry) { + // Find out which version of the page we should load. + $translations = $this->getLanguageTemplates((string)$key); + if (!$translations) { + // No translations found, is this a folder? + continue; + } + + // Find a translation. + $template = null; + foreach ($languages as $code) { + if (isset($translations[$code])) { + $template = $translations[$code]; + break; + } + } + + // We couldn't find a translation, remove entry from the list. + if (!isset($code, $template)) { + unset($entries['key']); + continue; + } + + // Get the main key without template and language. + [$main_key,] = explode('|', $entry['storage_key'] . '|', 2); + + // Update storage key and language. + $entry['storage_key'] = $main_key . '|' . $template . '.' . $code; + $entry['lang'] = $code; + } + unset($entry); + + return $entries; + } + + /** + * @return array + */ + protected function getLanguageTemplates(string $key): array + { + $meta = $this->getMetaData($key); + $template = $meta['template'] ?? 'folder'; + $translations = $meta['markdown'] ?? []; + $list = []; + foreach ($translations as $code => $search) { + if (isset($search[$template])) { + // Use main template if possible. + $list[$code] = $template; + } elseif (!empty($search)) { + // Fall back to first matching template. + $list[$code] = key($search); + } + } + + return $list; + } + + /** + * @param string|null $languageCode + * @param bool|null $fallback + * @return array + */ + protected function getFallbackLanguages(string $languageCode = null, bool $fallback = null): array + { + $fallback = $fallback ?? true; + if (!$fallback && null !== $languageCode) { + return [$languageCode]; + } + + $grav = Grav::instance(); + + /** @var Language $language */ + $language = $grav['language']; + $languageCode = $languageCode ?? ''; + if ($languageCode === '' && $fallback) { + return $language->getFallbackLanguages(null, true); + } + + return $fallback ? $language->getFallbackLanguages($languageCode, true) : [$languageCode]; + } + + /** + * @param array $options + * @return array + */ + protected function getLevelListingRecurse(array $options): array + { + $filters = $options['filters'] ?? []; + $field = $options['field']; + $route = $options['route']; + $leaf_route = $options['leaf_route']; + $sortby = $options['sortby']; + $order = $options['order']; + $language = $options['lang']; + + $status = 'error'; + $response = []; + $extra = null; + + // Handle leaf_route + $leaf = null; + if ($leaf_route && $route !== $leaf_route) { + $nodes = explode('/', $leaf_route); + $sub_route = '/' . implode('/', array_slice($nodes, 1, $options['level']++)); + $options['route'] = $sub_route; + + [$status,,$leaf,$extra] = $this->getLevelListingRecurse($options); + } + + // Handle no route, assume page tree root + if (!$route) { + $page = $this->getRoot(); + } else { + $page = $this->get(trim($route, '/')); + } + $path = $page ? $page->path() : null; + + if ($field) { + // Get forced filters from the field. + $blueprint = $page ? $page->getBlueprint() : $this->getFlexDirectory()->getBlueprint(); + $settings = $blueprint->schema()->getProperty($field); + $filters = array_merge([], $filters, $settings['filters'] ?? []); + } + + // Clean up filter. + $filter_type = (array)($filters['type'] ?? []); + unset($filters['type']); + $filters = array_filter($filters, static function($val) { return $val !== null && $val !== ''; }); + + if ($page) { + $status = 'success'; + $msg = 'PLUGIN_ADMIN.PAGE_ROUTE_FOUND'; + + if ($page->root() && (!$filter_type || in_array('root', $filter_type, true))) { + if ($field) { + $response[] = [ + 'name' => '', + 'value' => '/', + 'item-key' => '', + 'filename' => '.', + 'extension' => '', + 'type' => 'root', + 'modified' => $page->modified(), + 'size' => 0, + 'symlink' => false, + 'has-children' => false + ]; + } else { + $response[] = [ + 'item-key' => '-root-', + 'icon' => 'root', + 'title' => 'Root', // FIXME + 'route' => [ + 'display' => '<root>', // FIXME + 'raw' => '_root', + ], + 'modified' => $page->modified(), + 'extras' => [ + 'template' => $page->template(), + //'lang' => null, + //'translated' => null, + 'langs' => [], + 'published' => false, + 'visible' => false, + 'routable' => false, + 'tags' => ['root', 'non-routable'], + 'actions' => ['edit'], // FIXME + ] + ]; + } + } + + /** @var PageCollection|PageIndex $children */ + $children = $page->children(); + /** @var PageIndex $children */ + $children = $children->getIndex(); + $selectedChildren = $children->filterBy($filters + ['language' => $language], true); + + /** @var Header $header */ + $header = $page->header(); + + if (!$field && $header->get('admin.children_display_order', 'collection') === 'collection' && ($orderby = $header->get('content.order.by'))) { + // Use custom sorting by page header. + $sortby = $orderby; + $order = $header->get('content.order.dir', $order); + $custom = $header->get('content.order.custom'); + } + + if ($sortby) { + // Sort children. + $selectedChildren = $selectedChildren->order($sortby, $order, $custom ?? null); + } + + /** @var UserInterface|null $user */ + $user = Grav::instance()['user'] ?? null; + + /** @var PageObject $child */ + foreach ($selectedChildren as $child) { + $selected = $child->path() === $extra; + $includeChildren = is_array($leaf) && !empty($leaf) && $selected; + if ($field) { + $child_count = count($child->children()); + $payload = [ + 'name' => $child->menu(), + 'value' => $child->rawRoute(), + 'item-key' => Utils::basename($child->rawRoute() ?? ''), + 'filename' => $child->folder(), + 'extension' => $child->extension(), + 'type' => 'dir', + 'modified' => $child->modified(), + 'size' => $child_count, + 'symlink' => false, + 'has-children' => $child_count > 0 + ]; + } else { + $lang = $child->findTranslation($language) ?? 'n/a'; + /** @var PageObject $child */ + $child = $child->getTranslation($language) ?? $child; + + // TODO: all these features are independent from each other, we cannot just have one icon/color to catch all. + // TODO: maybe icon by home/modular/page/folder (or even from blueprints) and color by visibility etc.. + if ($child->home()) { + $icon = 'home'; + } elseif ($child->isModule()) { + $icon = 'modular'; + } elseif ($child->visible()) { + $icon = 'visible'; + } elseif ($child->isPage()) { + $icon = 'page'; + } else { + // TODO: add support + $icon = 'folder'; + } + $tags = [ + $child->published() ? 'published' : 'non-published', + $child->visible() ? 'visible' : 'non-visible', + $child->routable() ? 'routable' : 'non-routable' + ]; + $extras = [ + 'template' => $child->template(), + 'lang' => $lang ?: null, + 'translated' => $lang ? $child->hasTranslation($language, false) : null, + 'langs' => $child->getAllLanguages(true) ?: null, + 'published' => $child->published(), + 'published_date' => $this->jsDate($child->publishDate()), + 'unpublished_date' => $this->jsDate($child->unpublishDate()), + 'visible' => $child->visible(), + 'routable' => $child->routable(), + 'tags' => $tags, + 'actions' => $this->getListingActions($child, $user), + ]; + $extras = array_filter($extras, static function ($v) { + return $v !== null; + }); + + /** @var PageIndex $tmp */ + $tmp = $child->children()->getIndex(); + $child_count = $tmp->count(); + $count = $filters ? $tmp->filterBy($filters, true)->count() : null; + $route = $child->getRoute(); + $route = $route ? ($route->toString(false) ?: '/') : ''; + $payload = [ + 'item-key' => htmlspecialchars(Utils::basename($child->rawRoute() ?? $child->getKey())), + 'icon' => $icon, + 'title' => htmlspecialchars($child->menu()), + 'route' => [ + 'display' => htmlspecialchars($route) ?: null, + 'raw' => htmlspecialchars($child->rawRoute()), + ], + 'modified' => $this->jsDate($child->modified()), + 'child_count' => $child_count ?: null, + 'count' => $count ?? null, + 'filters_hit' => $filters ? ($child->filterBy($filters, false) ?: null) : null, + 'extras' => $extras + ]; + $payload = array_filter($payload, static function ($v) { + return $v !== null; + }); + } + + // Add children if any + if ($includeChildren) { + $payload['children'] = array_values($leaf); + } + + $response[] = $payload; + } + } else { + $msg = 'PLUGIN_ADMIN.PAGE_ROUTE_NOT_FOUND'; + } + + if ($field) { + $temp_array = []; + foreach ($response as $index => $item) { + $temp_array[$item['type']][$index] = $item; + } + + $sorted = Utils::sortArrayByArray($temp_array, $filter_type); + $response = Utils::arrayFlatten($sorted); + } + + return [$status, $msg, $response, $path]; + } + + /** + * @param PageObject $object + * @param UserInterface $user + * @return array + */ + protected function getListingActions(PageObject $object, UserInterface $user): array + { + $actions = []; + if ($object->isAuthorized('read', null, $user)) { + $actions[] = 'preview'; + $actions[] = 'edit'; + } + if ($object->isAuthorized('update', null, $user)) { + $actions[] = 'copy'; + $actions[] = 'move'; + } + if ($object->isAuthorized('delete', null, $user)) { + $actions[] = 'delete'; + } + + return $actions; + } + + /** + * @param FlexStorageInterface $storage + * @return CompiledJsonFile|CompiledYamlFile|null + */ + protected static function getIndexFile(FlexStorageInterface $storage) + { + if (!method_exists($storage, 'isIndexed') || !$storage->isIndexed()) { + return null; + } + + // Load saved index file. + $grav = Grav::instance(); + $locator = $grav['locator']; + + $filename = $locator->findResource('user-data://flex/indexes/pages.json', true, true); + + return CompiledJsonFile::instance($filename); + } + + /** + * @param int|null $timestamp + * @return string|null + */ + private function jsDate(int $timestamp = null): ?string + { + if (!$timestamp) { + return null; + } + + $config = Grav::instance()['config']; + $dateFormat = $config->get('system.pages.dateformat.long'); + + return date($dateFormat, $timestamp) ?: null; + } + + /** + * Add a single page to a collection + * + * @param PageInterface $page + * @return PageCollection + * @phpstan-return C + */ + public function addPage(PageInterface $page) + { + return $this->getCollection()->addPage($page); + } + + /** + * + * Create a copy of this collection + * + * @return static + * @phpstan-return static + */ + public function copy() + { + return clone $this; + } + + /** + * + * Merge another collection with the current collection + * + * @param PageCollectionInterface $collection + * @return PageCollection + * @phpstan-return C + */ + public function merge(PageCollectionInterface $collection) + { + return $this->getCollection()->merge($collection); + } + + + /** + * Intersect another collection with the current collection + * + * @param PageCollectionInterface $collection + * @return PageCollection + * @phpstan-return C + */ + public function intersect(PageCollectionInterface $collection) + { + return $this->getCollection()->intersect($collection); + } + + /** + * Split collection into array of smaller collections. + * + * @param int $size + * @return PageCollection[] + * @phpstan-return C[] + */ + public function batch($size) + { + return $this->getCollection()->batch($size); + } + + /** + * Remove item from the list. + * + * @param string $key + * @return PageObject|null + * @phpstan-return T|null + * @throws InvalidArgumentException + */ + public function remove($key) + { + return $this->getCollection()->remove($key); + } + + /** + * Reorder collection. + * + * @param string $by + * @param string $dir + * @param array $manual + * @param string $sort_flags + * @return static + * @phpstan-return static + */ + public function order($by, $dir = 'asc', $manual = null, $sort_flags = null) + { + /** @var PageCollectionInterface $collection */ + $collection = $this->__call('order', [$by, $dir, $manual, $sort_flags]); + + return $collection; + } + + /** + * Check to see if this item is the first in the collection. + * + * @param string $path + * @return bool True if item is first. + */ + public function isFirst($path): bool + { + /** @var bool $result */ + $result = $this->__call('isFirst', [$path]); + + return $result; + + } + + /** + * Check to see if this item is the last in the collection. + * + * @param string $path + * @return bool True if item is last. + */ + public function isLast($path): bool + { + /** @var bool $result */ + $result = $this->__call('isLast', [$path]); + + return $result; + } + + /** + * Gets the previous sibling based on current position. + * + * @param string $path + * @return PageObject|null The previous item. + * @phpstan-return T|null + */ + public function prevSibling($path) + { + /** @var PageObject|null $result */ + $result = $this->__call('prevSibling', [$path]); + + return $result; + } + + /** + * Gets the next sibling based on current position. + * + * @param string $path + * @return PageObject|null The next item. + * @phpstan-return T|null + */ + public function nextSibling($path) + { + /** @var PageObject|null $result */ + $result = $this->__call('nextSibling', [$path]); + + return $result; + } + + /** + * Returns the adjacent sibling based on a direction. + * + * @param string $path + * @param int $direction either -1 or +1 + * @return PageObject|false The sibling item. + * @phpstan-return T|false + */ + public function adjacentSibling($path, $direction = 1) + { + /** @var PageObject|false $result */ + $result = $this->__call('adjacentSibling', [$path, $direction]); + + return $result; + } + + /** + * Returns the item in the current position. + * + * @param string $path the path the item + * @return int|null The index of the current page, null if not found. + */ + public function currentPosition($path): ?int + { + /** @var int|null $result */ + $result = $this->__call('currentPosition', [$path]); + + return $result; + } + + /** + * Returns the items between a set of date ranges of either the page date field (default) or + * an arbitrary datetime page field where start date and end date are optional + * Dates must be passed in as text that strtotime() can process + * http://php.net/manual/en/function.strtotime.php + * + * @param string|null $startDate + * @param string|null $endDate + * @param string|null $field + * @return static + * @phpstan-return static + * @throws Exception + */ + public function dateRange($startDate = null, $endDate = null, $field = null) + { + $collection = $this->__call('dateRange', [$startDate, $endDate, $field]); + + return $collection; + } + + /** + * Mimicks Pages class. + * + * @return $this + * @deprecated 1.7 Not needed anymore in Flex Pages (does nothing). + */ + public function all() + { + return $this; + } + + /** + * Creates new collection with only visible pages + * + * @return static The collection with only visible pages + * @phpstan-return static + */ + public function visible() + { + $collection = $this->__call('visible', []); + + return $collection; + } + + /** + * Creates new collection with only non-visible pages + * + * @return static The collection with only non-visible pages + * @phpstan-return static + */ + public function nonVisible() + { + $collection = $this->__call('nonVisible', []); + + return $collection; + } + + /** + * Creates new collection with only non-modular pages + * + * @return static The collection with only non-modular pages + * @phpstan-return static + */ + public function pages() + { + $collection = $this->__call('pages', []); + + return $collection; + } + + /** + * Creates new collection with only modular pages + * + * @return static The collection with only modular pages + * @phpstan-return static + */ + public function modules() + { + $collection = $this->__call('modules', []); + + return $collection; + } + + /** + * Creates new collection with only modular pages + * + * @return static The collection with only modular pages + * @phpstan-return static + */ + public function modular() + { + return $this->modules(); + } + + /** + * Creates new collection with only non-modular pages + * + * @return static The collection with only non-modular pages + * @phpstan-return static + */ + public function nonModular() + { + return $this->pages(); + } + + /** + * Creates new collection with only published pages + * + * @return static The collection with only published pages + * @phpstan-return static + */ + public function published() + { + $collection = $this->__call('published', []); + + return $collection; + } + + /** + * Creates new collection with only non-published pages + * + * @return static The collection with only non-published pages + * @phpstan-return static + */ + public function nonPublished() + { + $collection = $this->__call('nonPublished', []); + + return $collection; + } + + /** + * Creates new collection with only routable pages + * + * @return static The collection with only routable pages + * @phpstan-return static + */ + public function routable() + { + $collection = $this->__call('routable', []); + + return $collection; + } + + /** + * Creates new collection with only non-routable pages + * + * @return static The collection with only non-routable pages + * @phpstan-return static + */ + public function nonRoutable() + { + $collection = $this->__call('nonRoutable', []); + + return $collection; + } + + /** + * Creates new collection with only pages of the specified type + * + * @param string $type + * @return static The collection + * @phpstan-return static + */ + public function ofType($type) + { + $collection = $this->__call('ofType', [$type]); + + return $collection; + } + + /** + * Creates new collection with only pages of one of the specified types + * + * @param string[] $types + * @return static The collection + * @phpstan-return static + */ + public function ofOneOfTheseTypes($types) + { + $collection = $this->__call('ofOneOfTheseTypes', [$types]); + + return $collection; + } + + /** + * Creates new collection with only pages of one of the specified access levels + * + * @param array $accessLevels + * @return static The collection + * @phpstan-return static + */ + public function ofOneOfTheseAccessLevels($accessLevels) + { + $collection = $this->__call('ofOneOfTheseAccessLevels', [$accessLevels]); + + return $collection; + } + + /** + * Converts collection into an array. + * + * @return array + */ + public function toArray() + { + return $this->getCollection()->toArray(); + } + + /** + * Get the extended version of this Collection with each page keyed by route + * + * @return array + * @throws Exception + */ + public function toExtendedArray() + { + return $this->getCollection()->toExtendedArray(); + } + +} diff --git a/system/src/Grav/Common/Flex/Types/Pages/PageObject.php b/system/src/Grav/Common/Flex/Types/Pages/PageObject.php new file mode 100644 index 0000000..9f71df7 --- /dev/null +++ b/system/src/Grav/Common/Flex/Types/Pages/PageObject.php @@ -0,0 +1,744 @@ + true, + 'full_order' => true, + 'filterBy' => true, + 'translated' => false, + ] + parent::getCachedMethods(); + } + + /** + * @return void + */ + public function initialize(): void + { + if (!$this->_initialized) { + Grav::instance()->fireEvent('onPageProcessed', new Event(['page' => $this])); + $this->_initialized = true; + } + } + + /** + * @param string|array $query + * @return Route|null + */ + public function getRoute($query = []): ?Route + { + $path = $this->route(); + if (null === $path) { + return null; + } + + $route = RouteFactory::createFromString($path); + if ($lang = $route->getLanguage()) { + $grav = Grav::instance(); + if (!$grav['config']->get('system.languages.include_default_lang')) { + /** @var Language $language */ + $language = $grav['language']; + if ($lang === $language->getDefault()) { + $route = $route->withLanguage(''); + } + } + } + if (is_array($query)) { + foreach ($query as $key => $value) { + $route = $route->withQueryParam($key, $value); + } + } else { + $route = $route->withAddedPath($query); + } + + return $route; + } + + /** + * @inheritdoc PageInterface + */ + public function getFormValue(string $name, $default = null, string $separator = null) + { + $test = new stdClass(); + + $value = $this->pageContentValue($name, $test); + if ($value !== $test) { + return $value; + } + + switch ($name) { + case 'name': + // TODO: this should not be template! + return $this->getProperty('template'); + case 'route': + $filesystem = Filesystem::getInstance(false); + $key = $filesystem->dirname($this->hasKey() ? '/' . $this->getKey() : '/'); + return $key !== '/' ? $key : null; + case 'full_route': + return $this->hasKey() ? '/' . $this->getKey() : ''; + case 'full_order': + return $this->full_order(); + case 'lang': + return $this->getLanguage() ?? ''; + case 'translations': + return $this->getLanguages(); + } + + return parent::getFormValue($name, $default, $separator); + } + + /** + * {@inheritdoc} + * @see FlexObjectInterface::getCacheKey() + */ + public function getCacheKey(): string + { + $cacheKey = parent::getCacheKey(); + if ($cacheKey) { + /** @var Language $language */ + $language = Grav::instance()['language']; + $cacheKey .= '_' . $language->getActive(); + } + + return $cacheKey; + } + + /** + * @param array $variables + * @return array + */ + protected function onBeforeSave(array $variables) + { + $reorder = $variables[0] ?? true; + + $meta = $this->getMetaData(); + if (($meta['copy'] ?? false) === true) { + $this->folder = $this->getKey(); + } + + // Figure out storage path to the new route. + $parentKey = $this->getProperty('parent_key'); + if ($parentKey !== '') { + $parentRoute = $this->getProperty('route'); + + // Root page cannot be moved. + if ($this->root()) { + throw new RuntimeException(sprintf('Root page cannot be moved to %s', $parentRoute)); + } + + // Make sure page isn't being moved under itself. + $key = $this->getStorageKey(); + + /** @var PageObject|null $parent */ + $parent = $parentKey !== false ? $this->getFlexDirectory()->getObject($parentKey, 'storage_key') : null; + if (!$parent) { + // Page cannot be moved to non-existing location. + throw new RuntimeException(sprintf('Page /%s cannot be moved to non-existing path %s', $key, $parentRoute)); + } + + // TODO: make sure that the page doesn't exist yet if moved/copied. + } + + if ($reorder === true && !$this->root()) { + $reorder = $this->_reorder; + } + + // Force automatic reorder if item is supposed to be added to the last. + if (!is_array($reorder) && (int)$this->order() >= 999999) { + $reorder = []; + } + + // Reorder siblings. + $siblings = is_array($reorder) ? ($this->reorderSiblings($reorder) ?? []) : []; + + $data = $this->prepareStorage(); + unset($data['header']); + + foreach ($siblings as $sibling) { + $data = $sibling->prepareStorage(); + unset($data['header']); + } + + return ['reorder' => $reorder, 'siblings' => $siblings]; + } + + /** + * @param array $variables + * @return array + */ + protected function onSave(array $variables): array + { + /** @var PageCollection $siblings */ + $siblings = $variables['siblings']; + /** @var PageObject $sibling */ + foreach ($siblings as $sibling) { + $sibling->save(false); + } + + return $variables; + } + + /** + * @param array $variables + */ + protected function onAfterSave(array $variables): void + { + $this->getFlexDirectory()->reloadIndex(); + } + + /** + * @param UserInterface|null $user + */ + public function check(UserInterface $user = null): void + { + parent::check($user); + + if ($user && $this->isMoved()) { + $parentKey = $this->getProperty('parent_key'); + + /** @var PageObject|null $parent */ + $parent = $this->getFlexDirectory()->getObject($parentKey, 'storage_key'); + if (!$parent || !$parent->isAuthorized('create', null, $user)) { + throw new \RuntimeException('Forbidden', 403); + } + } + } + + /** + * @param array|bool $reorder + * @return static + */ + public function save($reorder = true) + { + $variables = $this->onBeforeSave(func_get_args()); + + // Backwards compatibility with older plugins. + $fireEvents = $reorder && $this->isAdminSite() && $this->getFlexDirectory()->getConfig('object.compat.events', true); + $grav = $this->getContainer(); + if ($fireEvents) { + $self = $this; + $grav->fireEvent('onAdminSave', new Event(['type' => 'flex', 'directory' => $this->getFlexDirectory(), 'object' => &$self])); + if ($self !== $this) { + throw new RuntimeException('Switching Flex Page object during onAdminSave event is not supported! Please update plugin.'); + } + } + + /** @var static $instance */ + $instance = parent::save(); + $variables = $this->onSave($variables); + + $this->onAfterSave($variables); + + // Backwards compatibility with older plugins. + if ($fireEvents) { + $grav->fireEvent('onAdminAfterSave', new Event(['type' => 'flex', 'directory' => $this->getFlexDirectory(), 'object' => $this])); + } + + // Reset original after save events have all been called. + $this->_originalObject = null; + + return $instance; + } + + /** + * @return static + */ + public function delete() + { + $result = parent::delete(); + + // Backwards compatibility with older plugins. + $fireEvents = $this->isAdminSite() && $this->getFlexDirectory()->getConfig('object.compat.events', true); + if ($fireEvents) { + $this->getContainer()->fireEvent('onAdminAfterDelete', new Event(['object' => $this])); + } + + return $result; + } + + /** + * Prepare move page to new location. Moves also everything that's under the current page. + * + * You need to call $this->save() in order to perform the move. + * + * @param PageInterface $parent New parent page. + * @return $this + */ + public function move(PageInterface $parent) + { + if (!$parent instanceof FlexObjectInterface) { + throw new RuntimeException('Failed: Parent is not Flex Object'); + } + + $this->_reorder = []; + $this->setProperty('parent_key', $parent->getStorageKey()); + $this->storeOriginal(); + + return $this; + } + + /** + * @param UserInterface $user + * @param string $action + * @param string $scope + * @param bool $isMe + * @return bool|null + */ + protected function isAuthorizedOverride(UserInterface $user, string $action, string $scope, bool $isMe): ?bool + { + // Special case: creating a new page means checking parent for its permissions. + if ($action === 'create' && !$this->exists()) { + $parent = $this->parent(); + if ($parent && method_exists($parent, 'isAuthorized')) { + return $parent->isAuthorized($action, $scope, $user); + } + + return false; + } + + return parent::isAuthorizedOverride($user, $action, $scope, $isMe); + } + + /** + * @return bool + */ + protected function isMoved(): bool + { + $storageKey = $this->getMasterKey(); + $filesystem = Filesystem::getInstance(false); + $oldParentKey = ltrim($filesystem->dirname("/{$storageKey}"), '/'); + $newParentKey = $this->getProperty('parent_key'); + + return $this->exists() && $oldParentKey !== $newParentKey; + } + + /** + * @param array $ordering + * @return PageCollection|null + * @phpstan-return ObjectCollection|null + */ + protected function reorderSiblings(array $ordering) + { + $storageKey = $this->getMasterKey(); + $isMoved = $this->isMoved(); + $order = !$isMoved ? $this->order() : false; + if ($order !== false) { + $order = (int)$order; + } + + $parent = $this->parent(); + if (!$parent) { + throw new RuntimeException('Cannot reorder a page which has no parent'); + } + + /** @var PageCollection $siblings */ + $siblings = $parent->children(); + $siblings = $siblings->getCollection()->withOrdered(); + + // Handle special case where ordering isn't given. + if ($ordering === []) { + if ($order >= 999999) { + // Set ordering to point to be the last item, ignoring the object itself. + $order = 0; + foreach ($siblings as $sibling) { + if ($sibling->getKey() !== $this->getKey()) { + $order = max($order, (int)$sibling->order()); + } + } + $this->order($order + 1); + } + + // Do not change sibling ordering. + return null; + } + + $siblings = $siblings->orderBy(['order' => 'ASC']); + + if ($storageKey !== null) { + if ($order !== false) { + // Add current page back to the list if it's ordered. + $siblings->set($storageKey, $this); + } else { + // Remove old copy of the current page from the siblings list. + $siblings->remove($storageKey); + } + } + + // Add missing siblings into the end of the list, keeping the previous ordering between them. + foreach ($siblings as $sibling) { + $folder = (string)$sibling->getProperty('folder'); + $basename = preg_replace('|^\d+\.|', '', $folder); + if (!in_array($basename, $ordering, true)) { + $ordering[] = $basename; + } + } + + // Reorder. + $ordering = array_flip(array_values($ordering)); + $count = count($ordering); + foreach ($siblings as $sibling) { + $folder = (string)$sibling->getProperty('folder'); + $basename = preg_replace('|^\d+\.|', '', $folder); + $newOrder = $ordering[$basename] ?? null; + $newOrder = null !== $newOrder ? $newOrder + 1 : (int)$sibling->order() + $count; + $sibling->order($newOrder); + } + + $siblings = $siblings->orderBy(['order' => 'ASC']); + $siblings->removeElement($this); + + // If menu item was moved, just make it to be the last in order. + if ($isMoved && $this->order() !== false) { + $parentKey = $this->getProperty('parent_key'); + if ($parentKey === '') { + /** @var PageIndex $index */ + $index = $this->getFlexDirectory()->getIndex(); + $newParent = $index->getRoot(); + } else { + $newParent = $this->getFlexDirectory()->getObject($parentKey, 'storage_key'); + if (!$newParent instanceof PageInterface) { + throw new RuntimeException("New parent page '{$parentKey}' not found."); + } + } + /** @var PageCollection $newSiblings */ + $newSiblings = $newParent->children(); + $newSiblings = $newSiblings->getCollection()->withOrdered(); + $order = 0; + foreach ($newSiblings as $sibling) { + $order = max($order, (int)$sibling->order()); + } + $this->order($order + 1); + } + + return $siblings; + } + + /** + * @return string + */ + public function full_order(): string + { + $route = $this->path() . '/' . $this->folder(); + + return preg_replace(PageIndex::ORDER_LIST_REGEX, '\\1', $route) ?? $route; + } + + /** + * @param string $name + * @return Blueprint + */ + protected function doGetBlueprint(string $name = ''): Blueprint + { + try { + // Make sure that pages has been initialized. + Pages::getTypes(); + + // TODO: We need to move raw blueprint logic to Grav itself to remove admin dependency here. + if ($name === 'raw') { + // Admin RAW mode. + if ($this->isAdminSite()) { + /** @var Admin $admin */ + $admin = Grav::instance()['admin']; + + $template = $this->isModule() ? 'modular_raw' : ($this->root() ? 'root_raw' : 'raw'); + + return $admin->blueprints("admin/pages/{$template}"); + } + } + + $template = $this->getProperty('template') . ($name ? '.' . $name : ''); + + $blueprint = $this->getFlexDirectory()->getBlueprint($template, 'blueprints://pages'); + } catch (RuntimeException $e) { + $template = 'default' . ($name ? '.' . $name : ''); + + $blueprint = $this->getFlexDirectory()->getBlueprint($template, 'blueprints://pages'); + } + + $isNew = $blueprint->get('initialized', false) === false; + if ($isNew === true && $name === '') { + // Support onBlueprintCreated event just like in Pages::blueprints($template) + $blueprint->set('initialized', true); + $blueprint->setFilename($template); + + Grav::instance()->fireEvent('onBlueprintCreated', new Event(['blueprint' => $blueprint, 'type' => $template])); + } + + return $blueprint; + } + + /** + * @param array $options + * @return array + */ + public function getLevelListing(array $options): array + { + $index = $this->getFlexDirectory()->getIndex(); + if (!is_callable([$index, 'getLevelListing'])) { + return []; + } + + // Deal with relative paths. + $initial = $options['initial'] ?? null; + $var = $initial ? 'leaf_route' : 'route'; + $route = $options[$var] ?? ''; + if ($route !== '' && !str_starts_with($route, '/')) { + $filesystem = Filesystem::getInstance(); + + $route = "/{$this->getKey()}/{$route}"; + $route = $filesystem->normalize($route); + + $options[$var] = $route; + } + + [$status, $message, $response,] = $index->getLevelListing($options); + + return [$status, $message, $response, $options[$var] ?? null]; + } + + /** + * Filter page (true/false) by given filters. + * + * - search: string + * - extension: string + * - module: bool + * - visible: bool + * - routable: bool + * - published: bool + * - page: bool + * - translated: bool + * + * @param array $filters + * @param bool $recursive + * @return bool + */ + public function filterBy(array $filters, bool $recursive = false): bool + { + $language = $filters['language'] ?? null; + if (null !== $language) { + /** @var PageObject $test */ + $test = $this->getTranslation($language) ?? $this; + } else { + $test = $this; + } + + foreach ($filters as $key => $value) { + switch ($key) { + case 'search': + $matches = $test->search((string)$value) > 0.0; + break; + case 'page_type': + $types = $value ? explode(',', $value) : []; + $matches = in_array($test->template(), $types, true); + break; + case 'extension': + $matches = Utils::contains((string)$value, $test->extension()); + break; + case 'routable': + $matches = $test->isRoutable() === (bool)$value; + break; + case 'published': + $matches = $test->isPublished() === (bool)$value; + break; + case 'visible': + $matches = $test->isVisible() === (bool)$value; + break; + case 'module': + $matches = $test->isModule() === (bool)$value; + break; + case 'page': + $matches = $test->isPage() === (bool)$value; + break; + case 'folder': + $matches = $test->isPage() === !$value; + break; + case 'translated': + $matches = $test->hasTranslation() === (bool)$value; + break; + default: + $matches = true; + break; + } + + // If current filter does not match, we still may have match as a parent. + if ($matches === false) { + if (!$recursive) { + return false; + } + + /** @var PageIndex $index */ + $index = $this->children()->getIndex(); + + return $index->filterBy($filters, true)->count() > 0; + } + } + + return true; + } + + /** + * {@inheritdoc} + * @see FlexObjectInterface::exists() + */ + public function exists(): bool + { + return $this->root ?: parent::exists(); + } + + /** + * @return array + */ + public function __debugInfo(): array + { + $list = parent::__debugInfo(); + + return $list + [ + '_content_meta:private' => $this->getContentMeta(), + '_content:private' => $this->getRawContent() + ]; + } + + /** + * @param array $elements + * @param bool $extended + */ + protected function filterElements(array &$elements, bool $extended = false): void + { + // Change parent page if needed. + if (array_key_exists('route', $elements) && isset($elements['folder'], $elements['name'])) { + $elements['template'] = $elements['name']; + + // Figure out storage path to the new route. + $parentKey = trim($elements['route'] ?? '', '/'); + if ($parentKey !== '') { + /** @var PageObject|null $parent */ + $parent = $this->getFlexDirectory()->getObject($parentKey); + $parentKey = $parent ? $parent->getStorageKey() : $parentKey; + } + + $elements['parent_key'] = $parentKey; + } + + // Deal with ordering=bool and order=page1,page2,page3. + if ($this->root()) { + // Root page doesn't have ordering. + unset($elements['ordering'], $elements['order']); + } elseif (array_key_exists('ordering', $elements) && array_key_exists('order', $elements)) { + // Store ordering. + $ordering = $elements['order'] ?? null; + $this->_reorder = !empty($ordering) ? explode(',', $ordering) : []; + + $order = false; + if ((bool)($elements['ordering'] ?? false)) { + $order = $this->order(); + if ($order === false) { + $order = 999999; + } + } + + $elements['order'] = $order; + } + + parent::filterElements($elements, true); + } + + /** + * @return array + */ + public function prepareStorage(): array + { + $meta = $this->getMetaData(); + $oldLang = $meta['lang'] ?? ''; + $newLang = $this->getProperty('lang') ?? ''; + + // Always clone the page to the new language. + if ($oldLang !== $newLang) { + $meta['clone'] = true; + } + + // Make sure that certain elements are always sent to the storage layer. + $elements = [ + '__META' => $meta, + 'storage_key' => $this->getStorageKey(), + 'parent_key' => $this->getProperty('parent_key'), + 'order' => $this->getProperty('order'), + 'folder' => preg_replace('|^\d+\.|', '', $this->getProperty('folder') ?? ''), + 'template' => preg_replace('|modular/|', '', $this->getProperty('template') ?? ''), + 'lang' => $newLang + ] + parent::prepareStorage(); + + return $elements; + } +} diff --git a/system/src/Grav/Common/Flex/Types/Pages/Storage/PageStorage.php b/system/src/Grav/Common/Flex/Types/Pages/Storage/PageStorage.php new file mode 100644 index 0000000..577a0d7 --- /dev/null +++ b/system/src/Grav/Common/Flex/Types/Pages/Storage/PageStorage.php @@ -0,0 +1,700 @@ +flags = FilesystemIterator::KEY_AS_FILENAME | FilesystemIterator::CURRENT_AS_FILEINFO + | FilesystemIterator::SKIP_DOTS | FilesystemIterator::UNIX_PATHS; + + $grav = Grav::instance(); + + $config = $grav['config']; + $this->ignore_hidden = (bool)$config->get('system.pages.ignore_hidden'); + $this->ignore_files = (array)$config->get('system.pages.ignore_files'); + $this->ignore_folders = (array)$config->get('system.pages.ignore_folders'); + $this->include_default_lang_file_extension = (bool)$config->get('system.languages.include_default_lang_file_extension', true); + $this->recurse = (bool)($options['recurse'] ?? true); + $this->regex = '/(\.([\w\d_-]+))?\.md$/D'; + } + + /** + * @param string $key + * @param bool $variations + * @return array + */ + public function parseKey(string $key, bool $variations = true): array + { + if (mb_strpos($key, '|') !== false) { + [$key, $params] = explode('|', $key, 2); + } else { + $params = ''; + } + $key = ltrim($key, '/'); + + $keys = parent::parseKey($key, false) + ['params' => $params]; + + if ($variations) { + $keys += $this->parseParams($key, $params); + } + + return $keys; + } + + /** + * @param string $key + * @return string + */ + public function readFrontmatter(string $key): string + { + $path = $this->getPathFromKey($key); + $file = $this->getFile($path); + try { + if ($file instanceof MarkdownFile) { + $frontmatter = $file->frontmatter(); + } else { + $frontmatter = $file->raw(); + } + } catch (RuntimeException $e) { + $frontmatter = 'ERROR: ' . $e->getMessage(); + } finally { + $file->free(); + unset($file); + } + + return $frontmatter; + } + + /** + * @param string $key + * @return string + */ + public function readRaw(string $key): string + { + $path = $this->getPathFromKey($key); + $file = $this->getFile($path); + try { + $raw = $file->raw(); + } catch (RuntimeException $e) { + $raw = 'ERROR: ' . $e->getMessage(); + } finally { + $file->free(); + unset($file); + } + + return $raw; + } + + /** + * @param array $keys + * @param bool $includeParams + * @return string + */ + public function buildStorageKey(array $keys, bool $includeParams = true): string + { + $key = $keys['key'] ?? null; + if (null === $key) { + $key = $keys['parent_key'] ?? ''; + if ($key !== '') { + $key .= '/'; + } + $order = $keys['order'] ?? null; + $folder = $keys['folder'] ?? 'undefined'; + $key .= is_numeric($order) ? sprintf('%02d.%s', $order, $folder) : $folder; + } + + $params = $includeParams ? $this->buildStorageKeyParams($keys) : ''; + + return $params ? "{$key}|{$params}" : $key; + } + + /** + * @param array $keys + * @return string + */ + public function buildStorageKeyParams(array $keys): string + { + $params = $keys['template'] ?? ''; + $language = $keys['lang'] ?? ''; + if ($language) { + $params .= '.' . $language; + } + + return $params; + } + + /** + * @param array $keys + * @return string + */ + public function buildFolder(array $keys): string + { + return $this->dataFolder . '/' . $this->buildStorageKey($keys, false); + } + + /** + * @param array $keys + * @return string + */ + public function buildFilename(array $keys): string + { + $file = $this->buildStorageKeyParams($keys); + + // Template is optional; if it is missing, we need to have to load the object metadata. + if ($file && $file[0] === '.') { + $meta = $this->getObjectMeta($this->buildStorageKey($keys, false)); + $file = ($meta['template'] ?? 'folder') . $file; + } + + return $file . $this->dataExt; + } + + /** + * @param array $keys + * @return string + */ + public function buildFilepath(array $keys): string + { + $folder = $this->buildFolder($keys); + $filename = $this->buildFilename($keys); + + return rtrim($folder, '/') !== $folder ? $folder . $filename : $folder . '/' . $filename; + } + + /** + * @param array $row + * @param bool $setDefaultLang + * @return array + */ + public function extractKeysFromRow(array $row, bool $setDefaultLang = true): array + { + $meta = $row['__META'] ?? null; + $storageKey = $row['storage_key'] ?? $meta['storage_key'] ?? ''; + $keyMeta = $storageKey !== '' ? $this->extractKeysFromStorageKey($storageKey) : null; + $parentKey = $row['parent_key'] ?? $meta['parent_key'] ?? $keyMeta['parent_key'] ?? ''; + $order = $row['order'] ?? $meta['order'] ?? $keyMeta['order'] ?? null; + $folder = $row['folder'] ?? $meta['folder'] ?? $keyMeta['folder'] ?? ''; + $template = $row['template'] ?? $meta['template'] ?? $keyMeta['template'] ?? ''; + $lang = $row['lang'] ?? $meta['lang'] ?? $keyMeta['lang'] ?? ''; + + // Handle default language, if it should be saved without language extension. + if ($setDefaultLang && empty($meta['markdown'][$lang])) { + $grav = Grav::instance(); + + /** @var Language $language */ + $language = $grav['language']; + $default = $language->getDefault(); + // Make sure that the default language file doesn't exist before overriding it. + if (empty($meta['markdown'][$default])) { + if ($this->include_default_lang_file_extension) { + if ($lang === '') { + $lang = $language->getDefault(); + } + } elseif ($lang === $language->getDefault()) { + $lang = ''; + } + } + } + + $keys = [ + 'key' => null, + 'params' => null, + 'parent_key' => $parentKey, + 'order' => is_numeric($order) ? (int)$order : null, + 'folder' => $folder, + 'template' => $template, + 'lang' => $lang + ]; + + $keys['key'] = $this->buildStorageKey($keys, false); + $keys['params'] = $this->buildStorageKeyParams($keys); + + return $keys; + } + + /** + * @param string $key + * @return array + */ + public function extractKeysFromStorageKey(string $key): array + { + if (mb_strpos($key, '|') !== false) { + [$key, $params] = explode('|', $key, 2); + [$template, $language] = mb_strpos($params, '.') !== false ? explode('.', $params, 2) : [$params, '']; + } else { + $params = $template = $language = ''; + } + $objectKey = Utils::basename($key); + if (preg_match('|^(\d+)\.(.+)$|', $objectKey, $matches)) { + [, $order, $folder] = $matches; + } else { + [$order, $folder] = ['', $objectKey]; + } + + $filesystem = Filesystem::getInstance(false); + + $parentKey = ltrim($filesystem->dirname('/' . $key), '/'); + + return [ + 'key' => $key, + 'params' => $params, + 'parent_key' => $parentKey, + 'order' => is_numeric($order) ? (int)$order : null, + 'folder' => $folder, + 'template' => $template, + 'lang' => $language + ]; + } + + /** + * @param string $key + * @param string $params + * @return array + */ + protected function parseParams(string $key, string $params): array + { + if (mb_strpos($params, '.') !== false) { + [$template, $language] = explode('.', $params, 2); + } else { + $template = $params; + $language = ''; + } + + if ($template === '') { + $meta = $this->getObjectMeta($key); + $template = $meta['template'] ?? 'folder'; + } + + return [ + 'file' => $template . ($language ? '.' . $language : ''), + 'template' => $template, + 'lang' => $language + ]; + } + + /** + * Prepares the row for saving and returns the storage key for the record. + * + * @param array $row + */ + protected function prepareRow(array &$row): void + { + // Remove keys used in the filesystem. + unset($row['parent_key'], $row['order'], $row['folder'], $row['template'], $row['lang']); + } + + /** + * @param string $key + * @return array + */ + protected function loadRow(string $key): ?array + { + $data = parent::loadRow($key); + + // Special case for root page. + if ($key === '' && null !== $data) { + $data['root'] = true; + } + + return $data; + } + + /** + * Page storage supports moving and copying the pages and their languages. + * + * $row['__META']['copy'] = true Use this if you want to copy the whole folder, otherwise it will be moved + * $row['__META']['clone'] = true Use this if you want to clone the file, otherwise it will be renamed + * + * @param string $key + * @param array $row + * @return array + */ + protected function saveRow(string $key, array $row): array + { + // Initialize all key-related variables. + $newKeys = $this->extractKeysFromRow($row); + $newKey = $this->buildStorageKey($newKeys); + $newFolder = $this->buildFolder($newKeys); + $newFilename = $this->buildFilename($newKeys); + $newFilepath = rtrim($newFolder, '/') !== $newFolder ? $newFolder . $newFilename : $newFolder . '/' . $newFilename; + + try { + if ($key === '' && empty($row['root'])) { + throw new RuntimeException('Page has no path'); + } + + $grav = Grav::instance(); + + /** @var Debugger $debugger */ + $debugger = $grav['debugger']; + $debugger->addMessage("Save page: {$newKey}", 'debug'); + + // Check if the row already exists. + $oldKey = $row['__META']['storage_key'] ?? null; + if (is_string($oldKey)) { + // Initialize all old key-related variables. + $oldKeys = $this->extractKeysFromRow(['__META' => $row['__META']], false); + $oldFolder = $this->buildFolder($oldKeys); + $oldFilename = $this->buildFilename($oldKeys); + + // Check if folder has changed. + if ($oldFolder !== $newFolder && file_exists($oldFolder)) { + $isCopy = $row['__META']['copy'] ?? false; + if ($isCopy) { + if (strpos($newFolder, $oldFolder . '/') === 0) { + throw new RuntimeException(sprintf('Page /%s cannot be copied to itself', $oldKey)); + } + + $this->copyRow($oldKey, $newKey); + $debugger->addMessage("Page copied: {$oldFolder} => {$newFolder}", 'debug'); + } else { + if (strpos($newFolder, $oldFolder . '/') === 0) { + throw new RuntimeException(sprintf('Page /%s cannot be moved to itself', $oldKey)); + } + + $this->renameRow($oldKey, $newKey); + $debugger->addMessage("Page moved: {$oldFolder} => {$newFolder}", 'debug'); + } + } + + // Check if filename has changed. + if ($oldFilename !== $newFilename) { + // Get instance of the old file (we have already copied/moved it). + $oldFilepath = "{$newFolder}/{$oldFilename}"; + $file = $this->getFile($oldFilepath); + + // Rename the file if we aren't supposed to clone it. + $isClone = $row['__META']['clone'] ?? false; + if (!$isClone && $file->exists()) { + /** @var UniformResourceLocator $locator */ + $locator = $grav['locator']; + $toPath = $locator->isStream($newFilepath) ? $locator->findResource($newFilepath, true, true) : GRAV_ROOT . "/{$newFilepath}"; + $success = $file->rename($toPath); + if (!$success) { + throw new RuntimeException("Changing page template failed: {$oldFilepath} => {$newFilepath}"); + } + $debugger->addMessage("Page template changed: {$oldFilename} => {$newFilename}", 'debug'); + } else { + $file = null; + $debugger->addMessage("Page template created: {$newFilename}", 'debug'); + } + } + } + + // Clean up the data to be saved. + $this->prepareRow($row); + unset($row['__META'], $row['__ERROR']); + + if (!isset($file)) { + $file = $this->getFile($newFilepath); + } + + // Compare existing file content to the new one and save the file only if content has been changed. + $file->free(); + $oldRaw = $file->raw(); + $file->content($row); + $newRaw = $file->raw(); + if ($oldRaw !== $newRaw) { + $file->save($row); + $debugger->addMessage("Page content saved: {$newFilepath}", 'debug'); + } else { + $debugger->addMessage('Page content has not been changed, do not update the file', 'debug'); + } + } catch (RuntimeException $e) { + $name = isset($file) ? $file->filename() : $newKey; + + throw new RuntimeException(sprintf('Flex saveRow(%s): %s', $name, $e->getMessage())); + } finally { + /** @var UniformResourceLocator $locator */ + $locator = Grav::instance()['locator']; + $locator->clearCache(); + + if (isset($file)) { + $file->free(); + unset($file); + } + } + + $row['__META'] = $this->getObjectMeta($newKey, true); + + return $row; + } + + /** + * Check if page folder should be deleted. + * + * Deleting page can be done either by deleting everything or just a single language. + * If key contains the language, delete only it, unless it is the last language. + * + * @param string $key + * @return bool + */ + protected function canDeleteFolder(string $key): bool + { + // Return true if there's no language in the key. + $keys = $this->extractKeysFromStorageKey($key); + if (!$keys['lang']) { + return true; + } + + // Get the main key and reload meta. + $key = $this->buildStorageKey($keys); + $meta = $this->getObjectMeta($key, true); + + // Return true if there aren't any markdown files left. + return empty($meta['markdown'] ?? []); + } + + /** + * Get key from the filesystem path. + * + * @param string $path + * @return string + */ + protected function getKeyFromPath(string $path): string + { + if ($this->base_path) { + $path = $this->base_path . '/' . $path; + } + + return $path; + } + + /** + * Returns list of all stored keys in [key => timestamp] pairs. + * + * @return array + */ + protected function buildIndex(): array + { + $this->clearCache(); + + return $this->getIndexMeta(); + } + + /** + * @param string $key + * @param bool $reload + * @return array + */ + protected function getObjectMeta(string $key, bool $reload = false): array + { + $keys = $this->extractKeysFromStorageKey($key); + $key = $keys['key']; + + if ($reload || !isset($this->meta[$key])) { + /** @var UniformResourceLocator $locator */ + $locator = Grav::instance()['locator']; + if (mb_strpos($key, '@@') === false) { + $path = $this->getStoragePath($key); + if (is_string($path)) { + $path = $locator->isStream($path) ? $locator->findResource($path) : GRAV_ROOT . "/{$path}"; + } else { + $path = null; + } + } else { + $path = null; + } + + $modified = 0; + $markdown = []; + $children = []; + + if (is_string($path) && is_dir($path)) { + $modified = filemtime($path); + $iterator = new FilesystemIterator($path, $this->flags); + + /** @var SplFileInfo $info */ + foreach ($iterator as $k => $info) { + // Ignore all hidden files if set. + if ($k === '' || ($this->ignore_hidden && $k[0] === '.')) { + continue; + } + + if ($info->isDir()) { + // Ignore all folders in ignore list. + if ($this->ignore_folders && in_array($k, $this->ignore_folders, true)) { + continue; + } + + $children[$k] = false; + } else { + // Ignore all files in ignore list. + if ($this->ignore_files && in_array($k, $this->ignore_files, true)) { + continue; + } + + $timestamp = $info->getMTime(); + + // Page is the one that matches to $page_extensions list with the lowest index number. + if (preg_match($this->regex, $k, $matches)) { + $mark = $matches[2] ?? ''; + $ext = $matches[1] ?? ''; + $ext .= $this->dataExt; + $markdown[$mark][Utils::basename($k, $ext)] = $timestamp; + } + + $modified = max($modified, $timestamp); + } + } + } + + $rawRoute = trim(preg_replace(PageIndex::PAGE_ROUTE_REGEX, '/', "/{$key}") ?? '', '/'); + $route = PageIndex::normalizeRoute($rawRoute); + + ksort($markdown, SORT_NATURAL | SORT_FLAG_CASE); + ksort($children, SORT_NATURAL | SORT_FLAG_CASE); + + $file = array_key_first($markdown[''] ?? (reset($markdown) ?: [])); + + $meta = [ + 'key' => $route, + 'storage_key' => $key, + 'template' => $file, + 'storage_timestamp' => $modified, + ]; + if ($markdown) { + $meta['markdown'] = $markdown; + } + if ($children) { + $meta['children'] = $children; + } + $meta['checksum'] = md5(json_encode($meta) ?: ''); + + // Cache meta as copy. + $this->meta[$key] = $meta; + } else { + $meta = $this->meta[$key]; + } + + $params = $keys['params']; + if ($params) { + $language = $keys['lang']; + $template = $keys['template'] ?: array_key_first($meta['markdown'][$language]) ?? $meta['template']; + $meta['exists'] = ($template && !empty($meta['children'])) || isset($meta['markdown'][$language][$template]); + $meta['storage_key'] .= '|' . $params; + $meta['template'] = $template; + $meta['lang'] = $language; + } + + return $meta; + } + + /** + * @return array + */ + protected function getIndexMeta(): array + { + $queue = ['']; + $list = []; + do { + $current = array_pop($queue); + if ($current === null) { + break; + } + + $meta = $this->getObjectMeta($current); + $storage_key = $meta['storage_key']; + + if (!empty($meta['children'])) { + $prefix = $storage_key . ($storage_key !== '' ? '/' : ''); + + foreach ($meta['children'] as $child => $value) { + $queue[] = $prefix . $child; + } + } + + $list[$storage_key] = $meta; + } while ($queue); + + ksort($list, SORT_NATURAL | SORT_FLAG_CASE); + + // Update parent timestamps. + foreach (array_reverse($list) as $storage_key => $meta) { + if ($storage_key !== '') { + $filesystem = Filesystem::getInstance(false); + + $storage_key = (string)$storage_key; + $parentKey = $filesystem->dirname($storage_key); + if ($parentKey === '.') { + $parentKey = ''; + } + + /** @phpstan-var array{'storage_key': string, 'storage_timestamp': int, 'children': array} $parent */ + $parent = &$list[$parentKey]; + $basename = Utils::basename($storage_key); + + if (isset($parent['children'][$basename])) { + $timestamp = $meta['storage_timestamp']; + $parent['children'][$basename] = $timestamp; + if ($basename && $basename[0] === '_') { + $parent['storage_timestamp'] = max($parent['storage_timestamp'], $timestamp); + } + } + } + } + + return $list; + } + + /** + * @return string + */ + protected function getNewKey(): string + { + throw new RuntimeException('Generating random key is disabled for pages'); + } +} diff --git a/system/src/Grav/Common/Flex/Types/Pages/Traits/PageContentTrait.php b/system/src/Grav/Common/Flex/Types/Pages/Traits/PageContentTrait.php new file mode 100644 index 0000000..b6452b0 --- /dev/null +++ b/system/src/Grav/Common/Flex/Types/Pages/Traits/PageContentTrait.php @@ -0,0 +1,75 @@ +getProperty($property) : null; + if (null === $value) { + $value = $this->language() . ($var ?? ($this->modified() . md5($this->filePath() ?? $this->getKey()))); + + $this->setProperty($property, $value); + if ($this->doHasProperty($property)) { + $value = $this->getProperty($property); + } + } + + return $value; + } + + + /** + * @inheritdoc + */ + public function date($var = null): int + { + return $this->loadHeaderProperty( + 'date', + $var, + function ($value) { + $value = $value ? Utils::date2timestamp($value, $this->getProperty('dateformat')) : false; + + if (!$value) { + // Get the specific translation updated date. + $meta = $this->getMetaData(); + $language = $meta['lang'] ?? ''; + $template = $this->getProperty('template'); + $value = $meta['markdown'][$language][$template] ?? 0; + } + + return $value ?: $this->modified(); + } + ); + } + + /** + * @inheritdoc + * @param bool $bool + */ + public function isPage(bool $bool = true): bool + { + $meta = $this->getMetaData(); + + return empty($meta['markdown']) !== $bool; + } +} diff --git a/system/src/Grav/Common/Flex/Types/Pages/Traits/PageLegacyTrait.php b/system/src/Grav/Common/Flex/Types/Pages/Traits/PageLegacyTrait.php new file mode 100644 index 0000000..9fdd718 --- /dev/null +++ b/system/src/Grav/Common/Flex/Types/Pages/Traits/PageLegacyTrait.php @@ -0,0 +1,236 @@ +path() ?? ''; + + return $pages->children($path); + } + + /** + * Check to see if this item is the first in an array of sub-pages. + * + * @return bool True if item is first. + */ + public function isFirst(): bool + { + if (Utils::isAdminPlugin()) { + return parent::isFirst(); + } + + $path = $this->path(); + $parent = $this->parent(); + $collection = $parent ? $parent->collection('content', false) : null; + if (null !== $path && $collection instanceof PageCollectionInterface) { + return $collection->isFirst($path); + } + + return true; + } + + /** + * Check to see if this item is the last in an array of sub-pages. + * + * @return bool True if item is last + */ + public function isLast(): bool + { + if (Utils::isAdminPlugin()) { + return parent::isLast(); + } + + $path = $this->path(); + $parent = $this->parent(); + $collection = $parent ? $parent->collection('content', false) : null; + if (null !== $path && $collection instanceof PageCollectionInterface) { + return $collection->isLast($path); + } + + return true; + } + + /** + * Returns the adjacent sibling based on a direction. + * + * @param int $direction either -1 or +1 + * @return PageInterface|false the sibling page + */ + public function adjacentSibling($direction = 1) + { + if (Utils::isAdminPlugin()) { + return parent::adjacentSibling($direction); + } + + $path = $this->path(); + $parent = $this->parent(); + $collection = $parent ? $parent->collection('content', false) : null; + if (null !== $path && $collection instanceof PageCollectionInterface) { + $child = $collection->adjacentSibling($path, $direction); + if ($child instanceof PageInterface) { + return $child; + } + } + + return false; + } + + /** + * Helper method to return an ancestor page. + * + * @param string|null $lookup Name of the parent folder + * @return PageInterface|null page you were looking for if it exists + */ + public function ancestor($lookup = null) + { + if (Utils::isAdminPlugin()) { + return parent::ancestor($lookup); + } + + /** @var Pages $pages */ + $pages = Grav::instance()['pages']; + + return $pages->ancestor($this->getProperty('parent_route'), $lookup); + } + + /** + * Method that contains shared logic for inherited() and inheritedField() + * + * @param string $field Name of the parent folder + * @return array + */ + protected function getInheritedParams($field): array + { + if (Utils::isAdminPlugin()) { + return parent::getInheritedParams($field); + } + + /** @var Pages $pages */ + $pages = Grav::instance()['pages']; + + $inherited = $pages->inherited($this->getProperty('parent_route'), $field); + $inheritedParams = $inherited ? (array)$inherited->value('header.' . $field) : []; + $currentParams = (array)$this->getFormValue('header.' . $field); + if ($inheritedParams && is_array($inheritedParams)) { + $currentParams = array_replace_recursive($inheritedParams, $currentParams); + } + + return [$inherited, $currentParams]; + } + + /** + * Helper method to return a page. + * + * @param string $url the url of the page + * @param bool $all + * @return PageInterface|null page you were looking for if it exists + */ + public function find($url, $all = false) + { + if (Utils::isAdminPlugin()) { + return parent::find($url, $all); + } + + /** @var Pages $pages */ + $pages = Grav::instance()['pages']; + + return $pages->find($url, $all); + } + + /** + * Get a collection of pages in the current context. + * + * @param string|array $params + * @param bool $pagination + * @return PageCollectionInterface|Collection + * @throws InvalidArgumentException + */ + public function collection($params = 'content', $pagination = true) + { + if (Utils::isAdminPlugin()) { + return parent::collection($params, $pagination); + } + + if (is_string($params)) { + // Look into a page header field. + $params = (array)$this->getFormValue('header.' . $params); + } elseif (!is_array($params)) { + throw new InvalidArgumentException('Argument should be either header variable name or array of parameters'); + } + + $context = [ + 'pagination' => $pagination, + 'self' => $this + ]; + + /** @var Pages $pages */ + $pages = Grav::instance()['pages']; + + return $pages->getCollection($params, $context); + } + + /** + * @param string|array $value + * @param bool $only_published + * @return PageCollectionInterface|Collection + */ + public function evaluate($value, $only_published = true) + { + if (Utils::isAdminPlugin()) { + return parent::collection($value, $only_published); + } + + $params = [ + 'items' => $value, + 'published' => $only_published + ]; + $context = [ + 'event' => false, + 'pagination' => false, + 'url_taxonomy_filters' => false, + 'self' => $this + ]; + + /** @var Pages $pages */ + $pages = Grav::instance()['pages']; + + return $pages->getCollection($params, $context); + } +} diff --git a/system/src/Grav/Common/Flex/Types/Pages/Traits/PageRoutableTrait.php b/system/src/Grav/Common/Flex/Types/Pages/Traits/PageRoutableTrait.php new file mode 100644 index 0000000..2cfe450 --- /dev/null +++ b/system/src/Grav/Common/Flex/Types/Pages/Traits/PageRoutableTrait.php @@ -0,0 +1,122 @@ +root()) { + return null; + } + + /** @var Pages $pages */ + $pages = Grav::instance()['pages']; + + $filesystem = Filesystem::getInstance(false); + + // FIXME: this does not work, needs to use $pages->get() with cached parent id! + $key = $this->getKey(); + $parent_route = $filesystem->dirname('/' . $key); + + return $parent_route !== '/' ? $pages->find($parent_route) : $pages->root(); + } + + /** + * Returns the item in the current position. + * + * @return int|null the index of the current page. + */ + public function currentPosition(): ?int + { + $path = $this->path(); + $parent = $this->parent(); + $collection = $parent ? $parent->collection('content', false) : null; + if (null !== $path && $collection instanceof PageCollectionInterface) { + return $collection->currentPosition($path); + } + + return 1; + } + + /** + * Returns whether or not this page is the currently active page requested via the URL. + * + * @return bool True if it is active + */ + public function active(): bool + { + $grav = Grav::instance(); + $uri_path = rtrim(urldecode($grav['uri']->path()), '/') ?: '/'; + $routes = $grav['pages']->routes(); + + return isset($routes[$uri_path]) && $routes[$uri_path] === $this->path(); + } + + /** + * Returns whether or not this URI's URL contains the URL of the active page. + * Or in other words, is this page's URL in the current URL + * + * @return bool True if active child exists + */ + public function activeChild(): bool + { + $grav = Grav::instance(); + /** @var Uri $uri */ + $uri = $grav['uri']; + /** @var Pages $pages */ + $pages = $grav['pages']; + $uri_path = rtrim(urldecode($uri->path()), '/'); + $routes = $pages->routes(); + + if (isset($routes[$uri_path])) { + $page = $pages->find($uri->route()); + /** @var PageInterface|null $child_page */ + $child_page = $page ? $page->parent() : null; + while ($child_page && !$child_page->root()) { + if ($this->path() === $child_page->path()) { + return true; + } + $child_page = $child_page->parent(); + } + } + + return false; + } +} diff --git a/system/src/Grav/Common/Flex/Types/Pages/Traits/PageTranslateTrait.php b/system/src/Grav/Common/Flex/Types/Pages/Traits/PageTranslateTrait.php new file mode 100644 index 0000000..d8d86b0 --- /dev/null +++ b/system/src/Grav/Common/Flex/Types/Pages/Traits/PageTranslateTrait.php @@ -0,0 +1,108 @@ +getLanguageTemplates(); + if (!$translated) { + return $translated; + } + + $grav = Grav::instance(); + + /** @var Language $language */ + $language = $grav['language']; + + /** @var UniformResourceLocator $locator */ + $locator = $grav['locator']; + + $languages = $language->getLanguages(); + $languages[] = ''; + $defaultCode = $language->getDefault(); + + if (isset($translated[$defaultCode])) { + unset($translated['']); + } + + foreach ($translated as $key => &$template) { + $template .= $key !== '' ? ".{$key}.md" : '.md'; + } + unset($template); + + $translated = array_intersect_key($translated, array_flip($languages)); + + $folder = $this->getStorageFolder(); + if (!$folder) { + return []; + } + $folder = $locator->isStream($folder) ? $locator->getResource($folder) : GRAV_ROOT . "/{$folder}"; + + $list = array_fill_keys($languages, null); + foreach ($translated as $languageCode => $languageFile) { + $languageExtension = $languageCode ? ".{$languageCode}.md" : '.md'; + $path = "{$folder}/{$languageFile}"; + + // FIXME: use flex, also rawRoute() does not fully work? + $aPage = new Page(); + $aPage->init(new SplFileInfo($path), $languageExtension); + if ($onlyPublished && !$aPage->published()) { + continue; + } + + $header = $aPage->header(); + // @phpstan-ignore-next-line + $routes = $header->routes ?? []; + $route = $routes['default'] ?? $aPage->rawRoute(); + if (!$route) { + $route = $aPage->route(); + } + + $list[$languageCode ?: $defaultCode] = $route ?? ''; + } + + $list = array_filter($list, static function ($var) { + return null !== $var; + }); + + // Hack to get the same result as with old pages. + foreach ($list as &$path) { + if ($path === '') { + $path = null; + } + } + + return $list; + } +} diff --git a/system/src/Grav/Common/Flex/Types/UserGroups/UserGroupCollection.php b/system/src/Grav/Common/Flex/Types/UserGroups/UserGroupCollection.php new file mode 100644 index 0000000..daaa942 --- /dev/null +++ b/system/src/Grav/Common/Flex/Types/UserGroups/UserGroupCollection.php @@ -0,0 +1,56 @@ + + */ +class UserGroupCollection extends FlexCollection +{ + /** + * @return array + */ + public static function getCachedMethods(): array + { + return [ + 'authorize' => false, + ] + parent::getCachedMethods(); + } + + /** + * Checks user authorization to the action. + * + * @param string $action + * @param string|null $scope + * @return bool|null + */ + public function authorize(string $action, string $scope = null): ?bool + { + $authorized = null; + /** @var UserGroupObject $object */ + foreach ($this as $object) { + $auth = $object->authorize($action, $scope); + if ($auth === true) { + $authorized = true; + } elseif ($auth === false) { + return false; + } + } + + return $authorized; + } +} diff --git a/system/src/Grav/Common/Flex/Types/UserGroups/UserGroupIndex.php b/system/src/Grav/Common/Flex/Types/UserGroups/UserGroupIndex.php new file mode 100644 index 0000000..86b9c37 --- /dev/null +++ b/system/src/Grav/Common/Flex/Types/UserGroups/UserGroupIndex.php @@ -0,0 +1,24 @@ + + */ +class UserGroupIndex extends FlexIndex +{ +} diff --git a/system/src/Grav/Common/Flex/Types/UserGroups/UserGroupObject.php b/system/src/Grav/Common/Flex/Types/UserGroups/UserGroupObject.php new file mode 100644 index 0000000..c8da8a2 --- /dev/null +++ b/system/src/Grav/Common/Flex/Types/UserGroups/UserGroupObject.php @@ -0,0 +1,134 @@ + false, + ] + parent::getCachedMethods(); + } + + /** + * @return string + */ + public function getTitle(): string + { + return $this->getProperty('readableName'); + } + + /** + * Checks user authorization to the action. + * + * @param string $action + * @param string|null $scope + * @return bool|null + */ + public function authorize(string $action, string $scope = null): ?bool + { + if ($scope === 'test') { + $scope = null; + } elseif (!$this->getProperty('enabled', true)) { + return null; + } + + $access = $this->getAccess(); + + $authorized = $access->authorize($action, $scope); + if (is_bool($authorized)) { + return $authorized; + } + + return $access->authorize('admin.super') ? true : null; + } + + public static function groupNames(): array + { + $groups = []; + $user_groups = Grav::instance()['user_groups'] ?? []; + + foreach ($user_groups as $key => $group) { + $groups[$key] = $group->readableName; + } + + return $groups; + } + + /** + * @return Access + */ + protected function getAccess(): Access + { + if (null === $this->_access) { + $this->getProperty('access'); + } + + return $this->_access; + } + + /** + * @param mixed $value + * @return array + */ + protected function offsetLoad_access($value): array + { + if (!$value instanceof Access) { + $value = new Access($value); + } + + $this->_access = $value; + + return $value->jsonSerialize(); + } + + /** + * @param mixed $value + * @return array + */ + protected function offsetPrepare_access($value): array + { + return $this->offsetLoad_access($value); + } + + /** + * @param array|null $value + * @return array|null + */ + protected function offsetSerialize_access(?array $value): ?array + { + return $value; + } +} diff --git a/system/src/Grav/Common/Flex/Types/Users/Storage/UserFileStorage.php b/system/src/Grav/Common/Flex/Types/Users/Storage/UserFileStorage.php new file mode 100644 index 0000000..01e3f96 --- /dev/null +++ b/system/src/Grav/Common/Flex/Types/Users/Storage/UserFileStorage.php @@ -0,0 +1,47 @@ +update($data)` instead (same but with data validation & filtering, file upload support). + */ + public function merge(array $data) + { + user_error(__CLASS__ . '::' . __FUNCTION__ . '() is deprecated since Grav 1.6, use ->update($data) method instead', E_USER_DEPRECATED); + + $this->setElements($this->getBlueprint()->mergeData($this->toArray(), $data)); + + return $this; + } + + /** + * Return media object for the User's avatar. + * + * @return ImageMedium|StaticImageMedium|null + * @deprecated 1.6 Use ->getAvatarImage() method instead. + */ + public function getAvatarMedia() + { + user_error(__CLASS__ . '::' . __FUNCTION__ . '() is deprecated since Grav 1.6, use ->getAvatarImage() method instead', E_USER_DEPRECATED); + + return $this->getAvatarImage(); + } + + /** + * Return the User's avatar URL + * + * @return string + * @deprecated 1.6 Use ->getAvatarUrl() method instead. + */ + public function avatarUrl() + { + user_error(__CLASS__ . '::' . __FUNCTION__ . '() is deprecated since Grav 1.6, use ->getAvatarUrl() method instead', E_USER_DEPRECATED); + + return $this->getAvatarUrl(); + } + + /** + * Checks user authorization to the action. + * Ensures backwards compatibility + * + * @param string $action + * @return bool + * @deprecated 1.5 Use ->authorize() method instead. + */ + public function authorise($action) + { + user_error(__CLASS__ . '::' . __FUNCTION__ . '() is deprecated since Grav 1.5, use ->authorize() method instead', E_USER_DEPRECATED); + + return $this->authorize($action) ?? false; + } + + /** + * Implements Countable interface. + * + * @return int + * @deprecated 1.6 Method makes no sense for user account. + */ + #[\ReturnTypeWillChange] + public function count() + { + user_error(__CLASS__ . '::' . __FUNCTION__ . '() is deprecated since Grav 1.6', E_USER_DEPRECATED); + + return count($this->jsonSerialize()); + } +} diff --git a/system/src/Grav/Common/Flex/Types/Users/UserCollection.php b/system/src/Grav/Common/Flex/Types/Users/UserCollection.php new file mode 100644 index 0000000..9e86bde --- /dev/null +++ b/system/src/Grav/Common/Flex/Types/Users/UserCollection.php @@ -0,0 +1,135 @@ + + */ +class UserCollection extends FlexCollection implements UserCollectionInterface +{ + /** + * @return array + */ + public static function getCachedMethods(): array + { + return [ + 'authorize' => 'session', + ] + parent::getCachedMethods(); + } + + /** + * Load user account. + * + * Always creates user object. To check if user exists, use $this->exists(). + * + * @param string $username + * @return UserObject + */ + public function load($username): UserInterface + { + $username = (string)$username; + + if ($username !== '') { + $key = $this->filterUsername($username); + $user = $this->get($key); + if ($user) { + return $user; + } + } else { + $key = ''; + } + + $directory = $this->getFlexDirectory(); + + /** @var UserObject $object */ + $object = $directory->createObject( + [ + 'username' => $username, + 'state' => 'enabled' + ], + $key + ); + + return $object; + } + + /** + * Find a user by username, email, etc + * + * @param string $query the query to search for + * @param string|string[] $fields the fields to search + * @return UserObject + */ + public function find($query, $fields = ['username', 'email']): UserInterface + { + if (is_string($query) && $query !== '') { + foreach ((array)$fields as $field) { + if ($field === 'key') { + $user = $this->get($query); + } elseif ($field === 'storage_key') { + $user = $this->withKeyField('storage_key')->get($query); + } elseif ($field === 'flex_key') { + $user = $this->withKeyField('flex_key')->get($query); + } elseif ($field === 'username') { + $user = $this->get($this->filterUsername($query)); + } else { + $user = parent::find($query, $field); + } + if ($user instanceof UserObject) { + return $user; + } + } + } + + return $this->load(''); + } + + /** + * Delete user account. + * + * @param string $username + * @return bool True if user account was found and was deleted. + */ + public function delete($username): bool + { + $user = $this->load($username); + + $exists = $user->exists(); + if ($exists) { + $user->delete(); + } + + return $exists; + } + + /** + * @param string $key + * @return string + */ + protected function filterUsername(string $key): string + { + $storage = $this->getFlexDirectory()->getStorage(); + if (method_exists($storage, 'normalizeKey')) { + return $storage->normalizeKey($key); + } + + return mb_strtolower($key); + } +} diff --git a/system/src/Grav/Common/Flex/Types/Users/UserIndex.php b/system/src/Grav/Common/Flex/Types/Users/UserIndex.php new file mode 100644 index 0000000..d6781af --- /dev/null +++ b/system/src/Grav/Common/Flex/Types/Users/UserIndex.php @@ -0,0 +1,206 @@ + + */ +class UserIndex extends FlexIndex implements UserCollectionInterface +{ + public const VERSION = parent::VERSION . '.2'; + + /** + * @param FlexStorageInterface $storage + * @return array + */ + public static function loadEntriesFromStorage(FlexStorageInterface $storage): array + { + // Load saved index. + $index = static::loadIndex($storage); + + $version = $index['version'] ?? 0; + $force = static::VERSION !== $version; + + // TODO: Following check flex index to be out of sync after some saves, disabled until better solution is found. + //$timestamp = $index['timestamp'] ?? 0; + //if (!$force && $timestamp && $timestamp > time() - 1) { + // return $index['index']; + //} + + // Load up-to-date index. + $entries = parent::loadEntriesFromStorage($storage); + + return static::updateIndexFile($storage, $index['index'], $entries, ['force_update' => $force]); + } + + /** + * @param array $meta + * @param array $data + * @param FlexStorageInterface $storage + * @return void + */ + public static function updateObjectMeta(array &$meta, array $data, FlexStorageInterface $storage): void + { + // Username can also be number and stored as such. + $key = (string)($data['username'] ?? $meta['key'] ?? $meta['storage_key']); + $meta['key'] = static::filterUsername($key, $storage); + $meta['email'] = isset($data['email']) ? mb_strtolower($data['email']) : null; + } + + /** + * Load user account. + * + * Always creates user object. To check if user exists, use $this->exists(). + * + * @param string $username + * @return UserObject + */ + public function load($username): UserInterface + { + $username = (string)$username; + + if ($username !== '') { + $key = static::filterUsername($username, $this->getFlexDirectory()->getStorage()); + $user = $this->get($key); + if ($user) { + return $user; + } + } else { + $key = ''; + } + + $directory = $this->getFlexDirectory(); + + /** @var UserObject $object */ + $object = $directory->createObject( + [ + 'username' => $username, + 'state' => 'enabled' + ], + $key + ); + + return $object; + } + + /** + * Delete user account. + * + * @param string $username + * @return bool True if user account was found and was deleted. + */ + public function delete($username): bool + { + $user = $this->load($username); + + $exists = $user->exists(); + if ($exists) { + $user->delete(); + } + + return $exists; + } + + /** + * Find a user by username, email, etc + * + * @param string $query the query to search for + * @param array $fields the fields to search + * @return UserObject + */ + public function find($query, $fields = ['username', 'email']): UserInterface + { + if (is_string($query) && $query !== '') { + foreach ((array)$fields as $field) { + if ($field === 'key') { + $user = $this->get($query); + } elseif ($field === 'storage_key') { + $user = $this->withKeyField('storage_key')->get($query); + } elseif ($field === 'flex_key') { + $user = $this->withKeyField('flex_key')->get($query); + } elseif ($field === 'email') { + $email = mb_strtolower($query); + $user = $this->withKeyField('email')->get($email); + } elseif ($field === 'username') { + $username = static::filterUsername($query, $this->getFlexDirectory()->getStorage()); + $user = $this->get($username); + } else { + $user = $this->__call('find', [$query, $field]); + } + if ($user) { + return $user; + } + } + } + + return $this->load(''); + } + + /** + * @param string $key + * @param FlexStorageInterface $storage + * @return string + */ + protected static function filterUsername(string $key, FlexStorageInterface $storage): string + { + return method_exists($storage, 'normalizeKey') ? $storage->normalizeKey($key) : $key; + } + + /** + * @param FlexStorageInterface $storage + * @return CompiledYamlFile|null + */ + protected static function getIndexFile(FlexStorageInterface $storage) + { + // Load saved index file. + $grav = Grav::instance(); + $locator = $grav['locator']; + $filename = $locator->findResource('user-data://flex/indexes/accounts.yaml', true, true); + + return CompiledYamlFile::instance($filename); + } + + /** + * @param array $entries + * @param array $added + * @param array $updated + * @param array $removed + */ + protected static function onChanges(array $entries, array $added, array $updated, array $removed): void + { + $message = sprintf('Flex: User index updated, %d objects (%d added, %d updated, %d removed).', count($entries), count($added), count($updated), count($removed)); + + $grav = Grav::instance(); + + /** @var Logger $logger */ + $logger = $grav['log']; + $logger->addDebug($message); + + /** @var Debugger $debugger */ + $debugger = $grav['debugger']; + $debugger->addMessage($message, 'debug'); + } +} diff --git a/system/src/Grav/Common/Flex/Types/Users/UserObject.php b/system/src/Grav/Common/Flex/Types/Users/UserObject.php new file mode 100644 index 0000000..5cdaafd --- /dev/null +++ b/system/src/Grav/Common/Flex/Types/Users/UserObject.php @@ -0,0 +1,1059 @@ + 'session', + 'load' => false, + 'find' => false, + 'remove' => false, + 'get' => true, + 'set' => false, + 'undef' => false, + 'def' => false, + ] + parent::getCachedMethods(); + } + + /** + * UserObject constructor. + * @param array $elements + * @param string $key + * @param FlexDirectory $directory + * @param bool $validate + */ + public function __construct(array $elements, $key, FlexDirectory $directory, bool $validate = false) + { + // User can only be authenticated via login. + unset($elements['authenticated'], $elements['authorized']); + + // Define username if it's not set. + if (!isset($elements['username'])) { + $storageKey = $elements['__META']['storage_key'] ?? null; + $storage = $directory->getStorage(); + if (null !== $storageKey && method_exists($storage, 'normalizeKey') && $key === $storage->normalizeKey($storageKey)) { + $elements['username'] = $storageKey; + } else { + $elements['username'] = $key; + } + } + + // Define state if it isn't set. + if (!isset($elements['state'])) { + $elements['state'] = 'enabled'; + } + + parent::__construct($elements, $key, $directory, $validate); + } + + public function __clone() + { + $this->_access = null; + $this->_groups = null; + + parent::__clone(); + } + + /** + * @return void + */ + public function onPrepareRegistration(): void + { + if (!$this->getProperty('access')) { + /** @var Config $config */ + $config = Grav::instance()['config']; + + $groups = $config->get('plugins.login.user_registration.groups', ''); + $access = $config->get('plugins.login.user_registration.access', ['site' => ['login' => true]]); + + $this->setProperty('groups', $groups); + $this->setProperty('access', $access); + } + } + + /** + * Helper to get content editor will fall back if not set + * + * @return string + */ + public function getContentEditor(): string + { + return $this->getProperty('content_editor', 'default'); + } + + /** + * Get value by using dot notation for nested arrays/objects. + * + * @example $value = $this->get('this.is.my.nested.variable'); + * + * @param string $name Dot separated path to the requested value. + * @param mixed $default Default value (or null). + * @param string|null $separator Separator, defaults to '.' + * @return mixed Value. + */ + public function get($name, $default = null, $separator = null) + { + return $this->getNestedProperty($name, $default, $separator); + } + + /** + * Set value by using dot notation for nested arrays/objects. + * + * @example $data->set('this.is.my.nested.variable', $value); + * + * @param string $name Dot separated path to the requested value. + * @param mixed $value New value. + * @param string|null $separator Separator, defaults to '.' + * @return $this + */ + public function set($name, $value, $separator = null) + { + $this->setNestedProperty($name, $value, $separator); + + return $this; + } + + /** + * Unset value by using dot notation for nested arrays/objects. + * + * @example $data->undef('this.is.my.nested.variable'); + * + * @param string $name Dot separated path to the requested value. + * @param string|null $separator Separator, defaults to '.' + * @return $this + */ + public function undef($name, $separator = null) + { + $this->unsetNestedProperty($name, $separator); + + return $this; + } + + /** + * Set default value by using dot notation for nested arrays/objects. + * + * @example $data->def('this.is.my.nested.variable', 'default'); + * + * @param string $name Dot separated path to the requested value. + * @param mixed $default Default value (or null). + * @param string|null $separator Separator, defaults to '.' + * @return $this + */ + public function def($name, $default = null, $separator = null) + { + $this->defNestedProperty($name, $default, $separator); + + return $this; + } + + /** + * @param UserInterface|null $user + * @return bool + */ + public function isMyself(?UserInterface $user = null): bool + { + if (null === $user) { + $user = $this->getActiveUser(); + if ($user && !$user->authenticated) { + $user = null; + } + } + + return $user && $this->username === $user->username; + } + + /** + * Checks user authorization to the action. + * + * @param string $action + * @param string|null $scope + * @return bool|null + */ + public function authorize(string $action, string $scope = null): ?bool + { + if ($scope === 'test') { + // Special scope to test user permissions. + $scope = null; + } else { + // User needs to be enabled. + if ($this->getProperty('state') !== 'enabled') { + return false; + } + + // User needs to be logged in. + if (!$this->getProperty('authenticated')) { + return false; + } + + if (strpos($action, 'login') === false && !$this->getProperty('authorized')) { + // User needs to be authorized (2FA). + return false; + } + + // Workaround bug in Login::isUserAuthorizedForPage() <= Login v3.0.4 + if ((string)(int)$action === $action) { + return false; + } + } + + // Check custom application access. + $authorizeCallable = static::$authorizeCallable; + if ($authorizeCallable instanceof Closure) { + $callable = $authorizeCallable->bindTo($this, $this); + $authorized = $callable($action, $scope); + if (is_bool($authorized)) { + return $authorized; + } + } + + // Check user access. + $access = $this->getAccess(); + $authorized = $access->authorize($action, $scope); + if (is_bool($authorized)) { + return $authorized; + } + + // Check group access. + $authorized = $this->getGroups()->authorize($action, $scope); + if (is_bool($authorized)) { + return $authorized; + } + + // If any specific rule isn't hit, check if user is a superuser. + return $access->authorize('admin.super') === true; + } + + /** + * @param string $property + * @param mixed $default + * @return mixed + */ + public function getProperty($property, $default = null) + { + $value = parent::getProperty($property, $default); + + if ($property === 'avatar') { + $settings = $this->getMediaFieldSettings($property); + $value = $this->parseFileProperty($value, $settings); + } + + return $value; + } + + /** + * @return UserGroupIndex + */ + public function getRoles(): UserGroupIndex + { + return $this->getGroups(); + } + + /** + * Convert object into an array. + * + * @return array + */ + public function toArray() + { + $array = $this->jsonSerialize(); + + $settings = $this->getMediaFieldSettings('avatar'); + $array['avatar'] = $this->parseFileProperty($array['avatar'] ?? null, $settings); + + return $array; + } + + /** + * Convert object into YAML string. + * + * @param int $inline The level where you switch to inline YAML. + * @param int $indent The amount of spaces to use for indentation of nested nodes. + * @return string A YAML string representing the object. + */ + public function toYaml($inline = 5, $indent = 2) + { + $yaml = new YamlFormatter(['inline' => $inline, 'indent' => $indent]); + + return $yaml->encode($this->toArray()); + } + + /** + * Convert object into JSON string. + * + * @return string + */ + public function toJson() + { + $json = new JsonFormatter(); + + return $json->encode($this->toArray()); + } + + /** + * Join nested values together by using blueprints. + * + * @param string $name Dot separated path to the requested value. + * @param mixed $value Value to be joined. + * @param string|null $separator Separator, defaults to '.' + * @return $this + * @throws RuntimeException + */ + public function join($name, $value, $separator = null) + { + $separator = $separator ?? '.'; + $old = $this->get($name, null, $separator); + if ($old !== null) { + if (!is_array($old)) { + throw new RuntimeException('Value ' . $old); + } + + if (is_object($value)) { + $value = (array) $value; + } elseif (!is_array($value)) { + throw new RuntimeException('Value ' . $value); + } + + $value = $this->getBlueprint()->mergeData($old, $value, $name, $separator); + } + + $this->set($name, $value, $separator); + + return $this; + } + + /** + * Get nested structure containing default values defined in the blueprints. + * + * Fields without default value are ignored in the list. + + * @return array + */ + public function getDefaults() + { + return $this->getBlueprint()->getDefaults(); + } + + /** + * Set default values by using blueprints. + * + * @param string $name Dot separated path to the requested value. + * @param mixed $value Value to be joined. + * @param string|null $separator Separator, defaults to '.' + * @return $this + */ + public function joinDefaults($name, $value, $separator = null) + { + if (is_object($value)) { + $value = (array) $value; + } + + $old = $this->get($name, null, $separator); + if ($old !== null) { + $value = $this->getBlueprint()->mergeData($value, $old, $name, $separator ?? '.'); + } + + $this->setNestedProperty($name, $value, $separator); + + return $this; + } + + /** + * Get value from the configuration and join it with given data. + * + * @param string $name Dot separated path to the requested value. + * @param array|object $value Value to be joined. + * @param string $separator Separator, defaults to '.' + * @return array + * @throws RuntimeException + */ + public function getJoined($name, $value, $separator = null) + { + if (is_object($value)) { + $value = (array) $value; + } elseif (!is_array($value)) { + throw new RuntimeException('Value ' . $value); + } + + $old = $this->get($name, null, $separator); + + if ($old === null) { + // No value set; no need to join data. + return $value; + } + + if (!is_array($old)) { + throw new RuntimeException('Value ' . $old); + } + + // Return joined data. + return $this->getBlueprint()->mergeData($old, $value, $name, $separator ?? '.'); + } + + /** + * Set default values to the configuration if variables were not set. + * + * @param array $data + * @return $this + */ + public function setDefaults(array $data) + { + $this->setElements($this->getBlueprint()->mergeData($data, $this->toArray())); + + return $this; + } + + /** + * Validate by blueprints. + * + * @return $this + * @throws \Exception + */ + public function validate() + { + $this->getBlueprint()->validate($this->toArray()); + + return $this; + } + + /** + * Filter all items by using blueprints. + * @return $this + */ + public function filter() + { + $this->setElements($this->getBlueprint()->filter($this->toArray())); + + return $this; + } + + /** + * Get extra items which haven't been defined in blueprints. + * + * @return array + */ + public function extra() + { + return $this->getBlueprint()->extra($this->toArray()); + } + + /** + * Return unmodified data as raw string. + * + * NOTE: This function only returns data which has been saved to the storage. + * + * @return string + */ + public function raw() + { + $file = $this->file(); + + return $file ? $file->raw() : ''; + } + + /** + * Set or get the data storage. + * + * @param FileInterface|null $storage Optionally enter a new storage. + * @return FileInterface|null + */ + public function file(FileInterface $storage = null) + { + if (null !== $storage) { + $this->_storage = $storage; + } + + return $this->_storage; + } + + /** + * @return bool + */ + public function isValid(): bool + { + return $this->getProperty('state') !== null; + } + + /** + * Save user + * + * @return static + */ + public function save() + { + // TODO: We may want to handle this in the storage layer in the future. + $key = $this->getStorageKey(); + if (!$key || strpos($key, '@@')) { + $storage = $this->getFlexDirectory()->getStorage(); + if ($storage instanceof FileStorage) { + $this->setStorageKey($this->getKey()); + } + } + + $password = $this->getProperty('password') ?? $this->getProperty('password1'); + if (null !== $password && '' !== $password) { + $password2 = $this->getProperty('password2'); + if (!\is_string($password) || ($password2 && $password !== $password2)) { + throw new \RuntimeException('Passwords did not match.'); + } + + $this->setProperty('hashed_password', Authentication::create($password)); + } + $this->unsetProperty('password'); + $this->unsetProperty('password1'); + $this->unsetProperty('password2'); + + // Backwards compatibility with older plugins. + $fireEvents = $this->isAdminSite() && $this->getFlexDirectory()->getConfig('object.compat.events', true); + $grav = $this->getContainer(); + if ($fireEvents) { + $self = $this; + $grav->fireEvent('onAdminSave', new Event(['type' => 'flex', 'directory' => $this->getFlexDirectory(), 'object' => &$self])); + if ($self !== $this) { + throw new RuntimeException('Switching Flex User object during onAdminSave event is not supported! Please update plugin.'); + } + } + + $instance = parent::save(); + + // Backwards compatibility with older plugins. + if ($fireEvents) { + $grav->fireEvent('onAdminAfterSave', new Event(['type' => 'flex', 'directory' => $this->getFlexDirectory(), 'object' => $this])); + } + + return $instance; + } + + /** + * @return array + */ + public function prepareStorage(): array + { + $elements = parent::prepareStorage(); + + // Do not save authorization information. + unset($elements['authenticated'], $elements['authorized']); + + return $elements; + } + + /** + * @return MediaCollectionInterface + */ + public function getMedia() + { + /** @var Media $media */ + $media = $this->getFlexMedia(); + + // Deal with shared avatar folder. + $path = $this->getAvatarFile(); + if ($path && !$media[$path] && is_file($path)) { + $medium = MediumFactory::fromFile($path); + if ($medium) { + $media->add($path, $medium); + $name = Utils::basename($path); + if ($name !== $path) { + $media->add($name, $medium); + } + } + } + + return $media; + } + + /** + * @return string|null + */ + public function getMediaFolder(): ?string + { + $folder = $this->getFlexMediaFolder(); + + // Check for shared media + if (!$folder && !$this->getFlexDirectory()->getMediaFolder()) { + $this->_loadMedia = false; + $folder = $this->getBlueprint()->fields()['avatar']['destination'] ?? 'account://avatars'; + } + + return $folder; + } + + /** + * @param string $name + * @return array|object|null + * @internal + */ + public function initRelationship(string $name) + { + switch ($name) { + case 'media': + $list = []; + foreach ($this->getMedia()->all() as $filename => $object) { + $list[] = $this->buildMediaObject(null, $filename, $object); + } + + return $list; + case 'avatar': + return $this->buildMediaObject('avatar', basename($this->getAvatarUrl()), $this->getAvatarImage()); + } + + throw new \InvalidArgumentException(sprintf('%s: Relationship %s does not exist', $this->getFlexType(), $name)); + } + + /** + * @return bool Return true if relationships were updated. + */ + protected function updateRelationships(): bool + { + $modified = $this->getRelationships()->getModified(); + if ($modified) { + foreach ($modified as $relationship) { + $name = $relationship->getName(); + switch ($name) { + case 'avatar': + \assert($relationship instanceof ToOneRelationshipInterface); + $this->updateAvatarRelationship($relationship); + break; + default: + throw new \InvalidArgumentException(sprintf('%s: Relationship %s cannot be modified', $this->getFlexType(), $name), 400); + } + } + + $this->resetRelationships(); + + return true; + } + + return false; + } + + /** + * @param ToOneRelationshipInterface $relationship + */ + protected function updateAvatarRelationship(ToOneRelationshipInterface $relationship): void + { + $files = []; + $avatar = $this->getAvatarImage(); + if ($avatar) { + $files['avatar'][$avatar->filename] = null; + } + + $identifier = $relationship->getIdentifier(); + if ($identifier) { + \assert($identifier instanceof MediaIdentifier); + $object = $identifier->getObject(); + if ($object instanceof UploadedMediaObject) { + $uploadedFile = $object->getUploadedFile(); + if ($uploadedFile) { + $files['avatar'][$uploadedFile->getClientFilename()] = $uploadedFile; + } + } + } + + $this->update([], $files); + } + + /** + * @param string $name + * @return Blueprint + */ + protected function doGetBlueprint(string $name = ''): Blueprint + { + $blueprint = $this->getFlexDirectory()->getBlueprint($name ? '.' . $name : $name); + + // HACK: With folder storage we need to ignore the avatar destination. + if ($this->getFlexDirectory()->getMediaFolder()) { + $field = $blueprint->get('form/fields/avatar'); + if ($field) { + unset($field['destination']); + $blueprint->set('form/fields/avatar', $field); + } + } + + return $blueprint; + } + + /** + * @param UserInterface $user + * @param string $action + * @param string $scope + * @param bool $isMe + * @return bool|null + */ + protected function isAuthorizedOverride(UserInterface $user, string $action, string $scope, bool $isMe = false): ?bool + { + // Check custom application access. + $isAuthorizedCallable = static::$isAuthorizedCallable; + if ($isAuthorizedCallable instanceof Closure) { + $callable = $isAuthorizedCallable->bindTo($this, $this); + $authorized = $callable($user, $action, $scope, $isMe); + if (is_bool($authorized)) { + return $authorized; + } + } + + if ($user instanceof self && $user->getStorageKey() === $this->getStorageKey()) { + // User cannot delete his own account, otherwise he has full access. + return $action !== 'delete'; + } + + return parent::isAuthorizedOverride($user, $action, $scope, $isMe); + } + + /** + * @return string|null + */ + protected function getAvatarFile(): ?string + { + $avatars = $this->getElement('avatar'); + if (is_array($avatars) && $avatars) { + $avatar = array_shift($avatars); + + return $avatar['path'] ?? null; + } + + return null; + } + + /** + * Gets the associated media collection (original images). + * + * @return MediaCollectionInterface Representation of associated media. + */ + protected function getOriginalMedia() + { + $folder = $this->getMediaFolder(); + if ($folder) { + $folder .= '/original'; + } + + return (new Media($folder ?? '', $this->getMediaOrder()))->setTimestamps(); + } + + /** + * @param array $files + * @return void + */ + protected function setUpdatedMedia(array $files): void + { + /** @var UniformResourceLocator $locator */ + $locator = Grav::instance()['locator']; + + $media = $this->getMedia(); + if (!$media instanceof MediaUploadInterface) { + return; + } + + $filesystem = Filesystem::getInstance(false); + + $list = []; + $list_original = []; + foreach ($files as $field => $group) { + // Ignore files without a field. + if ($field === '') { + continue; + } + $field = (string)$field; + + // Load settings for the field. + $settings = $this->getMediaFieldSettings($field); + foreach ($group as $filename => $file) { + if ($file) { + // File upload. + $filename = $file->getClientFilename(); + + /** @var FormFlashFile $file */ + $data = $file->jsonSerialize(); + unset($data['tmp_name'], $data['path']); + } else { + // File delete. + $data = null; + } + + if ($file) { + // Check file upload against media limits (except for max size). + $filename = $media->checkUploadedFile($file, $filename, ['filesize' => 0] + $settings); + } + + $self = $settings['self']; + if ($this->_loadMedia && $self) { + $filepath = $filename; + } else { + $filepath = "{$settings['destination']}/{$filename}"; + + // For backwards compatibility we are always using relative path from the installation root. + if ($locator->isStream($filepath)) { + $filepath = $locator->findResource($filepath, false, true); + } + } + + // Special handling for original images. + if (strpos($field, '/original')) { + if ($this->_loadMedia && $self) { + $list_original[$filename] = [$file, $settings]; + } + continue; + } + + // Calculate path without the retina scaling factor. + $realpath = $filesystem->pathname($filepath) . str_replace(['@3x', '@2x'], '', Utils::basename($filepath)); + + $list[$filename] = [$file, $settings]; + + $path = str_replace('.', "\n", $field); + if (null !== $data) { + $data['name'] = $filename; + $data['path'] = $filepath; + + $this->setNestedProperty("{$path}\n{$realpath}", $data, "\n"); + } else { + $this->unsetNestedProperty("{$path}\n{$realpath}", "\n"); + } + } + } + + $this->clearMediaCache(); + + $this->_uploads = $list; + $this->_uploads_original = $list_original; + } + + protected function saveUpdatedMedia(): void + { + $media = $this->getMedia(); + if (!$media instanceof MediaUploadInterface) { + throw new RuntimeException('Internal error UO101'); + } + + // Upload/delete original sized images. + /** + * @var string $filename + * @var UploadedFileInterface|array|null $file + */ + foreach ($this->_uploads_original ?? [] as $filename => $file) { + $filename = 'original/' . $filename; + if (is_array($file)) { + [$file, $settings] = $file; + } else { + $settings = null; + } + if ($file instanceof UploadedFileInterface) { + $media->copyUploadedFile($file, $filename, $settings); + } else { + $media->deleteFile($filename, $settings); + } + } + + // Upload/delete altered files. + /** + * @var string $filename + * @var UploadedFileInterface|array|null $file + */ + foreach ($this->getUpdatedMedia() as $filename => $file) { + if (is_array($file)) { + [$file, $settings] = $file; + } else { + $settings = null; + } + if ($file instanceof UploadedFileInterface) { + $media->copyUploadedFile($file, $filename, $settings); + } else { + $media->deleteFile($filename, $settings); + } + } + + $this->setUpdatedMedia([]); + $this->clearMediaCache(); + } + + /** + * @return array + */ + protected function doSerialize(): array + { + return [ + 'type' => $this->getFlexType(), + 'key' => $this->getKey(), + 'elements' => $this->jsonSerialize(), + 'storage' => $this->getMetaData() + ]; + } + + /** + * @return UserGroupIndex + */ + protected function getUserGroups() + { + $grav = Grav::instance(); + + /** @var Flex $flex */ + $flex = $grav['flex']; + + /** @var UserGroupCollection|null $groups */ + $groups = $flex->getDirectory('user-groups'); + if ($groups) { + /** @var UserGroupIndex $index */ + $index = $groups->getIndex(); + + return $index; + } + + return $grav['user_groups']; + } + + /** + * @return UserGroupIndex + */ + protected function getGroups() + { + if (null === $this->_groups) { + /** @var UserGroupIndex $groups */ + $groups = $this->getUserGroups()->select((array)$this->getProperty('groups')); + $this->_groups = $groups; + } + + return $this->_groups; + } + + /** + * @return Access + */ + protected function getAccess(): Access + { + if (null === $this->_access) { + $this->_access = new Access($this->getProperty('access')); + } + + return $this->_access; + } + + /** + * @param mixed $value + * @return array + */ + protected function offsetLoad_access($value): array + { + if (!$value instanceof Access) { + $value = new Access($value); + } + + return $value->jsonSerialize(); + } + + /** + * @param mixed $value + * @return array + */ + protected function offsetPrepare_access($value): array + { + return $this->offsetLoad_access($value); + } + + /** + * @param array|null $value + * @return array|null + */ + protected function offsetSerialize_access(?array $value): ?array + { + return $value; + } +} diff --git a/system/src/Grav/Common/Form/FormFlash.php b/system/src/Grav/Common/Form/FormFlash.php new file mode 100644 index 0000000..24f9999 --- /dev/null +++ b/system/src/Grav/Common/Form/FormFlash.php @@ -0,0 +1,107 @@ +files as $field => $files) { + if (strpos($field, '/')) { + continue; + } + foreach ($files as $file) { + if (is_array($file)) { + $file['tmp_name'] = $this->getTmpDir() . '/' . $file['tmp_name']; + $fields[$field][$file['path'] ?? $file['name']] = $file; + } + } + } + + return $fields; + } + + /** + * @param string $field + * @param string $filename + * @param array $upload + * @return bool + * @deprecated 1.6 For backwards compatibility only, do not use + */ + public function uploadFile(string $field, string $filename, array $upload): bool + { + if (!$this->uniqueId) { + return false; + } + + $tmp_dir = $this->getTmpDir(); + Folder::create($tmp_dir); + + $tmp_file = $upload['file']['tmp_name']; + $basename = Utils::basename($tmp_file); + + if (!move_uploaded_file($tmp_file, $tmp_dir . '/' . $basename)) { + return false; + } + + $upload['file']['tmp_name'] = $basename; + $upload['file']['name'] = $filename; + + $this->addFileInternal($field, $filename, $upload['file']); + + return true; + } + + /** + * @param string $field + * @param string $filename + * @param array $upload + * @param array $crop + * @return bool + * @deprecated 1.6 For backwards compatibility only, do not use + */ + public function cropFile(string $field, string $filename, array $upload, array $crop): bool + { + if (!$this->uniqueId) { + return false; + } + + $tmp_dir = $this->getTmpDir(); + Folder::create($tmp_dir); + + $tmp_file = $upload['file']['tmp_name']; + $basename = Utils::basename($tmp_file); + + if (!move_uploaded_file($tmp_file, $tmp_dir . '/' . $basename)) { + return false; + } + + $upload['file']['tmp_name'] = $basename; + $upload['file']['name'] = $filename; + + $this->addFileInternal($field, $filename, $upload['file'], $crop); + + return true; + } +} diff --git a/system/src/Grav/Common/GPM/AbstractCollection.php b/system/src/Grav/Common/GPM/AbstractCollection.php new file mode 100644 index 0000000..ab3c2fb --- /dev/null +++ b/system/src/Grav/Common/GPM/AbstractCollection.php @@ -0,0 +1,41 @@ +toArray(), JSON_THROW_ON_ERROR); + } + + /** + * @return array + */ + public function toArray() + { + $items = []; + + foreach ($this->items as $name => $package) { + $items[$name] = $package->toArray(); + } + + return $items; + } +} diff --git a/system/src/Grav/Common/GPM/Common/AbstractPackageCollection.php b/system/src/Grav/Common/GPM/Common/AbstractPackageCollection.php new file mode 100644 index 0000000..5f69d37 --- /dev/null +++ b/system/src/Grav/Common/GPM/Common/AbstractPackageCollection.php @@ -0,0 +1,50 @@ +items as $name => $package) { + $items[$name] = $package->toArray(); + } + + return json_encode($items, JSON_THROW_ON_ERROR); + } + + /** + * @return array + */ + public function toArray() + { + $items = []; + + foreach ($this->items as $name => $package) { + $items[$name] = $package->toArray(); + } + + return $items; + } +} diff --git a/system/src/Grav/Common/GPM/Common/CachedCollection.php b/system/src/Grav/Common/GPM/Common/CachedCollection.php new file mode 100644 index 0000000..f93c76c --- /dev/null +++ b/system/src/Grav/Common/GPM/Common/CachedCollection.php @@ -0,0 +1,43 @@ + $item) { + $this->append([$name => $item]); + } + } +} diff --git a/system/src/Grav/Common/GPM/Common/Package.php b/system/src/Grav/Common/GPM/Common/Package.php new file mode 100644 index 0000000..2b359d1 --- /dev/null +++ b/system/src/Grav/Common/GPM/Common/Package.php @@ -0,0 +1,99 @@ +data = $package; + + if ($type) { + $this->data->set('package_type', $type); + } + } + + /** + * @return Data + */ + public function getData() + { + return $this->data; + } + + /** + * @param string $key + * @return mixed + */ + #[\ReturnTypeWillChange] + public function __get($key) + { + return $this->data->get($key); + } + + /** + * @param string $key + * @param mixed $value + * @return void + */ + #[\ReturnTypeWillChange] + public function __set($key, $value) + { + $this->data->set($key, $value); + } + + /** + * @param string $key + * @return bool + */ + #[\ReturnTypeWillChange] + public function __isset($key) + { + return isset($this->data->{$key}); + } + + /** + * @return string + */ + #[\ReturnTypeWillChange] + public function __toString() + { + return $this->toJson(); + } + + /** + * @return string + */ + public function toJson() + { + return $this->data->toJson(); + } + + /** + * @return array + */ + public function toArray() + { + return $this->data->toArray(); + } +} diff --git a/system/src/Grav/Common/GPM/GPM.php b/system/src/Grav/Common/GPM/GPM.php new file mode 100644 index 0000000..2f05a76 --- /dev/null +++ b/system/src/Grav/Common/GPM/GPM.php @@ -0,0 +1,1270 @@ + 'user/plugins/%name%', + 'themes' => 'user/themes/%name%', + 'skeletons' => 'user/' + ]; + + /** + * Creates a new GPM instance with Local and Remote packages available + * + * @param bool $refresh Applies to Remote Packages only and forces a refetch of data + * @param callable|null $callback Either a function or callback in array notation + */ + public function __construct($refresh = false, $callback = null) + { + parent::__construct(); + + Folder::create(CACHE_DIR . '/gpm'); + + $this->cache = []; + $this->installed = new Local\Packages(); + $this->refresh = $refresh; + $this->callback = $callback; + } + + /** + * Magic getter method + * + * @param string $offset Asset name value + * @return mixed Asset value + */ + #[\ReturnTypeWillChange] + public function __get($offset) + { + switch ($offset) { + case 'grav': + return $this->getGrav(); + } + + return parent::__get($offset); + } + + /** + * Magic method to determine if the attribute is set + * + * @param string $offset Asset name value + * @return bool True if the value is set + */ + #[\ReturnTypeWillChange] + public function __isset($offset) + { + switch ($offset) { + case 'grav': + return $this->getGrav() !== null; + } + + return parent::__isset($offset); + } + + /** + * Return the locally installed packages + * + * @return Local\Packages + */ + public function getInstalled() + { + return $this->installed; + } + + /** + * Returns the Locally installable packages + * + * @param array $list_type_installed + * @return array The installed packages + */ + public function getInstallable($list_type_installed = ['plugins' => true, 'themes' => true]) + { + $items = ['total' => 0]; + foreach ($list_type_installed as $type => $type_installed) { + if ($type_installed === false) { + continue; + } + $methodInstallableType = 'getInstalled' . ucfirst($type); + $to_install = $this->$methodInstallableType(); + $items[$type] = $to_install; + $items['total'] += count($to_install); + } + + return $items; + } + + /** + * Returns the amount of locally installed packages + * + * @return int Amount of installed packages + */ + public function countInstalled() + { + $installed = $this->getInstalled(); + + return count($installed['plugins']) + count($installed['themes']); + } + + /** + * Return the instance of a specific Package + * + * @param string $slug The slug of the Package + * @return Local\Package|null The instance of the Package + */ + public function getInstalledPackage($slug) + { + return $this->getInstalledPlugin($slug) ?? $this->getInstalledTheme($slug); + } + + /** + * Return the instance of a specific Plugin + * + * @param string $slug The slug of the Plugin + * @return Local\Package|null The instance of the Plugin + */ + public function getInstalledPlugin($slug) + { + return $this->installed['plugins'][$slug] ?? null; + } + + /** + * Returns the Locally installed plugins + * @return Iterator The installed plugins + */ + public function getInstalledPlugins() + { + return $this->installed['plugins']; + } + + + /** + * Returns the plugin's enabled state + * + * @param string $slug + * @return bool True if the Plugin is Enabled. False if manually set to enable:false. Null otherwise. + */ + public function isPluginEnabled($slug): bool + { + $grav = Grav::instance(); + + return ($grav['config']['plugins'][$slug]['enabled'] ?? false) === true; + } + + /** + * Checks if a Plugin is installed + * + * @param string $slug The slug of the Plugin + * @return bool True if the Plugin has been installed. False otherwise + */ + public function isPluginInstalled($slug): bool + { + return isset($this->installed['plugins'][$slug]); + } + + /** + * @param string $slug + * @return bool + */ + public function isPluginInstalledAsSymlink($slug) + { + $plugin = $this->getInstalledPlugin($slug); + + return (bool)($plugin->symlink ?? false); + } + + /** + * Return the instance of a specific Theme + * + * @param string $slug The slug of the Theme + * @return Local\Package|null The instance of the Theme + */ + public function getInstalledTheme($slug) + { + return $this->installed['themes'][$slug] ?? null; + } + + /** + * Returns the Locally installed themes + * + * @return Iterator The installed themes + */ + public function getInstalledThemes() + { + return $this->installed['themes']; + } + + /** + * Checks if a Theme is enabled + * + * @param string $slug The slug of the Theme + * @return bool True if the Theme has been set to the default theme. False if installed, but not enabled. Null otherwise. + */ + public function isThemeEnabled($slug): bool + { + $grav = Grav::instance(); + + $current_theme = $grav['config']['system']['pages']['theme'] ?? null; + + return $current_theme === $slug; + } + + /** + * Checks if a Theme is installed + * + * @param string $slug The slug of the Theme + * @return bool True if the Theme has been installed. False otherwise + */ + public function isThemeInstalled($slug): bool + { + return isset($this->installed['themes'][$slug]); + } + + /** + * Returns the amount of updates available + * + * @return int Amount of available updates + */ + public function countUpdates() + { + return count($this->getUpdatablePlugins()) + count($this->getUpdatableThemes()); + } + + /** + * Returns an array of Plugins and Themes that can be updated. + * Plugins and Themes are extended with the `available` property that relies to the remote version + * + * @param array $list_type_update specifies what type of package to update + * @return array Array of updatable Plugins and Themes. + * Format: ['total' => int, 'plugins' => array, 'themes' => array] + */ + public function getUpdatable($list_type_update = ['plugins' => true, 'themes' => true]) + { + $items = ['total' => 0]; + foreach ($list_type_update as $type => $type_updatable) { + if ($type_updatable === false) { + continue; + } + $methodUpdatableType = 'getUpdatable' . ucfirst($type); + $to_update = $this->$methodUpdatableType(); + $items[$type] = $to_update; + $items['total'] += count($to_update); + } + + return $items; + } + + /** + * Returns an array of Plugins that can be updated. + * The Plugins are extended with the `available` property that relies to the remote version + * + * @return array Array of updatable Plugins + */ + public function getUpdatablePlugins() + { + $items = []; + + $repository = $this->getRepository(); + if (null === $repository) { + return $items; + } + + $plugins = $repository['plugins']; + + // local cache to speed things up + if (isset($this->cache[__METHOD__])) { + return $this->cache[__METHOD__]; + } + + foreach ($this->installed['plugins'] as $slug => $plugin) { + if (!isset($plugins[$slug]) || $plugin->symlink || !$plugin->version || $plugin->gpm === false) { + continue; + } + + $local_version = $plugin->version ?? 'Unknown'; + $remote_version = $plugins[$slug]->version; + + if (version_compare($local_version, $remote_version) < 0) { + $plugins[$slug]->available = $remote_version; + $plugins[$slug]->version = $local_version; + $plugins[$slug]->type = $plugins[$slug]->release_type; + $items[$slug] = $plugins[$slug]; + } + } + + $this->cache[__METHOD__] = $items; + + return $items; + } + + /** + * Get the latest release of a package from the GPM + * + * @param string $package_name + * @return string|null + */ + public function getLatestVersionOfPackage($package_name) + { + $repository = $this->getRepository(); + if (null === $repository) { + return null; + } + + $plugins = $repository['plugins']; + if (isset($plugins[$package_name])) { + return $plugins[$package_name]->available ?: $plugins[$package_name]->version; + } + + //Not a plugin, it's a theme? + $themes = $repository['themes']; + if (isset($themes[$package_name])) { + return $themes[$package_name]->available ?: $themes[$package_name]->version; + } + + return null; + } + + /** + * Check if a Plugin or Theme is updatable + * + * @param string $slug The slug of the package + * @return bool True if updatable. False otherwise or if not found + */ + public function isUpdatable($slug) + { + return $this->isPluginUpdatable($slug) || $this->isThemeUpdatable($slug); + } + + /** + * Checks if a Plugin is updatable + * + * @param string $plugin The slug of the Plugin + * @return bool True if the Plugin is updatable. False otherwise + */ + public function isPluginUpdatable($plugin) + { + return array_key_exists($plugin, (array)$this->getUpdatablePlugins()); + } + + /** + * Returns an array of Themes that can be updated. + * The Themes are extended with the `available` property that relies to the remote version + * + * @return array Array of updatable Themes + */ + public function getUpdatableThemes() + { + $items = []; + + $repository = $this->getRepository(); + if (null === $repository) { + return $items; + } + + $themes = $repository['themes']; + + // local cache to speed things up + if (isset($this->cache[__METHOD__])) { + return $this->cache[__METHOD__]; + } + + foreach ($this->installed['themes'] as $slug => $plugin) { + if (!isset($themes[$slug]) || $plugin->symlink || !$plugin->version || $plugin->gpm === false) { + continue; + } + + $local_version = $plugin->version ?? 'Unknown'; + $remote_version = $themes[$slug]->version; + + if (version_compare($local_version, $remote_version) < 0) { + $themes[$slug]->available = $remote_version; + $themes[$slug]->version = $local_version; + $themes[$slug]->type = $themes[$slug]->release_type; + $items[$slug] = $themes[$slug]; + } + } + + $this->cache[__METHOD__] = $items; + + return $items; + } + + /** + * Checks if a Theme is Updatable + * + * @param string $theme The slug of the Theme + * @return bool True if the Theme is updatable. False otherwise + */ + public function isThemeUpdatable($theme) + { + return array_key_exists($theme, (array)$this->getUpdatableThemes()); + } + + /** + * Get the release type of a package (stable / testing) + * + * @param string $package_name + * @return string|null + */ + public function getReleaseType($package_name) + { + $repository = $this->getRepository(); + if (null === $repository) { + return null; + } + + $plugins = $repository['plugins']; + if (isset($plugins[$package_name])) { + return $plugins[$package_name]->release_type; + } + + //Not a plugin, it's a theme? + $themes = $repository['themes']; + if (isset($themes[$package_name])) { + return $themes[$package_name]->release_type; + } + + return null; + } + + /** + * Returns true if the package latest release is stable + * + * @param string $package_name + * @return bool + */ + public function isStableRelease($package_name) + { + return $this->getReleaseType($package_name) === 'stable'; + } + + /** + * Returns true if the package latest release is testing + * + * @param string $package_name + * @return bool + */ + public function isTestingRelease($package_name) + { + $package = $this->getInstalledPackage($package_name); + $testing = $package->testing ?? false; + + return $this->getReleaseType($package_name) === 'testing' || $testing; + } + + /** + * Returns a Plugin from the repository + * + * @param string $slug The slug of the Plugin + * @return Remote\Package|null Package if found, NULL if not + */ + public function getRepositoryPlugin($slug) + { + $packages = $this->getRepositoryPlugins(); + + return $packages ? ($packages[$slug] ?? null) : null; + } + + /** + * Returns the list of Plugins available in the repository + * + * @return Iterator|null The Plugins remotely available + */ + public function getRepositoryPlugins() + { + return $this->getRepository()['plugins'] ?? null; + } + + /** + * Returns a Theme from the repository + * + * @param string $slug The slug of the Theme + * @return Remote\Package|null Package if found, NULL if not + */ + public function getRepositoryTheme($slug) + { + $packages = $this->getRepositoryThemes(); + + return $packages ? ($packages[$slug] ?? null) : null; + } + + /** + * Returns the list of Themes available in the repository + * + * @return Iterator|null The Themes remotely available + */ + public function getRepositoryThemes() + { + return $this->getRepository()['themes'] ?? null; + } + + /** + * Returns the list of Plugins and Themes available in the repository + * + * @return Remote\Packages|null Available Plugins and Themes + * Format: ['plugins' => array, 'themes' => array] + */ + public function getRepository() + { + if (null === $this->repository) { + try { + $this->repository = new Remote\Packages($this->refresh, $this->callback); + } catch (Exception $e) {} + } + + return $this->repository; + } + + /** + * Returns Grav version available in the repository + * + * @return Remote\GravCore|null + */ + public function getGrav() + { + if (null === $this->grav) { + try { + $this->grav = new Remote\GravCore($this->refresh, $this->callback); + } catch (Exception $e) {} + } + + return $this->grav; + } + + /** + * Searches for a Package in the repository + * + * @param string $search Can be either the slug or the name + * @param bool $ignore_exception True if should not fire an exception (for use in Twig) + * @return Remote\Package|false Package if found, FALSE if not + */ + public function findPackage($search, $ignore_exception = false) + { + $search = strtolower($search); + + $found = $this->getRepositoryPlugin($search) ?? $this->getRepositoryTheme($search); + if ($found) { + return $found; + } + + $themes = $this->getRepositoryThemes(); + $plugins = $this->getRepositoryPlugins(); + + if (null === $themes || null === $plugins) { + if (!is_writable(GRAV_ROOT . '/cache/gpm')) { + throw new RuntimeException('The cache/gpm folder is not writable. Please check the folder permissions.'); + } + + if ($ignore_exception) { + return false; + } + + throw new RuntimeException('GPM not reachable. Please check your internet connection or check the Grav site is reachable'); + } + + foreach ($themes as $slug => $theme) { + if ($search === $slug || $search === $theme->name) { + return $theme; + } + } + + foreach ($plugins as $slug => $plugin) { + if ($search === $slug || $search === $plugin->name) { + return $plugin; + } + } + + return false; + } + + /** + * Download the zip package via the URL + * + * @param string $package_file + * @param string $tmp + * @return string|null + */ + public static function downloadPackage($package_file, $tmp) + { + $package = parse_url($package_file); + if (!is_array($package)) { + throw new \RuntimeException("Malformed GPM URL: {$package_file}"); + } + + $filename = Utils::basename($package['path'] ?? ''); + + if (Grav::instance()['config']->get('system.gpm.official_gpm_only') && ($package['host'] ?? null) !== 'getgrav.org') { + throw new RuntimeException('Only official GPM URLs are allowed. You can modify this behavior in the System configuration.'); + } + + $output = Response::get($package_file, []); + + if ($output) { + Folder::create($tmp); + file_put_contents($tmp . DS . $filename, $output); + return $tmp . DS . $filename; + } + + return null; + } + + /** + * Copy the local zip package to tmp + * + * @param string $package_file + * @param string $tmp + * @return string|null + */ + public static function copyPackage($package_file, $tmp) + { + $package_file = realpath($package_file); + + if ($package_file && file_exists($package_file)) { + $filename = Utils::basename($package_file); + Folder::create($tmp); + copy($package_file, $tmp . DS . $filename); + return $tmp . DS . $filename; + } + + return null; + } + + /** + * Try to guess the package type from the source files + * + * @param string $source + * @return string|false + */ + public static function getPackageType($source) + { + $plugin_regex = '/^class\\s{1,}[a-zA-Z0-9]{1,}\\s{1,}extends.+Plugin/m'; + $theme_regex = '/^class\\s{1,}[a-zA-Z0-9]{1,}\\s{1,}extends.+Theme/m'; + + if (file_exists($source . 'system/defines.php') && + file_exists($source . 'system/config/system.yaml') + ) { + return 'grav'; + } + + // must have a blueprint + if (!file_exists($source . 'blueprints.yaml')) { + return false; + } + + // either theme or plugin + $name = Utils::basename($source); + if (Utils::contains($name, 'theme')) { + return 'theme'; + } + if (Utils::contains($name, 'plugin')) { + return 'plugin'; + } + + $glob = glob($source . '*.php') ?: []; + foreach ($glob as $filename) { + $contents = file_get_contents($filename); + if (!$contents) { + continue; + } + if (preg_match($theme_regex, $contents)) { + return 'theme'; + } + if (preg_match($plugin_regex, $contents)) { + return 'plugin'; + } + } + + // Assume it's a theme + return 'theme'; + } + + /** + * Try to guess the package name from the source files + * + * @param string $source + * @return string|false + */ + public static function getPackageName($source) + { + $ignore_yaml_files = ['blueprints', 'languages']; + + $glob = glob($source . '*.yaml') ?: []; + foreach ($glob as $filename) { + $name = strtolower(Utils::basename($filename, '.yaml')); + if (in_array($name, $ignore_yaml_files)) { + continue; + } + + return $name; + } + + return false; + } + + /** + * Find/Parse the blueprint file + * + * @param string $source + * @return array|false + */ + public static function getBlueprints($source) + { + $blueprint_file = $source . 'blueprints.yaml'; + if (!file_exists($blueprint_file)) { + return false; + } + + $file = YamlFile::instance($blueprint_file); + $blueprint = (array)$file->content(); + $file->free(); + + return $blueprint; + } + + /** + * Get the install path for a name and a particular type of package + * + * @param string $type + * @param string $name + * @return string + */ + public static function getInstallPath($type, $name) + { + $locator = Grav::instance()['locator']; + + if ($type === 'theme') { + $install_path = $locator->findResource('themes://', false) . DS . $name; + } else { + $install_path = $locator->findResource('plugins://', false) . DS . $name; + } + + return $install_path; + } + + /** + * Searches for a list of Packages in the repository + * + * @param array $searches An array of either slugs or names + * @return array Array of found Packages + * Format: ['total' => int, 'not_found' => array, ] + */ + public function findPackages($searches = []) + { + $packages = ['total' => 0, 'not_found' => []]; + $inflector = new Inflector(); + + foreach ($searches as $search) { + $repository = ''; + // if this is an object, get the search data from the key + if (is_object($search)) { + $search = (array)$search; + $key = key($search); + $repository = $search[$key]; + $search = $key; + } + + $found = $this->findPackage($search); + if ($found) { + // set override repository if provided + if ($repository) { + $found->override_repository = $repository; + } + if (!isset($packages[$found->package_type])) { + $packages[$found->package_type] = []; + } + + $packages[$found->package_type][$found->slug] = $found; + $packages['total']++; + } else { + // make a best guess at the type based on the repo URL + if (Utils::contains($repository, '-theme')) { + $type = 'themes'; + } else { + $type = 'plugins'; + } + + $not_found = new stdClass(); + $not_found->name = $inflector::camelize($search); + $not_found->slug = $search; + $not_found->package_type = $type; + $not_found->install_path = str_replace('%name%', $search, $this->install_paths[$type]); + $not_found->override_repository = $repository; + $packages['not_found'][$search] = $not_found; + } + } + + return $packages; + } + + /** + * Return the list of packages that have the passed one as dependency + * + * @param string $slug The slug name of the package + * @return array + */ + public function getPackagesThatDependOnPackage($slug) + { + $plugins = $this->getInstalledPlugins(); + $themes = $this->getInstalledThemes(); + $packages = array_merge($plugins->toArray(), $themes->toArray()); + + $list = []; + foreach ($packages as $package_name => $package) { + $dependencies = $package['dependencies'] ?? []; + foreach ($dependencies as $dependency) { + if (is_array($dependency) && isset($dependency['name'])) { + $dependency = $dependency['name']; + } + + if ($dependency === $slug) { + $list[] = $package_name; + } + } + } + + return $list; + } + + + /** + * Get the required version of a dependency of a package + * + * @param string $package_slug + * @param string $dependency_slug + * @return mixed|null + */ + public function getVersionOfDependencyRequiredByPackage($package_slug, $dependency_slug) + { + $dependencies = $this->getInstalledPackage($package_slug)->dependencies ?? []; + foreach ($dependencies as $dependency) { + if (isset($dependency[$dependency_slug])) { + return $dependency[$dependency_slug]; + } + } + + return null; + } + + /** + * Check the package identified by $slug can be updated to the version passed as argument. + * Thrown an exception if it cannot be updated because another package installed requires it to be at an older version. + * + * @param string $slug + * @param string $version_with_operator + * @param array $ignore_packages_list + * @return bool + * @throws RuntimeException + */ + public function checkNoOtherPackageNeedsThisDependencyInALowerVersion($slug, $version_with_operator, $ignore_packages_list) + { + // check if any of the currently installed package need this in a lower version than the one we need. In case, abort and tell which package + $dependent_packages = $this->getPackagesThatDependOnPackage($slug); + $version = $this->calculateVersionNumberFromDependencyVersion($version_with_operator); + + if (count($dependent_packages)) { + foreach ($dependent_packages as $dependent_package) { + $other_dependency_version_with_operator = $this->getVersionOfDependencyRequiredByPackage($dependent_package, $slug); + $other_dependency_version = $this->calculateVersionNumberFromDependencyVersion($other_dependency_version_with_operator); + + // check version is compatible with the one needed by the current package + if ($this->versionFormatIsNextSignificantRelease($other_dependency_version_with_operator)) { + $compatible = $this->checkNextSignificantReleasesAreCompatible($version, $other_dependency_version); + if (!$compatible && !in_array($dependent_package, $ignore_packages_list, true)) { + throw new RuntimeException( + "Package $slug is required in an older version by package $dependent_package. This package needs a newer version, and because of this it cannot be installed. The $dependent_package package must be updated to use a newer release of $slug.", + 2 + ); + } + } + } + } + + return true; + } + + /** + * Check the passed packages list can be updated + * + * @param array $packages_names_list + * @return void + * @throws Exception + */ + public function checkPackagesCanBeInstalled($packages_names_list) + { + foreach ($packages_names_list as $package_name) { + $latest = $this->getLatestVersionOfPackage($package_name); + $this->checkNoOtherPackageNeedsThisDependencyInALowerVersion($package_name, $latest, $packages_names_list); + } + } + + /** + * Fetch the dependencies, check the installed packages and return an array with + * the list of packages with associated an information on what to do: install, update or ignore. + * + * `ignore` means the package is already installed and can be safely left as-is. + * `install` means the package is not installed and must be installed. + * `update` means the package is already installed and must be updated as a dependency needs a higher version. + * + * @param array $packages + * @return array + * @throws RuntimeException + */ + public function getDependencies($packages) + { + $dependencies = $this->calculateMergedDependenciesOfPackages($packages); + foreach ($dependencies as $dependency_slug => $dependencyVersionWithOperator) { + $dependency_slug = (string)$dependency_slug; + if (in_array($dependency_slug, $packages, true)) { + unset($dependencies[$dependency_slug]); + continue; + } + + // Check PHP version + if ($dependency_slug === 'php') { + $testVersion = $this->calculateVersionNumberFromDependencyVersion($dependencyVersionWithOperator); + if (version_compare($testVersion, PHP_VERSION) === 1) { + //Needs a Grav update first + throw new RuntimeException("One of the packages require PHP {$dependencies['php']}. Please update PHP to resolve this"); + } + + unset($dependencies[$dependency_slug]); + continue; + } + + //First, check for Grav dependency. If a dependency requires Grav > the current version, abort and tell. + if ($dependency_slug === 'grav') { + $testVersion = $this->calculateVersionNumberFromDependencyVersion($dependencyVersionWithOperator); + if (version_compare($testVersion, GRAV_VERSION) === 1) { + //Needs a Grav update first + throw new RuntimeException("One of the packages require Grav {$dependencies['grav']}. Please update Grav to the latest release."); + } + + unset($dependencies[$dependency_slug]); + continue; + } + + if ($this->isPluginInstalled($dependency_slug)) { + if ($this->isPluginInstalledAsSymlink($dependency_slug)) { + unset($dependencies[$dependency_slug]); + continue; + } + + $dependencyVersion = $this->calculateVersionNumberFromDependencyVersion($dependencyVersionWithOperator); + + // get currently installed version + $locator = Grav::instance()['locator']; + $blueprints_path = $locator->findResource('plugins://' . $dependency_slug . DS . 'blueprints.yaml'); + $file = YamlFile::instance($blueprints_path); + $package_yaml = $file->content(); + $file->free(); + $currentlyInstalledVersion = $package_yaml['version']; + + // if requirement is next significant release, check is compatible with currently installed version, might not be + if ($this->versionFormatIsNextSignificantRelease($dependencyVersionWithOperator) + && $this->firstVersionIsLower($dependencyVersion, $currentlyInstalledVersion)) { + $compatible = $this->checkNextSignificantReleasesAreCompatible($dependencyVersion, $currentlyInstalledVersion); + + if (!$compatible) { + throw new RuntimeException( + 'Dependency ' . $dependency_slug . ' is required in an older version than the one installed. This package must be updated. Please get in touch with its developer.', + 2 + ); + } + } + + //if I already have the latest release, remove the dependency + $latestRelease = $this->getLatestVersionOfPackage($dependency_slug); + + if ($this->firstVersionIsLower($latestRelease, $dependencyVersion)) { + //throw an exception if a required version cannot be found in the GPM yet + throw new RuntimeException( + 'Dependency ' . $package_yaml['name'] . ' is required in version ' . $dependencyVersion . ' which is higher than the latest release, ' . $latestRelease . '. Try running `bin/gpm -f index` to force a refresh of the GPM cache', + 1 + ); + } + + if ($this->firstVersionIsLower($currentlyInstalledVersion, $dependencyVersion)) { + $dependencies[$dependency_slug] = 'update'; + } elseif ($currentlyInstalledVersion === $latestRelease) { + unset($dependencies[$dependency_slug]); + } else { + // an update is not strictly required mark as 'ignore' + $dependencies[$dependency_slug] = 'ignore'; + } + } else { + $dependencyVersion = $this->calculateVersionNumberFromDependencyVersion($dependencyVersionWithOperator); + + // if requirement is next significant release, check is compatible with latest available version, might not be + if ($this->versionFormatIsNextSignificantRelease($dependencyVersionWithOperator)) { + $latestVersionOfPackage = $this->getLatestVersionOfPackage($dependency_slug); + if ($this->firstVersionIsLower($dependencyVersion, $latestVersionOfPackage)) { + $compatible = $this->checkNextSignificantReleasesAreCompatible( + $dependencyVersion, + $latestVersionOfPackage + ); + + if (!$compatible) { + throw new RuntimeException( + 'Dependency ' . $dependency_slug . ' is required in an older version than the latest release available, and it cannot be installed. This package must be updated. Please get in touch with its developer.', + 2 + ); + } + } + } + + $dependencies[$dependency_slug] = 'install'; + } + } + + $dependencies_slugs = array_keys($dependencies); + $this->checkNoOtherPackageNeedsTheseDependenciesInALowerVersion(array_merge($packages, $dependencies_slugs)); + + return $dependencies; + } + + /** + * @param array $dependencies_slugs + * @return void + */ + public function checkNoOtherPackageNeedsTheseDependenciesInALowerVersion($dependencies_slugs) + { + foreach ($dependencies_slugs as $dependency_slug) { + $this->checkNoOtherPackageNeedsThisDependencyInALowerVersion( + $dependency_slug, + $this->getLatestVersionOfPackage($dependency_slug), + $dependencies_slugs + ); + } + } + + /** + * @param string $firstVersion + * @param string $secondVersion + * @return bool + */ + private function firstVersionIsLower($firstVersion, $secondVersion) + { + return version_compare($firstVersion, $secondVersion) === -1; + } + + /** + * Calculates and merges the dependencies of a package + * + * @param string $packageName The package information + * @param array $dependencies The dependencies array + * @return array + */ + private function calculateMergedDependenciesOfPackage($packageName, $dependencies) + { + $packageData = $this->findPackage($packageName); + + if (empty($packageData->dependencies)) { + return $dependencies; + } + + foreach ($packageData->dependencies as $dependency) { + $dependencyName = $dependency['name'] ?? null; + if (!$dependencyName) { + continue; + } + + $dependencyVersion = $dependency['version'] ?? '*'; + + if (!isset($dependencies[$dependencyName])) { + // Dependency added for the first time + $dependencies[$dependencyName] = $dependencyVersion; + + //Factor in the package dependencies too + $dependencies = $this->calculateMergedDependenciesOfPackage($dependencyName, $dependencies); + } elseif ($dependencyVersion !== '*') { + // Dependency already added by another package + // If this package requires a version higher than the currently stored one, store this requirement instead + $currentDependencyVersion = $dependencies[$dependencyName]; + $currently_stored_version_number = $this->calculateVersionNumberFromDependencyVersion($currentDependencyVersion); + + $currently_stored_version_is_in_next_significant_release_format = false; + if ($this->versionFormatIsNextSignificantRelease($currentDependencyVersion)) { + $currently_stored_version_is_in_next_significant_release_format = true; + } + + if (!$currently_stored_version_number) { + $currently_stored_version_number = '*'; + } + + $current_package_version_number = $this->calculateVersionNumberFromDependencyVersion($dependencyVersion); + if (!$current_package_version_number) { + throw new RuntimeException("Bad format for version of dependency {$dependencyName} for package {$packageName}", 1); + } + + $current_package_version_is_in_next_significant_release_format = false; + if ($this->versionFormatIsNextSignificantRelease($dependencyVersion)) { + $current_package_version_is_in_next_significant_release_format = true; + } + + //If I had stored '*', change right away with the more specific version required + if ($currently_stored_version_number === '*') { + $dependencies[$dependencyName] = $dependencyVersion; + } elseif (!$currently_stored_version_is_in_next_significant_release_format && !$current_package_version_is_in_next_significant_release_format) { + //Comparing versions equals or higher, a simple version_compare is enough + if (version_compare($currently_stored_version_number, $current_package_version_number) === -1) { + //Current package version is higher + $dependencies[$dependencyName] = $dependencyVersion; + } + } else { + $compatible = $this->checkNextSignificantReleasesAreCompatible($currently_stored_version_number, $current_package_version_number); + if (!$compatible) { + throw new RuntimeException("Dependency {$dependencyName} is required in two incompatible versions", 2); + } + } + } + } + + return $dependencies; + } + + /** + * Calculates and merges the dependencies of the passed packages + * + * @param array $packages + * @return array + */ + public function calculateMergedDependenciesOfPackages($packages) + { + $dependencies = []; + + foreach ($packages as $package) { + $dependencies = $this->calculateMergedDependenciesOfPackage($package, $dependencies); + } + + return $dependencies; + } + + /** + * Returns the actual version from a dependency version string. + * Examples: + * $versionInformation == '~2.0' => returns '2.0' + * $versionInformation == '>=2.0.2' => returns '2.0.2' + * $versionInformation == '2.0.2' => returns '2.0.2' + * $versionInformation == '*' => returns null + * $versionInformation == '' => returns null + * + * @param string $version + * @return string|null + */ + public function calculateVersionNumberFromDependencyVersion($version) + { + if ($version === '*') { + return null; + } + if ($version === '') { + return null; + } + if ($this->versionFormatIsNextSignificantRelease($version)) { + return trim(substr($version, 1)); + } + if ($this->versionFormatIsEqualOrHigher($version)) { + return trim(substr($version, 2)); + } + + return $version; + } + + /** + * Check if the passed version information contains next significant release (tilde) operator + * + * Example: returns true for $version: '~2.0' + * + * @param string $version + * @return bool + */ + public function versionFormatIsNextSignificantRelease($version): bool + { + return strpos($version, '~') === 0; + } + + /** + * Check if the passed version information contains equal or higher operator + * + * Example: returns true for $version: '>=2.0' + * + * @param string $version + * @return bool + */ + public function versionFormatIsEqualOrHigher($version): bool + { + return strpos($version, '>=') === 0; + } + + /** + * Check if two releases are compatible by next significant release + * + * ~1.2 is equivalent to >=1.2 <2.0.0 + * ~1.2.3 is equivalent to >=1.2.3 <1.3.0 + * + * In short, allows the last digit specified to go up + * + * @param string $version1 the version string (e.g. '2.0.0' or '1.0') + * @param string $version2 the version string (e.g. '2.0.0' or '1.0') + * @return bool + */ + public function checkNextSignificantReleasesAreCompatible($version1, $version2): bool + { + $version1array = explode('.', $version1); + $version2array = explode('.', $version2); + + if (count($version1array) > count($version2array)) { + [$version1array, $version2array] = [$version2array, $version1array]; + } + + $i = 0; + while ($i < count($version1array) - 1) { + if ($version1array[$i] !== $version2array[$i]) { + return false; + } + $i++; + } + + return true; + } +} diff --git a/system/src/Grav/Common/GPM/Installer.php b/system/src/Grav/Common/GPM/Installer.php new file mode 100644 index 0000000..2987e4a --- /dev/null +++ b/system/src/Grav/Common/GPM/Installer.php @@ -0,0 +1,544 @@ + true, + 'ignore_symlinks' => true, + 'sophisticated' => false, + 'theme' => false, + 'install_path' => '', + 'ignores' => [], + 'exclude_checks' => [self::EXISTS, self::NOT_FOUND, self::IS_LINK] + ]; + + /** + * Installs a given package to a given destination. + * + * @param string $zip the local path to ZIP package + * @param string $destination The local path to the Grav Instance + * @param array $options Options to use for installing. ie, ['install_path' => 'user/themes/antimatter'] + * @param string|null $extracted The local path to the extacted ZIP package + * @param bool $keepExtracted True if you want to keep the original files + * @return bool True if everything went fine, False otherwise. + */ + public static function install($zip, $destination, $options = [], $extracted = null, $keepExtracted = false) + { + $destination = rtrim($destination, DS); + $options = array_merge(self::$options, $options); + $install_path = rtrim($destination . DS . ltrim($options['install_path'], DS), DS); + + if (!self::isGravInstance($destination) || !self::isValidDestination( + $install_path, + $options['exclude_checks'] + ) + ) { + return false; + } + + if ((self::lastErrorCode() === self::IS_LINK && $options['ignore_symlinks']) || + (self::lastErrorCode() === self::EXISTS && !$options['overwrite']) + ) { + return false; + } + + // Create a tmp location + $tmp_dir = Grav::instance()['locator']->findResource('tmp://', true, true); + $tmp = $tmp_dir . '/Grav-' . uniqid('', false); + + if (!$extracted) { + $extracted = self::unZip($zip, $tmp); + if (!$extracted) { + Folder::delete($tmp); + return false; + } + } + + if (!file_exists($extracted)) { + self::$error = self::INVALID_SOURCE; + return false; + } + + $is_install = true; + $installer = self::loadInstaller($extracted, $is_install); + + if (isset($options['is_update']) && $options['is_update'] === true) { + $method = 'preUpdate'; + } else { + $method = 'preInstall'; + } + + if ($installer && method_exists($installer, $method)) { + $method_result = $installer::$method(); + if ($method_result !== true) { + self::$error = 'An error occurred'; + if (is_string($method_result)) { + self::$error = $method_result; + } + + return false; + } + } + + if (!$options['sophisticated']) { + $isTheme = $options['theme'] ?? false; + // Make sure that themes are always being copied, even if option was not set! + $isTheme = $isTheme || preg_match('|/themes/[^/]+|ui', $install_path); + if ($isTheme) { + self::copyInstall($extracted, $install_path); + } else { + self::moveInstall($extracted, $install_path); + } + } else { + self::sophisticatedInstall($extracted, $install_path, $options['ignores'], $keepExtracted); + } + + Folder::delete($tmp); + + if (isset($options['is_update']) && $options['is_update'] === true) { + $method = 'postUpdate'; + } else { + $method = 'postInstall'; + } + + self::$message = ''; + if ($installer && method_exists($installer, $method)) { + self::$message = $installer::$method(); + } + + self::$error = self::OK; + + return true; + } + + /** + * Unzip a file to somewhere + * + * @param string $zip_file + * @param string $destination + * @return string|false + */ + public static function unZip($zip_file, $destination) + { + $zip = new ZipArchive(); + $archive = $zip->open($zip_file); + + if ($archive === true) { + Folder::create($destination); + + $unzip = $zip->extractTo($destination); + + + if (!$unzip) { + self::$error = self::ZIP_EXTRACT_ERROR; + Folder::delete($destination); + $zip->close(); + return false; + } + + $package_folder_name = $zip->getNameIndex(0); + if ($package_folder_name === false) { + throw new \RuntimeException('Bad package file: ' . Utils::basename($zip_file)); + } + $package_folder_name = preg_replace('#\./$#', '', $package_folder_name); + $zip->close(); + + return $destination . '/' . $package_folder_name; + } + + self::$error = self::ZIP_EXTRACT_ERROR; + self::$error_zip = $archive; + + return false; + } + + /** + * Instantiates and returns the package installer class + * + * @param string $installer_file_folder The folder path that contains install.php + * @param bool $is_install True if install, false if removal + * @return string|null + */ + private static function loadInstaller($installer_file_folder, $is_install) + { + $installer_file_folder = rtrim($installer_file_folder, DS); + + $install_file = $installer_file_folder . DS . 'install.php'; + + if (!file_exists($install_file)) { + return null; + } + + require_once $install_file; + + if ($is_install) { + $slug = ''; + if (($pos = strpos($installer_file_folder, 'grav-plugin-')) !== false) { + $slug = substr($installer_file_folder, $pos + strlen('grav-plugin-')); + } elseif (($pos = strpos($installer_file_folder, 'grav-theme-')) !== false) { + $slug = substr($installer_file_folder, $pos + strlen('grav-theme-')); + } + } else { + $path_elements = explode('/', $installer_file_folder); + $slug = end($path_elements); + } + + if (!$slug) { + return null; + } + + $class_name = ucfirst($slug) . 'Install'; + + if (class_exists($class_name)) { + return $class_name; + } + + $class_name_alphanumeric = preg_replace('/[^a-zA-Z0-9]+/', '', $class_name) ?? $class_name; + + if (class_exists($class_name_alphanumeric)) { + return $class_name_alphanumeric; + } + + return null; + } + + /** + * @param string $source_path + * @param string $install_path + * @return bool + */ + public static function moveInstall($source_path, $install_path) + { + if (file_exists($install_path)) { + Folder::delete($install_path); + } + + Folder::move($source_path, $install_path); + + return true; + } + + /** + * @param string $source_path + * @param string $install_path + * @return bool + */ + public static function copyInstall($source_path, $install_path) + { + if (empty($source_path)) { + throw new RuntimeException("Directory $source_path is missing"); + } + + Folder::rcopy($source_path, $install_path); + + return true; + } + + /** + * @param string $source_path + * @param string $install_path + * @param array $ignores + * @param bool $keep_source + * @return bool + */ + public static function sophisticatedInstall($source_path, $install_path, $ignores = [], $keep_source = false) + { + foreach (new DirectoryIterator($source_path) as $file) { + if ($file->isLink() || $file->isDot() || in_array($file->getFilename(), $ignores, true)) { + continue; + } + + $path = $install_path . DS . $file->getFilename(); + + if ($file->isDir()) { + Folder::delete($path); + if ($keep_source) { + Folder::copy($file->getPathname(), $path); + } else { + Folder::move($file->getPathname(), $path); + } + + if ($file->getFilename() === 'bin') { + $glob = glob($path . DS . '*') ?: []; + foreach ($glob as $bin_file) { + @chmod($bin_file, 0755); + } + } + } else { + @unlink($path); + @copy($file->getPathname(), $path); + } + } + + return true; + } + + /** + * Uninstalls one or more given package + * + * @param string $path The slug of the package(s) + * @param array $options Options to use for uninstalling + * @return bool True if everything went fine, False otherwise. + */ + public static function uninstall($path, $options = []) + { + $options = array_merge(self::$options, $options); + if (!self::isValidDestination($path, $options['exclude_checks']) + ) { + return false; + } + + $installer_file_folder = $path; + $is_install = false; + $installer = self::loadInstaller($installer_file_folder, $is_install); + + if ($installer && method_exists($installer, 'preUninstall')) { + $method_result = $installer::preUninstall(); + if ($method_result !== true) { + self::$error = 'An error occurred'; + if (is_string($method_result)) { + self::$error = $method_result; + } + + return false; + } + } + + $result = Folder::delete($path); + + self::$message = ''; + if ($result && $installer && method_exists($installer, 'postUninstall')) { + self::$message = $installer::postUninstall(); + } + + return $result; + } + + /** + * Runs a set of checks on the destination and sets the Error if any + * + * @param string $destination The directory to run validations at + * @param array $exclude An array of constants to exclude from the validation + * @return bool True if validation passed. False otherwise + */ + public static function isValidDestination($destination, $exclude = []) + { + self::$error = 0; + self::$target = $destination; + + if (is_link($destination)) { + self::$error = self::IS_LINK; + } elseif (file_exists($destination)) { + self::$error = self::EXISTS; + } elseif (!file_exists($destination)) { + self::$error = self::NOT_FOUND; + } elseif (!is_dir($destination)) { + self::$error = self::NOT_DIRECTORY; + } + + if (count($exclude) && in_array(self::$error, $exclude, true)) { + return true; + } + + return !self::$error; + } + + /** + * Validates if the given path is a Grav Instance + * + * @param string $target The local path to the Grav Instance + * @return bool True if is a Grav Instance. False otherwise + */ + public static function isGravInstance($target) + { + self::$error = 0; + self::$target = $target; + + if (!file_exists($target . DS . 'index.php') || + !file_exists($target . DS . 'bin') || + !file_exists($target . DS . 'user') || + !file_exists($target . DS . 'system' . DS . 'config' . DS . 'system.yaml') + ) { + self::$error = self::NOT_GRAV_ROOT; + } + + return !self::$error; + } + + /** + * Returns the last message added by the installer + * + * @return string The message + */ + public static function getMessage() + { + return self::$message; + } + + /** + * Returns the last error occurred in a string message format + * + * @return string The message of the last error + */ + public static function lastErrorMsg() + { + if (is_string(self::$error)) { + return self::$error; + } + + switch (self::$error) { + case 0: + $msg = 'No Error'; + break; + + case self::EXISTS: + $msg = 'The target path "' . self::$target . '" already exists'; + break; + + case self::IS_LINK: + $msg = 'The target path "' . self::$target . '" is a symbolic link'; + break; + + case self::NOT_FOUND: + $msg = 'The target path "' . self::$target . '" does not appear to exist'; + break; + + case self::NOT_DIRECTORY: + $msg = 'The target path "' . self::$target . '" does not appear to be a folder'; + break; + + case self::NOT_GRAV_ROOT: + $msg = 'The target path "' . self::$target . '" does not appear to be a Grav instance'; + break; + + case self::ZIP_OPEN_ERROR: + $msg = 'Unable to open the package file'; + break; + + case self::ZIP_EXTRACT_ERROR: + $msg = 'Unable to extract the package. '; + if (self::$error_zip) { + switch (self::$error_zip) { + case ZipArchive::ER_EXISTS: + $msg .= 'File already exists.'; + break; + + case ZipArchive::ER_INCONS: + $msg .= 'Zip archive inconsistent.'; + break; + + case ZipArchive::ER_MEMORY: + $msg .= 'Memory allocation failure.'; + break; + + case ZipArchive::ER_NOENT: + $msg .= 'No such file.'; + break; + + case ZipArchive::ER_NOZIP: + $msg .= 'Not a zip archive.'; + break; + + case ZipArchive::ER_OPEN: + $msg .= "Can't open file."; + break; + + case ZipArchive::ER_READ: + $msg .= 'Read error.'; + break; + + case ZipArchive::ER_SEEK: + $msg .= 'Seek error.'; + break; + } + } + break; + + case self::INVALID_SOURCE: + $msg = 'Invalid source file'; + break; + + default: + $msg = 'Unknown Error'; + break; + } + + return $msg; + } + + /** + * Returns the last error code of the occurred error + * + * @return int|string The code of the last error + */ + public static function lastErrorCode() + { + return self::$error; + } + + /** + * Allows to manually set an error + * + * @param int|string $error the Error code + * @return void + */ + public static function setError($error) + { + self::$error = $error; + } +} diff --git a/system/src/Grav/Common/GPM/Licenses.php b/system/src/Grav/Common/GPM/Licenses.php new file mode 100644 index 0000000..6f2cca9 --- /dev/null +++ b/system/src/Grav/Common/GPM/Licenses.php @@ -0,0 +1,116 @@ +content(); + $slug = strtolower($slug); + + if ($license && !self::validate($license)) { + return false; + } + + if (!is_string($license)) { + if (isset($data['licenses'][$slug])) { + unset($data['licenses'][$slug]); + } else { + return false; + } + } else { + $data['licenses'][$slug] = $license; + } + + $licenses->save($data); + $licenses->free(); + + return true; + } + + /** + * Returns the license for a Premium package + * + * @param string|null $slug + * @return string[]|string + */ + public static function get($slug = null) + { + $licenses = self::getLicenseFile(); + $data = (array)$licenses->content(); + $licenses->free(); + + if (null === $slug) { + return $data['licenses'] ?? []; + } + + $slug = strtolower($slug); + + return $data['licenses'][$slug] ?? ''; + } + + + /** + * Validates the License format + * + * @param string|null $license + * @return bool + */ + public static function validate($license = null) + { + if (!is_string($license)) { + return false; + } + + return (bool)preg_match('#' . self::$regex. '#', $license); + } + + /** + * Get the License File object + * + * @return FileInterface + */ + public static function getLicenseFile() + { + if (!isset(self::$file)) { + $path = Grav::instance()['locator']->findResource('user-data://') . '/licenses.yaml'; + if (!file_exists($path)) { + touch($path); + } + self::$file = CompiledYamlFile::instance($path); + } + + return self::$file; + } +} diff --git a/system/src/Grav/Common/GPM/Local/AbstractPackageCollection.php b/system/src/Grav/Common/GPM/Local/AbstractPackageCollection.php new file mode 100644 index 0000000..d5967c0 --- /dev/null +++ b/system/src/Grav/Common/GPM/Local/AbstractPackageCollection.php @@ -0,0 +1,34 @@ + $data) { + $data->set('slug', $name); + $this->items[$name] = new Package($data, $this->type); + } + } +} diff --git a/system/src/Grav/Common/GPM/Local/Package.php b/system/src/Grav/Common/GPM/Local/Package.php new file mode 100644 index 0000000..53b249a --- /dev/null +++ b/system/src/Grav/Common/GPM/Local/Package.php @@ -0,0 +1,51 @@ +blueprints()->toArray()); + parent::__construct($data, $package_type); + + $this->settings = $package->toArray(); + + $html_description = Parsedown::instance()->line($this->__get('description')); + $this->data->set('slug', $package->__get('slug')); + $this->data->set('description_html', $html_description); + $this->data->set('description_plain', strip_tags($html_description)); + $this->data->set('symlink', is_link(USER_DIR . $package_type . DS . $this->__get('slug'))); + } + + /** + * @return bool + */ + public function isEnabled() + { + return (bool)$this->settings['enabled']; + } +} diff --git a/system/src/Grav/Common/GPM/Local/Packages.php b/system/src/Grav/Common/GPM/Local/Packages.php new file mode 100644 index 0000000..fb68977 --- /dev/null +++ b/system/src/Grav/Common/GPM/Local/Packages.php @@ -0,0 +1,29 @@ + new Plugins(), + 'themes' => new Themes() + ]; + + parent::__construct($items); + } +} diff --git a/system/src/Grav/Common/GPM/Local/Plugins.php b/system/src/Grav/Common/GPM/Local/Plugins.php new file mode 100644 index 0000000..3fa7bbd --- /dev/null +++ b/system/src/Grav/Common/GPM/Local/Plugins.php @@ -0,0 +1,33 @@ +all()); + } +} diff --git a/system/src/Grav/Common/GPM/Local/Themes.php b/system/src/Grav/Common/GPM/Local/Themes.php new file mode 100644 index 0000000..7c056a7 --- /dev/null +++ b/system/src/Grav/Common/GPM/Local/Themes.php @@ -0,0 +1,33 @@ +all()); + } +} diff --git a/system/src/Grav/Common/GPM/Remote/AbstractPackageCollection.php b/system/src/Grav/Common/GPM/Remote/AbstractPackageCollection.php new file mode 100644 index 0000000..077fcd2 --- /dev/null +++ b/system/src/Grav/Common/GPM/Remote/AbstractPackageCollection.php @@ -0,0 +1,81 @@ +get('system.gpm.releases', 'stable'); + $cache_dir = Grav::instance()['locator']->findResource('cache://gpm', true, true); + $this->cache = new FilesystemCache($cache_dir); + + $this->repository = $repository . '?v=' . GRAV_VERSION . '&' . $channel . '=1'; + $this->raw = $this->cache->fetch(md5($this->repository)); + + $this->fetch($refresh, $callback); + foreach (json_decode($this->raw, true) as $slug => $data) { + // Temporarily fix for using multi-sites + if (isset($data['install_path'])) { + $path = preg_replace('~^user/~i', 'user://', $data['install_path']); + $data['install_path'] = Grav::instance()['locator']->findResource($path, false, true); + } + $this->items[$slug] = new Package($data, $this->type); + } + } + + /** + * @param bool $refresh + * @param callable|null $callback + * @return string + */ + public function fetch($refresh = false, $callback = null) + { + if (!$this->raw || $refresh) { + $response = Response::get($this->repository, [], $callback); + $this->raw = $response; + $this->cache->save(md5($this->repository), $this->raw, $this->lifetime); + } + + return $this->raw; + } +} diff --git a/system/src/Grav/Common/GPM/Remote/GravCore.php b/system/src/Grav/Common/GPM/Remote/GravCore.php new file mode 100644 index 0000000..d97eb83 --- /dev/null +++ b/system/src/Grav/Common/GPM/Remote/GravCore.php @@ -0,0 +1,151 @@ +get('system.gpm.releases', 'stable'); + $cache_dir = Grav::instance()['locator']->findResource('cache://gpm', true, true); + $this->cache = new FilesystemCache($cache_dir); + $this->repository .= '?v=' . GRAV_VERSION . '&' . $channel . '=1'; + $this->raw = $this->cache->fetch(md5($this->repository)); + + $this->fetch($refresh, $callback); + + $this->data = json_decode($this->raw, true); + $this->version = $this->data['version'] ?? '-'; + $this->date = $this->data['date'] ?? '-'; + $this->min_php = $this->data['min_php'] ?? null; + + if (isset($this->data['assets'])) { + foreach ((array)$this->data['assets'] as $slug => $data) { + $this->items[$slug] = new Package($data); + } + } + } + + /** + * Returns the list of assets associated to the latest version of Grav + * + * @return array list of assets + */ + public function getAssets() + { + return $this->data['assets']; + } + + /** + * Returns the changelog list for each version of Grav + * + * @param string|null $diff the version number to start the diff from + * @return array changelog list for each version + */ + public function getChangelog($diff = null) + { + if (!$diff) { + return $this->data['changelog']; + } + + $diffLog = []; + foreach ((array)$this->data['changelog'] as $version => $changelog) { + preg_match("/[\w\-\.]+/", $version, $cleanVersion); + + if (!$cleanVersion || version_compare($diff, $cleanVersion[0], '>=')) { + continue; + } + + $diffLog[$version] = $changelog; + } + + return $diffLog; + } + + /** + * Return the release date of the latest Grav + * + * @return string + */ + public function getDate() + { + return $this->date; + } + + /** + * Determine if this version of Grav is eligible to be updated + * + * @return mixed + */ + public function isUpdatable() + { + return version_compare(GRAV_VERSION, $this->getVersion(), '<'); + } + + /** + * Returns the latest version of Grav available remotely + * + * @return string + */ + public function getVersion() + { + return $this->version; + } + + /** + * Returns the minimum PHP version + * + * @return string + */ + public function getMinPHPVersion() + { + // If non min set, assume current PHP version + if (null === $this->min_php) { + $this->min_php = PHP_VERSION; + } + + return $this->min_php; + } + + /** + * Is this installation symlinked? + * + * @return bool + */ + public function isSymlink() + { + return is_link(GRAV_ROOT . DS . 'index.php'); + } +} diff --git a/system/src/Grav/Common/GPM/Remote/Package.php b/system/src/Grav/Common/GPM/Remote/Package.php new file mode 100644 index 0000000..bf839b0 --- /dev/null +++ b/system/src/Grav/Common/GPM/Remote/Package.php @@ -0,0 +1,66 @@ +data->toArray(); + } + + /** + * Returns the changelog list for each version of a package + * + * @param string|null $diff the version number to start the diff from + * @return array changelog list for each version + */ + public function getChangelog($diff = null) + { + if (!$diff) { + return $this->data['changelog']; + } + + $diffLog = []; + foreach ((array)$this->data['changelog'] as $version => $changelog) { + preg_match("/[\w\-.]+/", $version, $cleanVersion); + + if (!$cleanVersion || version_compare($diff, $cleanVersion[0], '>=')) { + continue; + } + + $diffLog[$version] = $changelog; + } + + return $diffLog; + } +} diff --git a/system/src/Grav/Common/GPM/Remote/Packages.php b/system/src/Grav/Common/GPM/Remote/Packages.php new file mode 100644 index 0000000..e7457e1 --- /dev/null +++ b/system/src/Grav/Common/GPM/Remote/Packages.php @@ -0,0 +1,34 @@ + new Plugins($refresh, $callback), + 'themes' => new Themes($refresh, $callback) + ]; + + parent::__construct($items); + } +} diff --git a/system/src/Grav/Common/GPM/Remote/Plugins.php b/system/src/Grav/Common/GPM/Remote/Plugins.php new file mode 100644 index 0000000..4d30af9 --- /dev/null +++ b/system/src/Grav/Common/GPM/Remote/Plugins.php @@ -0,0 +1,32 @@ +repository, $refresh, $callback); + } +} diff --git a/system/src/Grav/Common/GPM/Remote/Themes.php b/system/src/Grav/Common/GPM/Remote/Themes.php new file mode 100644 index 0000000..d386e1e --- /dev/null +++ b/system/src/Grav/Common/GPM/Remote/Themes.php @@ -0,0 +1,32 @@ +repository, $refresh, $callback); + } +} diff --git a/system/src/Grav/Common/GPM/Response.php b/system/src/Grav/Common/GPM/Response.php new file mode 100644 index 0000000..98654b6 --- /dev/null +++ b/system/src/Grav/Common/GPM/Response.php @@ -0,0 +1,3 @@ +remote = new Remote\GravCore($refresh, $callback); + } + + /** + * Returns the release date of the latest version of Grav + * + * @return string + */ + public function getReleaseDate() + { + return $this->remote->getDate(); + } + + /** + * Returns the version of the installed Grav + * + * @return string + */ + public function getLocalVersion() + { + return GRAV_VERSION; + } + + /** + * Returns the version of the remotely available Grav + * + * @return string + */ + public function getRemoteVersion() + { + return $this->remote->getVersion(); + } + + /** + * Returns an array of assets available to download remotely + * + * @return array + */ + public function getAssets() + { + return $this->remote->getAssets(); + } + + /** + * Returns the changelog list for each version of Grav + * + * @param string|null $diff the version number to start the diff from + * @return array return the changelog list for each version + */ + public function getChangelog($diff = null) + { + return $this->remote->getChangelog($diff); + } + + /** + * Make sure this meets minimum PHP requirements + * + * @return bool + */ + public function meetsRequirements() + { + if (version_compare(PHP_VERSION, $this->minPHPVersion(), '<')) { + return false; + } + + return true; + } + + /** + * Get minimum PHP version from remote + * + * @return string + */ + public function minPHPVersion() + { + if (null === $this->min_php) { + $this->min_php = $this->remote->getMinPHPVersion(); + } + + return $this->min_php; + } + + /** + * Checks if the currently installed Grav is upgradable to a newer version + * + * @return bool True if it's upgradable, False otherwise. + */ + public function isUpgradable() + { + return version_compare($this->getLocalVersion(), $this->getRemoteVersion(), '<'); + } + + /** + * Checks if Grav is currently symbolically linked + * + * @return bool True if Grav is symlinked, False otherwise. + */ + public function isSymlink() + { + return $this->remote->isSymlink(); + } +} diff --git a/system/src/Grav/Common/Getters.php b/system/src/Grav/Common/Getters.php new file mode 100644 index 0000000..aca39bc --- /dev/null +++ b/system/src/Grav/Common/Getters.php @@ -0,0 +1,170 @@ +offsetSet($offset, $value); + } + + /** + * Magic getter method + * + * @param int|string $offset Medium name value + * @return mixed Medium value + */ + #[\ReturnTypeWillChange] + public function __get($offset) + { + return $this->offsetGet($offset); + } + + /** + * Magic method to determine if the attribute is set + * + * @param int|string $offset Medium name value + * @return boolean True if the value is set + */ + #[\ReturnTypeWillChange] + public function __isset($offset) + { + return $this->offsetExists($offset); + } + + /** + * Magic method to unset the attribute + * + * @param int|string $offset The name value to unset + */ + #[\ReturnTypeWillChange] + public function __unset($offset) + { + $this->offsetUnset($offset); + } + + /** + * @param int|string $offset + * @return bool + */ + #[\ReturnTypeWillChange] + public function offsetExists($offset) + { + if ($this->gettersVariable) { + $var = $this->gettersVariable; + + return isset($this->{$var}[$offset]); + } + + return isset($this->{$offset}); + } + + /** + * @param int|string $offset + * @return mixed + */ + #[\ReturnTypeWillChange] + public function offsetGet($offset) + { + if ($this->gettersVariable) { + $var = $this->gettersVariable; + + return $this->{$var}[$offset] ?? null; + } + + return $this->{$offset} ?? null; + } + + /** + * @param int|string $offset + * @param mixed $value + */ + #[\ReturnTypeWillChange] + public function offsetSet($offset, $value) + { + if ($this->gettersVariable) { + $var = $this->gettersVariable; + $this->{$var}[$offset] = $value; + } else { + $this->{$offset} = $value; + } + } + + /** + * @param int|string $offset + */ + #[\ReturnTypeWillChange] + public function offsetUnset($offset) + { + if ($this->gettersVariable) { + $var = $this->gettersVariable; + unset($this->{$var}[$offset]); + } else { + unset($this->{$offset}); + } + } + + /** + * @return int + */ + #[\ReturnTypeWillChange] + public function count() + { + if ($this->gettersVariable) { + $var = $this->gettersVariable; + return count($this->{$var}); + } + + return count($this->toArray()); + } + + /** + * Returns an associative array of object properties. + * + * @return array + */ + public function toArray() + { + if ($this->gettersVariable) { + $var = $this->gettersVariable; + + return $this->{$var}; + } + + $properties = (array)$this; + $list = []; + foreach ($properties as $property => $value) { + if ($property[0] !== "\0") { + $list[$property] = $value; + } + } + + return $list; + } +} diff --git a/system/src/Grav/Common/Grav.php b/system/src/Grav/Common/Grav.php new file mode 100644 index 0000000..5f879ca --- /dev/null +++ b/system/src/Grav/Common/Grav.php @@ -0,0 +1,829 @@ + Browser::class, + 'cache' => Cache::class, + 'events' => EventDispatcher::class, + 'exif' => Exif::class, + 'plugins' => Plugins::class, + 'scheduler' => Scheduler::class, + 'taxonomy' => Taxonomy::class, + 'themes' => Themes::class, + 'twig' => Twig::class, + 'uri' => Uri::class, + ]; + + /** + * @var array All middleware processors that are processed in $this->process() + */ + protected $middleware = [ + 'multipartRequestSupport', + 'initializeProcessor', + 'pluginsProcessor', + 'themesProcessor', + 'requestProcessor', + 'tasksProcessor', + 'backupsProcessor', + 'schedulerProcessor', + 'assetsProcessor', + 'twigProcessor', + 'pagesProcessor', + 'debuggerAssetsProcessor', + 'renderProcessor', + ]; + + /** @var array */ + protected $initialized = []; + + /** + * Reset the Grav instance. + * + * @return void + */ + public static function resetInstance(): void + { + if (self::$instance) { + // @phpstan-ignore-next-line + self::$instance = null; + } + } + + /** + * Return the Grav instance. Create it if it's not already instanced + * + * @param array $values + * @return Grav + */ + public static function instance(array $values = []) + { + if (null === self::$instance) { + self::$instance = static::load($values); + + /** @var ClassLoader|null $loader */ + $loader = self::$instance['loader'] ?? null; + if ($loader) { + // Load fix for Deferred Twig Extension + $loader->addPsr4('Phive\\Twig\\Extensions\\Deferred\\', LIB_DIR . 'Phive/Twig/Extensions/Deferred/', true); + } + } elseif ($values) { + $instance = self::$instance; + foreach ($values as $key => $value) { + $instance->offsetSet($key, $value); + } + } + + return self::$instance; + } + + /** + * Get Grav version. + * + * @return string + */ + public function getVersion(): string + { + return GRAV_VERSION; + } + + /** + * @return bool + */ + public function isSetup(): bool + { + return isset($this->initialized['setup']); + } + + /** + * Setup Grav instance using specific environment. + * + * @param string|null $environment + * @return $this + */ + public function setup(string $environment = null) + { + if (isset($this->initialized['setup'])) { + return $this; + } + + $this->initialized['setup'] = true; + + // Force environment if passed to the method. + if ($environment) { + Setup::$environment = $environment; + } + + // Initialize setup and streams. + $this['setup']; + $this['streams']; + + return $this; + } + + /** + * Initialize CLI environment. + * + * Call after `$grav->setup($environment)` + * + * - Load configuration + * - Initialize logger + * - Disable debugger + * - Set timezone, locale + * - Load plugins (call PluginsLoadedEvent) + * - Set Pages and Users type to be used in the site + * + * This method WILL NOT initialize assets, twig or pages. + * + * @return $this + */ + public function initializeCli() + { + InitializeProcessor::initializeCli($this); + + return $this; + } + + /** + * Process a request + * + * @return void + */ + public function process(): void + { + if (isset($this->initialized['process'])) { + return; + } + + // Initialize Grav if needed. + $this->setup(); + + $this->initialized['process'] = true; + + $container = new Container( + [ + 'multipartRequestSupport' => function () { + return new MultipartRequestSupport(); + }, + 'initializeProcessor' => function () { + return new InitializeProcessor($this); + }, + 'backupsProcessor' => function () { + return new BackupsProcessor($this); + }, + 'pluginsProcessor' => function () { + return new PluginsProcessor($this); + }, + 'themesProcessor' => function () { + return new ThemesProcessor($this); + }, + 'schedulerProcessor' => function () { + return new SchedulerProcessor($this); + }, + 'requestProcessor' => function () { + return new RequestProcessor($this); + }, + 'tasksProcessor' => function () { + return new TasksProcessor($this); + }, + 'assetsProcessor' => function () { + return new AssetsProcessor($this); + }, + 'twigProcessor' => function () { + return new TwigProcessor($this); + }, + 'pagesProcessor' => function () { + return new PagesProcessor($this); + }, + 'debuggerAssetsProcessor' => function () { + return new DebuggerAssetsProcessor($this); + }, + 'renderProcessor' => function () { + return new RenderProcessor($this); + }, + ] + ); + + $default = static function () { + return new Response(404, ['Expires' => 0, 'Cache-Control' => 'no-store, max-age=0'], 'Not Found'); + }; + + $collection = new RequestHandler($this->middleware, $default, $container); + + $response = $collection->handle($this['request']); + $body = $response->getBody(); + + /** @var Messages $messages */ + $messages = $this['messages']; + + // Prevent caching if session messages were displayed in the page. + $noCache = $messages->isCleared(); + if ($noCache) { + $response = $response->withHeader('Cache-Control', 'no-store, max-age=0'); + } + + // Handle ETag and If-None-Match headers. + if ($response->getHeaderLine('ETag') === '1') { + $etag = md5($body); + $response = $response->withHeader('ETag', '"' . $etag . '"'); + + $search = trim($this['request']->getHeaderLine('If-None-Match'), '"'); + if ($noCache === false && $search === $etag) { + $response = $response->withStatus(304); + $body = ''; + } + } + + // Echo page content. + $this->header($response); + echo $body; + + $this['debugger']->render(); + + // Response object can turn off all shutdown processing. This can be used for example to speed up AJAX responses. + // Note that using this feature will also turn off response compression. + if ($response->getHeaderLine('Grav-Internal-SkipShutdown') !== '1') { + register_shutdown_function([$this, 'shutdown']); + } + } + + /** + * Clean any output buffers. Useful when exiting from the application. + * + * Please use $grav->close() and $grav->redirect() instead of calling this one! + * + * @return void + */ + public function cleanOutputBuffers(): void + { + // Make sure nothing extra gets written to the response. + while (ob_get_level()) { + ob_end_clean(); + } + // Work around PHP bug #8218 (8.0.17 & 8.1.4). + header_remove('Content-Encoding'); + } + + /** + * Terminates Grav request with a response. + * + * Please use this method instead of calling `die();` or `exit();`. Note that you need to create a response object. + * + * @param ResponseInterface $response + * @return never-return + */ + public function close(ResponseInterface $response): void + { + $this->cleanOutputBuffers(); + + // Close the session. + if (isset($this['session'])) { + $this['session']->close(); + } + + /** @var ServerRequestInterface $request */ + $request = $this['request']; + + /** @var Debugger $debugger */ + $debugger = $this['debugger']; + $response = $debugger->logRequest($request, $response); + + $body = $response->getBody(); + + /** @var Messages $messages */ + $messages = $this['messages']; + + // Prevent caching if session messages were displayed in the page. + $noCache = $messages->isCleared(); + if ($noCache) { + $response = $response->withHeader('Cache-Control', 'no-store, max-age=0'); + } + + // Handle ETag and If-None-Match headers. + if ($response->getHeaderLine('ETag') === '1') { + $etag = md5($body); + $response = $response->withHeader('ETag', '"' . $etag . '"'); + + $search = trim($this['request']->getHeaderLine('If-None-Match'), '"'); + if ($noCache === false && $search === $etag) { + $response = $response->withStatus(304); + $body = ''; + } + } + + // Echo page content. + $this->header($response); + echo $body; + exit(); + } + + /** + * @param ResponseInterface $response + * @return never-return + * @deprecated 1.7 Use $grav->close() instead. + */ + public function exit(ResponseInterface $response): void + { + $this->close($response); + } + + /** + * Terminates Grav request and redirects browser to another location. + * + * Please use this method instead of calling `header("Location: {$url}", true, 302); exit();`. + * + * @param Route|string $route Internal route. + * @param int|null $code Redirection code (30x) + * @return never-return + */ + public function redirect($route, $code = null): void + { + $response = $this->getRedirectResponse($route, $code); + + $this->close($response); + } + + /** + * Returns redirect response object from Grav. + * + * @param Route|string $route Internal route. + * @param int|null $code Redirection code (30x) + * @return ResponseInterface + */ + public function getRedirectResponse($route, $code = null): ResponseInterface + { + /** @var Uri $uri */ + $uri = $this['uri']; + + if (is_string($route)) { + // Clean route for redirect + $route = preg_replace("#^\/[\\\/]+\/#", '/', $route); + + if (null === $code) { + // Check for redirect code in the route: e.g. /new/[301], /new[301]/route or /new[301].html + $regex = '/.*(\[(30[1-7])\])(.\w+|\/.*?)?$/'; + preg_match($regex, $route, $matches); + if ($matches) { + $route = str_replace($matches[1], '', $matches[0]); + $code = $matches[2]; + } + } + + if ($uri::isExternal($route)) { + $url = $route; + } else { + $url = rtrim($uri->rootUrl(), '/') . '/'; + + if ($this['config']->get('system.pages.redirect_trailing_slash', true)) { + $url .= trim($route, '/'); // Remove trailing slash + } else { + $url .= ltrim($route, '/'); // Support trailing slash default routes + } + } + } elseif ($route instanceof Route) { + $url = $route->toString(true); + } else { + throw new InvalidArgumentException('Bad $route'); + } + + if ($code < 300 || $code > 399) { + $code = null; + } + + if ($code === null) { + $code = $this['config']->get('system.pages.redirect_default_code', 302); + } + + if ($uri->extension() === 'json') { + return new Response(200, ['Content-Type' => 'application/json'], json_encode(['code' => $code, 'redirect' => $url], JSON_THROW_ON_ERROR)); + } + + return new Response($code, ['Location' => $url]); + } + + /** + * Redirect browser to another location taking language into account (preferred) + * + * @param string $route Internal route. + * @param int $code Redirection code (30x) + * @return void + */ + public function redirectLangSafe($route, $code = null): void + { + if (!$this['uri']->isExternal($route)) { + $this->redirect($this['pages']->route($route), $code); + } else { + $this->redirect($route, $code); + } + } + + /** + * Set response header. + * + * @param ResponseInterface|null $response + * @return void + */ + public function header(ResponseInterface $response = null): void + { + if (null === $response) { + /** @var PageInterface $page */ + $page = $this['page']; + $response = new Response($page->httpResponseCode(), $page->httpHeaders(), ''); + } + + header("HTTP/{$response->getProtocolVersion()} {$response->getStatusCode()} {$response->getReasonPhrase()}"); + foreach ($response->getHeaders() as $key => $values) { + // Skip internal Grav headers. + if (strpos($key, 'Grav-Internal-') === 0) { + continue; + } + foreach ($values as $i => $value) { + header($key . ': ' . $value, $i === 0); + } + } + } + + /** + * Set the system locale based on the language and configuration + * + * @return void + */ + public function setLocale(): void + { + // Initialize Locale if set and configured. + if ($this['language']->enabled() && $this['config']->get('system.languages.override_locale')) { + $language = $this['language']->getLanguage(); + setlocale(LC_ALL, strlen($language) < 3 ? ($language . '_' . strtoupper($language)) : $language); + } elseif ($this['config']->get('system.default_locale')) { + setlocale(LC_ALL, $this['config']->get('system.default_locale')); + } + } + + /** + * @param object $event + * @return object + */ + public function dispatchEvent($event) + { + /** @var EventDispatcherInterface $events */ + $events = $this['events']; + $eventName = get_class($event); + + $timestamp = microtime(true); + $event = $events->dispatch($event); + + /** @var Debugger $debugger */ + $debugger = $this['debugger']; + $debugger->addEvent($eventName, $event, $events, $timestamp); + + return $event; + } + + /** + * Fires an event with optional parameters. + * + * @param string $eventName + * @param Event|null $event + * @return Event + */ + public function fireEvent($eventName, Event $event = null) + { + /** @var EventDispatcherInterface $events */ + $events = $this['events']; + if (null === $event) { + $event = new Event(); + } + + $timestamp = microtime(true); + $events->dispatch($event, $eventName); + + /** @var Debugger $debugger */ + $debugger = $this['debugger']; + $debugger->addEvent($eventName, $event, $events, $timestamp); + + return $event; + } + + /** + * Set the final content length for the page and flush the buffer + * + * @return void + */ + public function shutdown(): void + { + // Prevent user abort allowing onShutdown event to run without interruptions. + if (function_exists('ignore_user_abort')) { + @ignore_user_abort(true); + } + + // Close the session allowing new requests to be handled. + if (isset($this['session'])) { + $this['session']->close(); + } + + /** @var Config $config */ + $config = $this['config']; + if ($config->get('system.debugger.shutdown.close_connection', true)) { + // Flush the response and close the connection to allow time consuming tasks to be performed without leaving + // the connection to the client open. This will make page loads to feel much faster. + + // FastCGI allows us to flush all response data to the client and finish the request. + $success = function_exists('fastcgi_finish_request') ? @fastcgi_finish_request() : false; + if (!$success) { + // Unfortunately without FastCGI there is no way to force close the connection. + // We need to ask browser to close the connection for us. + + if ($config->get('system.cache.gzip')) { + // Flush gzhandler buffer if gzip setting was enabled to get the size of the compressed output. + ob_end_flush(); + } elseif ($config->get('system.cache.allow_webserver_gzip')) { + // Let web server to do the hard work. + header('Content-Encoding: identity'); + } elseif (function_exists('apache_setenv')) { + // Without gzip we have no other choice than to prevent server from compressing the output. + // This action turns off mod_deflate which would prevent us from closing the connection. + @apache_setenv('no-gzip', '1'); + } else { + // Fall back to unknown content encoding, it prevents most servers from deflating the content. + header('Content-Encoding: none'); + } + + // Get length and close the connection. + header('Content-Length: ' . ob_get_length()); + header('Connection: close'); + + ob_end_flush(); + @ob_flush(); + flush(); + } + } + + // Run any time consuming tasks. + $this->fireEvent('onShutdown'); + } + + /** + * Magic Catch All Function + * + * Used to call closures. + * + * Source: http://stackoverflow.com/questions/419804/closures-as-class-members + * + * @param string $method + * @param array $args + * @return mixed|null + */ + #[\ReturnTypeWillChange] + public function __call($method, $args) + { + $closure = $this->{$method} ?? null; + + return is_callable($closure) ? $closure(...$args) : null; + } + + /** + * Measure how long it takes to do an action. + * + * @param string $timerId + * @param string $timerTitle + * @param callable $callback + * @return mixed Returns value returned by the callable. + */ + public function measureTime(string $timerId, string $timerTitle, callable $callback) + { + $debugger = $this['debugger']; + $debugger->startTimer($timerId, $timerTitle); + $result = $callback(); + $debugger->stopTimer($timerId); + + return $result; + } + + /** + * Initialize and return a Grav instance + * + * @param array $values + * @return static + */ + protected static function load(array $values) + { + $container = new static($values); + + $container['debugger'] = new Debugger(); + $container['grav'] = function (Container $container) { + user_error('Calling $grav[\'grav\'] or {{ grav.grav }} is deprecated since Grav 1.6, just use $grav or {{ grav }}', E_USER_DEPRECATED); + + return $container; + }; + + $container->registerServices(); + + return $container; + } + + /** + * Register all services + * Services are defined in the diMap. They can either only the class + * of a Service Provider or a pair of serviceKey => serviceClass that + * gets directly mapped into the container. + * + * @return void + */ + protected function registerServices(): void + { + foreach (self::$diMap as $serviceKey => $serviceClass) { + if (is_int($serviceKey)) { + $this->register(new $serviceClass); + } else { + $this[$serviceKey] = function ($c) use ($serviceClass) { + return new $serviceClass($c); + }; + } + } + } + + /** + * This attempts to find media, other files, and download them + * + * @param string $path + * @return PageInterface|false + */ + public function fallbackUrl($path) + { + $path_parts = Utils::pathinfo($path); + if (!is_array($path_parts)) { + return false; + } + + /** @var Uri $uri */ + $uri = $this['uri']; + + /** @var Config $config */ + $config = $this['config']; + + /** @var Pages $pages */ + $pages = $this['pages']; + $page = $pages->find($path_parts['dirname'], true); + + $uri_extension = strtolower($uri->extension() ?? ''); + $fallback_types = $config->get('system.media.allowed_fallback_types'); + $supported_types = $config->get('media.types'); + + $parsed_url = parse_url(rawurldecode($uri->basename())); + $media_file = $parsed_url['path']; + + $event = new Event([ + 'uri' => $uri, + 'page' => &$page, + 'filename' => &$media_file, + 'extension' => $uri_extension, + 'allowed_fallback_types' => &$fallback_types, + 'media_types' => &$supported_types + ]); + + $this->fireEvent('onPageFallBackUrl', $event); + + // Check whitelist first, then ensure extension is a valid media type + if (!empty($fallback_types) && !in_array($uri_extension, $fallback_types, true)) { + return false; + } + if (!array_key_exists($uri_extension, $supported_types)) { + return false; + } + + if ($page) { + $media = $page->media()->all(); + + // if this is a media object, try actions first + if (isset($media[$media_file])) { + /** @var Medium $medium */ + $medium = $media[$media_file]; + foreach ($uri->query(null, true) as $action => $params) { + if (in_array($action, ImageMedium::$magic_actions, true)) { + call_user_func_array([&$medium, $action], explode(',', $params)); + } + } + Utils::download($medium->path(), false); + } + + // unsupported media type, try to download it... + if ($uri_extension) { + $extension = $uri_extension; + } elseif (isset($path_parts['extension'])) { + $extension = $path_parts['extension']; + } else { + $extension = null; + } + + if ($extension) { + $download = true; + if (in_array(ltrim($extension, '.'), $config->get('system.media.unsupported_inline_types', []), true)) { + $download = false; + } + Utils::download($page->path() . DIRECTORY_SEPARATOR . $uri->basename(), $download); + } + } + + // Nothing found + return false; + } +} diff --git a/system/src/Grav/Common/GravTrait.php b/system/src/Grav/Common/GravTrait.php new file mode 100644 index 0000000..76dacba --- /dev/null +++ b/system/src/Grav/Common/GravTrait.php @@ -0,0 +1,34 @@ + 'Grav CMS' + ]; + + public static function getClient(array $overrides = [], int $connections = 6, callable $callback = null): HttpClientInterface + { + $config = Grav::instance()['config']; + $options = static::getOptions(); + + // Use callback if provided + if ($callback) { + self::$callback = $callback; + $options->setOnProgress([Client::class, 'progress']); + } + + $settings = array_merge($options->toArray(), $overrides); + $preferred_method = $config->get('system.http.method'); + // Try old GPM setting if value is the same as system default + if ($preferred_method === 'auto') { + $preferred_method = $config->get('system.gpm.method', 'auto'); + } + + switch ($preferred_method) { + case 'curl': + $client = new CurlHttpClient($settings, $connections); + break; + case 'fopen': + case 'native': + $client = new NativeHttpClient($settings, $connections); + break; + default: + $client = HttpClient::create($settings, $connections); + } + + return $client; + } + + /** + * Get HTTP Options + * + * @return HttpOptions + */ + public static function getOptions(): HttpOptions + { + $config = Grav::instance()['config']; + $referer = defined('GRAV_CLI') ? 'grav_cli' : Grav::instance()['uri']->rootUrl(true); + + $options = new HttpOptions(); + + // Set default Headers + $options->setHeaders(array_merge([ 'Referer' => $referer ], self::$headers)); + + // Disable verify Peer if required + $verify_peer = $config->get('system.http.verify_peer'); + // Try old GPM setting if value is default + if ($verify_peer === true) { + $verify_peer = $config->get('system.gpm.verify_peer', null) ?? $verify_peer; + } + $options->verifyPeer($verify_peer); + + // Set verify Host + $verify_host = $config->get('system.http.verify_host', true); + $options->verifyHost($verify_host); + + // New setting and must be enabled for Proxy to work + if ($config->get('system.http.enable_proxy', true)) { + // Set proxy url if provided + $proxy_url = $config->get('system.http.proxy_url', $config->get('system.gpm.proxy_url', null)); + if ($proxy_url !== null) { + $options->setProxy($proxy_url); + } + + // Certificate + $proxy_cert = $config->get('system.http.proxy_cert_path', null); + if ($proxy_cert !== null) { + $options->setCaPath($proxy_cert); + } + } + + return $options; + } + + /** + * Progress normalized for cURL and Fopen + * Accepts a variable length of arguments passed in by stream method + * + * @return void + */ + public static function progress(int $bytes_transferred, int $filesize, array $info) + { + + if ($bytes_transferred > 0) { + $percent = $filesize <= 0 ? 0 : (int)(($bytes_transferred * 100) / $filesize); + + $progress = [ + 'code' => $info['http_code'], + 'filesize' => $filesize, + 'transferred' => $bytes_transferred, + 'percent' => $percent < 100 ? $percent : 100 + ]; + + if (self::$callback !== null) { + call_user_func(self::$callback, $progress); + } + } + } +} diff --git a/system/src/Grav/Common/HTTP/Response.php b/system/src/Grav/Common/HTTP/Response.php new file mode 100644 index 0000000..f05af0e --- /dev/null +++ b/system/src/Grav/Common/HTTP/Response.php @@ -0,0 +1,96 @@ +getContent(); + } + + + /** + * Makes a request to the URL by using the preferred method + * + * @param string $method method to call such as GET, PUT, etc + * @param string $uri URL to call + * @param array $overrides An array of parameters for both `curl` and `fopen` + * @param callable|null $callback Either a function or callback in array notation + * @return ResponseInterface + * @throws TransportExceptionInterface + */ + public static function request(string $method, string $uri, array $overrides = [], callable $callback = null): ResponseInterface + { + if (empty($method)) { + throw new TransportException('missing method (GET, PUT, etc.)'); + } + + if (empty($uri)) { + throw new TransportException('missing URI'); + } + + // check if this function is available, if so use it to stop any timeouts + try { + if (Utils::functionExists('set_time_limit')) { + @set_time_limit(0); + } + } catch (Exception $e) {} + + $client = Client::getClient($overrides, 6, $callback); + + return $client->request($method, $uri); + } + + + /** + * Is this a remote file or not + * + * @param string $file + * @return bool + */ + public static function isRemote($file): bool + { + return (bool) filter_var($file, FILTER_VALIDATE_URL); + } + + +} diff --git a/system/src/Grav/Common/Helpers/Base32.php b/system/src/Grav/Common/Helpers/Base32.php new file mode 100644 index 0000000..5aac178 --- /dev/null +++ b/system/src/Grav/Common/Helpers/Base32.php @@ -0,0 +1,141 @@ +', '?' + 0xFF,0x00,0x01,0x02,0x03,0x04,0x05,0x06, // '@', 'A', 'B', 'C', 'D', 'E', 'F', 'G' + 0x07,0x08,0x09,0x0A,0x0B,0x0C,0x0D,0x0E, // 'H', 'I', 'J', 'K', 'L', 'M', 'N', 'O' + 0x0F,0x10,0x11,0x12,0x13,0x14,0x15,0x16, // 'P', 'Q', 'R', 'S', 'T', 'U', 'V', 'W' + 0x17,0x18,0x19,0xFF,0xFF,0xFF,0xFF,0xFF, // 'X', 'Y', 'Z', '[', '\', ']', '^', '_' + 0xFF,0x00,0x01,0x02,0x03,0x04,0x05,0x06, // '`', 'a', 'b', 'c', 'd', 'e', 'f', 'g' + 0x07,0x08,0x09,0x0A,0x0B,0x0C,0x0D,0x0E, // 'h', 'i', 'j', 'k', 'l', 'm', 'n', 'o' + 0x0F,0x10,0x11,0x12,0x13,0x14,0x15,0x16, // 'p', 'q', 'r', 's', 't', 'u', 'v', 'w' + 0x17,0x18,0x19,0xFF,0xFF,0xFF,0xFF,0xFF // 'x', 'y', 'z', '{', '|', '}', '~', 'DEL' + ]; + + /** + * Encode in Base32 + * + * @param string $bytes + * @return string + */ + public static function encode($bytes) + { + $i = 0; + $index = 0; + $base32 = ''; + $bytesLen = strlen($bytes); + + while ($i < $bytesLen) { + $currByte = ord($bytes[$i]); + + /* Is the current digit going to span a byte boundary? */ + if ($index > 3) { + if (($i + 1) < $bytesLen) { + $nextByte = ord($bytes[$i+1]); + } else { + $nextByte = 0; + } + + $digit = $currByte & (0xFF >> $index); + $index = ($index + 5) % 8; + $digit <<= $index; + $digit |= $nextByte >> (8 - $index); + $i++; + } else { + $digit = ($currByte >> (8 - ($index + 5))) & 0x1F; + $index = ($index + 5) % 8; + if ($index === 0) { + $i++; + } + } + + $base32 .= self::$base32Chars[$digit]; + } + return $base32; + } + + /** + * Decode in Base32 + * + * @param string $base32 + * @return string + */ + public static function decode($base32) + { + $bytes = []; + $base32Len = strlen($base32); + $base32LookupLen = count(self::$base32Lookup); + + for ($i = $base32Len * 5 / 8 - 1; $i >= 0; --$i) { + $bytes[] = 0; + } + + for ($i = 0, $index = 0, $offset = 0; $i < $base32Len; $i++) { + $lookup = ord($base32[$i]) - ord('0'); + + /* Skip chars outside the lookup table */ + if ($lookup < 0 || $lookup >= $base32LookupLen) { + continue; + } + + $digit = self::$base32Lookup[$lookup]; + + /* If this digit is not in the table, ignore it */ + if ($digit === 0xFF) { + continue; + } + + if ($index <= 3) { + $index = ($index + 5) % 8; + if ($index === 0) { + $bytes[$offset] |= $digit; + $offset++; + if ($offset >= count($bytes)) { + break; + } + } else { + $bytes[$offset] |= $digit << (8 - $index); + } + } else { + $index = ($index + 5) % 8; + $bytes[$offset] |= ($digit >> $index); + $offset++; + if ($offset >= count($bytes)) { + break; + } + $bytes[$offset] |= $digit << (8 - $index); + } + } + + $bites = ''; + foreach ($bytes as $byte) { + $bites .= chr($byte); + } + + return $bites; + } +} diff --git a/system/src/Grav/Common/Helpers/Excerpts.php b/system/src/Grav/Common/Helpers/Excerpts.php new file mode 100644 index 0000000..254edc4 --- /dev/null +++ b/system/src/Grav/Common/Helpers/Excerpts.php @@ -0,0 +1,196 @@ +` + * @param PageInterface|null $page Page, defaults to the current page object + * @return string Returns final HTML string + */ + public static function processImageHtml($html, PageInterface $page = null) + { + $excerpt = static::getExcerptFromHtml($html, 'img'); + if (null === $excerpt) { + return ''; + } + + $original_src = $excerpt['element']['attributes']['src']; + $excerpt['element']['attributes']['href'] = $original_src; + + $excerpt = static::processLinkExcerpt($excerpt, $page, 'image'); + + $excerpt['element']['attributes']['src'] = $excerpt['element']['attributes']['href']; + unset($excerpt['element']['attributes']['href']); + + $excerpt = static::processImageExcerpt($excerpt, $page); + + $excerpt['element']['attributes']['data-src'] = $original_src; + + $html = static::getHtmlFromExcerpt($excerpt); + + return $html; + } + + /** + * Process Grav page link URL from HTML tag + * + * @param string $html HTML tag e.g. `Page Link` + * @param PageInterface|null $page Page, defaults to the current page object + * @return string Returns final HTML string + */ + public static function processLinkHtml($html, PageInterface $page = null) + { + $excerpt = static::getExcerptFromHtml($html, 'a'); + if (null === $excerpt) { + return ''; + } + + $original_href = $excerpt['element']['attributes']['href']; + $excerpt = static::processLinkExcerpt($excerpt, $page, 'link'); + $excerpt['element']['attributes']['data-href'] = $original_href; + + $html = static::getHtmlFromExcerpt($excerpt); + + return $html; + } + + /** + * Get an Excerpt array from a chunk of HTML + * + * @param string $html Chunk of HTML + * @param string $tag A tag, for example `img` + * @return array|null returns nested array excerpt + */ + public static function getExcerptFromHtml($html, $tag) + { + $doc = new DOMDocument('1.0', 'UTF-8'); + $internalErrors = libxml_use_internal_errors(true); + $doc->loadHTML(mb_convert_encoding($html, 'HTML-ENTITIES', 'UTF-8')); + libxml_use_internal_errors($internalErrors); + + $elements = $doc->getElementsByTagName($tag); + $excerpt = null; + $inner = []; + + foreach ($elements as $element) { + $attributes = []; + foreach ($element->attributes as $name => $value) { + $attributes[$name] = $value->value; + } + $excerpt = [ + 'element' => [ + 'name' => $element->tagName, + 'attributes' => $attributes + ] + ]; + + foreach ($element->childNodes as $node) { + $inner[] = $doc->saveHTML($node); + } + + $excerpt = array_merge_recursive($excerpt, ['element' => ['text' => implode('', $inner)]]); + + + } + + return $excerpt; + } + + /** + * Rebuild HTML tag from an excerpt array + * + * @param array $excerpt + * @return string + */ + public static function getHtmlFromExcerpt($excerpt) + { + $element = $excerpt['element']; + $html = '<'.$element['name']; + + if (isset($element['attributes'])) { + foreach ($element['attributes'] as $name => $value) { + if ($value === null) { + continue; + } + $html .= ' '.$name.'="'.$value.'"'; + } + } + + if (isset($element['text'])) { + $html .= '>'; + $html .= is_array($element['text']) ? static::getHtmlFromExcerpt(['element' => $element['text']]) : $element['text']; + $html .= ''; + } else { + $html .= ' />'; + } + + return $html; + } + + /** + * Process a Link excerpt + * + * @param array $excerpt + * @param PageInterface|null $page Page, defaults to the current page object + * @param string $type + * @return mixed + */ + public static function processLinkExcerpt($excerpt, PageInterface $page = null, $type = 'link') + { + $excerpts = new ExcerptsObject($page); + + return $excerpts->processLinkExcerpt($excerpt, $type); + } + + /** + * Process an image excerpt + * + * @param array $excerpt + * @param PageInterface|null $page Page, defaults to the current page object + * @return array + */ + public static function processImageExcerpt(array $excerpt, PageInterface $page = null) + { + $excerpts = new ExcerptsObject($page); + + return $excerpts->processImageExcerpt($excerpt); + } + + /** + * Process media actions + * + * @param Medium $medium + * @param string|array $url + * @param PageInterface|null $page Page, defaults to the current page object + * @return Medium|Link + */ + public static function processMediaActions($medium, $url, PageInterface $page = null) + { + $excerpts = new ExcerptsObject($page); + + return $excerpts->processMediaActions($medium, $url); + } +} diff --git a/system/src/Grav/Common/Helpers/Exif.php b/system/src/Grav/Common/Helpers/Exif.php new file mode 100644 index 0000000..a8ce8fe --- /dev/null +++ b/system/src/Grav/Common/Helpers/Exif.php @@ -0,0 +1,48 @@ +get('system.media.auto_metadata_exif')) { + if (function_exists('exif_read_data') && class_exists(Reader::class)) { + $this->reader = Reader::factory(Reader::TYPE_NATIVE); + } else { + throw new RuntimeException('Please enable the Exif extension for PHP or disable Exif support in Grav system configuration'); + } + } + } + + /** + * @return Reader + */ + public function getReader() + { + return $this->reader; + } +} diff --git a/system/src/Grav/Common/Helpers/LogViewer.php b/system/src/Grav/Common/Helpers/LogViewer.php new file mode 100644 index 0000000..085cc9e --- /dev/null +++ b/system/src/Grav/Common/Helpers/LogViewer.php @@ -0,0 +1,167 @@ +.*?)\] (?P\w+)\.(?P\w+): (?P.*[^ ]+) (?P[^ ]+) (?P[^ ]+)/'; + + /** + * Get the objects of a tailed file + * + * @param string $filepath + * @param int $lines + * @param bool $desc + * @return array + */ + public function objectTail($filepath, $lines = 1, $desc = true) + { + $data = $this->tail($filepath, $lines); + $tailed_log = $data ? explode(PHP_EOL, $data) : []; + $line_objects = []; + + foreach ($tailed_log as $line) { + $line_objects[] = $this->parse($line); + } + + return $desc ? $line_objects : array_reverse($line_objects); + } + + /** + * Optimized way to get just the last few entries of a log file + * + * @param string $filepath + * @param int $lines + * @return string|false + */ + public function tail($filepath, $lines = 1) + { + $f = $filepath ? @fopen($filepath, 'rb') : false; + if ($f === false) { + return false; + } + + $buffer = ($lines < 2 ? 64 : ($lines < 10 ? 512 : 4096)); + + fseek($f, -1, SEEK_END); + if (fread($f, 1) !== "\n") { + --$lines; + } + + // Start reading + $output = ''; + // While we would like more + while (ftell($f) > 0 && $lines >= 0) { + // Figure out how far back we should jump + $seek = min(ftell($f), $buffer); + // Do the jump (backwards, relative to where we are) + fseek($f, -$seek, SEEK_CUR); + // Read a chunk and prepend it to our output + $chunk = fread($f, $seek); + if ($chunk === false) { + throw new \RuntimeException('Cannot read file'); + } + $output = $chunk . $output; + // Jump back to where we started reading + fseek($f, -mb_strlen($chunk, '8bit'), SEEK_CUR); + // Decrease our line counter + $lines -= substr_count($chunk, "\n"); + } + // While we have too many lines + // (Because of buffer size we might have read too many) + while ($lines++ < 0) { + // Find first newline and remove all text before that + $output = substr($output, strpos($output, "\n") + 1); + } + // Close file and return + fclose($f); + + return trim($output); + } + + /** + * Helper class to get level color + * + * @param string $level + * @return string + */ + public static function levelColor($level) + { + $colors = [ + 'DEBUG' => 'green', + 'INFO' => 'cyan', + 'NOTICE' => 'yellow', + 'WARNING' => 'yellow', + 'ERROR' => 'red', + 'CRITICAL' => 'red', + 'ALERT' => 'red', + 'EMERGENCY' => 'magenta' + ]; + return $colors[$level] ?? 'white'; + } + + /** + * Parse a monolog row into array bits + * + * @param string $line + * @return array + */ + public function parse($line) + { + if (!is_string($line) || $line === '') { + return []; + } + + preg_match($this->pattern, $line, $data); + if (!isset($data['date'])) { + return []; + } + + preg_match('/(.*)- Trace:(.*)/', $data['message'], $matches); + if (is_array($matches) && isset($matches[1])) { + $data['message'] = trim($matches[1]); + $data['trace'] = trim($matches[2]); + } + + return [ + 'date' => DateTime::createFromFormat('Y-m-d H:i:s', $data['date']), + 'logger' => $data['logger'], + 'level' => $data['level'], + 'message' => $data['message'], + 'trace' => isset($data['trace']) ? self::parseTrace($data['trace']) : null, + 'context' => json_decode($data['context'], true), + 'extra' => json_decode($data['extra'], true) + ]; + } + + /** + * Parse text of trace into an array of lines + * + * @param string $trace + * @param int $rows + * @return array + */ + public static function parseTrace($trace, $rows = 10) + { + $lines = array_filter(preg_split('/#\d*/m', $trace)); + + return array_slice($lines, 0, $rows); + } +} diff --git a/system/src/Grav/Common/Helpers/Truncator.php b/system/src/Grav/Common/Helpers/Truncator.php new file mode 100644 index 0000000..d09c52c --- /dev/null +++ b/system/src/Grav/Common/Helpers/Truncator.php @@ -0,0 +1,344 @@ +getElementsByTagName('div')->item(0); + $container = $container->parentNode->removeChild($container); + + // Iterate over words. + $words = new DOMWordsIterator($container); + $truncated = false; + foreach ($words as $word) { + // If we have exceeded the limit, we delete the remainder of the content. + if ($words->key() >= $limit) { + // Grab current position. + $currentWordPosition = $words->currentWordPosition(); + $curNode = $currentWordPosition[0]; + $offset = $currentWordPosition[1]; + $words = $currentWordPosition[2]; + + $curNode->nodeValue = substr( + $curNode->nodeValue, + 0, + $words[$offset][1] + strlen($words[$offset][0]) + ); + + self::removeProceedingNodes($curNode, $container); + + if (!empty($ellipsis)) { + self::insertEllipsis($curNode, $ellipsis); + } + + $truncated = true; + + break; + } + } + + // Return original HTML if not truncated. + if ($truncated) { + $html = self::getCleanedHtml($doc, $container); + } + + return $html; + } + + /** + * Safely truncates HTML by a given number of letters. + * + * @param string $html Input HTML. + * @param int $limit Limit to how many letters we preserve. + * @param string $ellipsis String to use as ellipsis (if any). + * @return string Safe truncated HTML. + */ + public static function truncateLetters($html, $limit = 0, $ellipsis = '') + { + if ($limit <= 0) { + return $html; + } + + $doc = self::htmlToDomDocument($html); + $container = $doc->getElementsByTagName('div')->item(0); + $container = $container->parentNode->removeChild($container); + + // Iterate over letters. + $letters = new DOMLettersIterator($container); + $truncated = false; + foreach ($letters as $letter) { + // If we have exceeded the limit, we want to delete the remainder of this document. + if ($letters->key() >= $limit) { + $currentText = $letters->currentTextPosition(); + $currentText[0]->nodeValue = mb_substr($currentText[0]->nodeValue, 0, $currentText[1] + 1); + self::removeProceedingNodes($currentText[0], $container); + + if (!empty($ellipsis)) { + self::insertEllipsis($currentText[0], $ellipsis); + } + + $truncated = true; + + break; + } + } + + // Return original HTML if not truncated. + if ($truncated) { + $html = self::getCleanedHtml($doc, $container); + } + + return $html; + } + + /** + * Builds a DOMDocument object from a string containing HTML. + * + * @param string $html HTML to load + * @return DOMDocument Returns a DOMDocument object. + */ + public static function htmlToDomDocument($html) + { + if (!$html) { + $html = ''; + } + + // Transform multibyte entities which otherwise display incorrectly. + $html = mb_encode_numericentity($html, [0x80, 0x10FFFF, 0, ~0], 'UTF-8'); + + // Internal errors enabled as HTML5 not fully supported. + libxml_use_internal_errors(true); + + // Instantiate new DOMDocument object, and then load in UTF-8 HTML. + $dom = new DOMDocument(); + $dom->encoding = 'UTF-8'; + $dom->loadHTML("
$html
"); + + return $dom; + } + + /** + * Removes all nodes after the current node. + * + * @param DOMNode|DOMElement $domNode + * @param DOMNode|DOMElement $topNode + * @return void + */ + private static function removeProceedingNodes($domNode, $topNode) + { + /** @var DOMNode|null $nextNode */ + $nextNode = $domNode->nextSibling; + + if ($nextNode !== null) { + self::removeProceedingNodes($nextNode, $topNode); + $domNode->parentNode->removeChild($nextNode); + } else { + //scan upwards till we find a sibling + $curNode = $domNode->parentNode; + while ($curNode !== $topNode) { + if ($curNode->nextSibling !== null) { + $curNode = $curNode->nextSibling; + self::removeProceedingNodes($curNode, $topNode); + $curNode->parentNode->removeChild($curNode); + break; + } + $curNode = $curNode->parentNode; + } + } + } + + /** + * Clean extra code + * + * @param DOMDocument $doc + * @param DOMNode $container + * @return string + */ + private static function getCleanedHTML(DOMDocument $doc, DOMNode $container) + { + while ($doc->firstChild) { + $doc->removeChild($doc->firstChild); + } + + while ($container->firstChild) { + $doc->appendChild($container->firstChild); + } + + return trim($doc->saveHTML()); + } + + /** + * Inserts an ellipsis + * + * @param DOMNode|DOMElement $domNode Element to insert after. + * @param string $ellipsis Text used to suffix our document. + * @return void + */ + private static function insertEllipsis($domNode, $ellipsis) + { + $avoid = array('a', 'strong', 'em', 'h1', 'h2', 'h3', 'h4', 'h5'); //html tags to avoid appending the ellipsis to + + if ($domNode->parentNode->parentNode !== null && in_array($domNode->parentNode->nodeName, $avoid, true)) { + // Append as text node to parent instead + $textNode = new DOMText($ellipsis); + + /** @var DOMNode|null $nextSibling */ + $nextSibling = $domNode->parentNode->parentNode->nextSibling; + if ($nextSibling) { + $domNode->parentNode->parentNode->insertBefore($textNode, $domNode->parentNode->parentNode->nextSibling); + } else { + $domNode->parentNode->parentNode->appendChild($textNode); + } + } else { + // Append to current node + $domNode->nodeValue = rtrim($domNode->nodeValue) . $ellipsis; + } + } + + /** + * @param string $text + * @param int $length + * @param string $ending + * @param bool $exact + * @param bool $considerHtml + * @return string + */ + public function truncate( + $text, + $length = 100, + $ending = '...', + $exact = false, + $considerHtml = true + ) { + if ($considerHtml) { + // if the plain text is shorter than the maximum length, return the whole text + if (strlen(preg_replace('/<.*?>/', '', $text)) <= $length) { + return $text; + } + + // splits all html-tags to scanable lines + preg_match_all('/(<.+?>)?([^<>]*)/s', $text, $lines, PREG_SET_ORDER); + $total_length = strlen($ending); + $truncate = ''; + $open_tags = []; + + foreach ($lines as $line_matchings) { + // if there is any html-tag in this line, handle it and add it (uncounted) to the output + if (!empty($line_matchings[1])) { + // if it's an "empty element" with or without xhtml-conform closing slash + if (preg_match('/^<(\s*.+?\/\s*|\s*(img|br|input|hr|area|base|basefont|col|frame|isindex|link|meta|param)(\s.+?)?)>$/is', $line_matchings[1])) { + // do nothing + // if tag is a closing tag + } elseif (preg_match('/^<\s*\/([^\s]+?)\s*>$/s', $line_matchings[1], $tag_matchings)) { + // delete tag from $open_tags list + $pos = array_search($tag_matchings[1], $open_tags); + if ($pos !== false) { + unset($open_tags[$pos]); + } + // if tag is an opening tag + } elseif (preg_match('/^<\s*([^\s>!]+).*?>$/s', $line_matchings[1], $tag_matchings)) { + // add tag to the beginning of $open_tags list + array_unshift($open_tags, strtolower($tag_matchings[1])); + } + // add html-tag to $truncate'd text + $truncate .= $line_matchings[1]; + } + // calculate the length of the plain text part of the line; handle entities as one character + $content_length = strlen(preg_replace('/&[0-9a-z]{2,8};|&#[0-9]{1,7};|[0-9a-f]{1,6};/i', ' ', $line_matchings[2])); + if ($total_length+$content_length> $length) { + // the number of characters which are left + $left = $length - $total_length; + $entities_length = 0; + // search for html entities + if (preg_match_all('/&[0-9a-z]{2,8};|&#[0-9]{1,7};|[0-9a-f]{1,6};/i', $line_matchings[2], $entities, PREG_OFFSET_CAPTURE)) { + // calculate the real length of all entities in the legal range + foreach ($entities[0] as $entity) { + if ($entity[1]+1-$entities_length <= $left) { + $left--; + $entities_length += strlen($entity[0]); + } else { + // no more characters left + break; + } + } + } + $truncate .= substr($line_matchings[2], 0, $left+$entities_length); + // maximum lenght is reached, so get off the loop + break; + } else { + $truncate .= $line_matchings[2]; + $total_length += $content_length; + } + // if the maximum length is reached, get off the loop + if ($total_length>= $length) { + break; + } + } + } else { + if (strlen($text) <= $length) { + return $text; + } + + $truncate = substr($text, 0, $length - strlen($ending)); + } + // if the words shouldn't be cut in the middle... + if (!$exact) { + // ...search the last occurance of a space... + $spacepos = strrpos($truncate, ' '); + if (false !== $spacepos) { + // ...and cut the text in this position + $truncate = substr($truncate, 0, $spacepos); + } + } + // add the defined ending to the text + $truncate .= $ending; + if (isset($open_tags)) { + // close all unclosed html-tags + foreach ($open_tags as $tag) { + $truncate .= ''; + } + } + + return $truncate; + } +} diff --git a/system/src/Grav/Common/Helpers/YamlLinter.php b/system/src/Grav/Common/Helpers/YamlLinter.php new file mode 100644 index 0000000..1dee495 --- /dev/null +++ b/system/src/Grav/Common/Helpers/YamlLinter.php @@ -0,0 +1,122 @@ +get('system.pages.theme'); + $theme_path = 'themes://' . $current_theme . '/blueprints'; + + $locator->addPath('blueprints', '', [$theme_path]); + return static::recurseFolder('blueprints://'); + } + + /** + * @param string $path + * @param string $extensions + * @return array + */ + public static function recurseFolder($path, $extensions = '(md|yaml)') + { + $lint_errors = []; + + /** @var UniformResourceLocator $locator */ + $locator = Grav::instance()['locator']; + $flags = RecursiveDirectoryIterator::SKIP_DOTS | RecursiveDirectoryIterator::FOLLOW_SYMLINKS; + if ($locator->isStream($path)) { + $directory = $locator->getRecursiveIterator($path, $flags); + } else { + $directory = new RecursiveDirectoryIterator($path, $flags); + } + $recursive = new RecursiveIteratorIterator($directory, RecursiveIteratorIterator::SELF_FIRST); + $iterator = new RegexIterator($recursive, '/^.+\.'.$extensions.'$/ui'); + + /** @var RecursiveDirectoryIterator $file */ + foreach ($iterator as $filepath => $file) { + try { + Yaml::parse(static::extractYaml($filepath)); + } catch (Exception $e) { + $lint_errors[str_replace(GRAV_ROOT, '', $filepath)] = $e->getMessage(); + } + } + + return $lint_errors; + } + + /** + * @param string $path + * @return string + */ + protected static function extractYaml($path) + { + $extension = Utils::pathinfo($path, PATHINFO_EXTENSION); + if ($extension === 'md') { + $file = MarkdownFile::instance($path); + $contents = $file->frontmatter(); + $file->free(); + } else { + $contents = file_get_contents($path); + } + return $contents; + } +} diff --git a/system/src/Grav/Common/Inflector.php b/system/src/Grav/Common/Inflector.php new file mode 100644 index 0000000..ed64951 --- /dev/null +++ b/system/src/Grav/Common/Inflector.php @@ -0,0 +1,357 @@ +isDebug()) { + static::$plural = $language->translate('GRAV.INFLECTOR_PLURALS', null, true); + static::$singular = $language->translate('GRAV.INFLECTOR_SINGULAR', null, true); + static::$uncountable = $language->translate('GRAV.INFLECTOR_UNCOUNTABLE', null, true); + static::$irregular = $language->translate('GRAV.INFLECTOR_IRREGULAR', null, true); + static::$ordinals = $language->translate('GRAV.INFLECTOR_ORDINALS', null, true); + } + } + } + + /** + * Pluralizes English nouns. + * + * @param string $word English noun to pluralize + * @param int $count The count + * @return string|false Plural noun + */ + public static function pluralize($word, $count = 2) + { + static::init(); + + if ((int)$count === 1) { + return $word; + } + + $lowercased_word = strtolower($word); + + if (is_array(static::$uncountable)) { + foreach (static::$uncountable as $_uncountable) { + if (substr($lowercased_word, -1 * strlen($_uncountable)) === $_uncountable) { + return $word; + } + } + } + + if (is_array(static::$irregular)) { + foreach (static::$irregular as $_plural => $_singular) { + if (preg_match('/(' . $_plural . ')$/i', $word, $arr)) { + return preg_replace('/(' . $_plural . ')$/i', substr($arr[0], 0, 1) . substr($_singular, 1), $word); + } + } + } + + if (is_array(static::$plural)) { + foreach (static::$plural as $rule => $replacement) { + if (preg_match($rule, $word)) { + return preg_replace($rule, $replacement, $word); + } + } + } + + return false; + } + + /** + * Singularizes English nouns. + * + * @param string $word English noun to singularize + * @param int $count + * + * @return string Singular noun. + */ + public static function singularize($word, $count = 1) + { + static::init(); + + if ((int)$count !== 1) { + return $word; + } + + $lowercased_word = strtolower($word); + + if (is_array(static::$uncountable)) { + foreach (static::$uncountable as $_uncountable) { + if (substr($lowercased_word, -1 * strlen($_uncountable)) === $_uncountable) { + return $word; + } + } + } + + if (is_array(static::$irregular)) { + foreach (static::$irregular as $_plural => $_singular) { + if (preg_match('/(' . $_singular . ')$/i', $word, $arr)) { + return preg_replace('/(' . $_singular . ')$/i', substr($arr[0], 0, 1) . substr($_plural, 1), $word); + } + } + } + + if (is_array(static::$singular)) { + foreach (static::$singular as $rule => $replacement) { + if (preg_match($rule, $word)) { + return preg_replace($rule, $replacement, $word); + } + } + } + + return $word; + } + + /** + * Converts an underscored or CamelCase word into a English + * sentence. + * + * The titleize public function converts text like "WelcomePage", + * "welcome_page" or "welcome page" to this "Welcome + * Page". + * If second parameter is set to 'first' it will only + * capitalize the first character of the title. + * + * @param string $word Word to format as tile + * @param string $uppercase If set to 'first' it will only uppercase the + * first character. Otherwise it will uppercase all + * the words in the title. + * + * @return string Text formatted as title + */ + public static function titleize($word, $uppercase = '') + { + $uppercase = $uppercase === 'first' ? 'ucfirst' : 'ucwords'; + + return $uppercase(static::humanize(static::underscorize($word))); + } + + /** + * Returns given word as CamelCased + * + * Converts a word like "send_email" to "SendEmail". It + * will remove non alphanumeric character from the word, so + * "who's online" will be converted to "WhoSOnline" + * + * @see variablize + * + * @param string $word Word to convert to camel case + * @return string UpperCamelCasedWord + */ + public static function camelize($word) + { + return str_replace(' ', '', ucwords(preg_replace('/[^A-Z^a-z^0-9]+/', ' ', $word))); + } + + /** + * Converts a word "into_it_s_underscored_version" + * + * Convert any "CamelCased" or "ordinary Word" into an + * "underscored_word". + * + * This can be really useful for creating friendly URLs. + * + * @param string $word Word to underscore + * @return string Underscored word + */ + public static function underscorize($word) + { + $regex1 = preg_replace('/([A-Z]+)([A-Z][a-z])/', '\1_\2', $word); + $regex2 = preg_replace('/([a-zd])([A-Z])/', '\1_\2', $regex1); + $regex3 = preg_replace('/[^A-Z^a-z^0-9]+/', '_', $regex2); + + return strtolower($regex3); + } + + /** + * Converts a word "into-it-s-hyphenated-version" + * + * Convert any "CamelCased" or "ordinary Word" into an + * "hyphenated-word". + * + * This can be really useful for creating friendly URLs. + * + * @param string $word Word to hyphenate + * @return string hyphenized word + */ + public static function hyphenize($word) + { + $regex1 = preg_replace('/([A-Z]+)([A-Z][a-z])/', '\1-\2', $word); + $regex2 = preg_replace('/([a-z])([A-Z])/', '\1-\2', $regex1); + $regex3 = preg_replace('/([0-9])([A-Z])/', '\1-\2', $regex2); + $regex4 = preg_replace('/[^A-Z^a-z^0-9]+/', '-', $regex3); + + $regex4 = trim($regex4, '-'); + + return strtolower($regex4); + } + + /** + * Returns a human-readable string from $word + * + * Returns a human-readable string from $word, by replacing + * underscores with a space, and by upper-casing the initial + * character by default. + * + * If you need to uppercase all the words you just have to + * pass 'all' as a second parameter. + * + * @param string $word String to "humanize" + * @param string $uppercase If set to 'all' it will uppercase all the words + * instead of just the first one. + * + * @return string Human-readable word + */ + public static function humanize($word, $uppercase = '') + { + $uppercase = $uppercase === 'all' ? 'ucwords' : 'ucfirst'; + + return $uppercase(str_replace('_', ' ', preg_replace('/_id$/', '', $word))); + } + + /** + * Same as camelize but first char is underscored + * + * Converts a word like "send_email" to "sendEmail". It + * will remove non alphanumeric character from the word, so + * "who's online" will be converted to "whoSOnline" + * + * @see camelize + * + * @param string $word Word to lowerCamelCase + * @return string Returns a lowerCamelCasedWord + */ + public static function variablize($word) + { + $word = static::camelize($word); + + return strtolower($word[0]) . substr($word, 1); + } + + /** + * Converts a class name to its table name according to rails + * naming conventions. + * + * Converts "Person" to "people" + * + * @see classify + * + * @param string $class_name Class name for getting related table_name. + * @return string plural_table_name + */ + public static function tableize($class_name) + { + return static::pluralize(static::underscorize($class_name)); + } + + /** + * Converts a table name to its class name according to rails + * naming conventions. + * + * Converts "people" to "Person" + * + * @see tableize + * + * @param string $table_name Table name for getting related ClassName. + * @return string SingularClassName + */ + public static function classify($table_name) + { + return static::camelize(static::singularize($table_name)); + } + + /** + * Converts number to its ordinal English form. + * + * This method converts 13 to 13th, 2 to 2nd ... + * + * @param int $number Number to get its ordinal value + * @return string Ordinal representation of given string. + */ + public static function ordinalize($number) + { + static::init(); + + if (!is_array(static::$ordinals)) { + return (string)$number; + } + + if (in_array($number % 100, range(11, 13), true)) { + return $number . static::$ordinals['default']; + } + + switch ($number % 10) { + case 1: + return $number . static::$ordinals['first']; + case 2: + return $number . static::$ordinals['second']; + case 3: + return $number . static::$ordinals['third']; + default: + return $number . static::$ordinals['default']; + } + } + + /** + * Converts a number of days to a number of months + * + * @param int $days + * @return int + */ + public static function monthize($days) + { + $now = new DateTime(); + $end = new DateTime(); + + $duration = new DateInterval("P{$days}D"); + + $diff = $end->add($duration)->diff($now); + + // handle years + if ($diff->y > 0) { + $diff->m += 12 * $diff->y; + } + + return $diff->m; + } +} diff --git a/system/src/Grav/Common/Iterator.php b/system/src/Grav/Common/Iterator.php new file mode 100644 index 0000000..a60c74f --- /dev/null +++ b/system/src/Grav/Common/Iterator.php @@ -0,0 +1,264 @@ +items[$key] ?? null; + } + + /** + * Clone the iterator. + */ + #[\ReturnTypeWillChange] + public function __clone() + { + foreach ($this as $key => $value) { + if (is_object($value)) { + $this->{$key} = clone $this->{$key}; + } + } + } + + /** + * Convents iterator to a comma separated list. + * + * @return string + */ + #[\ReturnTypeWillChange] + public function __toString() + { + return implode(',', $this->items); + } + + /** + * Remove item from the list. + * + * @param string $key + * @return void + */ + public function remove($key) + { + $this->offsetUnset($key); + } + + /** + * Return previous item. + * + * @return mixed + */ + public function prev() + { + return prev($this->items); + } + + /** + * Return nth item. + * + * @param int $key + * @return mixed|bool + */ + public function nth($key) + { + $items = array_keys($this->items); + + return isset($items[$key]) ? $this->offsetGet($items[$key]) : false; + } + + /** + * Get the first item + * + * @return mixed + */ + public function first() + { + $items = array_keys($this->items); + + return $this->offsetGet(array_shift($items)); + } + + /** + * Get the last item + * + * @return mixed + */ + public function last() + { + $items = array_keys($this->items); + + return $this->offsetGet(array_pop($items)); + } + + /** + * Reverse the Iterator + * + * @return $this + */ + public function reverse() + { + $this->items = array_reverse($this->items); + + return $this; + } + + /** + * @param mixed $needle Searched value. + * + * @return string|int|false Key if found, otherwise false. + */ + public function indexOf($needle) + { + foreach (array_values($this->items) as $key => $value) { + if ($value === $needle) { + return $key; + } + } + + return false; + } + + /** + * Shuffle items. + * + * @return $this + */ + public function shuffle() + { + $keys = array_keys($this->items); + shuffle($keys); + + $new = []; + foreach ($keys as $key) { + $new[$key] = $this->items[$key]; + } + + $this->items = $new; + + return $this; + } + + /** + * Slice the list. + * + * @param int $offset + * @param int|null $length + * @return $this + */ + public function slice($offset, $length = null) + { + $this->items = array_slice($this->items, $offset, $length); + + return $this; + } + + /** + * Pick one or more random entries. + * + * @param int $num Specifies how many entries should be picked. + * @return $this + */ + public function random($num = 1) + { + $count = count($this->items); + if ($num > $count) { + $num = $count; + } + + $this->items = array_intersect_key($this->items, array_flip((array)array_rand($this->items, $num))); + + return $this; + } + + /** + * Append new elements to the list. + * + * @param array|Iterator $items Items to be appended. Existing keys will be overridden with the new values. + * @return $this + */ + public function append($items) + { + if ($items instanceof static) { + $items = $items->toArray(); + } + $this->items = array_merge($this->items, (array)$items); + + return $this; + } + + /** + * Filter elements from the list + * + * @param callable|null $callback A function the receives ($value, $key) and must return a boolean to indicate + * filter status + * + * @return $this + */ + public function filter(callable $callback = null) + { + foreach ($this->items as $key => $value) { + if ((!$callback && !(bool)$value) || ($callback && !$callback($value, $key))) { + unset($this->items[$key]); + } + } + + return $this; + } + + + /** + * Sorts elements from the list and returns a copy of the list in the proper order + * + * @param callable|null $callback + * @param bool $desc + * @return $this|array + * + */ + public function sort(callable $callback = null, $desc = false) + { + if (!$callback || !is_callable($callback)) { + return $this; + } + + $items = $this->items; + uasort($items, $callback); + + return !$desc ? $items : array_reverse($items, true); + } +} diff --git a/system/src/Grav/Common/Language/Language.php b/system/src/Grav/Common/Language/Language.php new file mode 100644 index 0000000..f2f3c1b --- /dev/null +++ b/system/src/Grav/Common/Language/Language.php @@ -0,0 +1,663 @@ +grav = $grav; + $this->config = $grav['config']; + + $languages = $this->config->get('system.languages.supported', []); + foreach ($languages as &$language) { + $language = (string)$language; + } + unset($language); + + $this->languages = $languages; + + $this->init(); + } + + /** + * Initialize the default and enabled languages + * + * @return void + */ + public function init() + { + $default = $this->config->get('system.languages.default_lang'); + if (null !== $default) { + $default = (string)$default; + } + + // Note that reset returns false on empty languages. + $this->default = $default ?? reset($this->languages); + + $this->resetFallbackPageExtensions(); + + if (empty($this->languages)) { + // If no languages are set, turn of multi-language support. + $this->enabled = false; + } elseif ($default && !in_array($default, $this->languages, true)) { + // If default language isn't in the language list, we need to add it. + array_unshift($this->languages, $default); + } + } + + /** + * Ensure that languages are enabled + * + * @return bool + */ + public function enabled() + { + return $this->enabled; + } + + /** + * Returns true if language debugging is turned on. + * + * @return bool + */ + public function isDebug(): bool + { + return !$this->config->get('system.languages.translations', true); + } + + /** + * Gets the array of supported languages + * + * @return array + */ + public function getLanguages() + { + return $this->languages; + } + + /** + * Sets the current supported languages manually + * + * @param array $langs + * @return void + */ + public function setLanguages($langs) + { + $this->languages = $langs; + + $this->init(); + } + + /** + * Gets a pipe-separated string of available languages + * + * @param string|null $delimiter Delimiter to be quoted. + * @return string + */ + public function getAvailable($delimiter = null) + { + $languagesArray = $this->languages; //Make local copy + + $languagesArray = array_map(static function ($value) use ($delimiter) { + return preg_quote($value, $delimiter); + }, $languagesArray); + + sort($languagesArray); + + return implode('|', array_reverse($languagesArray)); + } + + /** + * Gets language, active if set, else default + * + * @return string|false + */ + public function getLanguage() + { + return $this->active ?: $this->default; + } + + /** + * Gets current default language + * + * @return string|false + */ + public function getDefault() + { + return $this->default; + } + + /** + * Sets default language manually + * + * @param string $lang + * @return string|bool + */ + public function setDefault($lang) + { + $lang = (string)$lang; + if ($this->validate($lang)) { + $this->default = $lang; + + return $lang; + } + + return false; + } + + /** + * Gets current active language + * + * @return string|false + */ + public function getActive() + { + return $this->active; + } + + /** + * Sets active language manually + * + * @param string|false $lang + * @return string|false + */ + public function setActive($lang) + { + $lang = (string)$lang; + if ($this->validate($lang)) { + /** @var Debugger $debugger */ + $debugger = $this->grav['debugger']; + $debugger->addMessage('Active language set to ' . $lang, 'debug'); + + $this->active = $lang; + + return $lang; + } + + return false; + } + + /** + * Sets the active language based on the first part of the URL + * + * @param string $uri + * @return string + */ + public function setActiveFromUri($uri) + { + $regex = '/(^\/(' . $this->getAvailable() . '))(?:\/|\?|$)/i'; + + // if languages set + if ($this->enabled()) { + // Try setting language from prefix of URL (/en/blah/blah). + if (preg_match($regex, $uri, $matches)) { + $this->lang_in_url = true; + $this->setActive($matches[2]); + $uri = preg_replace("/\\" . $matches[1] . '/', '', $uri, 1); + + // Store in session if language is different. + if (isset($this->grav['session']) && $this->grav['session']->isStarted() + && $this->config->get('system.languages.session_store_active', true) + && $this->grav['session']->active_language != $this->active + ) { + $this->grav['session']->active_language = $this->active; + } + } else { + // Try getting language from the session, else no active. + if (isset($this->grav['session']) && $this->grav['session']->isStarted() && + $this->config->get('system.languages.session_store_active', true)) { + $this->setActive($this->grav['session']->active_language ?: null); + } + // if still null, try from http_accept_language header + if ($this->active === null && + $this->config->get('system.languages.http_accept_language') && + $accept = $_SERVER['HTTP_ACCEPT_LANGUAGE'] ?? false) { + $negotiator = new LanguageNegotiator(); + $best_language = $negotiator->getBest($accept, $this->languages); + + if ($best_language instanceof AcceptLanguage) { + $this->setActive($best_language->getType()); + } else { + $this->setActive($this->getDefault()); + } + } + } + } + + return $uri; + } + + /** + * Get a URL prefix based on configuration + * + * @param string|null $lang + * @return string + */ + public function getLanguageURLPrefix($lang = null) + { + if (!$this->enabled()) { + return ''; + } + + // if active lang is not passed in, use current active + if (!$lang) { + $lang = $this->getLanguage(); + } + + return $this->isIncludeDefaultLanguage($lang) ? '/' . $lang : ''; + } + + /** + * Test to see if language is default and language should be included in the URL + * + * @param string|null $lang + * @return bool + */ + public function isIncludeDefaultLanguage($lang = null) + { + if (!$this->enabled()) { + return false; + } + + // if active lang is not passed in, use current active + if (!$lang) { + $lang = $this->getLanguage(); + } + + return !($this->default === $lang && $this->config->get('system.languages.include_default_lang') === false); + } + + /** + * Simple getter to tell if a language was found in the URL + * + * @return bool + */ + public function isLanguageInUrl() + { + return (bool) $this->lang_in_url; + } + + /** + * Get full list of used language page extensions: [''=>'.md', 'en'=>'.en.md', ...] + * + * @param string|null $fileExtension + * @return array + */ + public function getPageExtensions($fileExtension = null) + { + $fileExtension = $fileExtension ?: CONTENT_EXT; + + if (!isset($this->fallback_extensions[$fileExtension])) { + $extensions[''] = $fileExtension; + foreach ($this->languages as $code) { + $extensions[$code] = ".{$code}{$fileExtension}"; + } + + $this->fallback_extensions[$fileExtension] = $extensions; + } + + return $this->fallback_extensions[$fileExtension]; + } + + /** + * Gets an array of valid extensions with active first, then fallback extensions + * + * @param string|null $fileExtension + * @param string|null $languageCode + * @param bool $assoc Return values in ['en' => '.en.md', ...] format. + * @return array Key is the language code, value is the file extension to be used. + */ + public function getFallbackPageExtensions(string $fileExtension = null, string $languageCode = null, bool $assoc = false) + { + $fileExtension = $fileExtension ?: CONTENT_EXT; + $key = $fileExtension . '-' . ($languageCode ?? 'default') . '-' . (int)$assoc; + + if (!isset($this->fallback_extensions[$key])) { + $all = $this->getPageExtensions($fileExtension); + $list = []; + $fallback = $this->getFallbackLanguages($languageCode, true); + foreach ($fallback as $code) { + $ext = $all[$code] ?? null; + if (null !== $ext) { + $list[$code] = $ext; + } + } + if (!$assoc) { + $list = array_values($list); + } + + $this->fallback_extensions[$key] = $list; + } + + return $this->fallback_extensions[$key]; + } + + /** + * Resets the fallback_languages value. + * + * Useful to re-initialize the pages and change site language at runtime, example: + * + * ``` + * $this->grav['language']->setActive('it'); + * $this->grav['language']->resetFallbackPageExtensions(); + * $this->grav['pages']->init(); + * ``` + * + * @return void + */ + public function resetFallbackPageExtensions() + { + $this->fallback_languages = []; + $this->fallback_extensions = []; + $this->page_extensions = []; + } + + /** + * Gets an array of languages with active first, then fallback languages. + * + * + * @param string|null $languageCode + * @param bool $includeDefault If true, list contains '', which can be used for default + * @return array + */ + public function getFallbackLanguages(string $languageCode = null, bool $includeDefault = false) + { + // Handle default. + if ($languageCode === '' || !$this->enabled()) { + return ['']; + } + + $default = $this->getDefault() ?? 'en'; + $active = $languageCode ?? $this->getActive() ?? $default; + $key = $active . '-' . (int)$includeDefault; + + if (!isset($this->fallback_languages[$key])) { + $fallback = $this->config->get('system.languages.content_fallback.' . $active); + $fallback_languages = []; + + if (null === $fallback && $this->config->get('system.languages.pages_fallback_only', false)) { + user_error('Configuration option `system.languages.pages_fallback_only` is deprecated since Grav 1.7, use `system.languages.content_fallback` instead', E_USER_DEPRECATED); + + // Special fallback list returns itself and all the previous items in reverse order: + // active: 'v2', languages: ['v1', 'v2', 'v3', 'v4'] => ['v2', 'v1', ''] + if ($includeDefault) { + $fallback_languages[''] = ''; + } + foreach ($this->languages as $code) { + $fallback_languages[$code] = $code; + if ($code === $active) { + break; + } + } + $fallback_languages = array_reverse($fallback_languages); + } else { + if (null === $fallback) { + $fallback = [$default]; + } elseif (!is_array($fallback)) { + $fallback = is_string($fallback) && $fallback !== '' ? explode(',', $fallback) : []; + } + array_unshift($fallback, $active); + $fallback = array_unique($fallback); + + foreach ($fallback as $code) { + // Default fallback list has active language followed by default language and extensionless file: + // active: 'fi', default: 'en', languages: ['sv', 'en', 'de', 'fi'] => ['fi', 'en', ''] + $fallback_languages[$code] = $code; + if ($includeDefault && $code === $default) { + $fallback_languages[''] = ''; + } + } + } + + $fallback_languages = array_values($fallback_languages); + + $this->fallback_languages[$key] = $fallback_languages; + } + + return $this->fallback_languages[$key]; + } + + /** + * Ensures the language is valid and supported + * + * @param string $lang + * @return bool + */ + public function validate($lang) + { + return in_array($lang, $this->languages, true); + } + + /** + * Translate a key and possibly arguments into a string using current lang and fallbacks + * + * @param string|array $args The first argument is the lookup key value + * Other arguments can be passed and replaced in the translation with sprintf syntax + * @param array|null $languages + * @param bool $array_support + * @param bool $html_out + * @return string|string[] + */ + public function translate($args, array $languages = null, $array_support = false, $html_out = false) + { + if (is_array($args)) { + $lookup = array_shift($args); + } else { + $lookup = $args; + $args = []; + } + + if (!$this->isDebug()) { + if ($lookup && $this->enabled() && empty($languages)) { + $languages = $this->getTranslatedLanguages(); + } + + $languages = $languages ?: ['en']; + + foreach ((array)$languages as $lang) { + $translation = $this->getTranslation($lang, $lookup, $array_support); + + if ($translation) { + if (is_string($translation) && count($args) >= 1) { + return vsprintf($translation, $args); + } + + return $translation; + } + } + } elseif ($array_support) { + return [$lookup]; + } + + if ($html_out) { + return '' . $lookup . ''; + } + + return $lookup; + } + + /** + * Translate Array + * + * @param string $key + * @param string $index + * @param array|null $languages + * @param bool $html_out + * @return string + */ + public function translateArray($key, $index, $languages = null, $html_out = false) + { + if ($this->isDebug()) { + return $key . '[' . $index . ']'; + } + + if ($key && empty($languages) && $this->enabled()) { + $languages = $this->getTranslatedLanguages(); + } + + $languages = $languages ?: ['en']; + + foreach ((array)$languages as $lang) { + $translation_array = (array)Grav::instance()['languages']->get($lang . '.' . $key, null); + if ($translation_array && array_key_exists($index, $translation_array)) { + return $translation_array[$index]; + } + } + + if ($html_out) { + return '' . $key . '[' . $index . ']'; + } + + return $key . '[' . $index . ']'; + } + + /** + * Lookup the translation text for a given lang and key + * + * @param string $lang lang code + * @param string $key key to lookup with + * @param bool $array_support + * @return string|string[] + */ + public function getTranslation($lang, $key, $array_support = false) + { + if ($this->isDebug()) { + return $key; + } + + $translation = Grav::instance()['languages']->get($lang . '.' . $key, null); + if (!$array_support && is_array($translation)) { + return (string)array_shift($translation); + } + + return $translation; + } + + /** + * Get the browser accepted languages + * + * @param array $accept_langs + * @return array + * @deprecated 1.6 No longer used - using content negotiation. + */ + public function getBrowserLanguages($accept_langs = []) + { + user_error(__CLASS__ . '::' . __FUNCTION__ . '() is deprecated since Grav 1.6, no longer used', E_USER_DEPRECATED); + + if (empty($this->http_accept_language)) { + if (empty($accept_langs) && isset($_SERVER['HTTP_ACCEPT_LANGUAGE'])) { + $accept_langs = $_SERVER['HTTP_ACCEPT_LANGUAGE']; + } else { + return $accept_langs; + } + + $langs = []; + + foreach (explode(',', $accept_langs) as $k => $pref) { + // split $pref again by ';q=' + // and decorate the language entries by inverted position + if (false !== ($i = strpos($pref, ';q='))) { + $langs[substr($pref, 0, $i)] = [(float)substr($pref, $i + 3), -$k]; + } else { + $langs[$pref] = [1, -$k]; + } + } + arsort($langs); + + // no need to undecorate, because we're only interested in the keys + $this->http_accept_language = array_keys($langs); + } + return $this->http_accept_language; + } + + /** + * Accessible wrapper to LanguageCodes + * + * @param string $code + * @param string $type + * @return string|false + */ + public function getLanguageCode($code, $type = 'name') + { + return LanguageCodes::get($code, $type); + } + + /** + * @return array + */ + #[\ReturnTypeWillChange] + public function __debugInfo() + { + $vars = get_object_vars($this); + unset($vars['grav'], $vars['config']); + + return $vars; + } + + /** + * @return array + */ + protected function getTranslatedLanguages(): array + { + if ($this->config->get('system.languages.translations_fallback', true)) { + $languages = $this->getFallbackLanguages(); + } else { + $languages = [$this->getLanguage()]; + } + + $languages[] = 'en'; + + return array_values(array_unique($languages)); + } +} diff --git a/system/src/Grav/Common/Language/LanguageCodes.php b/system/src/Grav/Common/Language/LanguageCodes.php new file mode 100644 index 0000000..86efd89 --- /dev/null +++ b/system/src/Grav/Common/Language/LanguageCodes.php @@ -0,0 +1,246 @@ + [ 'name' => 'Afrikaans', 'nativeName' => 'Afrikaans' ], + 'ak' => [ 'name' => 'Akan', 'nativeName' => 'Akan' ], // unverified native name + 'ast' => [ 'name' => 'Asturian', 'nativeName' => 'Asturianu' ], + 'ar' => [ 'name' => 'Arabic', 'nativeName' => 'عربي', 'orientation' => 'rtl'], + 'as' => [ 'name' => 'Assamese', 'nativeName' => 'অসমীয়া' ], + 'be' => [ 'name' => 'Belarusian', 'nativeName' => 'Беларуская' ], + 'bg' => [ 'name' => 'Bulgarian', 'nativeName' => 'Български' ], + 'bn' => [ 'name' => 'Bengali', 'nativeName' => 'বাংলা' ], + 'bn-BD' => [ 'name' => 'Bengali (Bangladesh)', 'nativeName' => 'বাংলা (বাংলাদেশ)' ], + 'bn-IN' => [ 'name' => 'Bengali (India)', 'nativeName' => 'বাংলা (ভারত)' ], + 'br' => [ 'name' => 'Breton', 'nativeName' => 'Brezhoneg' ], + 'bs' => [ 'name' => 'Bosnian', 'nativeName' => 'Bosanski' ], + 'ca' => [ 'name' => 'Catalan', 'nativeName' => 'Català' ], + 'ca-valencia'=> [ 'name' => 'Catalan (Valencian)', 'nativeName' => 'Català (valencià)' ], // not iso-639-1. a=l10n-drivers + 'cs' => [ 'name' => 'Czech', 'nativeName' => 'Čeština' ], + 'cy' => [ 'name' => 'Welsh', 'nativeName' => 'Cymraeg' ], + 'da' => [ 'name' => 'Danish', 'nativeName' => 'Dansk' ], + 'de' => [ 'name' => 'German', 'nativeName' => 'Deutsch' ], + 'de-AT' => [ 'name' => 'German (Austria)', 'nativeName' => 'Deutsch (Österreich)' ], + 'de-CH' => [ 'name' => 'German (Switzerland)', 'nativeName' => 'Deutsch (Schweiz)' ], + 'de-DE' => [ 'name' => 'German (Germany)', 'nativeName' => 'Deutsch (Deutschland)' ], + 'dsb' => [ 'name' => 'Lower Sorbian', 'nativeName' => 'Dolnoserbšćina' ], // iso-639-2 + 'el' => [ 'name' => 'Greek', 'nativeName' => 'Ελληνικά' ], + 'en' => [ 'name' => 'English', 'nativeName' => 'English' ], + 'en-AU' => [ 'name' => 'English (Australian)', 'nativeName' => 'English (Australian)' ], + 'en-CA' => [ 'name' => 'English (Canadian)', 'nativeName' => 'English (Canadian)' ], + 'en-GB' => [ 'name' => 'English (British)', 'nativeName' => 'English (British)' ], + 'en-NZ' => [ 'name' => 'English (New Zealand)', 'nativeName' => 'English (New Zealand)' ], + 'en-US' => [ 'name' => 'English (US)', 'nativeName' => 'English (US)' ], + 'en-ZA' => [ 'name' => 'English (South African)', 'nativeName' => 'English (South African)' ], + 'eo' => [ 'name' => 'Esperanto', 'nativeName' => 'Esperanto' ], + 'es' => [ 'name' => 'Spanish', 'nativeName' => 'Español' ], + 'es-AR' => [ 'name' => 'Spanish (Argentina)', 'nativeName' => 'Español (de Argentina)' ], + 'es-CL' => [ 'name' => 'Spanish (Chile)', 'nativeName' => 'Español (de Chile)' ], + 'es-ES' => [ 'name' => 'Spanish (Spain)', 'nativeName' => 'Español (de España)' ], + 'es-MX' => [ 'name' => 'Spanish (Mexico)', 'nativeName' => 'Español (de México)' ], + 'et' => [ 'name' => 'Estonian', 'nativeName' => 'Eesti keel' ], + 'eu' => [ 'name' => 'Basque', 'nativeName' => 'Euskara' ], + 'fa' => [ 'name' => 'Persian', 'nativeName' => 'فارسی' , 'orientation' => 'rtl' ], + 'fi' => [ 'name' => 'Finnish', 'nativeName' => 'Suomi' ], + 'fj-FJ' => [ 'name' => 'Fijian', 'nativeName' => 'Vosa vaka-Viti' ], + 'fr' => [ 'name' => 'French', 'nativeName' => 'Français' ], + 'fr-CA' => [ 'name' => 'French (Canada)', 'nativeName' => 'Français (Canada)' ], + 'fr-FR' => [ 'name' => 'French (France)', 'nativeName' => 'Français (France)' ], + 'fur' => [ 'name' => 'Friulian', 'nativeName' => 'Furlan' ], + 'fur-IT' => [ 'name' => 'Friulian', 'nativeName' => 'Furlan' ], + 'fy' => [ 'name' => 'Frisian', 'nativeName' => 'Frysk' ], + 'fy-NL' => [ 'name' => 'Frisian', 'nativeName' => 'Frysk' ], + 'ga' => [ 'name' => 'Irish', 'nativeName' => 'Gaeilge' ], + 'ga-IE' => [ 'name' => 'Irish (Ireland)', 'nativeName' => 'Gaeilge (Éire)' ], + 'gd' => [ 'name' => 'Gaelic (Scotland)', 'nativeName' => 'Gàidhlig' ], + 'gl' => [ 'name' => 'Galician', 'nativeName' => 'Galego' ], + 'gu' => [ 'name' => 'Gujarati', 'nativeName' => 'ગુજરાતી' ], + 'gu-IN' => [ 'name' => 'Gujarati', 'nativeName' => 'ગુજરાતી' ], + 'he' => [ 'name' => 'Hebrew', 'nativeName' => 'עברית', 'orientation' => 'rtl' ], + 'hi' => [ 'name' => 'Hindi', 'nativeName' => 'हिन्दी' ], + 'hi-IN' => [ 'name' => 'Hindi (India)', 'nativeName' => 'हिन्दी (भारत)' ], + 'hr' => [ 'name' => 'Croatian', 'nativeName' => 'Hrvatski' ], + 'hsb' => [ 'name' => 'Upper Sorbian', 'nativeName' => 'Hornjoserbsce' ], + 'hu' => [ 'name' => 'Hungarian', 'nativeName' => 'Magyar' ], + 'hy' => [ 'name' => 'Armenian', 'nativeName' => 'Հայերեն' ], + 'hy-AM' => [ 'name' => 'Armenian', 'nativeName' => 'Հայերեն' ], + 'id' => [ 'name' => 'Indonesian', 'nativeName' => 'Bahasa Indonesia' ], + 'is' => [ 'name' => 'Icelandic', 'nativeName' => 'íslenska' ], + 'it' => [ 'name' => 'Italian', 'nativeName' => 'Italiano' ], + 'ja' => [ 'name' => 'Japanese', 'nativeName' => '日本語' ], + 'ja-JP' => [ 'name' => 'Japanese', 'nativeName' => '日本語' ], // not iso-639-1 + 'ka' => [ 'name' => 'Georgian', 'nativeName' => 'ქართული' ], + 'kk' => [ 'name' => 'Kazakh', 'nativeName' => 'Қазақ' ], + 'km' => [ 'name' => 'Khmer', 'nativeName' => 'Khmer' ], + 'kn' => [ 'name' => 'Kannada', 'nativeName' => 'ಕನ್ನಡ' ], + 'ko' => [ 'name' => 'Korean', 'nativeName' => '한국어' ], + 'ku' => [ 'name' => 'Kurdish', 'nativeName' => 'Kurdî' ], + 'la' => [ 'name' => 'Latin', 'nativeName' => 'Latina' ], + 'lb' => [ 'name' => 'Luxembourgish', 'nativeName' => 'Lëtzebuergesch' ], + 'lg' => [ 'name' => 'Luganda', 'nativeName' => 'Luganda' ], + 'lo' => [ 'name' => 'Lao', 'nativeName' => 'Lao' ], + 'lt' => [ 'name' => 'Lithuanian', 'nativeName' => 'Lietuvių' ], + 'lv' => [ 'name' => 'Latvian', 'nativeName' => 'Latviešu' ], + 'mai' => [ 'name' => 'Maithili', 'nativeName' => 'मैथिली মৈথিলী' ], + 'mg' => [ 'name' => 'Malagasy', 'nativeName' => 'Malagasy' ], + 'mi' => [ 'name' => 'Maori (Aotearoa)', 'nativeName' => 'Māori (Aotearoa)' ], + 'mk' => [ 'name' => 'Macedonian', 'nativeName' => 'Македонски' ], + 'ml' => [ 'name' => 'Malayalam', 'nativeName' => 'മലയാളം' ], + 'mn' => [ 'name' => 'Mongolian', 'nativeName' => 'Монгол' ], + 'mr' => [ 'name' => 'Marathi', 'nativeName' => 'मराठी' ], + 'my' => [ 'name' => 'Myanmar (Burmese)', 'nativeName' => 'ဗမာी' ], + 'no' => [ 'name' => 'Norwegian', 'nativeName' => 'Norsk' ], + 'nb' => [ 'name' => 'Norwegian', 'nativeName' => 'Norsk' ], + 'nb-NO' => [ 'name' => 'Norwegian (Bokmål)', 'nativeName' => 'Norsk bokmål' ], + 'ne-NP' => [ 'name' => 'Nepali', 'nativeName' => 'नेपाली' ], + 'nn-NO' => [ 'name' => 'Norwegian (Nynorsk)', 'nativeName' => 'Norsk nynorsk' ], + 'nl' => [ 'name' => 'Dutch', 'nativeName' => 'Nederlands' ], + 'nr' => [ 'name' => 'Ndebele, South', 'nativeName' => 'IsiNdebele' ], + 'nso' => [ 'name' => 'Northern Sotho', 'nativeName' => 'Sepedi' ], + 'oc' => [ 'name' => 'Occitan (Lengadocian)', 'nativeName' => 'Occitan (lengadocian)' ], + 'or' => [ 'name' => 'Oriya', 'nativeName' => 'ଓଡ଼ିଆ' ], + 'pa' => [ 'name' => 'Punjabi', 'nativeName' => 'ਪੰਜਾਬੀ' ], + 'pa-IN' => [ 'name' => 'Punjabi', 'nativeName' => 'ਪੰਜਾਬੀ' ], + 'pl' => [ 'name' => 'Polish', 'nativeName' => 'Polski' ], + 'pt' => [ 'name' => 'Portuguese', 'nativeName' => 'Português' ], + 'pt-BR' => [ 'name' => 'Portuguese (Brazilian)', 'nativeName' => 'Português (do Brasil)' ], + 'pt-PT' => [ 'name' => 'Portuguese (Portugal)', 'nativeName' => 'Português (Europeu)' ], + 'ro' => [ 'name' => 'Romanian', 'nativeName' => 'Română' ], + 'rm' => [ 'name' => 'Romansh', 'nativeName' => 'Rumantsch' ], + 'ru' => [ 'name' => 'Russian', 'nativeName' => 'Русский' ], + 'rw' => [ 'name' => 'Kinyarwanda', 'nativeName' => 'Ikinyarwanda' ], + 'si' => [ 'name' => 'Sinhala', 'nativeName' => 'සිංහල' ], + 'sk' => [ 'name' => 'Slovak', 'nativeName' => 'Slovenčina' ], + 'sl' => [ 'name' => 'Slovenian', 'nativeName' => 'Slovensko' ], + 'son' => [ 'name' => 'Songhai', 'nativeName' => 'Soŋay' ], + 'sq' => [ 'name' => 'Albanian', 'nativeName' => 'Shqip' ], + 'sr' => [ 'name' => 'Serbian', 'nativeName' => 'Српски' ], + 'sr-Latn' => [ 'name' => 'Serbian', 'nativeName' => 'Srpski' ], // follows RFC 4646 + 'ss' => [ 'name' => 'Siswati', 'nativeName' => 'siSwati' ], + 'st' => [ 'name' => 'Southern Sotho', 'nativeName' => 'Sesotho' ], + 'sv' => [ 'name' => 'Swedish', 'nativeName' => 'Svenska' ], + 'sv-SE' => [ 'name' => 'Swedish', 'nativeName' => 'Svenska' ], + 'sw' => [ 'name' => 'Swahili', 'nativeName' => 'Swahili' ], + 'ta' => [ 'name' => 'Tamil', 'nativeName' => 'தமிழ்' ], + 'ta-IN' => [ 'name' => 'Tamil (India)', 'nativeName' => 'தமிழ் (இந்தியா)' ], + 'ta-LK' => [ 'name' => 'Tamil (Sri Lanka)', 'nativeName' => 'தமிழ் (இலங்கை)' ], + 'te' => [ 'name' => 'Telugu', 'nativeName' => 'తెలుగు' ], + 'th' => [ 'name' => 'Thai', 'nativeName' => 'ไทย' ], + 'tlh' => [ 'name' => 'Klingon', 'nativeName' => 'Klingon' ], + 'tn' => [ 'name' => 'Tswana', 'nativeName' => 'Setswana' ], + 'tr' => [ 'name' => 'Turkish', 'nativeName' => 'Türkçe' ], + 'ts' => [ 'name' => 'Tsonga', 'nativeName' => 'Xitsonga' ], + 'tt' => [ 'name' => 'Tatar', 'nativeName' => 'Tatarça' ], + 'tt-RU' => [ 'name' => 'Tatar', 'nativeName' => 'Tatarça' ], + 'uk' => [ 'name' => 'Ukrainian', 'nativeName' => 'Українська' ], + 'ur' => [ 'name' => 'Urdu', 'nativeName' => 'اُردو', 'orientation' => 'rtl' ], + 've' => [ 'name' => 'Venda', 'nativeName' => 'Tshivenḓa' ], + 'vi' => [ 'name' => 'Vietnamese', 'nativeName' => 'Tiếng Việt' ], + 'wo' => [ 'name' => 'Wolof', 'nativeName' => 'Wolof' ], + 'xh' => [ 'name' => 'Xhosa', 'nativeName' => 'isiXhosa' ], + 'yi' => [ 'name' => 'Yiddish', 'nativeName' => 'ייִדיש', 'orientation' => 'rtl' ], + 'ydd' => [ 'name' => 'Yiddish', 'nativeName' => 'ייִדיש', 'orientation' => 'rtl' ], + 'zh' => [ 'name' => 'Chinese (Simplified)', 'nativeName' => '中文 (简体)' ], + 'zh-CN' => [ 'name' => 'Chinese (Simplified)', 'nativeName' => '中文 (简体)' ], + 'zh-TW' => [ 'name' => 'Chinese (Traditional)', 'nativeName' => '正體中文 (繁體)' ], + 'zu' => [ 'name' => 'Zulu', 'nativeName' => 'isiZulu' ] + ]; + + /** + * @param string $code + * @return string|false + */ + public static function getName($code) + { + return static::get($code, 'name'); + } + + /** + * @param string $code + * @return string|false + */ + public static function getNativeName($code) + { + if (isset(static::$codes[$code])) { + return static::get($code, 'nativeName'); + } + + if (preg_match('/[a-zA-Z]{2}-[a-zA-Z]{2}/', $code)) { + return static::get(substr($code, 0, 2), 'nativeName') . ' (' . substr($code, -2) . ')'; + } + + return $code; + } + + /** + * @param string $code + * @return string + */ + public static function getOrientation($code) + { + return static::$codes[$code]['orientation'] ?? 'ltr'; + } + + /** + * @param string $code + * @return bool + */ + public static function isRtl($code) + { + return static::getOrientation($code) === 'rtl'; + } + + /** + * @param array $keys + * @return array + */ + public static function getNames(array $keys) + { + $results = []; + foreach ($keys as $key) { + if (isset(static::$codes[$key])) { + $results[$key] = static::$codes[$key]; + } + } + return $results; + } + + /** + * @param string $code + * @param string $type + * @return string|false + */ + public static function get($code, $type) + { + return static::$codes[$code][$type] ?? false; + } + + /** + * @param bool $native + * @return array + */ + public static function getList($native = true) + { + $list = []; + foreach (static::$codes as $key => $names) { + $list[$key] = $native ? $names['nativeName'] : $names['name']; + } + + return $list; + } +} diff --git a/system/src/Grav/Common/Markdown/Parsedown.php b/system/src/Grav/Common/Markdown/Parsedown.php new file mode 100644 index 0000000..bd2ab90 --- /dev/null +++ b/system/src/Grav/Common/Markdown/Parsedown.php @@ -0,0 +1,43 @@ + $defaults]; + } + $excerpts = new Excerpts($excerpts, $defaults); + user_error(__CLASS__ . '::' . __FUNCTION__ . '($page, $defaults) is deprecated since Grav 1.6.10, use new ' . __CLASS__ . '(new ' . Excerpts::class . '($page, [\'markdown\' => $defaults])) instead.', E_USER_DEPRECATED); + } + + $this->init($excerpts, $defaults); + } +} diff --git a/system/src/Grav/Common/Markdown/ParsedownExtra.php b/system/src/Grav/Common/Markdown/ParsedownExtra.php new file mode 100644 index 0000000..3ec8080 --- /dev/null +++ b/system/src/Grav/Common/Markdown/ParsedownExtra.php @@ -0,0 +1,46 @@ + $defaults]; + } + $excerpts = new Excerpts($excerpts, $defaults); + user_error(__CLASS__ . '::' . __FUNCTION__ . '($page, $defaults) is deprecated since Grav 1.6.10, use new ' . __CLASS__ . '(new ' . Excerpts::class . '($page, [\'markdown\' => $defaults])) instead.', E_USER_DEPRECATED); + } + + parent::__construct(); + + $this->init($excerpts, $defaults); + } +} diff --git a/system/src/Grav/Common/Markdown/ParsedownGravTrait.php b/system/src/Grav/Common/Markdown/ParsedownGravTrait.php new file mode 100644 index 0000000..3a6ceb4 --- /dev/null +++ b/system/src/Grav/Common/Markdown/ParsedownGravTrait.php @@ -0,0 +1,319 @@ + $defaults]; + } + $this->excerpts = new Excerpts($excerpts, $defaults); + user_error(__CLASS__ . '::' . __FUNCTION__ . '($page, $defaults) is deprecated since Grav 1.6.10, use ->init(new ' . Excerpts::class . '($page, [\'markdown\' => $defaults])) instead.', E_USER_DEPRECATED); + } else { + $this->excerpts = $excerpts; + } + + $this->BlockTypes['{'][] = 'TwigTag'; + $this->special_chars = ['>' => 'gt', '<' => 'lt', '"' => 'quot']; + + $defaults = $this->excerpts->getConfig(); + + if (isset($defaults['markdown']['auto_line_breaks'])) { + $this->setBreaksEnabled($defaults['markdown']['auto_line_breaks']); + } + if (isset($defaults['markdown']['auto_url_links'])) { + $this->setUrlsLinked($defaults['markdown']['auto_url_links']); + } + if (isset($defaults['markdown']['escape_markup'])) { + $this->setMarkupEscaped($defaults['markdown']['escape_markup']); + } + if (isset($defaults['markdown']['special_chars'])) { + $this->setSpecialChars($defaults['markdown']['special_chars']); + } + + $this->excerpts->fireInitializedEvent($this); + } + + /** + * @return Excerpts + */ + public function getExcerpts() + { + return $this->excerpts; + } + + /** + * Be able to define a new Block type or override an existing one + * + * @param string $type + * @param string $tag + * @param bool $continuable + * @param bool $completable + * @param int|null $index + * @return void + */ + public function addBlockType($type, $tag, $continuable = false, $completable = false, $index = null) + { + $block = &$this->unmarkedBlockTypes; + if ($type) { + if (!isset($this->BlockTypes[$type])) { + $this->BlockTypes[$type] = []; + } + $block = &$this->BlockTypes[$type]; + } + + if (null === $index) { + $block[] = $tag; + } else { + array_splice($block, $index, 0, [$tag]); + } + + if ($continuable) { + $this->continuable_blocks[] = $tag; + } + if ($completable) { + $this->completable_blocks[] = $tag; + } + } + + /** + * Be able to define a new Inline type or override an existing one + * + * @param string $type + * @param string $tag + * @param int|null $index + * @return void + */ + public function addInlineType($type, $tag, $index = null) + { + if (null === $index || !isset($this->InlineTypes[$type])) { + $this->InlineTypes[$type] [] = $tag; + } else { + array_splice($this->InlineTypes[$type], $index, 0, [$tag]); + } + + if (strpos($this->inlineMarkerList, $type) === false) { + $this->inlineMarkerList .= $type; + } + } + + /** + * Overrides the default behavior to allow for plugin-provided blocks to be continuable + * + * @param string $Type + * @return bool + */ + protected function isBlockContinuable($Type) + { + $continuable = in_array($Type, $this->continuable_blocks, true) + || method_exists($this, 'block' . $Type . 'Continue'); + + return $continuable; + } + + /** + * Overrides the default behavior to allow for plugin-provided blocks to be completable + * + * @param string $Type + * @return bool + */ + protected function isBlockCompletable($Type) + { + $completable = in_array($Type, $this->completable_blocks, true) + || method_exists($this, 'block' . $Type . 'Complete'); + + return $completable; + } + + + /** + * Make the element function publicly accessible, Medium uses this to render from Twig + * + * @param array $Element + * @return string markup + */ + public function elementToHtml(array $Element) + { + return $this->element($Element); + } + + /** + * Setter for special chars + * + * @param array $special_chars + * @return $this + */ + public function setSpecialChars($special_chars) + { + $this->special_chars = $special_chars; + + return $this; + } + + /** + * Ensure Twig tags are treated as block level items with no

tags + * + * @param array $line + * @return array|null + */ + protected function blockTwigTag($line) + { + if (preg_match('/(?:{{|{%|{#)(.*)(?:}}|%}|#})/', $line['body'], $matches)) { + return ['markup' => $line['body']]; + } + + return null; + } + + /** + * @param array $excerpt + * @return array|null + */ + protected function inlineSpecialCharacter($excerpt) + { + if ($excerpt['text'][0] === '&' && !preg_match('/^&#?\w+;/', $excerpt['text'])) { + return [ + 'markup' => '&', + 'extent' => 1, + ]; + } + + if (isset($this->special_chars[$excerpt['text'][0]])) { + return [ + 'markup' => '&' . $this->special_chars[$excerpt['text'][0]] . ';', + 'extent' => 1, + ]; + } + + return null; + } + + /** + * @param array $excerpt + * @return array + */ + protected function inlineImage($excerpt) + { + if (preg_match($this->twig_link_regex, $excerpt['text'], $matches)) { + $excerpt['text'] = str_replace($matches[1], '/', $excerpt['text']); + $excerpt = parent::inlineImage($excerpt); + $excerpt['element']['attributes']['src'] = $matches[1]; + $excerpt['extent'] = $excerpt['extent'] + strlen($matches[1]) - 1; + + return $excerpt; + } + + $excerpt['type'] = 'image'; + $excerpt = parent::inlineImage($excerpt); + + // if this is an image process it + if (isset($excerpt['element']['attributes']['src'])) { + $excerpt = $this->excerpts->processImageExcerpt($excerpt); + } + + return $excerpt; + } + + /** + * @param array $excerpt + * @return array + */ + protected function inlineLink($excerpt) + { + $type = $excerpt['type'] ?? 'link'; + + // do some trickery to get around Parsedown requirement for valid URL if its Twig in there + if (preg_match($this->twig_link_regex, $excerpt['text'], $matches)) { + $excerpt['text'] = str_replace($matches[1], '/', $excerpt['text']); + $excerpt = parent::inlineLink($excerpt); + $excerpt['element']['attributes']['href'] = $matches[1]; + $excerpt['extent'] = $excerpt['extent'] + strlen($matches[1]) - 1; + + return $excerpt; + } + + $excerpt = parent::inlineLink($excerpt); + + // if this is a link + if (isset($excerpt['element']['attributes']['href'])) { + $excerpt = $this->excerpts->processLinkExcerpt($excerpt, $type); + } + + return $excerpt; + } + + /** + * For extending this class via plugins + * + * @param string $method + * @param array $args + * @return mixed|null + */ + #[\ReturnTypeWillChange] + public function __call($method, $args) + { + + if (isset($this->plugins[$method]) === true) { + $func = $this->plugins[$method]; + + return call_user_func_array($func, $args); + } elseif (isset($this->{$method}) === true) { + $func = $this->{$method}; + + return call_user_func_array($func, $args); + } + + return null; + } + + public function __set($name, $value) + { + if (is_callable($value)) { + $this->plugins[$name] = $value; + } + + } + + +} diff --git a/system/src/Grav/Common/Media/Interfaces/AudioMediaInterface.php b/system/src/Grav/Common/Media/Interfaces/AudioMediaInterface.php new file mode 100644 index 0000000..0a68615 --- /dev/null +++ b/system/src/Grav/Common/Media/Interfaces/AudioMediaInterface.php @@ -0,0 +1,25 @@ +set('this.is.my.nested.variable', $value); + * + * @param string $name Dot separated path to the requested value. + * @param mixed $value New value. + * @param string|null $separator Separator, defaults to '.' + * @return $this + */ + public function set($name, $value, $separator = null); +} diff --git a/system/src/Grav/Common/Media/Interfaces/MediaPlayerInterface.php b/system/src/Grav/Common/Media/Interfaces/MediaPlayerInterface.php new file mode 100644 index 0000000..1f14080 --- /dev/null +++ b/system/src/Grav/Common/Media/Interfaces/MediaPlayerInterface.php @@ -0,0 +1,56 @@ + 'user://pages/media']; // Settings from the form field. + * $filename = $media->checkUploadedFile($uploadedFile, $filename, $settings); + * $media->copyUploadedFile($uploadedFile, $filename); + + * @param UploadedFileInterface $uploadedFile + * @param string|null $filename + * @param array|null $settings + * @return string + * @throws RuntimeException + */ + public function checkUploadedFile(UploadedFileInterface $uploadedFile, string $filename = null, array $settings = null): string; + + /** + * Copy uploaded file to the media collection. + * + * WARNING: Always check uploaded file before copying it! + * + * @example + * $filename = null; // Override filename if needed (ignored if randomizing filenames). + * $settings = ['destination' => 'user://pages/media']; // Settings from the form field. + * $filename = $media->checkUploadedFile($uploadedFile, $filename, $settings); + * $media->copyUploadedFile($uploadedFile, $filename); + * + * @param UploadedFileInterface $uploadedFile + * @param string $filename + * @param array|null $settings + * @return void + * @throws RuntimeException + */ + public function copyUploadedFile(UploadedFileInterface $uploadedFile, string $filename, array $settings = null): void; + + /** + * Delete real file from the media collection. + * + * @param string $filename + * @param array|null $settings + * @return void + */ + public function deleteFile(string $filename, array $settings = null): void; + + /** + * Rename file inside the media collection. + * + * @param string $from + * @param string $to + * @param array|null $settings + */ + public function renameFile(string $from, string $to, array $settings = null): void; +} diff --git a/system/src/Grav/Common/Media/Interfaces/VideoMediaInterface.php b/system/src/Grav/Common/Media/Interfaces/VideoMediaInterface.php new file mode 100644 index 0000000..03df0e0 --- /dev/null +++ b/system/src/Grav/Common/Media/Interfaces/VideoMediaInterface.php @@ -0,0 +1,32 @@ +attributes['controlsList'] = $controlsList; + + return $this; + } + + /** + * Parsedown element for source display mode + * + * @param array $attributes + * @param bool $reset + * @return array + */ + protected function sourceParsedownElement(array $attributes, $reset = true) + { + $location = $this->url($reset); + + return [ + 'name' => 'audio', + 'rawHtml' => 'Your browser does not support the audio tag.', + 'attributes' => $attributes + ]; + } +} diff --git a/system/src/Grav/Common/Media/Traits/ImageLoadingTrait.php b/system/src/Grav/Common/Media/Traits/ImageLoadingTrait.php new file mode 100644 index 0000000..ffcbd5f --- /dev/null +++ b/system/src/Grav/Common/Media/Traits/ImageLoadingTrait.php @@ -0,0 +1,37 @@ +get('system.images.defaults.loading', 'auto'); + } + if ($value && $value !== 'auto') { + $this->attributes['loading'] = $value; + } + + return $this; + } +} diff --git a/system/src/Grav/Common/Media/Traits/ImageMediaTrait.php b/system/src/Grav/Common/Media/Traits/ImageMediaTrait.php new file mode 100644 index 0000000..83b2d26 --- /dev/null +++ b/system/src/Grav/Common/Media/Traits/ImageMediaTrait.php @@ -0,0 +1,428 @@ + [0, 1], + 'forceResize' => [0, 1], + 'cropResize' => [0, 1], + 'crop' => [0, 1, 2, 3], + 'zoomCrop' => [0, 1] + ]; + + /** @var string */ + protected $sizes = '100vw'; + + + /** + * Allows the ability to override the image's pretty name stored in cache + * + * @param string $name + */ + public function setImagePrettyName($name) + { + $this->set('prettyname', $name); + if ($this->image) { + $this->image->setPrettyName($name); + } + } + + /** + * @return string + */ + public function getImagePrettyName() + { + if ($this->get('prettyname')) { + return $this->get('prettyname'); + } + + $basename = $this->get('basename'); + if (preg_match('/[a-z0-9]{40}-(.*)/', $basename, $matches)) { + $basename = $matches[1]; + } + return $basename; + } + + /** + * Simply processes with no extra methods. Useful for triggering events. + * + * @return $this + */ + public function cache() + { + if (!$this->image) { + $this->image(); + } + + return $this; + } + + /** + * Generate alternative image widths, using either an array of integers, or + * a min width, a max width, and a step parameter to fill out the necessary + * widths. Existing image alternatives won't be overwritten. + * + * @param int|int[] $min_width + * @param int $max_width + * @param int $step + * @return $this + */ + public function derivatives($min_width, $max_width = 2500, $step = 200) + { + if (!empty($this->alternatives)) { + $max = max(array_keys($this->alternatives)); + $base = $this->alternatives[$max]; + } else { + $base = $this; + } + + $widths = []; + + if (func_num_args() === 1) { + foreach ((array) func_get_arg(0) as $width) { + if ($width < $base->get('width')) { + $widths[] = $width; + } + } + } else { + $max_width = min($max_width, $base->get('width')); + + for ($width = $min_width; $width < $max_width; $width += $step) { + $widths[] = $width; + } + } + + foreach ($widths as $width) { + // Only generate image alternatives that don't already exist + if (array_key_exists((int) $width, $this->alternatives)) { + continue; + } + + $derivative = MediumFactory::fromFile($base->get('filepath')); + + // It's possible that MediumFactory::fromFile returns null if the + // original image file no longer exists and this class instance was + // retrieved from the page cache + if (null !== $derivative) { + $index = 2; + $alt_widths = array_keys($this->alternatives); + sort($alt_widths); + + foreach ($alt_widths as $i => $key) { + if ($width > $key) { + $index += max($i, 1); + } + } + + $basename = preg_replace('/(@\d+x)?$/', "@{$width}w", $base->get('basename'), 1); + $derivative->setImagePrettyName($basename); + + $ratio = $base->get('width') / $width; + $height = $derivative->get('height') / $ratio; + + $derivative->resize($width, $height); + $derivative->set('width', $width); + $derivative->set('height', $height); + + $this->addAlternative($ratio, $derivative); + } + } + + return $this; + } + + /** + * Clear out the alternatives. + */ + public function clearAlternatives() + { + $this->alternatives = []; + } + + /** + * Sets or gets the quality of the image + * + * @param int|null $quality 0-100 quality + * @return int|$this + */ + public function quality($quality = null) + { + if ($quality) { + if (!$this->image) { + $this->image(); + } + + $this->quality = $quality; + + return $this; + } + + return $this->quality; + } + + /** + * Sets image output format. + * + * @param string $format + * @return $this + */ + public function format($format) + { + if (!$this->image) { + $this->image(); + } + + $this->format = $format; + + return $this; + } + + /** + * Set or get sizes parameter for srcset media action + * + * @param string|null $sizes + * @return string + */ + public function sizes($sizes = null) + { + if ($sizes) { + $this->sizes = $sizes; + + return $this; + } + + return empty($this->sizes) ? '100vw' : $this->sizes; + } + + /** + * Allows to set the width attribute from Markdown or Twig + * Examples: ![Example](myimg.png?width=200&height=400) + * ![Example](myimg.png?resize=100,200&width=100&height=200) + * ![Example](myimg.png?width=auto&height=auto) + * ![Example](myimg.png?width&height) + * {{ page.media['myimg.png'].width().height().html }} + * {{ page.media['myimg.png'].resize(100,200).width(100).height(200).html }} + * + * @param string|int $value A value or 'auto' or empty to use the width of the image + * @return $this + */ + public function width($value = 'auto') + { + if (!$value || $value === 'auto') { + $this->attributes['width'] = $this->get('width'); + } else { + $this->attributes['width'] = $value; + } + + return $this; + } + + /** + * Allows to set the height attribute from Markdown or Twig + * Examples: ![Example](myimg.png?width=200&height=400) + * ![Example](myimg.png?resize=100,200&width=100&height=200) + * ![Example](myimg.png?width=auto&height=auto) + * ![Example](myimg.png?width&height) + * {{ page.media['myimg.png'].width().height().html }} + * {{ page.media['myimg.png'].resize(100,200).width(100).height(200).html }} + * + * @param string|int $value A value or 'auto' or empty to use the height of the image + * @return $this + */ + public function height($value = 'auto') + { + if (!$value || $value === 'auto') { + $this->attributes['height'] = $this->get('height'); + } else { + $this->attributes['height'] = $value; + } + + return $this; + } + + /** + * Filter image by using user defined filter parameters. + * + * @param string $filter Filter to be used. + * @return $this + */ + public function filter($filter = 'image.filters.default') + { + $filters = (array) $this->get($filter, []); + foreach ($filters as $params) { + $params = (array) $params; + $method = array_shift($params); + $this->__call($method, $params); + } + + return $this; + } + + /** + * Return the image higher quality version + * + * @return ImageMediaInterface|$this the alternative version with higher quality + */ + public function higherQualityAlternative() + { + if ($this->alternatives) { + /** @var ImageMedium $max */ + $max = reset($this->alternatives); + /** @var ImageMedium $alternative */ + foreach ($this->alternatives as $alternative) { + if ($alternative->quality() > $max->quality()) { + $max = $alternative; + } + } + + return $max; + } + + return $this; + } + + /** + * Gets medium image, resets image manipulation operations. + * + * @return $this + */ + protected function image() + { + $locator = Grav::instance()['locator']; + + // Use existing cache folder or if it doesn't exist, create it. + $cacheDir = $locator->findResource('cache://images', true) ?: $locator->findResource('cache://images', true, true); + + // Make sure we free previous image. + unset($this->image); + + /** @var MediaCollectionInterface $media */ + $media = $this->get('media'); + if ($media && method_exists($media, 'getImageFileObject')) { + $this->image = $media->getImageFileObject($this); + } else { + $this->image = ImageFile::open($this->get('filepath')); + } + + $this->image + ->setCacheDir($cacheDir) + ->setActualCacheDir($cacheDir) + ->setPrettyName($this->getImagePrettyName()); + + // Fix orientation if enabled + $config = Grav::instance()['config']; + if ($config->get('system.images.auto_fix_orientation', false) && + extension_loaded('exif') && function_exists('exif_read_data')) { + $this->image->fixOrientation(); + } + + // Set CLS configuration + $this->auto_sizes = $config->get('system.images.cls.auto_sizes', false); + $this->aspect_ratio = $config->get('system.images.cls.aspect_ratio', false); + $this->retina_scale = $config->get('system.images.cls.retina_scale', 1); + + $this->watermark = $config->get('system.images.watermark.watermark_all', false); + + return $this; + } + + /** + * Save the image with cache. + * + * @return string + */ + protected function saveImage() + { + if (!$this->image) { + return parent::path(false); + } + + $this->filter(); + + if (isset($this->result)) { + return $this->result; + } + + if ($this->format === 'guess') { + $extension = strtolower($this->get('extension')); + $this->format($extension); + } + + if (!$this->debug_watermarked && $this->get('debug')) { + $ratio = $this->get('ratio'); + if (!$ratio) { + $ratio = 1; + } + + $locator = Grav::instance()['locator']; + $overlay = $locator->findResource("system://assets/responsive-overlays/{$ratio}x.png") ?: $locator->findResource('system://assets/responsive-overlays/unknown.png'); + $this->image->merge(ImageFile::open($overlay)); + } + + if ($this->watermark) { + $this->watermark(); + } + + return $this->image->cacheFile($this->format, $this->quality, false, [$this->get('width'), $this->get('height'), $this->get('modified')]); + } +} diff --git a/system/src/Grav/Common/Media/Traits/MediaFileTrait.php b/system/src/Grav/Common/Media/Traits/MediaFileTrait.php new file mode 100644 index 0000000..9e3f870 --- /dev/null +++ b/system/src/Grav/Common/Media/Traits/MediaFileTrait.php @@ -0,0 +1,139 @@ +path(false); + + return file_exists($path); + } + + /** + * Get file modification time for the medium. + * + * @return int|null + */ + public function modified() + { + $path = $this->path(false); + if (!file_exists($path)) { + return null; + } + + return filemtime($path) ?: null; + } + + /** + * Get size of the medium. + * + * @return int + */ + public function size() + { + $path = $this->path(false); + if (!file_exists($path)) { + return 0; + } + + return filesize($path) ?: 0; + } + + /** + * Return PATH to file. + * + * @param bool $reset + * @return string path to file + */ + public function path($reset = true) + { + if ($reset) { + $this->reset(); + } + + return $this->get('url') ?? $this->get('filepath'); + } + + /** + * Return the relative path to file + * + * @param bool $reset + * @return string + */ + public function relativePath($reset = true) + { + if ($reset) { + $this->reset(); + } + + $path = $this->path(false); + $output = preg_replace('|^' . preg_quote(GRAV_ROOT, '|') . '|', '', $path) ?: $path; + + /** @var UniformResourceLocator $locator */ + $locator = $this->getGrav()['locator']; + if ($locator->isStream($output)) { + $output = (string)($locator->findResource($output, false) ?: $locator->findResource($output, false, true)); + } + + return $output; + } + + /** + * Return URL to file. + * + * @param bool $reset + * @return string + */ + public function url($reset = true) + { + $url = $this->get('url'); + if ($url) { + return $url; + } + + $path = $this->relativePath($reset); + + return trim($this->getGrav()['base_url'] . '/' . $this->urlQuerystring($path), '\\'); + } + + /** + * Get the URL with full querystring + * + * @param string $url + * @return string + */ + abstract public function urlQuerystring($url); + + /** + * Reset medium. + * + * @return $this + */ + abstract public function reset(); + + /** + * @return Grav + */ + abstract protected function getGrav(): Grav; +} diff --git a/system/src/Grav/Common/Media/Traits/MediaObjectTrait.php b/system/src/Grav/Common/Media/Traits/MediaObjectTrait.php new file mode 100644 index 0000000..f872dd1 --- /dev/null +++ b/system/src/Grav/Common/Media/Traits/MediaObjectTrait.php @@ -0,0 +1,630 @@ +getItems()); + } + + /** + * Set querystring to file modification timestamp (or value provided as a parameter). + * + * @param string|int|null $timestamp + * @return $this + */ + public function setTimestamp($timestamp = null) + { + if (null !== $timestamp) { + $this->timestamp = (string)($timestamp); + } elseif ($this instanceof MediaFileInterface) { + $this->timestamp = (string)$this->modified(); + } else { + $this->timestamp = ''; + } + + return $this; + } + + /** + * Returns an array containing just the metadata + * + * @return array + */ + public function metadata() + { + return $this->metadata; + } + + /** + * Add meta file for the medium. + * + * @param string $filepath + */ + abstract public function addMetaFile($filepath); + + /** + * Add alternative Medium to this Medium. + * + * @param int|float $ratio + * @param MediaObjectInterface $alternative + */ + public function addAlternative($ratio, MediaObjectInterface $alternative) + { + if (!is_numeric($ratio) || $ratio === 0) { + return; + } + + $alternative->set('ratio', $ratio); + $width = $alternative->get('width', 0); + + $this->alternatives[$width] = $alternative; + } + + /** + * @param bool $withDerived + * @return array + */ + public function getAlternatives(bool $withDerived = true): array + { + $alternatives = []; + foreach ($this->alternatives + [$this->get('width', 0) => $this] as $size => $alternative) { + if ($withDerived || $alternative->filename === Utils::basename($alternative->filepath)) { + $alternatives[$size] = $alternative; + } + } + + ksort($alternatives, SORT_NUMERIC); + + return $alternatives; + } + + /** + * Return string representation of the object (html). + * + * @return string + */ + #[\ReturnTypeWillChange] + abstract public function __toString(); + + /** + * Get/set querystring for the file's url + * + * @param string|null $querystring + * @param bool $withQuestionmark + * @return string + */ + public function querystring($querystring = null, $withQuestionmark = true) + { + if (null !== $querystring) { + $this->medium_querystring[] = ltrim($querystring, '?&'); + foreach ($this->alternatives as $alt) { + $alt->querystring($querystring, $withQuestionmark); + } + } + + if (empty($this->medium_querystring)) { + return ''; + } + + // join the strings + $querystring = implode('&', $this->medium_querystring); + // explode all strings + $query_parts = explode('&', $querystring); + // Join them again now ensure the elements are unique + $querystring = implode('&', array_unique($query_parts)); + + return $withQuestionmark ? ('?' . $querystring) : $querystring; + } + + /** + * Get the URL with full querystring + * + * @param string $url + * @return string + */ + public function urlQuerystring($url) + { + $querystring = $this->querystring(); + if (isset($this->timestamp) && !Utils::contains($querystring, $this->timestamp)) { + $querystring = empty($querystring) ? ('?' . $this->timestamp) : ($querystring . '&' . $this->timestamp); + } + + return ltrim($url . $querystring . $this->urlHash(), '/'); + } + + /** + * Get/set hash for the file's url + * + * @param string|null $hash + * @param bool $withHash + * @return string + */ + public function urlHash($hash = null, $withHash = true) + { + if ($hash) { + $this->set('urlHash', ltrim($hash, '#')); + } + + $hash = $this->get('urlHash', ''); + + return $withHash && !empty($hash) ? '#' . $hash : $hash; + } + + /** + * Get an element (is array) that can be rendered by the Parsedown engine + * + * @param string|null $title + * @param string|null $alt + * @param string|null $class + * @param string|null $id + * @param bool $reset + * @return array + */ + public function parsedownElement($title = null, $alt = null, $class = null, $id = null, $reset = true) + { + $attributes = $this->attributes; + $items = $this->getItems(); + + $style = ''; + foreach ($this->styleAttributes as $key => $value) { + if (is_numeric($key)) { // Special case for inline style attributes, refer to style() method + $style .= $value; + } else { + $style .= $key . ': ' . $value . ';'; + } + } + if ($style) { + $attributes['style'] = $style; + } + + if (empty($attributes['title'])) { + if (!empty($title)) { + $attributes['title'] = $title; + } elseif (!empty($items['title'])) { + $attributes['title'] = $items['title']; + } + } + + if (empty($attributes['alt'])) { + if (!empty($alt)) { + $attributes['alt'] = $alt; + } elseif (!empty($items['alt'])) { + $attributes['alt'] = $items['alt']; + } elseif (!empty($items['alt_text'])) { + $attributes['alt'] = $items['alt_text']; + } else { + $attributes['alt'] = ''; + } + } + + if (empty($attributes['class'])) { + if (!empty($class)) { + $attributes['class'] = $class; + } elseif (!empty($items['class'])) { + $attributes['class'] = $items['class']; + } + } + + if (empty($attributes['id'])) { + if (!empty($id)) { + $attributes['id'] = $id; + } elseif (!empty($items['id'])) { + $attributes['id'] = $items['id']; + } + } + + switch ($this->mode) { + case 'text': + $element = $this->textParsedownElement($attributes, false); + break; + case 'thumbnail': + $thumbnail = $this->getThumbnail(); + $element = $thumbnail ? $thumbnail->sourceParsedownElement($attributes, false) : []; + break; + case 'source': + $element = $this->sourceParsedownElement($attributes, false); + break; + default: + $element = []; + } + + if ($reset) { + $this->reset(); + } + + $this->display('source'); + + return $element; + } + + /** + * Reset medium. + * + * @return $this + */ + public function reset() + { + $this->attributes = []; + + return $this; + } + + /** + * Add custom attribute to medium. + * + * @param string $attribute + * @param string $value + * @return $this + */ + public function attribute($attribute = null, $value = '') + { + if (!empty($attribute)) { + $this->attributes[$attribute] = $value; + } + return $this; + } + + /** + * Switch display mode. + * + * @param string $mode + * + * @return MediaObjectInterface|null + */ + public function display($mode = 'source') + { + if ($this->mode === $mode) { + return $this; + } + + $this->mode = $mode; + if ($mode === 'thumbnail') { + $thumbnail = $this->getThumbnail(); + + return $thumbnail ? $thumbnail->reset() : null; + } + + return $this->reset(); + } + + /** + * Helper method to determine if this media item has a thumbnail or not + * + * @param string $type; + * @return bool + */ + public function thumbnailExists($type = 'page') + { + $thumbs = $this->get('thumbnails'); + + return isset($thumbs[$type]); + } + + /** + * Switch thumbnail. + * + * @param string $type + * @return $this + */ + public function thumbnail($type = 'auto') + { + if ($type !== 'auto' && !in_array($type, $this->thumbnailTypes, true)) { + return $this; + } + + if ($this->thumbnailType !== $type) { + $this->_thumbnail = null; + } + + $this->thumbnailType = $type; + + return $this; + } + + /** + * Return URL to file. + * + * @param bool $reset + * @return string + */ + abstract public function url($reset = true); + + /** + * Turn the current Medium into a Link + * + * @param bool $reset + * @param array $attributes + * @return MediaLinkInterface + */ + public function link($reset = true, array $attributes = []) + { + if ($this->mode !== 'source') { + $this->display('source'); + } + + foreach ($this->attributes as $key => $value) { + empty($attributes['data-' . $key]) && $attributes['data-' . $key] = $value; + } + + empty($attributes['href']) && $attributes['href'] = $this->url(); + + return $this->createLink($attributes); + } + + /** + * Turn the current Medium into a Link with lightbox enabled + * + * @param int|null $width + * @param int|null $height + * @param bool $reset + * @return MediaLinkInterface + */ + public function lightbox($width = null, $height = null, $reset = true) + { + $attributes = ['rel' => 'lightbox']; + + if ($width && $height) { + $attributes['data-width'] = $width; + $attributes['data-height'] = $height; + } + + return $this->link($reset, $attributes); + } + + /** + * Add a class to the element from Markdown or Twig + * Example: ![Example](myimg.png?classes=float-left) or ![Example](myimg.png?classes=myclass1,myclass2) + * + * @return $this + */ + public function classes() + { + $classes = func_get_args(); + if (!empty($classes)) { + $this->attributes['class'] = implode(',', $classes); + } + + return $this; + } + + /** + * Add an id to the element from Markdown or Twig + * Example: ![Example](myimg.png?id=primary-img) + * + * @param string $id + * @return $this + */ + public function id($id) + { + if (is_string($id)) { + $this->attributes['id'] = trim($id); + } + + return $this; + } + + /** + * Allows to add an inline style attribute from Markdown or Twig + * Example: ![Example](myimg.png?style=float:left) + * + * @param string $style + * @return $this + */ + public function style($style) + { + $this->styleAttributes[] = rtrim($style, ';') . ';'; + + return $this; + } + + /** + * Allow any action to be called on this medium from twig or markdown + * + * @param string $method + * @param array $args + * @return $this + */ + #[\ReturnTypeWillChange] + public function __call($method, $args) + { + $count = count($args); + if ($count > 1 || ($count === 1 && !empty($args[0]))) { + $method .= '=' . implode(',', array_map(static function ($a) { + if (is_array($a)) { + $a = '[' . implode(',', $a) . ']'; + } + + return rawurlencode($a); + }, $args)); + } + + if (!empty($method)) { + $this->querystring($this->querystring(null, false) . '&' . $method); + } + + return $this; + } + + /** + * Parsedown element for source display mode + * + * @param array $attributes + * @param bool $reset + * @return array + */ + protected function sourceParsedownElement(array $attributes, $reset = true) + { + return $this->textParsedownElement($attributes, $reset); + } + + /** + * Parsedown element for text display mode + * + * @param array $attributes + * @param bool $reset + * @return array + */ + protected function textParsedownElement(array $attributes, $reset = true) + { + if ($reset) { + $this->reset(); + } + + $text = $attributes['title'] ?? ''; + if ($text === '') { + $text = $attributes['alt'] ?? ''; + if ($text === '') { + $text = $this->get('filename'); + } + } + + return [ + 'name' => 'p', + 'attributes' => $attributes, + 'text' => $text + ]; + } + + /** + * Get the thumbnail Medium object + * + * @return ThumbnailImageMedium|null + */ + protected function getThumbnail() + { + if (null === $this->_thumbnail) { + $types = $this->thumbnailTypes; + + if ($this->thumbnailType !== 'auto') { + array_unshift($types, $this->thumbnailType); + } + + foreach ($types as $type) { + $thumb = $this->get("thumbnails.{$type}", false); + if ($thumb) { + $image = $thumb instanceof ThumbnailImageMedium ? $thumb : $this->createThumbnail($thumb); + if($image) { + $image->parent = $this; + $this->_thumbnail = $image; + } + break; + } + } + } + + return $this->_thumbnail; + } + + /** + * Get value by using dot notation for nested arrays/objects. + * + * @example $value = $this->get('this.is.my.nested.variable'); + * + * @param string $name Dot separated path to the requested value. + * @param mixed $default Default value (or null). + * @param string|null $separator Separator, defaults to '.' + * @return mixed Value. + */ + abstract public function get($name, $default = null, $separator = null); + + /** + * Set value by using dot notation for nested arrays/objects. + * + * @example $data->set('this.is.my.nested.variable', $value); + * + * @param string $name Dot separated path to the requested value. + * @param mixed $value New value. + * @param string|null $separator Separator, defaults to '.' + * @return $this + */ + abstract public function set($name, $value, $separator = null); + + /** + * @param string $thumb + */ + abstract protected function createThumbnail($thumb); + + /** + * @param array $attributes + * @return MediaLinkInterface + */ + abstract protected function createLink(array $attributes); + + /** + * @return array + */ + abstract protected function getItems(): array; +} diff --git a/system/src/Grav/Common/Media/Traits/MediaPlayerTrait.php b/system/src/Grav/Common/Media/Traits/MediaPlayerTrait.php new file mode 100644 index 0000000..97d79ef --- /dev/null +++ b/system/src/Grav/Common/Media/Traits/MediaPlayerTrait.php @@ -0,0 +1,113 @@ +attributes['controls'] = 'controls'; + } else { + unset($this->attributes['controls']); + } + + return $this; + } + + /** + * Allows to set the loop attribute + * + * @param bool $status + * @return $this + */ + public function loop($status = false) + { + if ($status) { + $this->attributes['loop'] = 'loop'; + } else { + unset($this->attributes['loop']); + } + + return $this; + } + + /** + * Allows to set the autoplay attribute + * + * @param bool $status + * @return $this + */ + public function autoplay($status = false) + { + if ($status) { + $this->attributes['autoplay'] = 'autoplay'; + } else { + unset($this->attributes['autoplay']); + } + + return $this; + } + + /** + * Allows to set the muted attribute + * + * @param bool $status + * @return $this + */ + public function muted($status = false) + { + if ($status) { + $this->attributes['muted'] = 'muted'; + } else { + unset($this->attributes['muted']); + } + + return $this; + } + + /** + * Allows to set the preload behaviour + * + * @param string|null $preload + * @return $this + */ + public function preload($preload = null) + { + $validPreloadAttrs = ['auto', 'metadata', 'none']; + + if (null === $preload) { + unset($this->attributes['preload']); + } elseif (in_array($preload, $validPreloadAttrs, true)) { + $this->attributes['preload'] = $preload; + } + + return $this; + } + + /** + * Reset player. + */ + public function resetPlayer() + { + $this->attributes['controls'] = 'controls'; + } +} diff --git a/system/src/Grav/Common/Media/Traits/MediaTrait.php b/system/src/Grav/Common/Media/Traits/MediaTrait.php new file mode 100644 index 0000000..93c4fdb --- /dev/null +++ b/system/src/Grav/Common/Media/Traits/MediaTrait.php @@ -0,0 +1,153 @@ +getMediaFolder(); + if (!$folder) { + return null; + } + + if (strpos($folder, '://')) { + return $folder; + } + + /** @var UniformResourceLocator $locator */ + $locator = Grav::instance()['locator']; + $user = $locator->findResource('user://'); + if (strpos($folder, $user) === 0) { + return 'user://' . substr($folder, strlen($user)+1); + } + + return null; + } + + /** + * Gets the associated media collection. + * + * @return MediaCollectionInterface|Media Representation of associated media. + */ + public function getMedia() + { + $media = $this->media; + if (null === $media) { + $cache = $this->getMediaCache(); + $cacheKey = md5('media' . $this->getCacheKey()); + + // Use cached media if possible. + $media = $cache->get($cacheKey); + if (!$media instanceof MediaCollectionInterface) { + $media = new Media($this->getMediaFolder(), $this->getMediaOrder(), $this->_loadMedia); + $cache->set($cacheKey, $media); + } + + $this->media = $media; + } + + return $media; + } + + /** + * Sets the associated media collection. + * + * @param MediaCollectionInterface|Media $media Representation of associated media. + * @return $this + */ + protected function setMedia(MediaCollectionInterface $media) + { + $cache = $this->getMediaCache(); + $cacheKey = md5('media' . $this->getCacheKey()); + $cache->set($cacheKey, $media); + + $this->media = $media; + + return $this; + } + + /** + * @return void + */ + protected function freeMedia() + { + $this->media = null; + } + + /** + * Clear media cache. + * + * @return void + */ + protected function clearMediaCache() + { + $cache = $this->getMediaCache(); + $cacheKey = md5('media' . $this->getCacheKey()); + $cache->delete($cacheKey); + + $this->freeMedia(); + } + + /** + * @return CacheInterface + */ + protected function getMediaCache() + { + /** @var Cache $cache */ + $cache = Grav::instance()['cache']; + + return $cache->getSimpleCache(); + } + + /** + * @return string + */ + abstract protected function getCacheKey(): string; +} diff --git a/system/src/Grav/Common/Media/Traits/MediaUploadTrait.php b/system/src/Grav/Common/Media/Traits/MediaUploadTrait.php new file mode 100644 index 0000000..36becdf --- /dev/null +++ b/system/src/Grav/Common/Media/Traits/MediaUploadTrait.php @@ -0,0 +1,680 @@ + true, // Whether path is in the media collection path itself. + 'avoid_overwriting' => false, // Do not override existing files (adds datetime postfix if conflict). + 'random_name' => false, // True if name needs to be randomized. + 'accept' => ['image/*'], // Accepted mime types or file extensions. + 'limit' => 10, // Maximum number of files. + 'filesize' => null, // Maximum filesize in MB. + 'destination' => null // Destination path, if empty, exception is thrown. + ]; + + /** + * Create Medium from an uploaded file. + * + * @param UploadedFileInterface $uploadedFile + * @param array $params + * @return Medium|null + */ + public function createFromUploadedFile(UploadedFileInterface $uploadedFile, array $params = []) + { + return MediumFactory::fromUploadedFile($uploadedFile, $params); + } + + /** + * Checks that uploaded file meets the requirements. Returns new filename. + * + * @example + * $filename = null; // Override filename if needed (ignored if randomizing filenames). + * $settings = ['destination' => 'user://pages/media']; // Settings from the form field. + * $filename = $media->checkUploadedFile($uploadedFile, $filename, $settings); + * $media->copyUploadedFile($uploadedFile, $filename); + * + * @param UploadedFileInterface $uploadedFile + * @param string|null $filename + * @param array|null $settings + * @return string + * @throws RuntimeException + */ + public function checkUploadedFile(UploadedFileInterface $uploadedFile, string $filename = null, array $settings = null): string + { + // Check if there is an upload error. + switch ($uploadedFile->getError()) { + case UPLOAD_ERR_OK: + break; + case UPLOAD_ERR_INI_SIZE: + case UPLOAD_ERR_FORM_SIZE: + throw new RuntimeException($this->translate('PLUGIN_ADMIN.EXCEEDED_FILESIZE_LIMIT'), 400); + case UPLOAD_ERR_PARTIAL: + case UPLOAD_ERR_NO_FILE: + if (!$uploadedFile instanceof FormFlashFile) { + throw new RuntimeException($this->translate('PLUGIN_ADMIN.NO_FILES_SENT'), 400); + } + break; + case UPLOAD_ERR_NO_TMP_DIR: + throw new RuntimeException($this->translate('PLUGIN_ADMIN.UPLOAD_ERR_NO_TMP_DIR'), 400); + case UPLOAD_ERR_CANT_WRITE: + case UPLOAD_ERR_EXTENSION: + default: + throw new RuntimeException($this->translate('PLUGIN_ADMIN.UNKNOWN_ERRORS'), 400); + } + + $metadata = [ + 'filename' => $uploadedFile->getClientFilename(), + 'mime' => $uploadedFile->getClientMediaType(), + 'size' => $uploadedFile->getSize(), + ]; + + if ($uploadedFile instanceof FormFlashFile) { + $uploadedFile->checkXss(); + } + + return $this->checkFileMetadata($metadata, $filename, $settings); + } + + /** + * Checks that file metadata meets the requirements. Returns new filename. + * + * @param array $metadata + * @param array|null $settings + * @return string + * @throws RuntimeException + */ + public function checkFileMetadata(array $metadata, string $filename = null, array $settings = null): string + { + // Add the defaults to the settings. + $settings = $this->getUploadSettings($settings); + + // Destination is always needed (but it can be set in defaults). + $self = $settings['self'] ?? false; + if (!isset($settings['destination']) && $self === false) { + throw new RuntimeException($this->translate('PLUGIN_ADMIN.DESTINATION_NOT_SPECIFIED'), 400); + } + + if (null === $filename) { + // If no filename is given, use the filename from the uploaded file (path is not allowed). + $folder = ''; + $filename = $metadata['filename'] ?? ''; + } else { + // If caller sets the filename, we will accept any custom path. + $folder = dirname($filename); + if ($folder === '.') { + $folder = ''; + } + $filename = Utils::basename($filename); + } + $extension = Utils::pathinfo($filename, PATHINFO_EXTENSION); + + // Decide which filename to use. + if ($settings['random_name']) { + // Generate random filename if asked for. + $filename = mb_strtolower(Utils::generateRandomString(15) . '.' . $extension); + } + + // Handle conflicting filename if needed. + if ($settings['avoid_overwriting']) { + $destination = $settings['destination']; + if ($destination && $this->fileExists($filename, $destination)) { + $filename = date('YmdHis') . '-' . $filename; + } + } + $filepath = $folder . $filename; + + // Check if the filename is allowed. + if (!Utils::checkFilename($filename)) { + throw new RuntimeException( + sprintf($this->translate('PLUGIN_ADMIN.FILEUPLOAD_UNABLE_TO_UPLOAD'), $filepath, $this->translate('PLUGIN_ADMIN.BAD_FILENAME')) + ); + } + + // Check if the file extension is allowed. + $extension = mb_strtolower($extension); + if (!$extension || !$this->getConfig()->get("media.types.{$extension}")) { + // Not a supported type. + throw new RuntimeException($this->translate('PLUGIN_ADMIN.UNSUPPORTED_FILE_TYPE') . ': ' . $extension, 400); + } + + // Calculate maximum file size (from MB). + $filesize = $settings['filesize']; + if ($filesize) { + $max_filesize = $filesize * 1048576; + if ($metadata['size'] > $max_filesize) { + // TODO: use own language string + throw new RuntimeException($this->translate('PLUGIN_ADMIN.EXCEEDED_GRAV_FILESIZE_LIMIT'), 400); + } + } elseif (null === $filesize) { + // Check size against the Grav upload limit. + $grav_limit = Utils::getUploadLimit(); + if ($grav_limit > 0 && $metadata['size'] > $grav_limit) { + throw new RuntimeException($this->translate('PLUGIN_ADMIN.EXCEEDED_GRAV_FILESIZE_LIMIT'), 400); + } + } + + $grav = Grav::instance(); + /** @var MimeTypes $mimeChecker */ + $mimeChecker = $grav['mime']; + + // Handle Accepted file types. Accept can only be mime types (image/png | image/*) or file extensions (.pdf | .jpg) + // Do not trust mime type sent by the browser. + $mime = $metadata['mime'] ?? $mimeChecker->getMimeType($extension); + $validExtensions = $mimeChecker->getExtensions($mime); + if (!in_array($extension, $validExtensions, true)) { + throw new RuntimeException('The mime type does not match to file extension', 400); + } + + $accepted = false; + $errors = []; + foreach ((array)$settings['accept'] as $type) { + // Force acceptance of any file when star notation + if ($type === '*') { + $accepted = true; + break; + } + + $isMime = strstr($type, '/'); + $find = str_replace(['.', '*', '+'], ['\.', '.*', '\+'], $type); + + if ($isMime) { + $match = preg_match('#' . $find . '$#', $mime); + if (!$match) { + // TODO: translate + $errors[] = 'The MIME type "' . $mime . '" for the file "' . $filepath . '" is not an accepted.'; + } else { + $accepted = true; + break; + } + } else { + $match = preg_match('#' . $find . '$#', $filename); + if (!$match) { + // TODO: translate + $errors[] = 'The File Extension for the file "' . $filepath . '" is not an accepted.'; + } else { + $accepted = true; + break; + } + } + } + if (!$accepted) { + throw new RuntimeException(implode('
', $errors), 400); + } + + return $filepath; + } + + /** + * Copy uploaded file to the media collection. + * + * WARNING: Always check uploaded file before copying it! + * + * @example + * $settings = ['destination' => 'user://pages/media']; // Settings from the form field. + * $filename = $media->checkUploadedFile($uploadedFile, $filename, $settings); + * $media->copyUploadedFile($uploadedFile, $filename, $settings); + * + * @param UploadedFileInterface $uploadedFile + * @param string $filename + * @param array|null $settings + * @return void + * @throws RuntimeException + */ + public function copyUploadedFile(UploadedFileInterface $uploadedFile, string $filename, array $settings = null): void + { + // Add the defaults to the settings. + $settings = $this->getUploadSettings($settings); + + $path = $settings['destination'] ?? $this->getPath(); + if (!$path || !$filename) { + throw new RuntimeException($this->translate('PLUGIN_ADMIN.FAILED_TO_MOVE_UPLOADED_FILE'), 400); + } + + /** @var UniformResourceLocator $locator */ + $locator = $this->getGrav()['locator']; + + try { + // Clear locator cache to make sure we have up to date information from the filesystem. + $locator->clearCache(); + $this->clearCache(); + + $filesystem = Filesystem::getInstance(false); + + // Calculate path without the retina scaling factor. + $basename = $filesystem->basename($filename); + $pathname = $filesystem->pathname($filename); + + // Get name for the uploaded file. + [$base, $ext,,] = $this->getFileParts($basename); + $name = "{$pathname}{$base}.{$ext}"; + + // Upload file. + if ($uploadedFile instanceof FormFlashFile) { + // FormFlashFile needs some additional logic. + if ($uploadedFile->getError() === \UPLOAD_ERR_OK) { + // Move uploaded file. + $this->doMoveUploadedFile($uploadedFile, $filename, $path); + } elseif (strpos($filename, 'original/') === 0 && !$this->fileExists($filename, $path) && $this->fileExists($basename, $path)) { + // Original image support: override original image if it's the same as the uploaded image. + $this->doCopy($basename, $filename, $path); + } + + // FormFlashFile may also contain metadata. + $metadata = $uploadedFile->getMetaData(); + if ($metadata) { + // TODO: This overrides metadata if used with multiple retina image sizes. + $this->doSaveMetadata(['upload' => $metadata], $name, $path); + } + } else { + // Not a FormFlashFile. + $this->doMoveUploadedFile($uploadedFile, $filename, $path); + } + + // Post-processing: Special content sanitization for SVG. + $mime = Utils::getMimeByFilename($filename); + if (Utils::contains($mime, 'svg', false)) { + $this->doSanitizeSvg($filename, $path); + } + + // Add the new file into the media. + // TODO: This overrides existing media sizes if used with multiple retina image sizes. + $this->doAddUploadedMedium($name, $filename, $path); + + } catch (Exception $e) { + throw new RuntimeException($this->translate('PLUGIN_ADMIN.FAILED_TO_MOVE_UPLOADED_FILE') . $e->getMessage(), 400); + } finally { + // Finally clear media cache. + $locator->clearCache(); + $this->clearCache(); + } + } + + /** + * Delete real file from the media collection. + * + * @param string $filename + * @param array|null $settings + * @return void + * @throws RuntimeException + */ + public function deleteFile(string $filename, array $settings = null): void + { + // Add the defaults to the settings. + $settings = $this->getUploadSettings($settings); + $filesystem = Filesystem::getInstance(false); + + // First check for allowed filename. + $basename = $filesystem->basename($filename); + if (!Utils::checkFilename($basename)) { + throw new RuntimeException($this->translate('PLUGIN_ADMIN.FILE_COULD_NOT_BE_DELETED') . ": {$this->translate('PLUGIN_ADMIN.BAD_FILENAME')}: " . $filename, 400); + } + + $path = $settings['destination'] ?? $this->getPath(); + if (!$path) { + return; + } + + /** @var UniformResourceLocator $locator */ + $locator = $this->getGrav()['locator']; + $locator->clearCache(); + + $pathname = $filesystem->pathname($filename); + + // Get base name of the file. + [$base, $ext,,] = $this->getFileParts($basename); + $name = "{$pathname}{$base}.{$ext}"; + + // Remove file and all all the associated metadata. + $this->doRemove($name, $path); + + // Finally clear media cache. + $locator->clearCache(); + $this->clearCache(); + } + + /** + * Rename file inside the media collection. + * + * @param string $from + * @param string $to + * @param array|null $settings + */ + public function renameFile(string $from, string $to, array $settings = null): void + { + // Add the defaults to the settings. + $settings = $this->getUploadSettings($settings); + $filesystem = Filesystem::getInstance(false); + + $path = $settings['destination'] ?? $this->getPath(); + if (!$path) { + // TODO: translate error message + throw new RuntimeException('Failed to rename file: Bad destination', 400); + } + + /** @var UniformResourceLocator $locator */ + $locator = $this->getGrav()['locator']; + $locator->clearCache(); + + // Get base name of the file. + $pathname = $filesystem->pathname($from); + + // Remove @2x, @3x and .meta.yaml + [$base, $ext,,] = $this->getFileParts($filesystem->basename($from)); + $from = "{$pathname}{$base}.{$ext}"; + + [$base, $ext,,] = $this->getFileParts($filesystem->basename($to)); + $to = "{$pathname}{$base}.{$ext}"; + + $this->doRename($from, $to, $path); + + // Finally clear media cache. + $locator->clearCache(); + $this->clearCache(); + } + + /** + * Internal logic to move uploaded file. + * + * @param UploadedFileInterface $uploadedFile + * @param string $filename + * @param string $path + */ + protected function doMoveUploadedFile(UploadedFileInterface $uploadedFile, string $filename, string $path): void + { + $filepath = sprintf('%s/%s', $path, $filename); + + /** @var UniformResourceLocator $locator */ + $locator = $this->getGrav()['locator']; + + // Do not use streams internally. + if ($locator->isStream($filepath)) { + $filepath = (string)$locator->findResource($filepath, true, true); + } + + Folder::create(dirname($filepath)); + + $uploadedFile->moveTo($filepath); + } + + /** + * Get upload settings. + * + * @param array|null $settings Form field specific settings (override). + * @return array + */ + public function getUploadSettings(?array $settings = null): array + { + return null !== $settings ? $settings + $this->_upload_defaults : $this->_upload_defaults; + } + + /** + * Internal logic to copy file. + * + * @param string $src + * @param string $dst + * @param string $path + */ + protected function doCopy(string $src, string $dst, string $path): void + { + $src = sprintf('%s/%s', $path, $src); + $dst = sprintf('%s/%s', $path, $dst); + + /** @var UniformResourceLocator $locator */ + $locator = $this->getGrav()['locator']; + + // Do not use streams internally. + if ($locator->isStream($dst)) { + $dst = (string)$locator->findResource($dst, true, true); + } + + Folder::create(dirname($dst)); + + copy($src, $dst); + } + + /** + * Internal logic to rename file. + * + * @param string $from + * @param string $to + * @param string $path + */ + protected function doRename(string $from, string $to, string $path): void + { + /** @var UniformResourceLocator $locator */ + $locator = $this->getGrav()['locator']; + + $fromPath = $path . '/' . $from; + if ($locator->isStream($fromPath)) { + $fromPath = $locator->findResource($fromPath, true, true); + } + + if (!is_file($fromPath)) { + return; + } + + $mediaPath = dirname($fromPath); + $toPath = $mediaPath . '/' . $to; + if ($locator->isStream($toPath)) { + $toPath = $locator->findResource($toPath, true, true); + } + + if (is_file($toPath)) { + // TODO: translate error message + throw new RuntimeException(sprintf('File could not be renamed: %s already exists (%s)', $to, $mediaPath), 500); + } + + $result = rename($fromPath, $toPath); + if (!$result) { + // TODO: translate error message + throw new RuntimeException(sprintf('File could not be renamed: %s -> %s (%s)', $from, $to, $mediaPath), 500); + } + + // TODO: Add missing logic to handle retina files. + if (is_file($fromPath . '.meta.yaml')) { + $result = rename($fromPath . '.meta.yaml', $toPath . '.meta.yaml'); + if (!$result) { + // TODO: translate error message + throw new RuntimeException(sprintf('Meta could not be renamed: %s -> %s (%s)', $from, $to, $mediaPath), 500); + } + } + } + + /** + * Internal logic to remove file. + * + * @param string $filename + * @param string $path + */ + protected function doRemove(string $filename, string $path): void + { + $filesystem = Filesystem::getInstance(false); + + /** @var UniformResourceLocator $locator */ + $locator = $this->getGrav()['locator']; + + // If path doesn't exist, there's nothing to do. + $pathname = $filesystem->pathname($filename); + if (!$this->fileExists($pathname, $path)) { + return; + } + + $folder = $locator->isStream($path) ? (string)$locator->findResource($path, true, true) : $path; + + // Remove requested media file. + if ($this->fileExists($filename, $path)) { + $result = unlink("{$folder}/{$filename}"); + if (!$result) { + throw new RuntimeException($this->translate('PLUGIN_ADMIN.FILE_COULD_NOT_BE_DELETED') . ': ' . $filename, 500); + } + } + + // Remove associated metadata. + $this->doRemoveMetadata($filename, $path); + + // Remove associated 2x, 3x and their .meta.yaml files. + $targetPath = rtrim(sprintf('%s/%s', $folder, $pathname), '/'); + $dir = scandir($targetPath, SCANDIR_SORT_NONE); + if (false === $dir) { + throw new RuntimeException($this->translate('PLUGIN_ADMIN.FILE_COULD_NOT_BE_DELETED') . ': ' . $filename, 500); + } + + /** @var UniformResourceLocator $locator */ + $locator = $this->getGrav()['locator']; + + $basename = $filesystem->basename($filename); + $fileParts = (array)$filesystem->pathinfo($filename); + + foreach ($dir as $file) { + $preg_name = preg_quote($fileParts['filename'], '`'); + $preg_ext = preg_quote($fileParts['extension'] ?? '.', '`'); + $preg_filename = preg_quote($basename, '`'); + + if (preg_match("`({$preg_name}@\d+x\.{$preg_ext}(?:\.meta\.yaml)?$|{$preg_filename}\.meta\.yaml)$`", $file)) { + $testPath = $targetPath . '/' . $file; + if ($locator->isStream($testPath)) { + $testPath = (string)$locator->findResource($testPath, true, true); + $locator->clearCache($testPath); + } + + if (is_file($testPath)) { + $result = unlink($testPath); + if (!$result) { + throw new RuntimeException($this->translate('PLUGIN_ADMIN.FILE_COULD_NOT_BE_DELETED') . ': ' . $filename, 500); + } + } + } + } + + $this->hide($filename); + } + + /** + * @param array $metadata + * @param string $filename + * @param string $path + */ + protected function doSaveMetadata(array $metadata, string $filename, string $path): void + { + $filepath = sprintf('%s/%s', $path, $filename); + + /** @var UniformResourceLocator $locator */ + $locator = $this->getGrav()['locator']; + + // Do not use streams internally. + if ($locator->isStream($filepath)) { + $filepath = (string)$locator->findResource($filepath, true, true); + } + + $file = YamlFile::instance($filepath . '.meta.yaml'); + $file->save($metadata); + } + + /** + * @param string $filename + * @param string $path + */ + protected function doRemoveMetadata(string $filename, string $path): void + { + $filepath = sprintf('%s/%s', $path, $filename); + + /** @var UniformResourceLocator $locator */ + $locator = $this->getGrav()['locator']; + + // Do not use streams internally. + if ($locator->isStream($filepath)) { + $filepath = (string)$locator->findResource($filepath, true); + if (!$filepath) { + return; + } + } + + $file = YamlFile::instance($filepath . '.meta.yaml'); + if ($file->exists()) { + $file->delete(); + } + } + + /** + * @param string $filename + * @param string $path + */ + protected function doSanitizeSvg(string $filename, string $path): void + { + $filepath = sprintf('%s/%s', $path, $filename); + + /** @var UniformResourceLocator $locator */ + $locator = $this->getGrav()['locator']; + + // Do not use streams internally. + if ($locator->isStream($filepath)) { + $filepath = (string)$locator->findResource($filepath, true, true); + } + + Security::sanitizeSVG($filepath); + } + + /** + * @param string $name + * @param string $filename + * @param string $path + */ + protected function doAddUploadedMedium(string $name, string $filename, string $path): void + { + $filepath = sprintf('%s/%s', $path, $filename); + $medium = $this->createFromFile($filepath); + $realpath = $path . '/' . $name; + $this->add($realpath, $medium); + } + + /** + * @param string $string + * @return string + */ + protected function translate(string $string): string + { + return $this->getLanguage()->translate($string); + } + + abstract protected function getPath(): ?string; + + abstract protected function getGrav(): Grav; + + abstract protected function getConfig(): Config; + + abstract protected function getLanguage(): Language; + + abstract protected function clearCache(): void; +} diff --git a/system/src/Grav/Common/Media/Traits/StaticResizeTrait.php b/system/src/Grav/Common/Media/Traits/StaticResizeTrait.php new file mode 100644 index 0000000..617b600 --- /dev/null +++ b/system/src/Grav/Common/Media/Traits/StaticResizeTrait.php @@ -0,0 +1,40 @@ +styleAttributes['width'] = $width . 'px'; + } else { + unset($this->styleAttributes['width']); + } + if ($height) { + $this->styleAttributes['height'] = $height . 'px'; + } else { + unset($this->styleAttributes['height']); + } + + return $this; + } +} diff --git a/system/src/Grav/Common/Media/Traits/ThumbnailMediaTrait.php b/system/src/Grav/Common/Media/Traits/ThumbnailMediaTrait.php new file mode 100644 index 0000000..e0c5d81 --- /dev/null +++ b/system/src/Grav/Common/Media/Traits/ThumbnailMediaTrait.php @@ -0,0 +1,149 @@ +bubble('parsedownElement', [$title, $alt, $class, $id, $reset]); + } + + /** + * Return HTML markup from the medium. + * + * @param string|null $title + * @param string|null $alt + * @param string|null $class + * @param string|null $id + * @param bool $reset + * @return string + */ + public function html($title = null, $alt = null, $class = null, $id = null, $reset = true) + { + return $this->bubble('html', [$title, $alt, $class, $id, $reset]); + } + + /** + * Switch display mode. + * + * @param string $mode + * + * @return MediaLinkInterface|MediaObjectInterface|null + */ + public function display($mode = 'source') + { + return $this->bubble('display', [$mode], false); + } + + /** + * Switch thumbnail. + * + * @param string $type + * + * @return MediaLinkInterface|MediaObjectInterface + */ + public function thumbnail($type = 'auto') + { + $this->bubble('thumbnail', [$type], false); + + return $this->bubble('getThumbnail', [], false); + } + + /** + * Turn the current Medium into a Link + * + * @param bool $reset + * @param array $attributes + * @return MediaLinkInterface + */ + public function link($reset = true, array $attributes = []) + { + return $this->bubble('link', [$reset, $attributes], false); + } + + /** + * Turn the current Medium into a Link with lightbox enabled + * + * @param int|null $width + * @param int|null $height + * @param bool $reset + * @return MediaLinkInterface + */ + public function lightbox($width = null, $height = null, $reset = true) + { + return $this->bubble('lightbox', [$width, $height, $reset], false); + } + + /** + * Bubble a function call up to either the superclass function or the parent Medium instance + * + * @param string $method + * @param array $arguments + * @param bool $testLinked + * @return mixed + */ + protected function bubble($method, array $arguments = [], $testLinked = true) + { + if (!$testLinked || $this->linked) { + $parent = $this->parent; + if (null === $parent) { + return $this; + } + + $closure = [$parent, $method]; + + if (!is_callable($closure)) { + throw new BadMethodCallException(get_class($parent) . '::' . $method . '() not found.'); + } + + return $closure(...$arguments); + } + + return parent::{$method}(...$arguments); + } +} diff --git a/system/src/Grav/Common/Media/Traits/VideoMediaTrait.php b/system/src/Grav/Common/Media/Traits/VideoMediaTrait.php new file mode 100644 index 0000000..1da313c --- /dev/null +++ b/system/src/Grav/Common/Media/Traits/VideoMediaTrait.php @@ -0,0 +1,68 @@ +attributes['poster'] = $urlImage; + + return $this; + } + + /** + * Allows to set the playsinline attribute + * + * @param bool $status + * @return $this + */ + public function playsinline($status = false) + { + if ($status) { + $this->attributes['playsinline'] = 'playsinline'; + } else { + unset($this->attributes['playsinline']); + } + + return $this; + } + + /** + * Parsedown element for source display mode + * + * @param array $attributes + * @param bool $reset + * @return array + */ + protected function sourceParsedownElement(array $attributes, $reset = true) + { + $location = $this->url($reset); + + return [ + 'name' => 'video', + 'rawHtml' => 'Your browser does not support the video tag.', + 'attributes' => $attributes + ]; + } +} diff --git a/system/src/Grav/Common/Page/Collection.php b/system/src/Grav/Common/Page/Collection.php new file mode 100644 index 0000000..8a62555 --- /dev/null +++ b/system/src/Grav/Common/Page/Collection.php @@ -0,0 +1,710 @@ + + */ +class Collection extends Iterator implements PageCollectionInterface +{ + /** @var Pages */ + protected $pages; + /** @var array */ + protected $params; + + /** + * Collection constructor. + * + * @param array $items + * @param array $params + * @param Pages|null $pages + */ + public function __construct($items = [], array $params = [], Pages $pages = null) + { + parent::__construct($items); + + $this->params = $params; + $this->pages = $pages ?: Grav::instance()->offsetGet('pages'); + } + + /** + * Get the collection params + * + * @return array + */ + public function params() + { + return $this->params; + } + + /** + * Set parameters to the Collection + * + * @param array $params + * @return $this + */ + public function setParams(array $params) + { + $this->params = array_merge($this->params, $params); + + return $this; + } + + /** + * Add a single page to a collection + * + * @param PageInterface $page + * @return $this + */ + public function addPage(PageInterface $page) + { + $this->items[$page->path()] = ['slug' => $page->slug()]; + + return $this; + } + + /** + * Add a page with path and slug + * + * @param string $path + * @param string $slug + * @return $this + */ + public function add($path, $slug) + { + $this->items[$path] = ['slug' => $slug]; + + return $this; + } + + /** + * + * Create a copy of this collection + * + * @return static + */ + public function copy() + { + return new static($this->items, $this->params, $this->pages); + } + + /** + * + * Merge another collection with the current collection + * + * @param PageCollectionInterface $collection + * @return $this + */ + public function merge(PageCollectionInterface $collection) + { + foreach ($collection as $page) { + $this->addPage($page); + } + + return $this; + } + + /** + * Intersect another collection with the current collection + * + * @param PageCollectionInterface $collection + * @return $this + */ + public function intersect(PageCollectionInterface $collection) + { + $array1 = $this->items; + $array2 = $collection->toArray(); + + $this->items = array_uintersect($array1, $array2, function ($val1, $val2) { + return strcmp($val1['slug'], $val2['slug']); + }); + + return $this; + } + + /** + * Set current page. + */ + public function setCurrent(string $path): void + { + reset($this->items); + + while (($key = key($this->items)) !== null && $key !== $path) { + next($this->items); + } + } + + /** + * Returns current page. + * + * @return PageInterface + */ + #[\ReturnTypeWillChange] + public function current() + { + $current = parent::key(); + + return $this->pages->get($current); + } + + /** + * Returns current slug. + * + * @return mixed + */ + #[\ReturnTypeWillChange] + public function key() + { + $current = parent::current(); + + return $current['slug']; + } + + /** + * Returns the value at specified offset. + * + * @param string $offset + * @return PageInterface|null + */ + #[\ReturnTypeWillChange] + public function offsetGet($offset) + { + return $this->pages->get($offset) ?: null; + } + + /** + * Split collection into array of smaller collections. + * + * @param int $size + * @return Collection[] + */ + public function batch($size) + { + $chunks = array_chunk($this->items, $size, true); + + $list = []; + foreach ($chunks as $chunk) { + $list[] = new static($chunk, $this->params, $this->pages); + } + + return $list; + } + + /** + * Remove item from the list. + * + * @param PageInterface|string|null $key + * @return $this + * @throws InvalidArgumentException + */ + public function remove($key = null) + { + if ($key instanceof PageInterface) { + $key = $key->path(); + } elseif (null === $key) { + $key = (string)key($this->items); + } + if (!is_string($key)) { + throw new InvalidArgumentException('Invalid argument $key.'); + } + + parent::remove($key); + + return $this; + } + + /** + * Reorder collection. + * + * @param string $by + * @param string $dir + * @param array|null $manual + * @param string|null $sort_flags + * @return $this + */ + public function order($by, $dir = 'asc', $manual = null, $sort_flags = null) + { + $this->items = $this->pages->sortCollection($this, $by, $dir, $manual, $sort_flags); + + return $this; + } + + /** + * Check to see if this item is the first in the collection. + * + * @param string $path + * @return bool True if item is first. + */ + public function isFirst($path): bool + { + return $this->items && $path === array_keys($this->items)[0]; + } + + /** + * Check to see if this item is the last in the collection. + * + * @param string $path + * @return bool True if item is last. + */ + public function isLast($path): bool + { + return $this->items && $path === array_keys($this->items)[count($this->items) - 1]; + } + + /** + * Gets the previous sibling based on current position. + * + * @param string $path + * + * @return PageInterface The previous item. + */ + public function prevSibling($path) + { + return $this->adjacentSibling($path, -1); + } + + /** + * Gets the next sibling based on current position. + * + * @param string $path + * + * @return PageInterface The next item. + */ + public function nextSibling($path) + { + return $this->adjacentSibling($path, 1); + } + + /** + * Returns the adjacent sibling based on a direction. + * + * @param string $path + * @param int $direction either -1 or +1 + * @return PageInterface|Collection The sibling item. + */ + public function adjacentSibling($path, $direction = 1) + { + $values = array_keys($this->items); + $keys = array_flip($values); + + if (array_key_exists($path, $keys)) { + $index = $keys[$path] - $direction; + + return isset($values[$index]) ? $this->offsetGet($values[$index]) : $this; + } + + return $this; + } + + /** + * Returns the item in the current position. + * + * @param string $path the path the item + * @return int|null The index of the current page, null if not found. + */ + public function currentPosition($path): ?int + { + $pos = array_search($path, array_keys($this->items), true); + + return $pos !== false ? $pos : null; + } + + /** + * Returns the items between a set of date ranges of either the page date field (default) or + * an arbitrary datetime page field where start date and end date are optional + * Dates must be passed in as text that strtotime() can process + * http://php.net/manual/en/function.strtotime.php + * + * @param string|null $startDate + * @param string|null $endDate + * @param string|null $field + * @return $this + * @throws Exception + */ + public function dateRange($startDate = null, $endDate = null, $field = null) + { + $start = $startDate ? Utils::date2timestamp($startDate) : null; + $end = $endDate ? Utils::date2timestamp($endDate) : null; + + $date_range = []; + foreach ($this->items as $path => $slug) { + $page = $this->pages->get($path); + if (!$page) { + continue; + } + + $date = $field ? strtotime($page->value($field)) : $page->date(); + + if ((!$start || $date >= $start) && (!$end || $date <= $end)) { + $date_range[$path] = $slug; + } + } + + $this->items = $date_range; + + return $this; + } + + /** + * Creates new collection with only visible pages + * + * @return Collection The collection with only visible pages + */ + public function visible() + { + $visible = []; + + foreach ($this->items as $path => $slug) { + $page = $this->pages->get($path); + if ($page !== null && $page->visible()) { + $visible[$path] = $slug; + } + } + $this->items = $visible; + + return $this; + } + + /** + * Creates new collection with only non-visible pages + * + * @return Collection The collection with only non-visible pages + */ + public function nonVisible() + { + $visible = []; + + foreach ($this->items as $path => $slug) { + $page = $this->pages->get($path); + if ($page !== null && !$page->visible()) { + $visible[$path] = $slug; + } + } + $this->items = $visible; + + return $this; + } + + /** + * Creates new collection with only pages + * + * @return Collection The collection with only pages + */ + public function pages() + { + $modular = []; + + foreach ($this->items as $path => $slug) { + $page = $this->pages->get($path); + if ($page !== null && !$page->isModule()) { + $modular[$path] = $slug; + } + } + $this->items = $modular; + + return $this; + } + + /** + * Creates new collection with only modules + * + * @return Collection The collection with only modules + */ + public function modules() + { + $modular = []; + + foreach ($this->items as $path => $slug) { + $page = $this->pages->get($path); + if ($page !== null && $page->isModule()) { + $modular[$path] = $slug; + } + } + $this->items = $modular; + + return $this; + } + + /** + * Alias of pages() + * + * @return Collection The collection with only non-module pages + */ + public function nonModular() + { + $this->pages(); + + return $this; + } + + /** + * Alias of modules() + * + * @return Collection The collection with only modules + */ + public function modular() + { + $this->modules(); + + return $this; + } + + /** + * Creates new collection with only translated pages + * + * @return Collection The collection with only published pages + * @internal + */ + public function translated() + { + $published = []; + + foreach ($this->items as $path => $slug) { + $page = $this->pages->get($path); + if ($page !== null && $page->translated()) { + $published[$path] = $slug; + } + } + $this->items = $published; + + return $this; + } + + /** + * Creates new collection with only untranslated pages + * + * @return Collection The collection with only non-published pages + * @internal + */ + public function nonTranslated() + { + $published = []; + + foreach ($this->items as $path => $slug) { + $page = $this->pages->get($path); + if ($page !== null && !$page->translated()) { + $published[$path] = $slug; + } + } + $this->items = $published; + + return $this; + } + + /** + * Creates new collection with only published pages + * + * @return Collection The collection with only published pages + */ + public function published() + { + $published = []; + + foreach ($this->items as $path => $slug) { + $page = $this->pages->get($path); + if ($page !== null && $page->published()) { + $published[$path] = $slug; + } + } + $this->items = $published; + + return $this; + } + + /** + * Creates new collection with only non-published pages + * + * @return Collection The collection with only non-published pages + */ + public function nonPublished() + { + $published = []; + + foreach ($this->items as $path => $slug) { + $page = $this->pages->get($path); + if ($page !== null && !$page->published()) { + $published[$path] = $slug; + } + } + $this->items = $published; + + return $this; + } + + /** + * Creates new collection with only routable pages + * + * @return Collection The collection with only routable pages + */ + public function routable() + { + $routable = []; + + foreach ($this->items as $path => $slug) { + $page = $this->pages->get($path); + + if ($page !== null && $page->routable()) { + $routable[$path] = $slug; + } + } + + $this->items = $routable; + + return $this; + } + + /** + * Creates new collection with only non-routable pages + * + * @return Collection The collection with only non-routable pages + */ + public function nonRoutable() + { + $routable = []; + + foreach ($this->items as $path => $slug) { + $page = $this->pages->get($path); + if ($page !== null && !$page->routable()) { + $routable[$path] = $slug; + } + } + $this->items = $routable; + + return $this; + } + + /** + * Creates new collection with only pages of the specified type + * + * @param string $type + * @return Collection The collection + */ + public function ofType($type) + { + $items = []; + + foreach ($this->items as $path => $slug) { + $page = $this->pages->get($path); + if ($page !== null && $page->template() === $type) { + $items[$path] = $slug; + } + } + + $this->items = $items; + + return $this; + } + + /** + * Creates new collection with only pages of one of the specified types + * + * @param string[] $types + * @return Collection The collection + */ + public function ofOneOfTheseTypes($types) + { + $items = []; + + foreach ($this->items as $path => $slug) { + $page = $this->pages->get($path); + if ($page !== null && in_array($page->template(), $types, true)) { + $items[$path] = $slug; + } + } + + $this->items = $items; + + return $this; + } + + /** + * Creates new collection with only pages of one of the specified access levels + * + * @param array $accessLevels + * @return Collection The collection + */ + public function ofOneOfTheseAccessLevels($accessLevels) + { + $items = []; + + foreach ($this->items as $path => $slug) { + $page = $this->pages->get($path); + + if ($page !== null && isset($page->header()->access)) { + if (is_array($page->header()->access)) { + //Multiple values for access + $valid = false; + + foreach ($page->header()->access as $index => $accessLevel) { + if (is_array($accessLevel)) { + foreach ($accessLevel as $innerIndex => $innerAccessLevel) { + if (in_array($innerAccessLevel, $accessLevels, false)) { + $valid = true; + } + } + } else { + if (in_array($index, $accessLevels, false)) { + $valid = true; + } + } + } + if ($valid) { + $items[$path] = $slug; + } + } else { + //Single value for access + if (in_array($page->header()->access, $accessLevels, false)) { + $items[$path] = $slug; + } + } + } + } + + $this->items = $items; + + return $this; + } + + /** + * Get the extended version of this Collection with each page keyed by route + * + * @return array + * @throws Exception + */ + public function toExtendedArray() + { + $items = []; + foreach ($this->items as $path => $slug) { + $page = $this->pages->get($path); + + if ($page !== null) { + $items[$page->route()] = $page->toArray(); + } + } + return $items; + } +} diff --git a/system/src/Grav/Common/Page/Header.php b/system/src/Grav/Common/Page/Header.php new file mode 100644 index 0000000..a562b17 --- /dev/null +++ b/system/src/Grav/Common/Page/Header.php @@ -0,0 +1,38 @@ +toArray(); + } +} diff --git a/system/src/Grav/Common/Page/Interfaces/PageCollectionInterface.php b/system/src/Grav/Common/Page/Interfaces/PageCollectionInterface.php new file mode 100644 index 0000000..9f5588c --- /dev/null +++ b/system/src/Grav/Common/Page/Interfaces/PageCollectionInterface.php @@ -0,0 +1,310 @@ + + * @extends ArrayAccess + */ +interface PageCollectionInterface extends Traversable, ArrayAccess, Countable, Serializable +{ + /** + * Get the collection params + * + * @return array + */ + public function params(); + + /** + * Set parameters to the Collection + * + * @param array $params + * @return $this + */ + public function setParams(array $params); + + /** + * Add a single page to a collection + * + * @param PageInterface $page + * @return $this + */ + public function addPage(PageInterface $page); + + /** + * Add a page with path and slug + * + * @param string $path + * @param string $slug + * @return $this + */ + //public function add($path, $slug); + + /** + * + * Create a copy of this collection + * + * @return static + */ + public function copy(); + + /** + * + * Merge another collection with the current collection + * + * @param PageCollectionInterface $collection + * @return PageCollectionInterface + * @phpstan-return PageCollectionInterface + */ + public function merge(PageCollectionInterface $collection); + + /** + * Intersect another collection with the current collection + * + * @param PageCollectionInterface $collection + * @return PageCollectionInterface + * @phpstan-return PageCollectionInterface + */ + public function intersect(PageCollectionInterface $collection); + + /** + * Split collection into array of smaller collections. + * + * @param int $size + * @return PageCollectionInterface[] + * @phpstan-return array> + */ + public function batch($size); + + /** + * Remove item from the list. + * + * @param PageInterface|string|null $key + * @return PageCollectionInterface + * @phpstan-return PageCollectionInterface + * @throws InvalidArgumentException + */ + //public function remove($key = null); + + /** + * Reorder collection. + * + * @param string $by + * @param string $dir + * @param array|null $manual + * @param string|null $sort_flags + * @return PageCollectionInterface + * @phpstan-return PageCollectionInterface + */ + public function order($by, $dir = 'asc', $manual = null, $sort_flags = null); + + /** + * Check to see if this item is the first in the collection. + * + * @param string $path + * @return bool True if item is first. + */ + public function isFirst($path): bool; + + /** + * Check to see if this item is the last in the collection. + * + * @param string $path + * @return bool True if item is last. + */ + public function isLast($path): bool; + + /** + * Gets the previous sibling based on current position. + * + * @param string $path + * @return PageInterface The previous item. + * @phpstan-return T + */ + public function prevSibling($path); + + /** + * Gets the next sibling based on current position. + * + * @param string $path + * @return PageInterface The next item. + * @phpstan-return T + */ + public function nextSibling($path); + + /** + * Returns the adjacent sibling based on a direction. + * + * @param string $path + * @param int $direction either -1 or +1 + * @return PageInterface|PageCollectionInterface|false The sibling item. + * @phpstan-return T|false + */ + public function adjacentSibling($path, $direction = 1); + + /** + * Returns the item in the current position. + * + * @param string $path the path the item + * @return int|null The index of the current page, null if not found. + */ + public function currentPosition($path): ?int; + + /** + * Returns the items between a set of date ranges of either the page date field (default) or + * an arbitrary datetime page field where start date and end date are optional + * Dates must be passed in as text that strtotime() can process + * http://php.net/manual/en/function.strtotime.php + * + * @param string|null $startDate + * @param string|null $endDate + * @param string|null $field + * @return PageCollectionInterface + * @phpstan-return PageCollectionInterface + * @throws Exception + */ + public function dateRange($startDate = null, $endDate = null, $field = null); + + /** + * Creates new collection with only visible pages + * + * @return PageCollectionInterface The collection with only visible pages + * @phpstan-return PageCollectionInterface + */ + public function visible(); + + /** + * Creates new collection with only non-visible pages + * + * @return PageCollectionInterface The collection with only non-visible pages + * @phpstan-return PageCollectionInterface + */ + public function nonVisible(); + + /** + * Creates new collection with only pages + * + * @return PageCollectionInterface The collection with only pages + * @phpstan-return PageCollectionInterface + */ + public function pages(); + + /** + * Creates new collection with only modules + * + * @return PageCollectionInterface The collection with only modules + * @phpstan-return PageCollectionInterface + */ + public function modules(); + + /** + * Creates new collection with only modules + * + * @return PageCollectionInterface The collection with only modules + * @phpstan-return PageCollectionInterface + * @deprecated 1.7 Use $this->modules() instead + */ + public function modular(); + + /** + * Creates new collection with only non-module pages + * + * @return PageCollectionInterface The collection with only non-module pages + * @phpstan-return PageCollectionInterface + * @deprecated 1.7 Use $this->pages() instead + */ + public function nonModular(); + + /** + * Creates new collection with only published pages + * + * @return PageCollectionInterface The collection with only published pages + * @phpstan-return PageCollectionInterface + */ + public function published(); + + /** + * Creates new collection with only non-published pages + * + * @return PageCollectionInterface The collection with only non-published pages + * @phpstan-return PageCollectionInterface + */ + public function nonPublished(); + + /** + * Creates new collection with only routable pages + * + * @return PageCollectionInterface The collection with only routable pages + * @phpstan-return PageCollectionInterface + */ + public function routable(); + + /** + * Creates new collection with only non-routable pages + * + * @return PageCollectionInterface The collection with only non-routable pages + * @phpstan-return PageCollectionInterface + */ + public function nonRoutable(); + + /** + * Creates new collection with only pages of the specified type + * + * @param string $type + * @return PageCollectionInterface The collection + * @phpstan-return PageCollectionInterface + */ + public function ofType($type); + + /** + * Creates new collection with only pages of one of the specified types + * + * @param string[] $types + * @return PageCollectionInterface The collection + * @phpstan-return PageCollectionInterface + */ + public function ofOneOfTheseTypes($types); + + /** + * Creates new collection with only pages of one of the specified access levels + * + * @param array $accessLevels + * @return PageCollectionInterface The collection + * @phpstan-return PageCollectionInterface + */ + public function ofOneOfTheseAccessLevels($accessLevels); + + /** + * Converts collection into an array. + * + * @return array + */ + public function toArray(); + + /** + * Get the extended version of this Collection with each page keyed by route + * + * @return array + * @throws Exception + */ + public function toExtendedArray(); +} diff --git a/system/src/Grav/Common/Page/Interfaces/PageContentInterface.php b/system/src/Grav/Common/Page/Interfaces/PageContentInterface.php new file mode 100644 index 0000000..2df4286 --- /dev/null +++ b/system/src/Grav/Common/Page/Interfaces/PageContentInterface.php @@ -0,0 +1,267 @@ +true) for example + * + * @param array|null $var New array of name value pairs where the name is the process and value is true or false + * @return array Array of name value pairs where the name is the process and value is true or false + */ + public function process($var = null); + + /** + * Gets and Sets the slug for the Page. The slug is used in the URL routing. If not set it uses + * the parent folder from the path + * + * @param string|null $var New slug, e.g. 'my-blog' + * @return string The slug + */ + public function slug($var = null); + + /** + * Get/set order number of this page. + * + * @param int|null $var New order as a number + * @return string|bool Order in a form of '02.' or false if not set + */ + public function order($var = null); + + /** + * Gets and sets the identifier for this Page object. + * + * @param string|null $var New identifier + * @return string The identifier + */ + public function id($var = null); + + /** + * Gets and sets the modified timestamp. + * + * @param int|null $var New modified unix timestamp + * @return int Modified unix timestamp + */ + public function modified($var = null); + + /** + * Gets and sets the option to show the last_modified header for the page. + * + * @param bool|null $var New last_modified header value + * @return bool Show last_modified header + */ + public function lastModified($var = null); + + /** + * Get/set the folder. + * + * @param string|null $var New folder + * @return string|null The folder + */ + public function folder($var = null); + + /** + * Gets and sets the date for this Page object. This is typically passed in via the page headers + * + * @param string|null $var New string representation of a date + * @return int Unix timestamp representation of the date + */ + public function date($var = null); + + /** + * Gets and sets the date format for this Page object. This is typically passed in via the page headers + * using typical PHP date string structure - http://php.net/manual/en/function.date.php + * + * @param string|null $var New string representation of a date format + * @return string String representation of a date format + */ + public function dateformat($var = null); + + /** + * Gets and sets the taxonomy array which defines which taxonomies this page identifies itself with. + * + * @param array|null $var New array of taxonomies + * @return array An array of taxonomies + */ + public function taxonomy($var = null); + + /** + * Gets the configured state of the processing method. + * + * @param string $process The process name, eg "twig" or "markdown" + * @return bool Whether or not the processing method is enabled for this Page + */ + public function shouldProcess($process); + + /** + * Returns true if page is a module. + * + * @return bool + */ + public function isModule(): bool; + + /** + * Returns whether or not this Page object has a .md file associated with it or if its just a directory. + * + * @return bool True if its a page with a .md file associated + */ + public function isPage(); + + /** + * Returns whether or not this Page object is a directory or a page. + * + * @return bool True if its a directory + */ + public function isDir(); + + /** + * Returns whether the page exists in the filesystem. + * + * @return bool + */ + public function exists(); + + /** + * Returns the blueprint from the page. + * + * @param string $name Name of the Blueprint form. Used by flex only. + * @return Blueprint Returns a Blueprint. + */ + public function getBlueprint(string $name = ''); +} diff --git a/system/src/Grav/Common/Page/Interfaces/PageFormInterface.php b/system/src/Grav/Common/Page/Interfaces/PageFormInterface.php new file mode 100644 index 0000000..3c88ebf --- /dev/null +++ b/system/src/Grav/Common/Page/Interfaces/PageFormInterface.php @@ -0,0 +1,33 @@ + blueprint, ...], where blueprint follows the regular form blueprint format. + * + * @return array + */ + //public function getForms(): array; + + /** + * Add forms to this page. + * + * @param array $new + * @return $this + */ + public function addForms(array $new/*, $override = true*/); + + /** + * Alias of $this->getForms(); + * + * @return array + */ + public function forms();//: array; +} diff --git a/system/src/Grav/Common/Page/Interfaces/PageInterface.php b/system/src/Grav/Common/Page/Interfaces/PageInterface.php new file mode 100644 index 0000000..8595c54 --- /dev/null +++ b/system/src/Grav/Common/Page/Interfaces/PageInterface.php @@ -0,0 +1,25 @@ +save() in order to perform the move. + * + * @param PageInterface $parent New parent page. + * @return $this + */ + public function move(PageInterface $parent); + + /** + * Prepare a copy from the page. Copies also everything that's under the current page. + * + * Returns a new Page object for the copy. + * You need to call $this->save() in order to perform the move. + * + * @param PageInterface $parent New parent page. + * @return $this + */ + public function copy(PageInterface $parent); + + /** + * Get blueprints for the page. + * + * @return Blueprint + */ + public function blueprints(); + + /** + * Get the blueprint name for this page. Use the blueprint form field if set + * + * @return string + */ + public function blueprintName(); + + /** + * Validate page header. + * + * @throws Exception + */ + public function validate(); + + /** + * Filter page header from illegal contents. + */ + public function filter(); + + /** + * Get unknown header variables. + * + * @return array + */ + public function extra(); + + /** + * Convert page to an array. + * + * @return array + */ + public function toArray(); + + /** + * Convert page to YAML encoded string. + * + * @return string + */ + public function toYaml(); + + /** + * Convert page to JSON encoded string. + * + * @return string + */ + public function toJson(); + + /** + * Returns normalized list of name => form pairs. + * + * @return array + */ + public function forms(); + + /** + * @param array $new + */ + public function addForms(array $new); + + /** + * Gets and sets the name field. If no name field is set, it will return 'default.md'. + * + * @param string|null $var The name of this page. + * @return string The name of this page. + */ + public function name($var = null); + + /** + * Returns child page type. + * + * @return string + */ + public function childType(); + + /** + * Gets and sets the template field. This is used to find the correct Twig template file to render. + * If no field is set, it will return the name without the .md extension + * + * @param string|null $var the template name + * @return string the template name + */ + public function template($var = null); + + /** + * Allows a page to override the output render format, usually the extension provided + * in the URL. (e.g. `html`, `json`, `xml`, etc). + * + * @param string|null $var + * @return string + */ + public function templateFormat($var = null); + + /** + * Gets and sets the extension field. + * + * @param string|null $var + * @return string|null + */ + public function extension($var = null); + + /** + * Gets and sets the expires field. If not set will return the default + * + * @param int|null $var The new expires value. + * @return int The expires value + */ + public function expires($var = null); + + /** + * Gets and sets the cache-control property. If not set it will return the default value (null) + * https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Cache-Control for more details on valid options + * + * @param string|null $var + * @return string|null + */ + public function cacheControl($var = null); + + /** + * @param bool|null $var + * @return bool + */ + public function ssl($var = null); + + /** + * Returns the state of the debugger override etting for this page + * + * @return bool + */ + public function debugger(); + + /** + * Function to merge page metadata tags and build an array of Metadata objects + * that can then be rendered in the page. + * + * @param array|null $var an Array of metadata values to set + * @return array an Array of metadata values for the page + */ + public function metadata($var = null); + + /** + * Gets and sets the option to show the etag header for the page. + * + * @param bool|null $var show etag header + * @return bool show etag header + */ + public function eTag($var = null): bool; + + /** + * Gets and sets the path to the .md file for this Page object. + * + * @param string|null $var the file path + * @return string|null the file path + */ + public function filePath($var = null); + + /** + * Gets the relative path to the .md file + * + * @return string The relative file path + */ + public function filePathClean(); + + /** + * Gets and sets the order by which any sub-pages should be sorted. + * + * @param string|null $var the order, either "asc" or "desc" + * @return string the order, either "asc" or "desc" + * @deprecated 1.6 + */ + public function orderDir($var = null); + + /** + * Gets and sets the order by which the sub-pages should be sorted. + * + * default - is the order based on the file system, ie 01.Home before 02.Advark + * title - is the order based on the title set in the pages + * date - is the order based on the date set in the pages + * folder - is the order based on the name of the folder with any numerics omitted + * + * @param string|null $var supported options include "default", "title", "date", and "folder" + * @return string supported options include "default", "title", "date", and "folder" + * @deprecated 1.6 + */ + public function orderBy($var = null); + + /** + * Gets the manual order set in the header. + * + * @param string|null $var supported options include "default", "title", "date", and "folder" + * @return array + * @deprecated 1.6 + */ + public function orderManual($var = null); + + /** + * Gets and sets the maxCount field which describes how many sub-pages should be displayed if the + * sub_pages header property is set for this page object. + * + * @param int|null $var the maximum number of sub-pages + * @return int the maximum number of sub-pages + * @deprecated 1.6 + */ + public function maxCount($var = null); + + /** + * Gets and sets the modular var that helps identify this page is a modular child + * + * @param bool|null $var true if modular_twig + * @return bool true if modular_twig + * @deprecated 1.7 Use ->isModule() or ->modularTwig() method instead. + */ + public function modular($var = null); + + /** + * Gets and sets the modular_twig var that helps identify this page as a modular child page that will need + * twig processing handled differently from a regular page. + * + * @param bool|null $var true if modular_twig + * @return bool true if modular_twig + */ + public function modularTwig($var = null); + + /** + * Returns children of this page. + * + * @return PageCollectionInterface|Collection + */ + public function children(); + + /** + * Check to see if this item is the first in an array of sub-pages. + * + * @return bool True if item is first. + */ + public function isFirst(); + + /** + * Check to see if this item is the last in an array of sub-pages. + * + * @return bool True if item is last + */ + public function isLast(); + + /** + * Gets the previous sibling based on current position. + * + * @return PageInterface the previous Page item + */ + public function prevSibling(); + + /** + * Gets the next sibling based on current position. + * + * @return PageInterface the next Page item + */ + public function nextSibling(); + + /** + * Returns the adjacent sibling based on a direction. + * + * @param int $direction either -1 or +1 + * @return PageInterface|false the sibling page + */ + public function adjacentSibling($direction = 1); + + /** + * Helper method to return an ancestor page. + * + * @param bool|null $lookup Name of the parent folder + * @return PageInterface page you were looking for if it exists + */ + public function ancestor($lookup = null); + + /** + * Helper method to return an ancestor page to inherit from. The current + * page object is returned. + * + * @param string $field Name of the parent folder + * @return PageInterface + */ + public function inherited($field); + + /** + * Helper method to return an ancestor field only to inherit from. The + * first occurrence of an ancestor field will be returned if at all. + * + * @param string $field Name of the parent folder + * @return array + */ + public function inheritedField($field); + + /** + * Helper method to return a page. + * + * @param string $url the url of the page + * @param bool $all + * @return PageInterface page you were looking for if it exists + */ + public function find($url, $all = false); + + /** + * Get a collection of pages in the current context. + * + * @param string|array $params + * @param bool $pagination + * @return Collection + * @throws InvalidArgumentException + */ + public function collection($params = 'content', $pagination = true); + + /** + * @param string|array $value + * @param bool $only_published + * @return PageCollectionInterface|Collection + */ + public function evaluate($value, $only_published = true); + + /** + * Returns whether or not the current folder exists + * + * @return bool + */ + public function folderExists(); + + /** + * Gets the Page Unmodified (original) version of the page. + * + * @return PageInterface The original version of the page. + */ + public function getOriginal(); + + /** + * Gets the action. + * + * @return string The Action string. + */ + public function getAction(); +} diff --git a/system/src/Grav/Common/Page/Interfaces/PageRoutableInterface.php b/system/src/Grav/Common/Page/Interfaces/PageRoutableInterface.php new file mode 100644 index 0000000..2900266 --- /dev/null +++ b/system/src/Grav/Common/Page/Interfaces/PageRoutableInterface.php @@ -0,0 +1,180 @@ +page = $page ?? Grav::instance()['page'] ?? null; + + // Add defaults to the configuration. + if (null === $config || !isset($config['markdown'], $config['images'])) { + $c = Grav::instance()['config']; + $config = $config ?? []; + $config += [ + 'markdown' => $c->get('system.pages.markdown', []), + 'images' => $c->get('system.images', []) + ]; + } + + $this->config = $config; + } + + /** + * @return PageInterface|null + */ + public function getPage(): ?PageInterface + { + return $this->page; + } + + /** + * @return array + */ + public function getConfig(): array + { + return $this->config; + } + + /** + * @param object $markdown + * @return void + */ + public function fireInitializedEvent($markdown): void + { + $grav = Grav::instance(); + + $grav->fireEvent('onMarkdownInitialized', new Event(['markdown' => $markdown, 'page' => $this->page])); + } + + /** + * Process a Link excerpt + * + * @param array $excerpt + * @param string $type + * @return array + */ + public function processLinkExcerpt(array $excerpt, string $type = 'link'): array + { + $grav = Grav::instance(); + $url = htmlspecialchars_decode(rawurldecode($excerpt['element']['attributes']['href'])); + $url_parts = $this->parseUrl($url); + + // If there is a query, then parse it and build action calls. + if (isset($url_parts['query'])) { + $actions = array_reduce( + explode('&', $url_parts['query']), + static function ($carry, $item) { + $parts = explode('=', $item, 2); + $value = isset($parts[1]) ? rawurldecode($parts[1]) : true; + $carry[$parts[0]] = $value; + + return $carry; + }, + [] + ); + + // Valid attributes supported. + $valid_attributes = $grav['config']->get('system.pages.markdown.valid_link_attributes') ?? []; + + $skip = []; + // Unless told to not process, go through actions. + if (array_key_exists('noprocess', $actions)) { + $skip = is_bool($actions['noprocess']) ? $actions : explode(',', $actions['noprocess']); + unset($actions['noprocess']); + } + + // Loop through actions for the image and call them. + foreach ($actions as $attrib => $value) { + if (!in_array($attrib, $skip)) { + $key = $attrib; + + if (in_array($attrib, $valid_attributes, true)) { + // support both class and classes. + if ($attrib === 'classes') { + $attrib = 'class'; + } + $excerpt['element']['attributes'][$attrib] = str_replace(',', ' ', $value); + unset($actions[$key]); + } + } + } + + $url_parts['query'] = http_build_query($actions, '', '&', PHP_QUERY_RFC3986); + } + + // If no query elements left, unset query. + if (empty($url_parts['query'])) { + unset($url_parts['query']); + } + + // Set path to / if not set. + if (empty($url_parts['path'])) { + $url_parts['path'] = ''; + } + + // If scheme isn't http(s).. + if (!empty($url_parts['scheme']) && !in_array($url_parts['scheme'], ['http', 'https'])) { + // Handle custom streams. + /** @var UniformResourceLocator $locator */ + $locator = $grav['locator']; + if ($type === 'link' && $locator->isStream($url)) { + $path = $locator->findResource($url, false) ?: $locator->findResource($url, false, true); + $url_parts['path'] = $grav['base_url_relative'] . '/' . $path; + unset($url_parts['stream'], $url_parts['scheme']); + } + + $excerpt['element']['attributes']['href'] = Uri::buildUrl($url_parts); + + return $excerpt; + } + + // Handle paths and such. + $url_parts = Uri::convertUrl($this->page, $url_parts, $type); + + // Build the URL from the component parts and set it on the element. + $excerpt['element']['attributes']['href'] = Uri::buildUrl($url_parts); + + return $excerpt; + } + + /** + * Process an image excerpt + * + * @param array $excerpt + * @return array + */ + public function processImageExcerpt(array $excerpt): array + { + $url = htmlspecialchars_decode(urldecode($excerpt['element']['attributes']['src'])); + $url_parts = $this->parseUrl($url); + + $media = null; + $filename = null; + + if (!empty($url_parts['stream'])) { + $filename = $url_parts['scheme'] . '://' . ($url_parts['path'] ?? ''); + + $media = $this->page->getMedia(); + } else { + $grav = Grav::instance(); + /** @var Pages $pages */ + $pages = $grav['pages']; + + // File is also local if scheme is http(s) and host matches. + $local_file = isset($url_parts['path']) + && (empty($url_parts['scheme']) || in_array($url_parts['scheme'], ['http', 'https'], true)) + && (empty($url_parts['host']) || $url_parts['host'] === $grav['uri']->host()); + + if ($local_file) { + $filename = Utils::basename($url_parts['path']); + $folder = dirname($url_parts['path']); + + // Get the local path to page media if possible. + if ($this->page && $folder === $this->page->url(false, false, false)) { + // Get the media objects for this page. + $media = $this->page->getMedia(); + } else { + // see if this is an external page to this one + $base_url = rtrim($grav['base_url_relative'] . $pages->base(), '/'); + $page_route = '/' . ltrim(str_replace($base_url, '', $folder), '/'); + + $ext_page = $pages->find($page_route, true); + if ($ext_page) { + $media = $ext_page->getMedia(); + } else { + $grav->fireEvent('onMediaLocate', new Event(['route' => $page_route, 'media' => &$media])); + } + } + } + } + + // If there is a media file that matches the path referenced.. + if ($media && $filename && isset($media[$filename])) { + // Get the medium object. + /** @var Medium $medium */ + $medium = $media[$filename]; + + // Process operations + $medium = $this->processMediaActions($medium, $url_parts); + $element_excerpt = $excerpt['element']['attributes']; + + $alt = $element_excerpt['alt'] ?? ''; + $title = $element_excerpt['title'] ?? ''; + $class = $element_excerpt['class'] ?? ''; + $id = $element_excerpt['id'] ?? ''; + + $excerpt['element'] = $medium->parsedownElement($title, $alt, $class, $id, true); + } else { + // Not a current page media file, see if it needs converting to relative. + $excerpt['element']['attributes']['src'] = Uri::buildUrl($url_parts); + } + + return $excerpt; + } + + /** + * Process media actions + * + * @param Medium $medium + * @param string|array $url + * @return Medium|Link + */ + public function processMediaActions($medium, $url) + { + $url_parts = is_string($url) ? $this->parseUrl($url) : $url; + $actions = []; + + + // if there is a query, then parse it and build action calls + if (isset($url_parts['query'])) { + $actions = array_reduce( + explode('&', $url_parts['query']), + static function ($carry, $item) { + $parts = explode('=', $item, 2); + $value = $parts[1] ?? null; + $carry[] = ['method' => $parts[0], 'params' => $value]; + + return $carry; + }, + [] + ); + } + + $defaults = $this->config['images']['defaults'] ?? []; + if (count($defaults)) { + foreach ($defaults as $method => $params) { + if (array_search($method, array_column($actions, 'method')) === false) { + $actions[] = [ + 'method' => $method, + 'params' => $params, + ]; + } + } + } + + // loop through actions for the image and call them + foreach ($actions as $action) { + $matches = []; + + if (preg_match('/\[(.*)\]/', $action['params'], $matches)) { + $args = [explode(',', $matches[1])]; + } else { + $args = explode(',', $action['params']); + } + + $medium = call_user_func_array([$medium, $action['method']], $args); + } + + if (isset($url_parts['fragment'])) { + $medium->urlHash($url_parts['fragment']); + } + + return $medium; + } + + /** + * Variation of parse_url() which works also with local streams. + * + * @param string $url + * @return array + */ + protected function parseUrl(string $url) + { + $url_parts = Utils::multibyteParseUrl($url); + + if (isset($url_parts['scheme'])) { + /** @var UniformResourceLocator $locator */ + $locator = Grav::instance()['locator']; + + // Special handling for the streams. + if ($locator->schemeExists($url_parts['scheme'])) { + if (isset($url_parts['host'])) { + // Merge host and path into a path. + $url_parts['path'] = $url_parts['host'] . (isset($url_parts['path']) ? '/' . $url_parts['path'] : ''); + unset($url_parts['host']); + } + + $url_parts['stream'] = true; + } + } + + return $url_parts; + } +} diff --git a/system/src/Grav/Common/Page/Media.php b/system/src/Grav/Common/Page/Media.php new file mode 100644 index 0000000..b29bbf3 --- /dev/null +++ b/system/src/Grav/Common/Page/Media.php @@ -0,0 +1,286 @@ +setPath($path); + $this->media_order = $media_order; + + $this->__wakeup(); + if ($load) { + $this->init(); + } + } + + /** + * Initialize static variables on unserialize. + */ + public function __wakeup() + { + if (null === static::$global) { + // Add fallback to global media. + static::$global = GlobalMedia::getInstance(); + } + } + + /** + * Return raw route to the page. + * + * @return string|null Route to the page or null if media isn't for a page. + */ + public function getRawRoute(): ?string + { + $path = $this->getPath(); + if ($path) { + /** @var Pages $pages */ + $pages = $this->getGrav()['pages']; + $page = $pages->get($path); + if ($page) { + return $page->rawRoute(); + } + } + + return null; + } + + /** + * Return page route. + * + * @return string|null Route to the page or null if media isn't for a page. + */ + public function getRoute(): ?string + { + $path = $this->getPath(); + if ($path) { + /** @var Pages $pages */ + $pages = $this->getGrav()['pages']; + $page = $pages->get($path); + if ($page) { + return $page->route(); + } + } + + return null; + } + + /** + * @param string $offset + * @return bool + */ + #[\ReturnTypeWillChange] + public function offsetExists($offset) + { + return parent::offsetExists($offset) ?: isset(static::$global[$offset]); + } + + /** + * @param string $offset + * @return MediaObjectInterface|null + */ + #[\ReturnTypeWillChange] + public function offsetGet($offset) + { + return parent::offsetGet($offset) ?: static::$global[$offset]; + } + + /** + * Initialize class. + * + * @return void + */ + protected function init() + { + $path = $this->getPath(); + + // Handle special cases where page doesn't exist in filesystem. + if (!$path || !is_dir($path)) { + return; + } + + $grav = Grav::instance(); + + /** @var UniformResourceLocator $locator */ + $locator = $grav['locator']; + + /** @var Config $config */ + $config = $grav['config']; + + $exif_reader = isset($grav['exif']) ? $grav['exif']->getReader() : null; + $media_types = array_keys($config->get('media.types', [])); + + $iterator = new FilesystemIterator($path, FilesystemIterator::UNIX_PATHS | FilesystemIterator::SKIP_DOTS); + + $media = []; + + foreach ($iterator as $file => $info) { + // Ignore folders and Markdown files. + $filename = $info->getFilename(); + if (!$info->isFile() || $info->getExtension() === 'md' || $filename === 'frontmatter.yaml' || $filename === 'media.json' || strpos($filename, '.') === 0) { + continue; + } + + // Find out what type we're dealing with + [$basename, $ext, $type, $extra] = $this->getFileParts($filename); + + if (!in_array(strtolower($ext), $media_types, true)) { + continue; + } + + if ($type === 'alternative') { + $media["{$basename}.{$ext}"][$type][$extra] = ['file' => $file, 'size' => $info->getSize()]; + } else { + $media["{$basename}.{$ext}"][$type] = ['file' => $file, 'size' => $info->getSize()]; + } + } + + foreach ($media as $name => $types) { + // First prepare the alternatives in case there is no base medium + if (!empty($types['alternative'])) { + /** + * @var string|int $ratio + * @var array $alt + */ + foreach ($types['alternative'] as $ratio => &$alt) { + $alt['file'] = $this->createFromFile($alt['file']); + + if (empty($alt['file'])) { + unset($types['alternative'][$ratio]); + } else { + $alt['file']->set('size', $alt['size']); + } + } + unset($alt); + } + + $file_path = null; + + // Create the base medium + if (empty($types['base'])) { + if (!isset($types['alternative'])) { + continue; + } + + $max = max(array_keys($types['alternative'])); + $medium = $types['alternative'][$max]['file']; + $file_path = $medium->path(); + $medium = MediumFactory::scaledFromMedium($medium, $max, 1)['file']; + } else { + $medium = $this->createFromFile($types['base']['file']); + if ($medium) { + $medium->set('size', $types['base']['size']); + $file_path = $medium->path(); + } + } + + if (empty($medium)) { + continue; + } + + // metadata file + $meta_path = $file_path . '.meta.yaml'; + + if (file_exists($meta_path)) { + $types['meta']['file'] = $meta_path; + } elseif ($file_path && $exif_reader && $medium->get('mime') === 'image/jpeg' && empty($types['meta']) && $config->get('system.media.auto_metadata_exif')) { + $meta = $exif_reader->read($file_path); + + if ($meta) { + $meta_data = $meta->getData(); + $meta_trimmed = array_diff_key($meta_data, array_flip($this->standard_exif)); + if ($meta_trimmed) { + if ($locator->isStream($meta_path)) { + $file = File::instance($locator->findResource($meta_path, true, true)); + } else { + $file = File::instance($meta_path); + } + $file->save(Yaml::dump($meta_trimmed)); + $types['meta']['file'] = $meta_path; + } + } + } + + if (!empty($types['meta'])) { + $medium->addMetaFile($types['meta']['file']); + } + + if (!empty($types['thumb'])) { + // We will not turn it into medium yet because user might never request the thumbnail + // not wasting any resources on that, maybe we should do this for medium in general? + $medium->set('thumbnails.page', $types['thumb']['file']); + } + + // Build missing alternatives + if (!empty($types['alternative'])) { + $alternatives = $types['alternative']; + $max = max(array_keys($alternatives)); + + for ($i=$max; $i > 1; $i--) { + if (isset($alternatives[$i])) { + continue; + } + + $types['alternative'][$i] = MediumFactory::scaledFromMedium($alternatives[$max]['file'], $max, $i); + } + + foreach ($types['alternative'] as $altMedium) { + if ($altMedium['file'] != $medium) { + $altWidth = $altMedium['file']->get('width'); + $medWidth = $medium->get('width'); + if ($altWidth && $medWidth) { + $ratio = $altWidth / $medWidth; + $medium->addAlternative($ratio, $altMedium['file']); + } + } + } + } + + $this->add($name, $medium); + } + } + + /** + * @return string|null + * @deprecated 1.6 Use $this->getPath() instead. + */ + public function path(): ?string + { + return $this->getPath(); + } +} diff --git a/system/src/Grav/Common/Page/Medium/AbstractMedia.php b/system/src/Grav/Common/Page/Medium/AbstractMedia.php new file mode 100644 index 0000000..906d044 --- /dev/null +++ b/system/src/Grav/Common/Page/Medium/AbstractMedia.php @@ -0,0 +1,344 @@ +path; + } + + /** + * @param string|null $path + * @return void + */ + public function setPath(?string $path): void + { + $this->path = $path; + } + + /** + * Get medium by filename. + * + * @param string $filename + * @return MediaObjectInterface|null + */ + public function get($filename) + { + return $this->offsetGet($filename); + } + + /** + * Call object as function to get medium by filename. + * + * @param string $filename + * @return mixed + */ + #[\ReturnTypeWillChange] + public function __invoke($filename) + { + return $this->offsetGet($filename); + } + + /** + * Set file modification timestamps (query params) for all the media files. + * + * @param string|int|null $timestamp + * @return $this + */ + public function setTimestamps($timestamp = null) + { + foreach ($this->items as $instance) { + $instance->setTimestamp($timestamp); + } + + return $this; + } + + /** + * Get a list of all media. + * + * @return MediaObjectInterface[] + */ + public function all() + { + $this->items = $this->orderMedia($this->items); + + return $this->items; + } + + /** + * Get a list of all image media. + * + * @return MediaObjectInterface[] + */ + public function images() + { + $this->images = $this->orderMedia($this->images); + + return $this->images; + } + + /** + * Get a list of all video media. + * + * @return MediaObjectInterface[] + */ + public function videos() + { + $this->videos = $this->orderMedia($this->videos); + + return $this->videos; + } + + /** + * Get a list of all audio media. + * + * @return MediaObjectInterface[] + */ + public function audios() + { + $this->audios = $this->orderMedia($this->audios); + + return $this->audios; + } + + /** + * Get a list of all file media. + * + * @return MediaObjectInterface[] + */ + public function files() + { + $this->files = $this->orderMedia($this->files); + + return $this->files; + } + + /** + * @param string $name + * @param MediaObjectInterface|null $file + * @return void + */ + public function add($name, $file) + { + if (null === $file) { + return; + } + + $this->offsetSet($name, $file); + + switch ($file->type) { + case 'image': + $this->images[$name] = $file; + break; + case 'video': + $this->videos[$name] = $file; + break; + case 'audio': + $this->audios[$name] = $file; + break; + default: + $this->files[$name] = $file; + } + } + + /** + * @param string $name + * @return void + */ + public function hide($name) + { + $this->offsetUnset($name); + + unset($this->images[$name], $this->videos[$name], $this->audios[$name], $this->files[$name]); + } + + /** + * Create Medium from a file. + * + * @param string $file + * @param array $params + * @return Medium|null + */ + public function createFromFile($file, array $params = []) + { + return MediumFactory::fromFile($file, $params); + } + + /** + * Create Medium from array of parameters + * + * @param array $items + * @param Blueprint|null $blueprint + * @return Medium|null + */ + public function createFromArray(array $items = [], Blueprint $blueprint = null) + { + return MediumFactory::fromArray($items, $blueprint); + } + + /** + * @param MediaObjectInterface $mediaObject + * @return ImageFile + */ + public function getImageFileObject(MediaObjectInterface $mediaObject): ImageFile + { + return ImageFile::open($mediaObject->get('filepath')); + } + + /** + * Order the media based on the page's media_order + * + * @param array $media + * @return array + */ + protected function orderMedia($media) + { + if (null === $this->media_order) { + $path = $this->getPath(); + if (null !== $path) { + /** @var Pages $pages */ + $pages = Grav::instance()['pages']; + $page = $pages->get($path); + if ($page && isset($page->header()->media_order)) { + $this->media_order = array_map('trim', explode(',', $page->header()->media_order)); + } + } + } + + if (!empty($this->media_order) && is_array($this->media_order)) { + $media = Utils::sortArrayByArray($media, $this->media_order); + } else { + ksort($media, SORT_NATURAL | SORT_FLAG_CASE); + } + + return $media; + } + + protected function fileExists(string $filename, string $destination): bool + { + return file_exists("{$destination}/{$filename}"); + } + + /** + * Get filename, extension and meta part. + * + * @param string $filename + * @return array + */ + protected function getFileParts($filename) + { + if (preg_match('/(.*)@(\d+)x\.(.*)$/', $filename, $matches)) { + $name = $matches[1]; + $extension = $matches[3]; + $extra = (int) $matches[2]; + $type = 'alternative'; + + if ($extra === 1) { + $type = 'base'; + $extra = null; + } + } else { + $fileParts = explode('.', $filename); + + $name = array_shift($fileParts); + $extension = null; + $extra = null; + $type = 'base'; + + while (($part = array_shift($fileParts)) !== null) { + if ($part !== 'meta' && $part !== 'thumb') { + if (null !== $extension) { + $name .= '.' . $extension; + } + $extension = $part; + } else { + $type = $part; + $extra = '.' . $part . '.' . implode('.', $fileParts); + break; + } + } + } + + return [$name, $extension, $type, $extra]; + } + + protected function getGrav(): Grav + { + return Grav::instance(); + } + + protected function getConfig(): Config + { + return $this->getGrav()['config']; + } + + protected function getLanguage(): Language + { + return $this->getGrav()['language']; + } + + protected function clearCache(): void + { + /** @var UniformResourceLocator $locator */ + $locator = $this->getGrav()['locator']; + $locator->clearCache(); + } +} diff --git a/system/src/Grav/Common/Page/Medium/AudioMedium.php b/system/src/Grav/Common/Page/Medium/AudioMedium.php new file mode 100644 index 0000000..81d3a5b --- /dev/null +++ b/system/src/Grav/Common/Page/Medium/AudioMedium.php @@ -0,0 +1,36 @@ +resetPlayer(); + + return $this; + } +} diff --git a/system/src/Grav/Common/Page/Medium/GlobalMedia.php b/system/src/Grav/Common/Page/Medium/GlobalMedia.php new file mode 100644 index 0000000..66ccca7 --- /dev/null +++ b/system/src/Grav/Common/Page/Medium/GlobalMedia.php @@ -0,0 +1,150 @@ +resolveStream($offset)); + } + + /** + * @param string $offset + * @return MediaObjectInterface|null + */ + #[\ReturnTypeWillChange] + public function offsetGet($offset) + { + return parent::offsetGet($offset) ?: $this->addMedium($offset); + } + + /** + * @param string $filename + * @return string|null + */ + protected function resolveStream($filename) + { + /** @var UniformResourceLocator $locator */ + $locator = Grav::instance()['locator']; + if (!$locator->isStream($filename)) { + return null; + } + + return $locator->findResource($filename) ?: null; + } + + /** + * @param string $stream + * @return MediaObjectInterface|null + */ + protected function addMedium($stream) + { + $filename = $this->resolveStream($stream); + if (!$filename) { + return null; + } + + $path = dirname($filename); + [$basename, $ext,, $extra] = $this->getFileParts(Utils::basename($filename)); + $medium = MediumFactory::fromFile($filename); + + if (null === $medium) { + return null; + } + + $medium->set('size', filesize($filename)); + $scale = (int) ($extra ?: 1); + + if ($scale !== 1) { + $altMedium = $medium; + + // Create scaled down regular sized image. + $medium = MediumFactory::scaledFromMedium($altMedium, $scale, 1)['file']; + + if (empty($medium)) { + return null; + } + + // Add original sized image as alternative. + $medium->addAlternative($scale, $altMedium['file']); + + // Locate or generate smaller retina images. + for ($i = $scale-1; $i > 1; $i--) { + $altFilename = "{$path}/{$basename}@{$i}x.{$ext}"; + + if (file_exists($altFilename)) { + $scaled = MediumFactory::fromFile($altFilename); + } else { + $scaled = MediumFactory::scaledFromMedium($altMedium, $scale, $i)['file']; + } + + if ($scaled) { + $medium->addAlternative($i, $scaled); + } + } + } + + $meta = "{$path}/{$basename}.{$ext}.yaml"; + if (file_exists($meta)) { + $medium->addMetaFile($meta); + } + $meta = "{$path}/{$basename}.{$ext}.meta.yaml"; + if (file_exists($meta)) { + $medium->addMetaFile($meta); + } + + $thumb = "{$path}/{$basename}.thumb.{$ext}"; + if (file_exists($thumb)) { + $medium->set('thumbnails.page', $thumb); + } + + $this->add($stream, $medium); + + return $medium; + } +} diff --git a/system/src/Grav/Common/Page/Medium/ImageFile.php b/system/src/Grav/Common/Page/Medium/ImageFile.php new file mode 100644 index 0000000..a347b81 --- /dev/null +++ b/system/src/Grav/Common/Page/Medium/ImageFile.php @@ -0,0 +1,212 @@ +adapter; + if ($adapter) { + $adapter->deinit(); + } + } + + /** + * Clear previously applied operations + * + * @return void + */ + public function clearOperations() + { + $this->operations = []; + } + + /** + * This is the same as the Gregwar Image class except this one fires a Grav Event on creation of new cached file + * + * @param string $type the image type + * @param int $quality the quality (for JPEG) + * @param bool $actual + * @param array $extras + * @return string + */ + public function cacheFile($type = 'jpg', $quality = 80, $actual = false, $extras = []) + { + if ($type === 'guess') { + $type = $this->guessType(); + } + + if (!$this->forceCache && !count($this->operations) && $type === $this->guessType()) { + return $this->getFilename($this->getFilePath()); + } + + // Computes the hash + $this->hash = $this->getHash($type, $quality, $extras); + + /** @var Config $config */ + $config = Grav::instance()['config']; + + // Seo friendly image names + $seofriendly = $config->get('system.images.seofriendly', false); + + if ($seofriendly) { + $mini_hash = substr($this->hash, 0, 4) . substr($this->hash, -4); + $cacheFile = "{$this->prettyName}-{$mini_hash}"; + } else { + $cacheFile = "{$this->hash}-{$this->prettyName}"; + } + + $cacheFile .= '.' . $type; + + // If the files does not exists, save it + $image = $this; + + // Target file should be younger than all the current image + // dependencies + $conditions = array( + 'younger-than' => $this->getDependencies() + ); + + // The generating function + $generate = function ($target) use ($image, $type, $quality) { + $result = $image->save($target, $type, $quality); + + if ($result !== $target) { + throw new GenerationError($result); + } + + Grav::instance()->fireEvent('onImageMediumSaved', new Event(['image' => $target])); + }; + + // Asking the cache for the cacheFile + try { + $perms = $config->get('system.images.cache_perms', '0755'); + $perms = octdec($perms); + $file = $this->getCacheSystem()->setDirectoryMode($perms)->getOrCreateFile($cacheFile, $conditions, $generate, $actual); + } catch (GenerationError $e) { + $file = $e->getNewFile(); + } + + // Nulling the resource + $adapter = $this->getAdapter(); + $adapter->setSource(new Source\File($file)); + $adapter->deinit(); + + if ($actual) { + return $file; + } + + return $this->getFilename($file); + } + + /** + * Gets the hash. + * + * @param string $type + * @param int $quality + * @param array $extras + * @return string + */ + public function getHash($type = 'guess', $quality = 80, $extras = []) + { + if (null === $this->hash) { + $this->generateHash($type, $quality, $extras); + } + + return $this->hash; + } + + /** + * Generates the hash. + * + * @param string $type + * @param int $quality + * @param array $extras + */ + public function generateHash($type = 'guess', $quality = 80, $extras = []) + { + $inputInfos = $this->source->getInfos(); + + $data = [ + $inputInfos, + $this->serializeOperations(), + $type, + $quality, + $extras + ]; + + $this->hash = sha1(serialize($data)); + } + + /** + * Read exif rotation from file and apply it. + */ + public function fixOrientation() + { + if (!extension_loaded('exif')) { + throw new RuntimeException('You need to EXIF PHP Extension to use this function'); + } + + if (!in_array(exif_imagetype($this->source->getInfos()), [IMAGETYPE_JPEG, IMAGETYPE_TIFF_II, IMAGETYPE_TIFF_MM], true)) { + return $this; + } + + // resolve any streams + /** @var UniformResourceLocator $locator */ + $locator = Grav::instance()['locator']; + $filepath = $this->source->getInfos(); + if ($locator->isStream($filepath)) { + $filepath = $locator->findResource($this->source->getInfos(), true, true); + } + + // Make sure file exists + if (!file_exists($filepath)) { + return $this; + } + + try { + $exif = @exif_read_data($filepath); + } catch (Exception $e) { + Grav::instance()['log']->error($filepath . ' - ' . $e->getMessage()); + return $this; + } + + if ($exif === false || !array_key_exists('Orientation', $exif)) { + return $this; + } + + return $this->applyExifOrientation($exif['Orientation']); + } +} diff --git a/system/src/Grav/Common/Page/Medium/ImageMedium.php b/system/src/Grav/Common/Page/Medium/ImageMedium.php new file mode 100644 index 0000000..30e369b --- /dev/null +++ b/system/src/Grav/Common/Page/Medium/ImageMedium.php @@ -0,0 +1,495 @@ +getGrav()['config']; + + $this->thumbnailTypes = ['page', 'media', 'default']; + $this->default_quality = $config->get('system.images.default_image_quality', 85); + $this->def('debug', $config->get('system.images.debug')); + + $path = $this->get('filepath'); + if (!$path || !file_exists($path) || !filesize($path)) { + return; + } + + $this->set('thumbnails.media', $path); + + if (!($this->offsetExists('width') && $this->offsetExists('height') && $this->offsetExists('mime'))) { + $image_info = getimagesize($path); + if ($image_info) { + $this->def('width', (int) $image_info[0]); + $this->def('height', (int) $image_info[1]); + $this->def('mime', $image_info['mime']); + } + } + + $this->reset(); + + if ($config->get('system.images.cache_all', false)) { + $this->cache(); + } + } + + /** + * @return array + */ + public function getMeta(): array + { + return [ + 'width' => $this->width, + 'height' => $this->height, + ] + parent::getMeta(); + } + + /** + * Also unset the image on destruct. + */ + #[\ReturnTypeWillChange] + public function __destruct() + { + unset($this->image); + } + + /** + * Also clone image. + */ + #[\ReturnTypeWillChange] + public function __clone() + { + if ($this->image) { + $this->image = clone $this->image; + } + + parent::__clone(); + } + + /** + * Reset image. + * + * @return $this + */ + public function reset() + { + parent::reset(); + + if ($this->image) { + $this->image(); + $this->medium_querystring = []; + $this->filter(); + $this->clearAlternatives(); + } + + $this->format = 'guess'; + $this->quality = $this->default_quality; + + $this->debug_watermarked = false; + + $config = $this->getGrav()['config']; + // Set CLS configuration + $this->auto_sizes = $config->get('system.images.cls.auto_sizes', false); + $this->aspect_ratio = $config->get('system.images.cls.aspect_ratio', false); + $this->retina_scale = $config->get('system.images.cls.retina_scale', 1); + + return $this; + } + + /** + * Add meta file for the medium. + * + * @param string $filepath + * @return $this + */ + public function addMetaFile($filepath) + { + parent::addMetaFile($filepath); + + // Apply filters in meta file + $this->reset(); + + return $this; + } + + /** + * Return PATH to image. + * + * @param bool $reset + * @return string path to image + */ + public function path($reset = true) + { + $output = $this->saveImage(); + + if ($reset) { + $this->reset(); + } + + return $output; + } + + /** + * Return URL to image. + * + * @param bool $reset + * @return string + */ + public function url($reset = true) + { + $grav = $this->getGrav(); + + /** @var UniformResourceLocator $locator */ + $locator = $grav['locator']; + $image_path = (string)($locator->findResource('cache://images', true) ?: $locator->findResource('cache://images', true, true)); + $saved_image_path = $this->saved_image_path = $this->saveImage(); + + $output = preg_replace('|^' . preg_quote(GRAV_ROOT, '|') . '|', '', $saved_image_path) ?: $saved_image_path; + + if ($locator->isStream($output)) { + $output = (string)($locator->findResource($output, false) ?: $locator->findResource($output, false, true)); + } + + if (Utils::startsWith($output, $image_path)) { + $image_dir = $locator->findResource('cache://images', false); + $output = '/' . $image_dir . preg_replace('|^' . preg_quote($image_path, '|') . '|', '', $output); + } + + if ($reset) { + $this->reset(); + } + + return trim($grav['base_url'] . '/' . $this->urlQuerystring($output), '\\'); + } + + /** + * Return srcset string for this Medium and its alternatives. + * + * @param bool $reset + * @return string + */ + public function srcset($reset = true) + { + if (empty($this->alternatives)) { + if ($reset) { + $this->reset(); + } + + return ''; + } + + $srcset = []; + foreach ($this->alternatives as $ratio => $medium) { + $srcset[] = $medium->url($reset) . ' ' . $medium->get('width') . 'w'; + } + $srcset[] = str_replace(' ', '%20', $this->url($reset)) . ' ' . $this->get('width') . 'w'; + + return implode(', ', $srcset); + } + + /** + * Parsedown element for source display mode + * + * @param array $attributes + * @param bool $reset + * @return array + */ + public function sourceParsedownElement(array $attributes, $reset = true) + { + empty($attributes['src']) && $attributes['src'] = $this->url(false); + + $srcset = $this->srcset($reset); + if ($srcset) { + empty($attributes['srcset']) && $attributes['srcset'] = $srcset; + $attributes['sizes'] = $this->sizes(); + } + + if ($this->saved_image_path && $this->auto_sizes) { + if (!array_key_exists('height', $this->attributes) && !array_key_exists('width', $this->attributes)) { + $info = getimagesize($this->saved_image_path); + $width = (int)$info[0]; + $height = (int)$info[1]; + + $scaling_factor = $this->retina_scale > 0 ? $this->retina_scale : 1; + $attributes['width'] = (int)($width / $scaling_factor); + $attributes['height'] = (int)($height / $scaling_factor); + + if ($this->aspect_ratio) { + $style = ($attributes['style'] ?? ' ') . "--aspect-ratio: $width/$height;"; + $attributes['style'] = trim($style); + } + } + } + + return ['name' => 'img', 'attributes' => $attributes]; + } + + /** + * Turn the current Medium into a Link + * + * @param bool $reset + * @param array $attributes + * @return MediaLinkInterface + */ + public function link($reset = true, array $attributes = []) + { + $attributes['href'] = $this->url(false); + $srcset = $this->srcset(false); + if ($srcset) { + $attributes['data-srcset'] = $srcset; + } + + return parent::link($reset, $attributes); + } + + /** + * Turn the current Medium into a Link with lightbox enabled + * + * @param int $width + * @param int $height + * @param bool $reset + * @return MediaLinkInterface + */ + public function lightbox($width = null, $height = null, $reset = true) + { + if ($this->mode !== 'source') { + $this->display('source'); + } + + if ($width && $height) { + $this->__call('cropResize', [(int) $width, (int) $height]); + } + + return parent::lightbox($width, $height, $reset); + } + + /** + * @param string $enabled + * @return $this + */ + public function autoSizes($enabled = 'true') + { + $this->auto_sizes = $enabled === 'true' ?: false; + + return $this; + } + + /** + * @param string $enabled + * @return $this + */ + public function aspectRatio($enabled = 'true') + { + $this->aspect_ratio = $enabled === 'true' ?: false; + + return $this; + } + + /** + * @param int $scale + * @return $this + */ + public function retinaScale($scale = 1) + { + $this->retina_scale = (int)$scale; + + return $this; + } + + /** + * @param string|null $image + * @param string|null $position + * @param int|float|null $scale + * @return $this + */ + public function watermark($image = null, $position = null, $scale = null) + { + $grav = $this->getGrav(); + + $locator = $grav['locator']; + $config = $grav['config']; + + $args = func_get_args(); + + $file = $args[0] ?? '1'; // using '1' because of markdown. doing ![](image.jpg?watermark) returns $args[0]='1'; + $file = $file === '1' ? $config->get('system.images.watermark.image') : $args[0]; + + $watermark = $locator->findResource($file); + $watermark = ImageFile::open($watermark); + + // Scaling operations + $scale = ($scale ?? $config->get('system.images.watermark.scale', 100)) / 100; + $wwidth = (int) ($this->get('width') * $scale); + $wheight = (int) ($this->get('height') * $scale); + $watermark->resize($wwidth, $wheight); + + // Position operations + $position = !empty($args[1]) ? explode('-', $args[1]) : ['center', 'center']; // todo change to config + $positionY = $position[0] ?? $config->get('system.images.watermark.position_y', 'center'); + $positionX = $position[1] ?? $config->get('system.images.watermark.position_x', 'center'); + + switch ($positionY) + { + case 'top': + $positionY = 0; + break; + + case 'bottom': + $positionY = (int)$this->get('height')-$wheight; + break; + + case 'center': + $positionY = ((int)$this->get('height')/2) - ($wheight/2); + break; + } + + switch ($positionX) + { + case 'left': + $positionX = 0; + break; + + case 'right': + $positionX = (int) ($this->get('width')-$wwidth); + break; + + case 'center': + $positionX = (int) (($this->get('width')/2) - ($wwidth/2)); + break; + } + + $this->__call('merge', [$watermark,$positionX, $positionY]); + + return $this; + } + + /** + * Handle this commonly used variant + * + * @return $this + */ + public function cropZoom() + { + $this->__call('zoomCrop', func_get_args()); + + return $this; + } + + /** + * Add a frame to image + * + * @return $this + */ + public function addFrame(int $border = 10, string $color = '0x000000') + { + if($border > 0 && preg_match('/^0x[a-f0-9]{6}$/i', $color)) { // $border must be an integer and bigger than 0; $color must be formatted as an HEX value (0x??????). + $image = ImageFile::open($this->path()); + } + else { + return $this; + } + + $dst_width = (int) ($image->width()+2*$border); + $dst_height = (int) ($image->height()+2*$border); + + $frame = ImageFile::create($dst_width, $dst_height); + + $frame->__call('fill', [$color]); + + $this->image = $frame; + + $this->__call('merge', [$image, $border, $border]); + + $this->saveImage(); + + return $this; + + } + + /** + * Forward the call to the image processing method. + * + * @param string $method + * @param mixed $args + * @return $this|mixed + */ + #[\ReturnTypeWillChange] + public function __call($method, $args) + { + if (!in_array($method, static::$magic_actions, true)) { + return parent::__call($method, $args); + } + + // Always initialize image. + if (!$this->image) { + $this->image(); + } + + try { + $this->image->{$method}(...$args); + + /** @var ImageMediaInterface $medium */ + foreach ($this->alternatives as $medium) { + $args_copy = $args; + + // regular image: resize 400x400 -> 200x200 + // --> @2x: resize 800x800->400x400 + if (isset(static::$magic_resize_actions[$method])) { + foreach (static::$magic_resize_actions[$method] as $param) { + if (isset($args_copy[$param])) { + $args_copy[$param] *= $medium->get('ratio'); + } + } + } + + // Do the same call for alternative media. + $medium->__call($method, $args_copy); + } + } catch (BadFunctionCallException $e) { + } + + return $this; + } +} diff --git a/system/src/Grav/Common/Page/Medium/Link.php b/system/src/Grav/Common/Page/Medium/Link.php new file mode 100644 index 0000000..1abc7ef --- /dev/null +++ b/system/src/Grav/Common/Page/Medium/Link.php @@ -0,0 +1,102 @@ +attributes = $attributes; + + $source = $medium->reset()->thumbnail('auto')->display('thumbnail'); + if (!$source instanceof MediaObjectInterface) { + throw new RuntimeException('Media has no thumbnail set'); + } + + $source->set('linked', true); + + $this->source = $source; + } + + /** + * Get an element (is array) that can be rendered by the Parsedown engine + * + * @param string|null $title + * @param string|null $alt + * @param string|null $class + * @param string|null $id + * @param bool $reset + * @return array + */ + public function parsedownElement($title = null, $alt = null, $class = null, $id = null, $reset = true) + { + $innerElement = $this->source->parsedownElement($title, $alt, $class, $id, $reset); + + return [ + 'name' => 'a', + 'attributes' => $this->attributes, + 'handler' => is_array($innerElement) ? 'element' : 'line', + 'text' => $innerElement + ]; + } + + /** + * Forward the call to the source element + * + * @param string $method + * @param mixed $args + * @return mixed + */ + #[\ReturnTypeWillChange] + public function __call($method, $args) + { + $object = $this->source; + $callable = [$object, $method]; + if (!is_callable($callable)) { + throw new BadMethodCallException(get_class($object) . '::' . $method . '() not found.'); + } + + $object = call_user_func_array($callable, $args); + if (!$object instanceof MediaLinkInterface) { + // Don't start nesting links, if user has multiple link calls in his + // actions, we will drop the previous links. + return $this; + } + + $this->source = $object; + + return $object; + } +} diff --git a/system/src/Grav/Common/Page/Medium/Medium.php b/system/src/Grav/Common/Page/Medium/Medium.php new file mode 100644 index 0000000..a17f68a --- /dev/null +++ b/system/src/Grav/Common/Page/Medium/Medium.php @@ -0,0 +1,140 @@ +get('system.media.enable_media_timestamp', true)) { + $this->timestamp = Grav::instance()['cache']->getKey(); + } + + $this->def('mime', 'application/octet-stream'); + + if (!$this->offsetExists('size')) { + $path = $this->get('filepath'); + $this->def('size', filesize($path)); + } + + $this->reset(); + } + + /** + * Clone medium. + */ + #[\ReturnTypeWillChange] + public function __clone() + { + // Allows future compatibility as parent::__clone() works. + } + + /** + * Add meta file for the medium. + * + * @param string $filepath + */ + public function addMetaFile($filepath) + { + $this->metadata = (array)CompiledYamlFile::instance($filepath)->content(); + $this->merge($this->metadata); + } + + /** + * @return array + */ + public function getMeta(): array + { + return [ + 'mime' => $this->mime, + 'size' => $this->size, + 'modified' => $this->modified, + ]; + } + + /** + * Return string representation of the object (html). + * + * @return string + */ + #[\ReturnTypeWillChange] + public function __toString() + { + return $this->html(); + } + + /** + * @param string $thumb + * @return Medium|null + */ + protected function createThumbnail($thumb) + { + return MediumFactory::fromFile($thumb, ['type' => 'thumbnail']); + } + + /** + * @param array $attributes + * @return MediaLinkInterface + */ + protected function createLink(array $attributes) + { + return new Link($attributes, $this); + } + + /** + * @return Grav + */ + protected function getGrav(): Grav + { + return Grav::instance(); + } + + /** + * @return array + */ + protected function getItems(): array + { + return $this->items; + } +} diff --git a/system/src/Grav/Common/Page/Medium/MediumFactory.php b/system/src/Grav/Common/Page/Medium/MediumFactory.php new file mode 100644 index 0000000..0796a83 --- /dev/null +++ b/system/src/Grav/Common/Page/Medium/MediumFactory.php @@ -0,0 +1,220 @@ +get('media.types.' . strtolower($ext)) : null; + if (!is_array($media_params)) { + return null; + } + + // Remove empty 'image' attribute + if (isset($media_params['image']) && empty($media_params['image'])) { + unset($media_params['image']); + } + + $params += $media_params; + + // Add default settings for undefined variables. + $params += (array)$config->get('media.types.defaults'); + $params += [ + 'type' => 'file', + 'thumb' => 'media/thumb.png', + 'mime' => 'application/octet-stream', + 'filepath' => $file, + 'filename' => $filename, + 'basename' => $basename, + 'extension' => $ext, + 'path' => $path, + 'modified' => filemtime($file), + 'thumbnails' => [] + ]; + + $locator = Grav::instance()['locator']; + + $file = $locator->findResource("image://{$params['thumb']}"); + if ($file) { + $params['thumbnails']['default'] = $file; + } + + return static::fromArray($params); + } + + /** + * Create Medium from an uploaded file + * + * @param UploadedFileInterface $uploadedFile + * @param array $params + * @return Medium|null + */ + public static function fromUploadedFile(UploadedFileInterface $uploadedFile, array $params = []) + { + // For now support only FormFlashFiles, which exist over multiple requests. Also ignore errored and moved media. + if (!$uploadedFile instanceof FormFlashFile || $uploadedFile->getError() !== \UPLOAD_ERR_OK || $uploadedFile->isMoved()) { + return null; + } + + $clientName = $uploadedFile->getClientFilename(); + if (!$clientName) { + return null; + } + + $parts = Utils::pathinfo($clientName); + $filename = $parts['basename']; + $ext = $parts['extension'] ?? ''; + $basename = $parts['filename']; + $file = $uploadedFile->getTmpFile(); + $path = $file ? dirname($file) : ''; + + $config = Grav::instance()['config']; + + $media_params = $ext ? $config->get('media.types.' . strtolower($ext)) : null; + if (!is_array($media_params)) { + return null; + } + + $params += $media_params; + + // Add default settings for undefined variables. + $params += (array)$config->get('media.types.defaults'); + $params += [ + 'type' => 'file', + 'thumb' => 'media/thumb.png', + 'mime' => 'application/octet-stream', + 'filepath' => $file, + 'filename' => $filename, + 'basename' => $basename, + 'extension' => $ext, + 'path' => $path, + 'modified' => $file ? filemtime($file) : 0, + 'thumbnails' => [] + ]; + + $locator = Grav::instance()['locator']; + + $file = $locator->findResource("image://{$params['thumb']}"); + if ($file) { + $params['thumbnails']['default'] = $file; + } + + return static::fromArray($params); + } + + /** + * Create Medium from array of parameters + * + * @param array $items + * @param Blueprint|null $blueprint + * @return Medium + */ + public static function fromArray(array $items = [], Blueprint $blueprint = null) + { + $type = $items['type'] ?? null; + + switch ($type) { + case 'image': + return new ImageMedium($items, $blueprint); + case 'thumbnail': + return new ThumbnailImageMedium($items, $blueprint); + case 'vector': + return new VectorImageMedium($items, $blueprint); + case 'animated': + return new StaticImageMedium($items, $blueprint); + case 'video': + return new VideoMedium($items, $blueprint); + case 'audio': + return new AudioMedium($items, $blueprint); + default: + return new Medium($items, $blueprint); + } + } + + /** + * Create a new ImageMedium by scaling another ImageMedium object. + * + * @param ImageMediaInterface|MediaObjectInterface $medium + * @param int $from + * @param int $to + * @return ImageMediaInterface|MediaObjectInterface|array + */ + public static function scaledFromMedium($medium, $from, $to) + { + if (!$medium instanceof ImageMedium) { + return $medium; + } + + if ($to > $from) { + return $medium; + } + + $ratio = $to / $from; + $width = $medium->get('width') * $ratio; + $height = $medium->get('height') * $ratio; + + $prev_basename = $medium->get('basename'); + $basename = str_replace('@' . $from . 'x', $to !== 1 ? '@' . $to . 'x' : '', $prev_basename); + + $debug = $medium->get('debug'); + $medium->set('debug', false); + $medium->setImagePrettyName($basename); + + $file = $medium->resize($width, $height)->path(); + + $medium->set('debug', $debug); + $medium->setImagePrettyName($prev_basename); + + $size = filesize($file); + + $medium = self::fromFile($file); + if ($medium) { + $medium->set('basename', $basename); + $medium->set('filename', $basename . '.' . $medium->extension); + $medium->set('size', $size); + } + + return ['file' => $medium, 'size' => $size]; + } +} diff --git a/system/src/Grav/Common/Page/Medium/ParsedownHtmlTrait.php b/system/src/Grav/Common/Page/Medium/ParsedownHtmlTrait.php new file mode 100644 index 0000000..3326150 --- /dev/null +++ b/system/src/Grav/Common/Page/Medium/ParsedownHtmlTrait.php @@ -0,0 +1,44 @@ +parsedownElement($title, $alt, $class, $id, $reset); + + if (!$this->parsedown) { + $this->parsedown = new Parsedown(new Excerpts()); + } + + return $this->parsedown->elementToHtml($element); + } +} diff --git a/system/src/Grav/Common/Page/Medium/RenderableInterface.php b/system/src/Grav/Common/Page/Medium/RenderableInterface.php new file mode 100644 index 0000000..e6ce40b --- /dev/null +++ b/system/src/Grav/Common/Page/Medium/RenderableInterface.php @@ -0,0 +1,41 @@ +url($reset); + } + + return ['name' => 'img', 'attributes' => $attributes]; + } + + /** + * @return $this + */ + public function higherQualityAlternative() + { + return $this; + } +} diff --git a/system/src/Grav/Common/Page/Medium/StaticResizeTrait.php b/system/src/Grav/Common/Page/Medium/StaticResizeTrait.php new file mode 100644 index 0000000..a48f8e5 --- /dev/null +++ b/system/src/Grav/Common/Page/Medium/StaticResizeTrait.php @@ -0,0 +1,24 @@ +get('width'); + $height = $this->get('height'); + if ($width && $height) { + return; + } + + // Make sure that getting image size is supported. + if ($this->mime !== 'image/svg+xml' || !\extension_loaded('simplexml')) { + return; + } + + // Make sure that the image exists. + $path = $this->get('filepath'); + if (!$path || !file_exists($path) || !filesize($path)) { + return; + } + + $xml = simplexml_load_string(file_get_contents($path)); + $attr = $xml ? $xml->attributes() : null; + if (!$attr instanceof \SimpleXMLElement) { + return; + } + + // Get the size from svg image. + if ($attr->width && $attr->height) { + $width = (string)$attr->width; + $height = (string)$attr->height; + } elseif ($attr->viewBox && \count($size = explode(' ', (string)$attr->viewBox)) === 4) { + [,$width,$height,] = $size; + } + + if ($width && $height) { + $this->def('width', (int)$width); + $this->def('height', (int)$height); + } + } +} diff --git a/system/src/Grav/Common/Page/Medium/VideoMedium.php b/system/src/Grav/Common/Page/Medium/VideoMedium.php new file mode 100644 index 0000000..326417c --- /dev/null +++ b/system/src/Grav/Common/Page/Medium/VideoMedium.php @@ -0,0 +1,36 @@ +resetPlayer(); + + return $this; + } +} diff --git a/system/src/Grav/Common/Page/Page.php b/system/src/Grav/Common/Page/Page.php new file mode 100644 index 0000000..7ecd0fe --- /dev/null +++ b/system/src/Grav/Common/Page/Page.php @@ -0,0 +1,2927 @@ +taxonomy = []; + $this->process = $config->get('system.pages.process'); + $this->published = true; + } + + /** + * Initializes the page instance variables based on a file + * + * @param SplFileInfo $file The file information for the .md file that the page represents + * @param string|null $extension + * @return $this + */ + public function init(SplFileInfo $file, $extension = null) + { + $config = Grav::instance()['config']; + + $this->initialized = true; + + // some extension logic + if (empty($extension)) { + $this->extension('.' . $file->getExtension()); + } else { + $this->extension($extension); + } + + // extract page language from page extension + $language = trim(Utils::basename($this->extension(), 'md'), '.') ?: null; + $this->language($language); + + $this->hide_home_route = $config->get('system.home.hide_in_urls', false); + $this->home_route = $this->adjustRouteCase($config->get('system.home.alias')); + $this->filePath($file->getPathname()); + $this->modified($file->getMTime()); + $this->id($this->modified() . md5($this->filePath())); + $this->routable(true); + $this->header(); + $this->date(); + $this->metadata(); + $this->url(); + $this->visible(); + $this->modularTwig(strpos($this->slug(), '_') === 0); + $this->setPublishState(); + $this->published(); + $this->urlExtension(); + + return $this; + } + + #[\ReturnTypeWillChange] + public function __clone() + { + $this->initialized = false; + $this->header = $this->header ? clone $this->header : null; + } + + /** + * @return void + */ + public function initialize(): void + { + if (!$this->initialized) { + $this->initialized = true; + $this->route = null; + $this->raw_route = null; + $this->_forms = null; + } + } + + /** + * @return void + */ + protected function processFrontmatter() + { + // Quick check for twig output tags in frontmatter if enabled + $process_fields = (array)$this->header(); + if (Utils::contains(json_encode(array_values($process_fields)), '{{')) { + $ignored_fields = []; + foreach ((array)Grav::instance()['config']->get('system.pages.frontmatter.ignore_fields') as $field) { + if (isset($process_fields[$field])) { + $ignored_fields[$field] = $process_fields[$field]; + unset($process_fields[$field]); + } + } + $text_header = Grav::instance()['twig']->processString(json_encode($process_fields, JSON_UNESCAPED_UNICODE), ['page' => $this]); + $this->header((object)(json_decode($text_header, true) + $ignored_fields)); + } + } + + /** + * Return an array with the routes of other translated languages + * + * @param bool $onlyPublished only return published translations + * @return array the page translated languages + */ + public function translatedLanguages($onlyPublished = false) + { + $grav = Grav::instance(); + + /** @var Language $language */ + $language = $grav['language']; + + $languages = $language->getLanguages(); + $defaultCode = $language->getDefault(); + + $name = substr($this->name, 0, -strlen($this->extension())); + $translatedLanguages = []; + + foreach ($languages as $languageCode) { + $languageExtension = ".{$languageCode}.md"; + $path = $this->path . DS . $this->folder . DS . $name . $languageExtension; + $exists = file_exists($path); + + // Default language may be saved without language file location. + if (!$exists && $languageCode === $defaultCode) { + $languageExtension = '.md'; + $path = $this->path . DS . $this->folder . DS . $name . $languageExtension; + $exists = file_exists($path); + } + + if ($exists) { + $aPage = new Page(); + $aPage->init(new SplFileInfo($path), $languageExtension); + $aPage->route($this->route()); + $aPage->rawRoute($this->rawRoute()); + $route = $aPage->header()->routes['default'] ?? $aPage->rawRoute(); + if (!$route) { + $route = $aPage->route(); + } + + if ($onlyPublished && !$aPage->published()) { + continue; + } + + $translatedLanguages[$languageCode] = $route; + } + } + + return $translatedLanguages; + } + + /** + * Return an array listing untranslated languages available + * + * @param bool $includeUnpublished also list unpublished translations + * @return array the page untranslated languages + */ + public function untranslatedLanguages($includeUnpublished = false) + { + $grav = Grav::instance(); + + /** @var Language $language */ + $language = $grav['language']; + + $languages = $language->getLanguages(); + $translated = array_keys($this->translatedLanguages(!$includeUnpublished)); + + return array_values(array_diff($languages, $translated)); + } + + /** + * Gets and Sets the raw data + * + * @param string|null $var Raw content string + * @return string Raw content string + */ + public function raw($var = null) + { + $file = $this->file(); + + if ($var) { + // First update file object. + if ($file) { + $file->raw($var); + } + + // Reset header and content. + $this->modified = time(); + $this->id($this->modified() . md5($this->filePath())); + $this->header = null; + $this->content = null; + $this->summary = null; + } + + return $file ? $file->raw() : ''; + } + + /** + * Gets and Sets the page frontmatter + * + * @param string|null $var + * + * @return string + */ + public function frontmatter($var = null) + { + if ($var) { + $this->frontmatter = (string)$var; + + // Update also file object. + $file = $this->file(); + if ($file) { + $file->frontmatter((string)$var); + } + + // Force content re-processing. + $this->id(time() . md5($this->filePath())); + } + if (!$this->frontmatter) { + $this->header(); + } + + return $this->frontmatter; + } + + /** + * Gets and Sets the header based on the YAML configuration at the top of the .md file + * + * @param object|array|null $var a YAML object representing the configuration for the file + * @return \stdClass the current YAML configuration + */ + public function header($var = null) + { + if ($var) { + $this->header = (object)$var; + + // Update also file object. + $file = $this->file(); + if ($file) { + $file->header((array)$var); + } + + // Force content re-processing. + $this->id(time() . md5($this->filePath())); + } + if (!$this->header) { + $file = $this->file(); + if ($file) { + try { + $this->raw_content = $file->markdown(); + $this->frontmatter = $file->frontmatter(); + $this->header = (object)$file->header(); + + if (!Utils::isAdminPlugin()) { + // If there's a `frontmatter.yaml` file merge that in with the page header + // note page's own frontmatter has precedence and will overwrite any defaults + $frontmatter_filename = $this->path . '/' . $this->folder . '/frontmatter.yaml'; + if (file_exists($frontmatter_filename)) { + $frontmatter_file = CompiledYamlFile::instance($frontmatter_filename); + $frontmatter_data = $frontmatter_file->content(); + $this->header = (object)array_replace_recursive( + $frontmatter_data, + (array)$this->header + ); + $frontmatter_file->free(); + } + + // Process frontmatter with Twig if enabled + if (Grav::instance()['config']->get('system.pages.frontmatter.process_twig') === true) { + $this->processFrontmatter(); + } + } + } catch (Exception $e) { + $file->raw(Grav::instance()['language']->translate([ + 'GRAV.FRONTMATTER_ERROR_PAGE', + $this->slug(), + $file->filename(), + $e->getMessage(), + $file->raw() + ])); + $this->raw_content = $file->markdown(); + $this->frontmatter = $file->frontmatter(); + $this->header = (object)$file->header(); + } + $var = true; + } + } + + if ($var) { + if (isset($this->header->modified)) { + $this->modified($this->header->modified); + } + if (isset($this->header->slug)) { + $this->slug($this->header->slug); + } + if (isset($this->header->routes)) { + $this->routes = (array)$this->header->routes; + } + if (isset($this->header->title)) { + $this->title = trim($this->header->title); + } + if (isset($this->header->language)) { + $this->language = trim($this->header->language); + } + if (isset($this->header->template)) { + $this->template = trim($this->header->template); + } + if (isset($this->header->menu)) { + $this->menu = trim($this->header->menu); + } + if (isset($this->header->routable)) { + $this->routable = (bool)$this->header->routable; + } + if (isset($this->header->visible)) { + $this->visible = (bool)$this->header->visible; + } + if (isset($this->header->redirect)) { + $this->redirect = trim($this->header->redirect); + } + if (isset($this->header->external_url)) { + $this->external_url = trim($this->header->external_url); + } + if (isset($this->header->order_dir)) { + $this->order_dir = trim($this->header->order_dir); + } + if (isset($this->header->order_by)) { + $this->order_by = trim($this->header->order_by); + } + if (isset($this->header->order_manual)) { + $this->order_manual = (array)$this->header->order_manual; + } + if (isset($this->header->dateformat)) { + $this->dateformat($this->header->dateformat); + } + if (isset($this->header->date)) { + $this->date($this->header->date); + } + if (isset($this->header->markdown_extra)) { + $this->markdown_extra = (bool)$this->header->markdown_extra; + } + if (isset($this->header->taxonomy)) { + $this->taxonomy($this->header->taxonomy); + } + if (isset($this->header->max_count)) { + $this->max_count = (int)$this->header->max_count; + } + if (isset($this->header->process)) { + foreach ((array)$this->header->process as $process => $status) { + $this->process[$process] = (bool)$status; + } + } + if (isset($this->header->published)) { + $this->published = (bool)$this->header->published; + } + if (isset($this->header->publish_date)) { + $this->publishDate($this->header->publish_date); + } + if (isset($this->header->unpublish_date)) { + $this->unpublishDate($this->header->unpublish_date); + } + if (isset($this->header->expires)) { + $this->expires = (int)$this->header->expires; + } + if (isset($this->header->cache_control)) { + $this->cache_control = $this->header->cache_control; + } + if (isset($this->header->etag)) { + $this->etag = (bool)$this->header->etag; + } + if (isset($this->header->last_modified)) { + $this->last_modified = (bool)$this->header->last_modified; + } + if (isset($this->header->ssl)) { + $this->ssl = (bool)$this->header->ssl; + } + if (isset($this->header->template_format)) { + $this->template_format = $this->header->template_format; + } + if (isset($this->header->debugger)) { + $this->debugger = (bool)$this->header->debugger; + } + if (isset($this->header->append_url_extension)) { + $this->url_extension = $this->header->append_url_extension; + } + } + + return $this->header; + } + + /** + * Get page language + * + * @param string|null $var + * @return mixed + */ + public function language($var = null) + { + if ($var !== null) { + $this->language = $var; + } + + return $this->language; + } + + /** + * Modify a header value directly + * + * @param string $key + * @param mixed $value + */ + public function modifyHeader($key, $value) + { + $this->header->{$key} = $value; + } + + /** + * @return int + */ + public function httpResponseCode() + { + return (int)($this->header()->http_response_code ?? 200); + } + + /** + * @return array + */ + public function httpHeaders() + { + $headers = []; + + $grav = Grav::instance(); + $format = $this->templateFormat(); + $cache_control = $this->cacheControl(); + $expires = $this->expires(); + + // Set Content-Type header + $headers['Content-Type'] = Utils::getMimeByExtension($format, 'text/html'); + + // Calculate Expires Headers if set to > 0 + if ($expires > 0) { + $expires_date = gmdate('D, d M Y H:i:s', time() + $expires) . ' GMT'; + if (!$cache_control) { + $headers['Cache-Control'] = 'max-age=' . $expires; + } + $headers['Expires'] = $expires_date; + } + + // Set Cache-Control header + if ($cache_control) { + $headers['Cache-Control'] = strtolower($cache_control); + } + + // Set Last-Modified header + if ($this->lastModified()) { + $last_modified_date = gmdate('D, d M Y H:i:s', $this->modified()) . ' GMT'; + $headers['Last-Modified'] = $last_modified_date; + } + + // Ask Grav to calculate ETag from the final content. + if ($this->eTag()) { + $headers['ETag'] = '1'; + } + + // Set Vary: Accept-Encoding header + if ($grav['config']->get('system.pages.vary_accept_encoding', false)) { + $headers['Vary'] = 'Accept-Encoding'; + } + + + // Added new Headers event + $headers_obj = (object) $headers; + Grav::instance()->fireEvent('onPageHeaders', new Event(['headers' => $headers_obj])); + + return (array)$headers_obj; + } + + /** + * Get the summary. + * + * @param int|null $size Max summary size. + * @param bool $textOnly Only count text size. + * @return string + */ + public function summary($size = null, $textOnly = false) + { + $config = (array)Grav::instance()['config']->get('site.summary'); + if (isset($this->header->summary)) { + $config = array_merge($config, $this->header->summary); + } + + // Return summary based on settings in site config file + if (!$config['enabled']) { + return $this->content(); + } + + // Set up variables to process summary from page or from custom summary + if ($this->summary === null) { + $content = $textOnly ? strip_tags($this->content()) : $this->content(); + $summary_size = $this->summary_size; + } else { + $content = $textOnly ? strip_tags($this->summary) : $this->summary; + $summary_size = mb_strwidth($content, 'utf-8'); + } + + // Return calculated summary based on summary divider's position + $format = $config['format']; + // Return entire page content on wrong/ unknown format + if (!in_array($format, ['short', 'long'])) { + return $content; + } + if (($format === 'short') && isset($summary_size)) { + // Slice the string + if (mb_strwidth($content, 'utf8') > $summary_size) { + return mb_substr($content, 0, $summary_size); + } + + return $content; + } + + // Get summary size from site config's file + if ($size === null) { + $size = $config['size']; + } + + // If the size is zero, return the entire page content + if ($size === 0) { + return $content; + // Return calculated summary based on defaults + } + if (!is_numeric($size) || ($size < 0)) { + $size = 300; + } + + // Only return string but not html, wrap whatever html tag you want when using + if ($textOnly) { + if (mb_strwidth($content, 'utf-8') <= $size) { + return $content; + } + + return mb_strimwidth($content, 0, $size, '…', 'UTF-8'); + } + + $summary = Utils::truncateHtml($content, $size); + + return html_entity_decode($summary, ENT_COMPAT | ENT_HTML401, 'UTF-8'); + } + + /** + * Sets the summary of the page + * + * @param string $summary Summary + */ + public function setSummary($summary) + { + $this->summary = $summary; + } + + /** + * Gets and Sets the content based on content portion of the .md file + * + * @param string|null $var Content + * @return string Content + */ + public function content($var = null) + { + if ($var !== null) { + $this->raw_content = $var; + + // Update file object. + $file = $this->file(); + if ($file) { + $file->markdown($var); + } + + // Force re-processing. + $this->id(time() . md5($this->filePath())); + $this->content = null; + } + // If no content, process it + if ($this->content === null) { + // Get media + $this->media(); + + /** @var Config $config */ + $config = Grav::instance()['config']; + + // Load cached content + /** @var Cache $cache */ + $cache = Grav::instance()['cache']; + $cache_id = md5('page' . $this->getCacheKey()); + $content_obj = $cache->fetch($cache_id); + + if (is_array($content_obj)) { + $this->content = $content_obj['content']; + $this->content_meta = $content_obj['content_meta']; + } else { + $this->content = $content_obj; + } + + + $process_markdown = $this->shouldProcess('markdown'); + $process_twig = $this->shouldProcess('twig') || $this->modularTwig(); + + $cache_enable = $this->header->cache_enable ?? $config->get( + 'system.cache.enabled', + true + ); + $twig_first = $this->header->twig_first ?? $config->get( + 'system.pages.twig_first', + false + ); + + // never cache twig means it's always run after content + $never_cache_twig = $this->header->never_cache_twig ?? $config->get( + 'system.pages.never_cache_twig', + true + ); + + // if no cached-content run everything + if ($never_cache_twig) { + if ($this->content === false || $cache_enable === false) { + $this->content = $this->raw_content; + Grav::instance()->fireEvent('onPageContentRaw', new Event(['page' => $this])); + + if ($process_markdown) { + $this->processMarkdown(); + } + + // Content Processed but not cached yet + Grav::instance()->fireEvent('onPageContentProcessed', new Event(['page' => $this])); + + if ($cache_enable) { + $this->cachePageContent(); + } + } + + if ($process_twig) { + $this->processTwig(); + } + } else { + if ($this->content === false || $cache_enable === false) { + $this->content = $this->raw_content; + Grav::instance()->fireEvent('onPageContentRaw', new Event(['page' => $this])); + + if ($twig_first) { + if ($process_twig) { + $this->processTwig(); + } + if ($process_markdown) { + $this->processMarkdown(); + } + + // Content Processed but not cached yet + Grav::instance()->fireEvent('onPageContentProcessed', new Event(['page' => $this])); + } else { + if ($process_markdown) { + $this->processMarkdown($process_twig); + } + + // Content Processed but not cached yet + Grav::instance()->fireEvent('onPageContentProcessed', new Event(['page' => $this])); + + if ($process_twig) { + $this->processTwig(); + } + } + + if ($cache_enable) { + $this->cachePageContent(); + } + } + } + + // Handle summary divider + $delimiter = $config->get('site.summary.delimiter', '==='); + $divider_pos = mb_strpos($this->content, "

{$delimiter}

"); + if ($divider_pos !== false) { + $this->summary_size = $divider_pos; + $this->content = str_replace("

{$delimiter}

", '', $this->content); + } + + // Fire event when Page::content() is called + Grav::instance()->fireEvent('onPageContent', new Event(['page' => $this])); + } + + return $this->content; + } + + /** + * Get the contentMeta array and initialize content first if it's not already + * + * @return mixed + */ + public function contentMeta() + { + if ($this->content === null) { + $this->content(); + } + + return $this->getContentMeta(); + } + + /** + * Add an entry to the page's contentMeta array + * + * @param string $name + * @param mixed $value + */ + public function addContentMeta($name, $value) + { + $this->content_meta[$name] = $value; + } + + /** + * Return the whole contentMeta array as it currently stands + * + * @param string|null $name + * + * @return mixed|null + */ + public function getContentMeta($name = null) + { + if ($name) { + return $this->content_meta[$name] ?? null; + } + + return $this->content_meta; + } + + /** + * Sets the whole content meta array in one shot + * + * @param array $content_meta + * + * @return array + */ + public function setContentMeta($content_meta) + { + return $this->content_meta = $content_meta; + } + + /** + * Process the Markdown content. Uses Parsedown or Parsedown Extra depending on configuration + * + * @param bool $keepTwig If true, content between twig tags will not be processed. + * @return void + */ + protected function processMarkdown(bool $keepTwig = false) + { + /** @var Config $config */ + $config = Grav::instance()['config']; + + $markdownDefaults = (array)$config->get('system.pages.markdown'); + if (isset($this->header()->markdown)) { + $markdownDefaults = array_merge($markdownDefaults, $this->header()->markdown); + } + + // pages.markdown_extra is deprecated, but still check it... + if (!isset($markdownDefaults['extra']) && (isset($this->markdown_extra) || $config->get('system.pages.markdown_extra') !== null)) { + user_error('Configuration option \'system.pages.markdown_extra\' is deprecated since Grav 1.5, use \'system.pages.markdown.extra\' instead', E_USER_DEPRECATED); + + $markdownDefaults['extra'] = $this->markdown_extra ?: $config->get('system.pages.markdown_extra'); + } + + $extra = $markdownDefaults['extra'] ?? false; + $defaults = [ + 'markdown' => $markdownDefaults, + 'images' => $config->get('system.images', []) + ]; + + $excerpts = new Excerpts($this, $defaults); + + // Initialize the preferred variant of Parsedown + if ($extra) { + $parsedown = new ParsedownExtra($excerpts); + } else { + $parsedown = new Parsedown($excerpts); + } + + $content = $this->content; + if ($keepTwig) { + $token = [ + '/' . Utils::generateRandomString(3), + Utils::generateRandomString(3) . '/' + ]; + // Base64 encode any twig. + $content = preg_replace_callback( + ['/({#.*?#})/mu', '/({{.*?}})/mu', '/({%.*?%})/mu'], + static function ($matches) use ($token) { return $token[0] . base64_encode($matches[1]) . $token[1]; }, + $content + ); + } + + $content = $parsedown->text($content); + + if ($keepTwig) { + // Base64 decode the encoded twig. + $content = preg_replace_callback( + ['`' . $token[0] . '([A-Za-z0-9+/]+={0,2})' . $token[1] . '`mu'], + static function ($matches) { return base64_decode($matches[1]); }, + $content + ); + } + + $this->content = $content; + } + + + /** + * Process the Twig page content. + * + * @return void + */ + private function processTwig() + { + /** @var Twig $twig */ + $twig = Grav::instance()['twig']; + $this->content = $twig->processPage($this, $this->content); + } + + /** + * Fires the onPageContentProcessed event, and caches the page content using a unique ID for the page + * + * @return void + */ + public function cachePageContent() + { + /** @var Cache $cache */ + $cache = Grav::instance()['cache']; + $cache_id = md5('page' . $this->getCacheKey()); + $cache->save($cache_id, ['content' => $this->content, 'content_meta' => $this->content_meta]); + } + + /** + * Needed by the onPageContentProcessed event to get the raw page content + * + * @return string the current page content + */ + public function getRawContent() + { + return $this->content; + } + + /** + * Needed by the onPageContentProcessed event to set the raw page content + * + * @param string|null $content + * @return void + */ + public function setRawContent($content) + { + $this->content = $content ?? ''; + } + + /** + * Get value from a page variable (used mostly for creating edit forms). + * + * @param string $name Variable name. + * @param mixed $default + * @return mixed + */ + public function value($name, $default = null) + { + if ($name === 'content') { + return $this->raw_content; + } + if ($name === 'route') { + $parent = $this->parent(); + + return $parent ? $parent->rawRoute() : ''; + } + if ($name === 'order') { + $order = $this->order(); + + return $order ? (int)$this->order() : ''; + } + if ($name === 'ordering') { + return (bool)$this->order(); + } + if ($name === 'folder') { + return preg_replace(PAGE_ORDER_PREFIX_REGEX, '', $this->folder); + } + if ($name === 'slug') { + return $this->slug(); + } + if ($name === 'name') { + $name = $this->name(); + $language = $this->language() ? '.' . $this->language() : ''; + $pattern = '%(' . preg_quote($language, '%') . ')?\.md$%'; + $name = preg_replace($pattern, '', $name); + + if ($this->isModule()) { + return 'modular/' . $name; + } + + return $name; + } + if ($name === 'media') { + return $this->media()->all(); + } + if ($name === 'media.file') { + return $this->media()->files(); + } + if ($name === 'media.video') { + return $this->media()->videos(); + } + if ($name === 'media.image') { + return $this->media()->images(); + } + if ($name === 'media.audio') { + return $this->media()->audios(); + } + + $path = explode('.', $name); + $scope = array_shift($path); + + if ($name === 'frontmatter') { + return $this->frontmatter; + } + + if ($scope === 'header') { + $current = $this->header(); + foreach ($path as $field) { + if (is_object($current) && isset($current->{$field})) { + $current = $current->{$field}; + } elseif (is_array($current) && isset($current[$field])) { + $current = $current[$field]; + } else { + return $default; + } + } + + return $current; + } + + return $default; + } + + /** + * Gets and Sets the Page raw content + * + * @param string|null $var + * @return string + */ + public function rawMarkdown($var = null) + { + if ($var !== null) { + $this->raw_content = $var; + } + + return $this->raw_content; + } + + /** + * @return bool + * @internal + */ + public function translated(): bool + { + return $this->initialized; + } + + /** + * Get file object to the page. + * + * @return MarkdownFile|null + */ + public function file() + { + if ($this->name) { + return MarkdownFile::instance($this->filePath()); + } + + return null; + } + + /** + * Save page if there's a file assigned to it. + * + * @param bool|array $reorder Internal use. + */ + public function save($reorder = true) + { + // Perform move, copy [or reordering] if needed. + $this->doRelocation(); + + $file = $this->file(); + if ($file) { + $file->filename($this->filePath()); + $file->header((array)$this->header()); + $file->markdown($this->raw_content); + $file->save(); + } + + // Perform reorder if required + if ($reorder && is_array($reorder)) { + $this->doReorder($reorder); + } + + // We need to signal Flex Pages about the change. + /** @var Flex|null $flex */ + $flex = Grav::instance()['flex'] ?? null; + $directory = $flex ? $flex->getDirectory('pages') : null; + if (null !== $directory) { + $directory->clearCache(); + } + + $this->_original = null; + } + + /** + * Prepare move page to new location. Moves also everything that's under the current page. + * + * You need to call $this->save() in order to perform the move. + * + * @param PageInterface $parent New parent page. + * @return $this + */ + public function move(PageInterface $parent) + { + if (!$this->_original) { + $clone = clone $this; + $this->_original = $clone; + } + + $this->_action = 'move'; + + if ($this->route() === $parent->route()) { + throw new RuntimeException('Failed: Cannot set page parent to self'); + } + if (Utils::startsWith($parent->rawRoute(), $this->rawRoute())) { + throw new RuntimeException('Failed: Cannot set page parent to a child of current page'); + } + + $this->parent($parent); + $this->id(time() . md5($this->filePath())); + + if ($parent->path()) { + $this->path($parent->path() . '/' . $this->folder()); + } + + if ($parent->route()) { + $this->route($parent->route() . '/' . $this->slug()); + } else { + $this->route(Grav::instance()['pages']->root()->route() . '/' . $this->slug()); + } + + $this->raw_route = null; + + return $this; + } + + /** + * Prepare a copy from the page. Copies also everything that's under the current page. + * + * Returns a new Page object for the copy. + * You need to call $this->save() in order to perform the move. + * + * @param PageInterface $parent New parent page. + * @return $this + */ + public function copy(PageInterface $parent) + { + $this->move($parent); + $this->_action = 'copy'; + + return $this; + } + + /** + * Get blueprints for the page. + * + * @return Blueprint + */ + public function blueprints() + { + $grav = Grav::instance(); + + /** @var Pages $pages */ + $pages = $grav['pages']; + + $blueprint = $pages->blueprints($this->blueprintName()); + $fields = $blueprint->fields(); + $edit_mode = isset($grav['admin']) ? $grav['config']->get('plugins.admin.edit_mode') : null; + + // override if you only want 'normal' mode + if (empty($fields) && ($edit_mode === 'auto' || $edit_mode === 'normal')) { + $blueprint = $pages->blueprints('default'); + } + + // override if you only want 'expert' mode + if (!empty($fields) && $edit_mode === 'expert') { + $blueprint = $pages->blueprints(''); + } + + return $blueprint; + } + + /** + * Returns the blueprint from the page. + * + * @param string $name Not used. + * @return Blueprint Returns a Blueprint. + */ + public function getBlueprint(string $name = '') + { + return $this->blueprints(); + } + + /** + * Get the blueprint name for this page. Use the blueprint form field if set + * + * @return string + */ + public function blueprintName() + { + if (!isset($_POST['blueprint'])) { + return $this->template(); + } + + $post_value = $_POST['blueprint']; + $sanitized_value = htmlspecialchars(strip_tags($post_value), ENT_QUOTES, 'UTF-8'); + + return $sanitized_value ?: $this->template(); + } + + /** + * Validate page header. + * + * @return void + * @throws Exception + */ + public function validate() + { + $blueprints = $this->blueprints(); + $blueprints->validate($this->toArray()); + } + + /** + * Filter page header from illegal contents. + * + * @return void + */ + public function filter() + { + $blueprints = $this->blueprints(); + $values = $blueprints->filter($this->toArray()); + if ($values && isset($values['header'])) { + $this->header($values['header']); + } + } + + /** + * Get unknown header variables. + * + * @return array + */ + public function extra() + { + $blueprints = $this->blueprints(); + + return $blueprints->extra($this->toArray()['header'], 'header.'); + } + + /** + * Convert page to an array. + * + * @return array + */ + public function toArray() + { + return [ + 'header' => (array)$this->header(), + 'content' => (string)$this->value('content') + ]; + } + + /** + * Convert page to YAML encoded string. + * + * @return string + */ + public function toYaml() + { + return Yaml::dump($this->toArray(), 20); + } + + /** + * Convert page to JSON encoded string. + * + * @return string + */ + public function toJson() + { + return json_encode($this->toArray()); + } + + /** + * @return string + */ + public function getCacheKey(): string + { + return $this->id(); + } + + /** + * Gets and sets the associated media as found in the page folder. + * + * @param Media|null $var Representation of associated media. + * @return Media Representation of associated media. + */ + public function media($var = null) + { + if ($var) { + $this->setMedia($var); + } + + /** @var Media $media */ + $media = $this->getMedia(); + + return $media; + } + + /** + * Get filesystem path to the associated media. + * + * @return string|null + */ + public function getMediaFolder() + { + return $this->path(); + } + + /** + * Get display order for the associated media. + * + * @return array Empty array means default ordering. + */ + public function getMediaOrder() + { + $header = $this->header(); + + return isset($header->media_order) ? array_map('trim', explode(',', (string)$header->media_order)) : []; + } + + /** + * Gets and sets the name field. If no name field is set, it will return 'default.md'. + * + * @param string|null $var The name of this page. + * @return string The name of this page. + */ + public function name($var = null) + { + if ($var !== null) { + $this->name = $var; + } + + return $this->name ?: 'default.md'; + } + + /** + * Returns child page type. + * + * @return string + */ + public function childType() + { + return isset($this->header->child_type) ? (string)$this->header->child_type : ''; + } + + /** + * Gets and sets the template field. This is used to find the correct Twig template file to render. + * If no field is set, it will return the name without the .md extension + * + * @param string|null $var the template name + * @return string the template name + */ + public function template($var = null) + { + if ($var !== null) { + $this->template = $var; + } + if (empty($this->template)) { + $this->template = ($this->isModule() ? 'modular/' : '') . str_replace($this->extension(), '', $this->name()); + } + + return $this->template; + } + + /** + * Allows a page to override the output render format, usually the extension provided in the URL. + * (e.g. `html`, `json`, `xml`, etc). + * + * @param string|null $var + * @return string + */ + public function templateFormat($var = null) + { + if (null !== $var) { + $this->template_format = is_string($var) ? $var : null; + } + + if (!isset($this->template_format)) { + $this->template_format = ltrim($this->header->append_url_extension ?? Utils::getPageFormat(), '.'); + } + + return $this->template_format; + } + + /** + * Gets and sets the extension field. + * + * @param string|null $var + * @return string + */ + public function extension($var = null) + { + if ($var !== null) { + $this->extension = $var; + } + if (empty($this->extension)) { + $this->extension = '.' . Utils::pathinfo($this->name(), PATHINFO_EXTENSION); + } + + return $this->extension; + } + + /** + * Returns the page extension, got from the page `url_extension` config and falls back to the + * system config `system.pages.append_url_extension`. + * + * @return string The extension of this page. For example `.html` + */ + public function urlExtension() + { + if ($this->home()) { + return ''; + } + + // if not set in the page get the value from system config + if (null === $this->url_extension) { + $this->url_extension = Grav::instance()['config']->get('system.pages.append_url_extension', ''); + } + + return $this->url_extension; + } + + /** + * Gets and sets the expires field. If not set will return the default + * + * @param int|null $var The new expires value. + * @return int The expires value + */ + public function expires($var = null) + { + if ($var !== null) { + $this->expires = $var; + } + + return $this->expires ?? Grav::instance()['config']->get('system.pages.expires'); + } + + /** + * Gets and sets the cache-control property. If not set it will return the default value (null) + * https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Cache-Control for more details on valid options + * + * @param string|null $var + * @return string|null + */ + public function cacheControl($var = null) + { + if ($var !== null) { + $this->cache_control = $var; + } + + return $this->cache_control ?? Grav::instance()['config']->get('system.pages.cache_control'); + } + + /** + * Gets and sets the title for this Page. If no title is set, it will use the slug() to get a name + * + * @param string|null $var the title of the Page + * @return string the title of the Page + */ + public function title($var = null) + { + if ($var !== null) { + $this->title = $var; + } + if (empty($this->title)) { + $this->title = ucfirst($this->slug()); + } + + return $this->title; + } + + /** + * Gets and sets the menu name for this Page. This is the text that can be used specifically for navigation. + * If no menu field is set, it will use the title() + * + * @param string|null $var the menu field for the page + * @return string the menu field for the page + */ + public function menu($var = null) + { + if ($var !== null) { + $this->menu = $var; + } + if (empty($this->menu)) { + $this->menu = $this->title(); + } + + return $this->menu; + } + + /** + * Gets and Sets whether or not this Page is visible for navigation + * + * @param bool|null $var true if the page is visible + * @return bool true if the page is visible + */ + public function visible($var = null) + { + if ($var !== null) { + $this->visible = (bool)$var; + } + + if ($this->visible === null) { + // Set item visibility in menu if folder is different from slug + // eg folder = 01.Home and slug = Home + if (preg_match(PAGE_ORDER_PREFIX_REGEX, $this->folder)) { + $this->visible = true; + } else { + $this->visible = false; + } + } + + return $this->visible; + } + + /** + * Gets and Sets whether or not this Page is considered published + * + * @param bool|null $var true if the page is published + * @return bool true if the page is published + */ + public function published($var = null) + { + if ($var !== null) { + $this->published = (bool)$var; + } + + // If not published, should not be visible in menus either + if ($this->published === false) { + $this->visible = false; + } + + return $this->published; + } + + /** + * Gets and Sets the Page publish date + * + * @param string|null $var string representation of a date + * @return int unix timestamp representation of the date + */ + public function publishDate($var = null) + { + if ($var !== null) { + $this->publish_date = Utils::date2timestamp($var, $this->dateformat); + } + + return $this->publish_date; + } + + /** + * Gets and Sets the Page unpublish date + * + * @param string|null $var string representation of a date + * @return int|null unix timestamp representation of the date + */ + public function unpublishDate($var = null) + { + if ($var !== null) { + $this->unpublish_date = Utils::date2timestamp($var, $this->dateformat); + } + + return $this->unpublish_date; + } + + /** + * Gets and Sets whether or not this Page is routable, ie you can reach it + * via a URL. + * The page must be *routable* and *published* + * + * @param bool|null $var true if the page is routable + * @return bool true if the page is routable + */ + public function routable($var = null) + { + if ($var !== null) { + $this->routable = (bool)$var; + } + + return $this->routable && $this->published(); + } + + /** + * @param bool|null $var + * @return bool + */ + public function ssl($var = null) + { + if ($var !== null) { + $this->ssl = (bool)$var; + } + + return $this->ssl; + } + + /** + * Gets and Sets the process setup for this Page. This is multi-dimensional array that consists of + * a simple array of arrays with the form array("markdown"=>true) for example + * + * @param array|null $var an Array of name value pairs where the name is the process and value is true or false + * @return array an Array of name value pairs where the name is the process and value is true or false + */ + public function process($var = null) + { + if ($var !== null) { + $this->process = (array)$var; + } + + return $this->process; + } + + /** + * Returns the state of the debugger override setting for this page + * + * @return bool + */ + public function debugger() + { + return !(isset($this->debugger) && $this->debugger === false); + } + + /** + * Function to merge page metadata tags and build an array of Metadata objects + * that can then be rendered in the page. + * + * @param array|null $var an Array of metadata values to set + * @return array an Array of metadata values for the page + */ + public function metadata($var = null) + { + if ($var !== null) { + $this->metadata = (array)$var; + } + + // if not metadata yet, process it. + if (null === $this->metadata) { + $header_tag_http_equivs = ['content-type', 'default-style', 'refresh', 'x-ua-compatible', 'content-security-policy']; + + $this->metadata = []; + + // Set the Generator tag + $metadata = [ + 'generator' => 'GravCMS' + ]; + + $config = Grav::instance()['config']; + + $escape = !$config->get('system.strict_mode.twig_compat', false) || $config->get('system.twig.autoescape', true); + + // Get initial metadata for the page + $metadata = array_merge($metadata, $config->get('site.metadata', [])); + + if (isset($this->header->metadata) && is_array($this->header->metadata)) { + // Merge any site.metadata settings in with page metadata + $metadata = array_merge($metadata, $this->header->metadata); + } + + // Build an array of meta objects.. + foreach ((array)$metadata as $key => $value) { + // Lowercase the key + $key = strtolower($key); + // If this is a property type metadata: "og", "twitter", "facebook" etc + // Backward compatibility for nested arrays in metas + if (is_array($value)) { + foreach ($value as $property => $prop_value) { + $prop_key = $key . ':' . $property; + $this->metadata[$prop_key] = [ + 'name' => $prop_key, + 'property' => $prop_key, + 'content' => $escape ? htmlspecialchars($prop_value, ENT_QUOTES | ENT_HTML5, 'UTF-8') : $prop_value + ]; + } + } else { + // If it this is a standard meta data type + if ($value) { + if (in_array($key, $header_tag_http_equivs, true)) { + $this->metadata[$key] = [ + 'http_equiv' => $key, + 'content' => $escape ? htmlspecialchars($value, ENT_COMPAT, 'UTF-8') : $value + ]; + } elseif ($key === 'charset') { + $this->metadata[$key] = ['charset' => $escape ? htmlspecialchars($value, ENT_QUOTES | ENT_HTML5, 'UTF-8') : $value]; + } else { + // if it's a social metadata with separator, render as property + $separator = strpos($key, ':'); + $hasSeparator = $separator && $separator < strlen($key) - 1; + $entry = [ + 'content' => $escape ? htmlspecialchars($value, ENT_QUOTES | ENT_HTML5, 'UTF-8') : $value + ]; + + if ($hasSeparator && !Utils::startsWith($key, ['twitter', 'flattr'])) { + $entry['property'] = $key; + } else { + $entry['name'] = $key; + } + + $this->metadata[$key] = $entry; + } + } + } + } + } + + return $this->metadata; + } + + /** + * Reset the metadata and pull from header again + */ + public function resetMetadata() + { + $this->metadata = null; + } + + /** + * Gets and Sets the slug for the Page. The slug is used in the URL routing. If not set it uses + * the parent folder from the path + * + * @param string|null $var the slug, e.g. 'my-blog' + * @return string the slug + */ + public function slug($var = null) + { + if ($var !== null && $var !== '') { + $this->slug = $var; + } + + if (empty($this->slug)) { + $this->slug = $this->adjustRouteCase(preg_replace(PAGE_ORDER_PREFIX_REGEX, '', (string) $this->folder)) ?: null; + } + + return $this->slug; + } + + /** + * Get/set order number of this page. + * + * @param int|null $var + * @return string|bool + */ + public function order($var = null) + { + if ($var !== null) { + $order = $var ? sprintf('%02d.', (int)$var) : ''; + $this->folder($order . preg_replace(PAGE_ORDER_PREFIX_REGEX, '', $this->folder)); + + return $order; + } + + preg_match(PAGE_ORDER_PREFIX_REGEX, $this->folder, $order); + + return $order[0] ?? false; + } + + /** + * Gets the URL for a page - alias of url(). + * + * @param bool $include_host + * @return string the permalink + */ + public function link($include_host = false) + { + return $this->url($include_host); + } + + /** + * Gets the URL with host information, aka Permalink. + * @return string The permalink. + */ + public function permalink() + { + return $this->url(true, false, true, true); + } + + /** + * Returns the canonical URL for a page + * + * @param bool $include_lang + * @return string + */ + public function canonical($include_lang = true) + { + return $this->url(true, true, $include_lang); + } + + /** + * Gets the url for the Page. + * + * @param bool $include_host Defaults false, but true would include http://yourhost.com + * @param bool $canonical True to return the canonical URL + * @param bool $include_base Include base url on multisite as well as language code + * @param bool $raw_route + * @return string The url. + */ + public function url($include_host = false, $canonical = false, $include_base = true, $raw_route = false) + { + // Override any URL when external_url is set + if (isset($this->external_url)) { + return $this->external_url; + } + + $grav = Grav::instance(); + + /** @var Pages $pages */ + $pages = $grav['pages']; + + /** @var Config $config */ + $config = $grav['config']; + + // get base route (multi-site base and language) + $route = $include_base ? $pages->baseRoute() : ''; + + // add full route if configured to do so + if (!$include_host && $config->get('system.absolute_urls', false)) { + $include_host = true; + } + + if ($canonical) { + $route .= $this->routeCanonical(); + } elseif ($raw_route) { + $route .= $this->rawRoute(); + } else { + $route .= $this->route(); + } + + /** @var Uri $uri */ + $uri = $grav['uri']; + $url = $uri->rootUrl($include_host) . '/' . trim($route, '/') . $this->urlExtension(); + + return Uri::filterPath($url); + } + + /** + * Gets the route for the page based on the route headers if available, else from + * the parents route and the current Page's slug. + * + * @param string|null $var Set new default route. + * @return string|null The route for the Page. + */ + public function route($var = null) + { + if ($var !== null) { + $this->route = $var; + } + + if (empty($this->route)) { + $baseRoute = null; + + // calculate route based on parent slugs + $parent = $this->parent(); + if (isset($parent)) { + if ($this->hide_home_route && $parent->route() === $this->home_route) { + $baseRoute = ''; + } else { + $baseRoute = (string)$parent->route(); + } + } + + $this->route = isset($baseRoute) ? $baseRoute . '/' . $this->slug() : null; + + if (!empty($this->routes) && isset($this->routes['default'])) { + $this->routes['aliases'][] = $this->route; + $this->route = $this->routes['default']; + + return $this->route; + } + } + + return $this->route; + } + + /** + * Helper method to clear the route out so it regenerates next time you use it + */ + public function unsetRouteSlug() + { + unset($this->route, $this->slug); + } + + /** + * Gets and Sets the page raw route + * + * @param string|null $var + * @return null|string + */ + public function rawRoute($var = null) + { + if ($var !== null) { + $this->raw_route = $var; + } + + if (empty($this->raw_route)) { + $parent = $this->parent(); + $baseRoute = $parent ? (string)$parent->rawRoute() : null; + + $slug = $this->adjustRouteCase(preg_replace(PAGE_ORDER_PREFIX_REGEX, '', $this->folder)); + + $this->raw_route = isset($baseRoute) ? $baseRoute . '/' . $slug : null; + } + + return $this->raw_route; + } + + /** + * Gets the route aliases for the page based on page headers. + * + * @param array|null $var list of route aliases + * @return array The route aliases for the Page. + */ + public function routeAliases($var = null) + { + if ($var !== null) { + $this->routes['aliases'] = (array)$var; + } + + if (!empty($this->routes) && isset($this->routes['aliases'])) { + return $this->routes['aliases']; + } + + return []; + } + + /** + * Gets the canonical route for this page if its set. If provided it will use + * that value, else if it's `true` it will use the default route. + * + * @param string|null $var + * @return bool|string + */ + public function routeCanonical($var = null) + { + if ($var !== null) { + $this->routes['canonical'] = $var; + } + + if (!empty($this->routes) && isset($this->routes['canonical'])) { + return $this->routes['canonical']; + } + + return $this->route(); + } + + /** + * Gets and sets the identifier for this Page object. + * + * @param string|null $var the identifier + * @return string the identifier + */ + public function id($var = null) + { + if (null === $this->id) { + // We need to set unique id to avoid potential cache conflicts between pages. + $var = time() . md5($this->filePath()); + } + if ($var !== null) { + // store unique per language + $active_lang = Grav::instance()['language']->getLanguage() ?: ''; + $id = $active_lang . $var; + $this->id = $id; + } + + return $this->id; + } + + /** + * Gets and sets the modified timestamp. + * + * @param int|null $var modified unix timestamp + * @return int modified unix timestamp + */ + public function modified($var = null) + { + if ($var !== null) { + $this->modified = $var; + } + + return $this->modified; + } + + /** + * Gets the redirect set in the header. + * + * @param string|null $var redirect url + * @return string|null + */ + public function redirect($var = null) + { + if ($var !== null) { + $this->redirect = $var; + } + + return $this->redirect ?: null; + } + + /** + * Gets and sets the option to show the etag header for the page. + * + * @param bool|null $var show etag header + * @return bool show etag header + */ + public function eTag($var = null): bool + { + if ($var !== null) { + $this->etag = $var; + } + if (!isset($this->etag)) { + $this->etag = (bool)Grav::instance()['config']->get('system.pages.etag'); + } + + return $this->etag ?? false; + } + + /** + * Gets and sets the option to show the last_modified header for the page. + * + * @param bool|null $var show last_modified header + * @return bool show last_modified header + */ + public function lastModified($var = null) + { + if ($var !== null) { + $this->last_modified = $var; + } + if (!isset($this->last_modified)) { + $this->last_modified = (bool)Grav::instance()['config']->get('system.pages.last_modified'); + } + + return $this->last_modified; + } + + /** + * Gets and sets the path to the .md file for this Page object. + * + * @param string|null $var the file path + * @return string|null the file path + */ + public function filePath($var = null) + { + if ($var !== null) { + // Filename of the page. + $this->name = Utils::basename($var); + // Folder of the page. + $this->folder = Utils::basename(dirname($var)); + // Path to the page. + $this->path = dirname($var, 2); + } + + return rtrim($this->path . '/' . $this->folder . '/' . ($this->name() ?: ''), '/'); + } + + /** + * Gets the relative path to the .md file + * + * @return string The relative file path + */ + public function filePathClean() + { + return str_replace(GRAV_ROOT . DS, '', $this->filePath()); + } + + /** + * Returns the clean path to the page file + * + * @return string + */ + public function relativePagePath() + { + return str_replace('/' . $this->name(), '', $this->filePathClean()); + } + + /** + * Gets and sets the path to the folder where the .md for this Page object resides. + * This is equivalent to the filePath but without the filename. + * + * @param string|null $var the path + * @return string|null the path + */ + public function path($var = null) + { + if ($var !== null) { + // Folder of the page. + $this->folder = Utils::basename($var); + // Path to the page. + $this->path = dirname($var); + } + + return $this->path ? $this->path . '/' . $this->folder : null; + } + + /** + * Get/set the folder. + * + * @param string|null $var Optional path + * @return string|null + */ + public function folder($var = null) + { + if ($var !== null) { + $this->folder = $var; + } + + return $this->folder; + } + + /** + * Gets and sets the date for this Page object. This is typically passed in via the page headers + * + * @param string|null $var string representation of a date + * @return int unix timestamp representation of the date + */ + public function date($var = null) + { + if ($var !== null) { + $this->date = Utils::date2timestamp($var, $this->dateformat); + } + + if (!$this->date) { + $this->date = $this->modified; + } + + return $this->date; + } + + /** + * Gets and sets the date format for this Page object. This is typically passed in via the page headers + * using typical PHP date string structure - http://php.net/manual/en/function.date.php + * + * @param string|null $var string representation of a date format + * @return string string representation of a date format + */ + public function dateformat($var = null) + { + if ($var !== null) { + $this->dateformat = $var; + } + + return $this->dateformat; + } + + /** + * Gets and sets the order by which any sub-pages should be sorted. + * + * @param string|null $var the order, either "asc" or "desc" + * @return string the order, either "asc" or "desc" + * @deprecated 1.6 + */ + public function orderDir($var = null) + { + //user_error(__CLASS__ . '::' . __FUNCTION__ . '() is deprecated since Grav 1.6', E_USER_DEPRECATED); + + if ($var !== null) { + $this->order_dir = $var; + } + + if (empty($this->order_dir)) { + $this->order_dir = 'asc'; + } + + return $this->order_dir; + } + + /** + * Gets and sets the order by which the sub-pages should be sorted. + * + * default - is the order based on the file system, ie 01.Home before 02.Advark + * title - is the order based on the title set in the pages + * date - is the order based on the date set in the pages + * folder - is the order based on the name of the folder with any numerics omitted + * + * @param string|null $var supported options include "default", "title", "date", and "folder" + * @return string supported options include "default", "title", "date", and "folder" + * @deprecated 1.6 + */ + public function orderBy($var = null) + { + //user_error(__CLASS__ . '::' . __FUNCTION__ . '() is deprecated since Grav 1.6', E_USER_DEPRECATED); + + if ($var !== null) { + $this->order_by = $var; + } + + return $this->order_by; + } + + /** + * Gets the manual order set in the header. + * + * @param string|null $var supported options include "default", "title", "date", and "folder" + * @return array + * @deprecated 1.6 + */ + public function orderManual($var = null) + { + //user_error(__CLASS__ . '::' . __FUNCTION__ . '() is deprecated since Grav 1.6', E_USER_DEPRECATED); + + if ($var !== null) { + $this->order_manual = $var; + } + + return (array)$this->order_manual; + } + + /** + * Gets and sets the maxCount field which describes how many sub-pages should be displayed if the + * sub_pages header property is set for this page object. + * + * @param int|null $var the maximum number of sub-pages + * @return int the maximum number of sub-pages + * @deprecated 1.6 + */ + public function maxCount($var = null) + { + //user_error(__CLASS__ . '::' . __FUNCTION__ . '() is deprecated since Grav 1.6', E_USER_DEPRECATED); + + if ($var !== null) { + $this->max_count = (int)$var; + } + if (empty($this->max_count)) { + /** @var Config $config */ + $config = Grav::instance()['config']; + $this->max_count = (int)$config->get('system.pages.list.count'); + } + + return $this->max_count; + } + + /** + * Gets and sets the taxonomy array which defines which taxonomies this page identifies itself with. + * + * @param array|null $var an array of taxonomies + * @return array an array of taxonomies + */ + public function taxonomy($var = null) + { + if ($var !== null) { + // make sure first level are arrays + array_walk($var, static function (&$value) { + $value = (array) $value; + }); + // make sure all values are strings + array_walk_recursive($var, static function (&$value) { + $value = (string) $value; + }); + $this->taxonomy = $var; + } + + return $this->taxonomy; + } + + /** + * Gets and sets the modular var that helps identify this page is a modular child + * + * @param bool|null $var true if modular_twig + * @return bool true if modular_twig + * @deprecated 1.7 Use ->isModule() or ->modularTwig() method instead. + */ + public function modular($var = null) + { + user_error(__METHOD__ . '() is deprecated since Grav 1.7, use ->isModule() or ->modularTwig() method instead', E_USER_DEPRECATED); + + return $this->modularTwig($var); + } + + /** + * Gets and sets the modular_twig var that helps identify this page as a modular child page that will need + * twig processing handled differently from a regular page. + * + * @param bool|null $var true if modular_twig + * @return bool true if modular_twig + */ + public function modularTwig($var = null) + { + if ($var !== null) { + $this->modular_twig = (bool)$var; + if ($var) { + $this->visible(false); + // some routable logic + if (empty($this->header->routable)) { + $this->routable = false; + } + } + } + + return $this->modular_twig ?? false; + } + + /** + * Gets the configured state of the processing method. + * + * @param string $process the process, eg "twig" or "markdown" + * @return bool whether or not the processing method is enabled for this Page + */ + public function shouldProcess($process) + { + return (bool)($this->process[$process] ?? false); + } + + /** + * Gets and Sets the parent object for this page + * + * @param PageInterface|null $var the parent page object + * @return PageInterface|null the parent page object if it exists. + */ + public function parent(PageInterface $var = null) + { + if ($var) { + $this->parent = $var->path(); + + return $var; + } + + /** @var Pages $pages */ + $pages = Grav::instance()['pages']; + + return $pages->get($this->parent); + } + + /** + * Gets the top parent object for this page. Can return page itself. + * + * @return PageInterface The top parent page object. + */ + public function topParent() + { + $topParent = $this; + + while (true) { + $theParent = $topParent->parent(); + if ($theParent !== null && $theParent->parent() !== null) { + $topParent = $theParent; + } else { + break; + } + } + + return $topParent; + } + + /** + * Returns children of this page. + * + * @return PageCollectionInterface|Collection + */ + public function children() + { + /** @var Pages $pages */ + $pages = Grav::instance()['pages']; + + return $pages->children($this->path()); + } + + + /** + * Check to see if this item is the first in an array of sub-pages. + * + * @return bool True if item is first. + */ + public function isFirst() + { + $parent = $this->parent(); + $collection = $parent ? $parent->collection('content', false) : null; + if ($collection instanceof Collection) { + return $collection->isFirst($this->path()); + } + + return true; + } + + /** + * Check to see if this item is the last in an array of sub-pages. + * + * @return bool True if item is last + */ + public function isLast() + { + $parent = $this->parent(); + $collection = $parent ? $parent->collection('content', false) : null; + if ($collection instanceof Collection) { + return $collection->isLast($this->path()); + } + + return true; + } + + /** + * Gets the previous sibling based on current position. + * + * @return PageInterface the previous Page item + */ + public function prevSibling() + { + return $this->adjacentSibling(-1); + } + + /** + * Gets the next sibling based on current position. + * + * @return PageInterface the next Page item + */ + public function nextSibling() + { + return $this->adjacentSibling(1); + } + + /** + * Returns the adjacent sibling based on a direction. + * + * @param int $direction either -1 or +1 + * @return PageInterface|false the sibling page + */ + public function adjacentSibling($direction = 1) + { + $parent = $this->parent(); + $collection = $parent ? $parent->collection('content', false) : null; + if ($collection instanceof Collection) { + return $collection->adjacentSibling($this->path(), $direction); + } + + return false; + } + + /** + * Returns the item in the current position. + * + * @return int|null The index of the current page. + */ + public function currentPosition() + { + $parent = $this->parent(); + $collection = $parent ? $parent->collection('content', false) : null; + if ($collection instanceof Collection) { + return $collection->currentPosition($this->path()); + } + + return 1; + } + + /** + * Returns whether or not this page is the currently active page requested via the URL. + * + * @return bool True if it is active + */ + public function active() + { + $uri_path = rtrim(urldecode(Grav::instance()['uri']->path()), '/') ?: '/'; + $routes = Grav::instance()['pages']->routes(); + + return isset($routes[$uri_path]) && $routes[$uri_path] === $this->path(); + } + + /** + * Returns whether or not this URI's URL contains the URL of the active page. + * Or in other words, is this page's URL in the current URL + * + * @return bool True if active child exists + */ + public function activeChild() + { + $grav = Grav::instance(); + /** @var Uri $uri */ + $uri = $grav['uri']; + /** @var Pages $pages */ + $pages = $grav['pages']; + $uri_path = rtrim(urldecode($uri->path()), '/'); + $routes = $pages->routes(); + + if (isset($routes[$uri_path])) { + $page = $pages->find($uri->route()); + /** @var PageInterface|null $child_page */ + $child_page = $page ? $page->parent() : null; + while ($child_page && !$child_page->root()) { + if ($this->path() === $child_page->path()) { + return true; + } + $child_page = $child_page->parent(); + } + } + + return false; + } + + /** + * Returns whether or not this page is the currently configured home page. + * + * @return bool True if it is the homepage + */ + public function home() + { + $home = Grav::instance()['config']->get('system.home.alias'); + + return $this->route() === $home || $this->rawRoute() === $home; + } + + /** + * Returns whether or not this page is the root node of the pages tree. + * + * @return bool True if it is the root + */ + public function root() + { + return !$this->parent && !$this->name && !$this->visible; + } + + /** + * Helper method to return an ancestor page. + * + * @param bool|null $lookup Name of the parent folder + * @return PageInterface page you were looking for if it exists + */ + public function ancestor($lookup = null) + { + /** @var Pages $pages */ + $pages = Grav::instance()['pages']; + + return $pages->ancestor($this->route, $lookup); + } + + /** + * Helper method to return an ancestor page to inherit from. The current + * page object is returned. + * + * @param string $field Name of the parent folder + * @return PageInterface + */ + public function inherited($field) + { + [$inherited, $currentParams] = $this->getInheritedParams($field); + + $this->modifyHeader($field, $currentParams); + + return $inherited; + } + + /** + * Helper method to return an ancestor field only to inherit from. The + * first occurrence of an ancestor field will be returned if at all. + * + * @param string $field Name of the parent folder + * + * @return array + */ + public function inheritedField($field) + { + [$inherited, $currentParams] = $this->getInheritedParams($field); + + return $currentParams; + } + + /** + * Method that contains shared logic for inherited() and inheritedField() + * + * @param string $field Name of the parent folder + * @return array + */ + protected function getInheritedParams($field) + { + $pages = Grav::instance()['pages']; + + /** @var Pages $pages */ + $inherited = $pages->inherited($this->route, $field); + $inheritedParams = $inherited ? (array)$inherited->value('header.' . $field) : []; + $currentParams = (array)$this->value('header.' . $field); + if ($inheritedParams && is_array($inheritedParams)) { + $currentParams = array_replace_recursive($inheritedParams, $currentParams); + } + + return [$inherited, $currentParams]; + } + + /** + * Helper method to return a page. + * + * @param string $url the url of the page + * @param bool $all + * + * @return PageInterface page you were looking for if it exists + */ + public function find($url, $all = false) + { + /** @var Pages $pages */ + $pages = Grav::instance()['pages']; + + return $pages->find($url, $all); + } + + /** + * Get a collection of pages in the current context. + * + * @param string|array $params + * @param bool $pagination + * + * @return PageCollectionInterface|Collection + * @throws InvalidArgumentException + */ + public function collection($params = 'content', $pagination = true) + { + if (is_string($params)) { + // Look into a page header field. + $params = (array)$this->value('header.' . $params); + } elseif (!is_array($params)) { + throw new InvalidArgumentException('Argument should be either header variable name or array of parameters'); + } + + $params['filter'] = ($params['filter'] ?? []) + ['translated' => true]; + $context = [ + 'pagination' => $pagination, + 'self' => $this + ]; + + /** @var Pages $pages */ + $pages = Grav::instance()['pages']; + + return $pages->getCollection($params, $context); + } + + /** + * @param string|array $value + * @param bool $only_published + * @return PageCollectionInterface|Collection + */ + public function evaluate($value, $only_published = true) + { + $params = [ + 'items' => $value, + 'published' => $only_published + ]; + $context = [ + 'event' => false, + 'pagination' => false, + 'url_taxonomy_filters' => false, + 'self' => $this + ]; + + /** @var Pages $pages */ + $pages = Grav::instance()['pages']; + + return $pages->getCollection($params, $context); + } + + /** + * Returns whether or not this Page object has a .md file associated with it or if its just a directory. + * + * @return bool True if its a page with a .md file associated + */ + public function isPage() + { + if ($this->name) { + return true; + } + + return false; + } + + /** + * Returns whether or not this Page object is a directory or a page. + * + * @return bool True if its a directory + */ + public function isDir() + { + return !$this->isPage(); + } + + /** + * @return bool + */ + public function isModule(): bool + { + return $this->modularTwig(); + } + + /** + * Returns whether the page exists in the filesystem. + * + * @return bool + */ + public function exists() + { + $file = $this->file(); + + return $file && $file->exists(); + } + + /** + * Returns whether or not the current folder exists + * + * @return bool + */ + public function folderExists() + { + return file_exists($this->path()); + } + + /** + * Cleans the path. + * + * @param string $path the path + * @return string the path + */ + protected function cleanPath($path) + { + $lastchunk = strrchr($path, DS); + if (strpos($lastchunk, ':') !== false) { + $path = str_replace($lastchunk, '', $path); + } + + return $path; + } + + /** + * Reorders all siblings according to a defined order + * + * @param array|null $new_order + */ + protected function doReorder($new_order) + { + if (!$this->_original) { + return; + } + + $pages = Grav::instance()['pages']; + $pages->init(); + + $this->_original->path($this->path()); + + $parent = $this->parent(); + $siblings = $parent ? $parent->children() : null; + + if ($siblings) { + $siblings->order('slug', 'asc', $new_order); + + $counter = 0; + + // Reorder all moved pages. + foreach ($siblings as $slug => $page) { + $order = (int)trim($page->order(), '.'); + $counter++; + + if ($order) { + if ($page->path() === $this->path() && $this->folderExists()) { + // Handle current page; we do want to change ordering number, but nothing else. + $this->order($counter); + $this->save(false); + } else { + // Handle all the other pages. + $page = $pages->get($page->path()); + if ($page && $page->folderExists() && !$page->_action) { + $page = $page->move($this->parent()); + $page->order($counter); + $page->save(false); + } + } + } + } + } + } + + /** + * Moves or copies the page in filesystem. + * + * @internal + * @return void + * @throws Exception + */ + protected function doRelocation() + { + if (!$this->_original) { + return; + } + + if (is_dir($this->_original->path())) { + if ($this->_action === 'move') { + Folder::move($this->_original->path(), $this->path()); + } elseif ($this->_action === 'copy') { + Folder::copy($this->_original->path(), $this->path()); + } + } + + if ($this->name() !== $this->_original->name()) { + $path = $this->path(); + if (is_file($path . '/' . $this->_original->name())) { + rename($path . '/' . $this->_original->name(), $path . '/' . $this->name()); + } + } + } + + /** + * @return void + */ + protected function setPublishState() + { + // Handle publishing dates if no explicit published option set + if (Grav::instance()['config']->get('system.pages.publish_dates') && !isset($this->header->published)) { + // unpublish if required, if not clear cache right before page should be unpublished + if ($this->unpublishDate()) { + if ($this->unpublishDate() < time()) { + $this->published(false); + } else { + $this->published(); + Grav::instance()['cache']->setLifeTime($this->unpublishDate()); + } + } + // publish if required, if not clear cache right before page is published + if ($this->publishDate() && $this->publishDate() > time()) { + $this->published(false); + Grav::instance()['cache']->setLifeTime($this->publishDate()); + } + } + } + + /** + * @param string $route + * @return string + */ + protected function adjustRouteCase($route) + { + $case_insensitive = Grav::instance()['config']->get('system.force_lowercase_urls'); + + return $case_insensitive ? mb_strtolower($route) : $route; + } + + /** + * Gets the Page Unmodified (original) version of the page. + * + * @return PageInterface The original version of the page. + */ + public function getOriginal() + { + return $this->_original; + } + + /** + * Gets the action. + * + * @return string|null The Action string. + */ + public function getAction() + { + return $this->_action; + } +} diff --git a/system/src/Grav/Common/Page/Pages.php b/system/src/Grav/Common/Page/Pages.php new file mode 100644 index 0000000..df23287 --- /dev/null +++ b/system/src/Grav/Common/Page/Pages.php @@ -0,0 +1,2258 @@ + */ + protected $instances = []; + /** @var array */ + protected $index = []; + /** @var array */ + protected $children; + /** @var string */ + protected $base = ''; + /** @var string[] */ + protected $baseRoute = []; + /** @var string[] */ + protected $routes = []; + /** @var array */ + protected $sort; + /** @var Blueprints */ + protected $blueprints; + /** @var bool */ + protected $enable_pages = true; + /** @var int */ + protected $last_modified; + /** @var string[] */ + protected $ignore_files; + /** @var string[] */ + protected $ignore_folders; + /** @var bool */ + protected $ignore_hidden; + /** @var string */ + protected $check_method; + /** @var string */ + protected $simple_pages_hash; + /** @var string */ + protected $pages_cache_id; + /** @var bool */ + protected $initialized = false; + /** @var string */ + protected $active_lang; + /** @var bool */ + protected $fire_events = false; + /** @var Types|null */ + protected static $types; + /** @var string|null */ + protected static $home_route; + + + /** + * Constructor + * + * @param Grav $grav + */ + public function __construct(Grav $grav) + { + $this->grav = $grav; + } + + /** + * @return FlexDirectory|null + */ + public function getDirectory(): ?FlexDirectory + { + return $this->directory; + } + + /** + * Method used in admin to disable frontend pages from being initialized. + */ + public function disablePages(): void + { + $this->enable_pages = false; + } + + /** + * Method used in admin to later load frontend pages. + */ + public function enablePages(): void + { + if (!$this->enable_pages) { + $this->enable_pages = true; + + $this->init(); + } + } + + /** + * Get or set base path for the pages. + * + * @param string|null $path + * @return string + */ + public function base($path = null) + { + if ($path !== null) { + $path = trim($path, '/'); + $this->base = $path ? '/' . $path : ''; + $this->baseRoute = []; + } + + return $this->base; + } + + /** + * + * Get base route for Grav pages. + * + * @param string|null $lang Optional language code for multilingual routes. + * @return string + */ + public function baseRoute($lang = null) + { + $key = $lang ?: $this->active_lang ?: 'default'; + + if (!isset($this->baseRoute[$key])) { + /** @var Language $language */ + $language = $this->grav['language']; + + $path_base = rtrim($this->base(), '/'); + $path_lang = $language->enabled() ? $language->getLanguageURLPrefix($lang) : ''; + + $this->baseRoute[$key] = $path_base . $path_lang; + } + + return $this->baseRoute[$key]; + } + + /** + * + * Get route for Grav site. + * + * @param string $route Optional route to the page. + * @param string|null $lang Optional language code for multilingual links. + * @return string + */ + public function route($route = '/', $lang = null) + { + if (!$route || $route === '/') { + return $this->baseRoute($lang) ?: '/'; + } + + return $this->baseRoute($lang) . $route; + } + + /** + * Get relative referrer route and language code. Returns null if the route isn't within the current base, language (if set) and route. + * + * @example `$langCode = null; $referrer = $pages->referrerRoute($langCode, '/admin');` returns relative referrer url within /admin and updates $langCode + * @example `$langCode = 'en'; $referrer = $pages->referrerRoute($langCode, '/admin');` returns relative referrer url within the /en/admin + * + * @param string|null $langCode Variable to store the language code. If already set, check only against that language. + * @param string $route Optional route within the site. + * @return string|null + * @since 1.7.23 + */ + public function referrerRoute(?string &$langCode, string $route = '/'): ?string + { + $referrer = $_SERVER['HTTP_REFERER'] ?? null; + + // Start by checking that referrer came from our site. + $root = $this->grav['base_url_absolute']; + if (!is_string($referrer) || !str_starts_with($referrer, $root)) { + return null; + } + + /** @var Language $language */ + $language = $this->grav['language']; + + // Get all language codes and append no language. + if (null === $langCode) { + $languages = $language->enabled() ? $language->getLanguages() : []; + $languages[] = ''; + } else { + $languages[] = $langCode; + } + + $path_base = rtrim($this->base(), '/'); + $path_route = rtrim($route, '/'); + + // Try to figure out the language code. + foreach ($languages as $code) { + $path_lang = $code ? "/{$code}" : ''; + + $base = $path_base . $path_lang . $path_route; + if ($referrer === $base || str_starts_with($referrer, "{$base}/")) { + if (null === $langCode) { + $langCode = $code; + } + + return substr($referrer, \strlen($base)); + } + } + + return null; + } + + /** + * + * Get base URL for Grav pages. + * + * @param string|null $lang Optional language code for multilingual links. + * @param bool|null $absolute If true, return absolute url, if false, return relative url. Otherwise return default. + * @return string + */ + public function baseUrl($lang = null, $absolute = null) + { + if ($absolute === null) { + $type = 'base_url'; + } elseif ($absolute) { + $type = 'base_url_absolute'; + } else { + $type = 'base_url_relative'; + } + + return $this->grav[$type] . $this->baseRoute($lang); + } + + /** + * + * Get home URL for Grav site. + * + * @param string|null $lang Optional language code for multilingual links. + * @param bool|null $absolute If true, return absolute url, if false, return relative url. Otherwise return default. + * @return string + */ + public function homeUrl($lang = null, $absolute = null) + { + return $this->baseUrl($lang, $absolute) ?: '/'; + } + + /** + * + * Get URL for Grav site. + * + * @param string $route Optional route to the page. + * @param string|null $lang Optional language code for multilingual links. + * @param bool|null $absolute If true, return absolute url, if false, return relative url. Otherwise return default. + * @return string + */ + public function url($route = '/', $lang = null, $absolute = null) + { + if (!$route || $route === '/') { + return $this->homeUrl($lang, $absolute); + } + + return $this->baseUrl($lang, $absolute) . Uri::filterPath($route); + } + + /** + * @param string $method + * @return void + */ + public function setCheckMethod($method): void + { + $this->check_method = strtolower($method); + } + + /** + * @return void + */ + public function register(): void + { + $config = $this->grav['config']; + $type = $config->get('system.pages.type'); + if ($type === 'flex') { + $this->initFlexPages(); + } + } + + /** + * Reset pages (used in search indexing etc). + * + * @return void + */ + public function reset(): void + { + $this->initialized = false; + + $this->init(); + } + + /** + * Class initialization. Must be called before using this class. + */ + public function init(): void + { + if ($this->initialized) { + return; + } + + $config = $this->grav['config']; + $this->ignore_files = (array)$config->get('system.pages.ignore_files'); + $this->ignore_folders = (array)$config->get('system.pages.ignore_folders'); + $this->ignore_hidden = (bool)$config->get('system.pages.ignore_hidden'); + $this->fire_events = (bool)$config->get('system.pages.events.page'); + + $this->instances = []; + $this->index = []; + $this->children = []; + $this->routes = []; + + if (!$this->check_method) { + $this->setCheckMethod($config->get('system.cache.check.method', 'file')); + } + + if ($this->enable_pages === false) { + $page = $this->buildRootPage(); + $this->instances[$page->path()] = $page; + + return; + } + + $this->buildPages(); + + $this->initialized = true; + } + + /** + * Get or set last modification time. + * + * @param int|null $modified + * @return int|null + */ + public function lastModified($modified = null) + { + if ($modified && $modified > $this->last_modified) { + $this->last_modified = $modified; + } + + return $this->last_modified; + } + + /** + * Returns a list of all pages. + * + * @return PageInterface[] + */ + public function instances() + { + $instances = []; + foreach ($this->index as $path => $instance) { + $page = $this->get($path); + if ($page) { + $instances[$path] = $page; + } + } + + return $instances; + } + + /** + * Returns a list of all routes. + * + * @return array + */ + public function routes() + { + return $this->routes; + } + + /** + * Adds a page and assigns a route to it. + * + * @param PageInterface $page Page to be added. + * @param string|null $route Optional route (uses route from the object if not set). + */ + public function addPage(PageInterface $page, $route = null): void + { + $path = $page->path() ?? ''; + if (!isset($this->index[$path])) { + $this->index[$path] = $page; + $this->instances[$path] = $page; + } + $route = $page->route($route); + $parent = $page->parent(); + if ($parent) { + $this->children[$parent->path() ?? ''][$path] = ['slug' => $page->slug()]; + } + $this->routes[$route] = $path; + + $this->grav->fireEvent('onPageProcessed', new Event(['page' => $page])); + } + + /** + * Get a collection of pages in the given context. + * + * @param array $params + * @param array $context + * @return PageCollectionInterface|Collection + */ + public function getCollection(array $params = [], array $context = []) + { + if (!isset($params['items'])) { + return new Collection(); + } + + /** @var Config $config */ + $config = $this->grav['config']; + + $context += [ + 'event' => true, + 'pagination' => true, + 'url_taxonomy_filters' => $config->get('system.pages.url_taxonomy_filters'), + 'taxonomies' => (array)$config->get('site.taxonomies'), + 'pagination_page' => 1, + 'self' => null, + ]; + + // Include taxonomies from the URL if requested. + $process_taxonomy = $params['url_taxonomy_filters'] ?? $context['url_taxonomy_filters']; + if ($process_taxonomy) { + /** @var Uri $uri */ + $uri = $this->grav['uri']; + foreach ($context['taxonomies'] as $taxonomy) { + $param = $uri->param(rawurlencode($taxonomy)); + $items = is_string($param) ? explode(',', $param) : []; + foreach ($items as $item) { + $params['taxonomies'][$taxonomy][] = htmlspecialchars_decode(rawurldecode($item), ENT_QUOTES); + } + } + } + + $pagination = $params['pagination'] ?? $context['pagination']; + if ($pagination && !isset($params['page'], $params['start'])) { + /** @var Uri $uri */ + $uri = $this->grav['uri']; + $context['current_page'] = $uri->currentPage(); + } + + $collection = $this->evaluate($params['items'], $context['self']); + $collection->setParams($params); + + // Filter by taxonomies. + foreach ($params['taxonomies'] ?? [] as $taxonomy => $items) { + foreach ($collection as $page) { + // Don't include modules + if ($page->isModule()) { + continue; + } + + $test = $page->taxonomy()[$taxonomy] ?? []; + foreach ($items as $item) { + if (!$test || !in_array($item, $test, true)) { + $collection->remove($page->path()); + } + } + } + } + + $filters = $params['filter'] ?? []; + + // Assume published=true if not set. + if (!isset($filters['published']) && !isset($filters['non-published'])) { + $filters['published'] = true; + } + + // Remove any inclusive sets from filter. + $sets = ['published', 'visible', 'modular', 'routable']; + foreach ($sets as $type) { + $nonType = "non-{$type}"; + if (isset($filters[$type], $filters[$nonType]) && $filters[$type] === $filters[$nonType]) { + if (!$filters[$type]) { + // Both options are false, return empty collection as nothing can match the filters. + return new Collection(); + } + + // Both options are true, remove opposite filters as all pages will match the filters. + unset($filters[$type], $filters[$nonType]); + } + } + + // Filter the collection + foreach ($filters as $type => $filter) { + if (null === $filter) { + continue; + } + + // Convert non-type to type. + if (str_starts_with($type, 'non-')) { + $type = substr($type, 4); + $filter = !$filter; + } + + switch ($type) { + case 'translated': + if ($filter) { + $collection = $collection->translated(); + } else { + $collection = $collection->nonTranslated(); + } + break; + case 'published': + if ($filter) { + $collection = $collection->published(); + } else { + $collection = $collection->nonPublished(); + } + break; + case 'visible': + if ($filter) { + $collection = $collection->visible(); + } else { + $collection = $collection->nonVisible(); + } + break; + case 'page': + if ($filter) { + $collection = $collection->pages(); + } else { + $collection = $collection->modules(); + } + break; + case 'module': + case 'modular': + if ($filter) { + $collection = $collection->modules(); + } else { + $collection = $collection->pages(); + } + break; + case 'routable': + if ($filter) { + $collection = $collection->routable(); + } else { + $collection = $collection->nonRoutable(); + } + break; + case 'type': + $collection = $collection->ofType($filter); + break; + case 'types': + $collection = $collection->ofOneOfTheseTypes($filter); + break; + case 'access': + $collection = $collection->ofOneOfTheseAccessLevels($filter); + break; + } + } + + if (isset($params['dateRange'])) { + $start = $params['dateRange']['start'] ?? null; + $end = $params['dateRange']['end'] ?? null; + $field = $params['dateRange']['field'] ?? null; + $collection = $collection->dateRange($start, $end, $field); + } + + if (isset($params['order'])) { + $by = $params['order']['by'] ?? 'default'; + $dir = $params['order']['dir'] ?? 'asc'; + $custom = $params['order']['custom'] ?? null; + $sort_flags = $params['order']['sort_flags'] ?? null; + + if (is_array($sort_flags)) { + $sort_flags = array_map('constant', $sort_flags); //transform strings to constant value + $sort_flags = array_reduce($sort_flags, static function ($a, $b) { + return $a | $b; + }, 0); //merge constant values using bit or + } + + $collection = $collection->order($by, $dir, $custom, $sort_flags); + } + + // New Custom event to handle things like pagination. + if ($context['event']) { + $this->grav->fireEvent('onCollectionProcessed', new Event(['collection' => $collection, 'context' => $context])); + } + + if ($context['pagination']) { + // Slice and dice the collection if pagination is required + $params = $collection->params(); + + $limit = (int)($params['limit'] ?? 0); + $page = (int)($params['page'] ?? $context['current_page'] ?? 0); + $start = (int)($params['start'] ?? 0); + $start = $limit > 0 && $page > 0 ? ($page - 1) * $limit : max(0, $start); + + if ($start || ($limit && $collection->count() > $limit)) { + $collection->slice($start, $limit ?: null); + } + } + + return $collection; + } + + /** + * @param array|string $value + * @param PageInterface|null $self + * @return Collection + */ + protected function evaluate($value, PageInterface $self = null) + { + // Parse command. + if (is_string($value)) { + // Format: @command.param + $cmd = $value; + $params = []; + } elseif (is_array($value) && count($value) === 1 && !is_int(key($value))) { + // Format: @command.param: { attr1: value1, attr2: value2 } + $cmd = (string)key($value); + $params = (array)current($value); + } else { + $result = []; + foreach ((array)$value as $key => $val) { + if (is_int($key)) { + $result = $result + $this->evaluate($val, $self)->toArray(); + } else { + $result = $result + $this->evaluate([$key => $val], $self)->toArray(); + } + } + + return new Collection($result); + } + + $parts = explode('.', $cmd); + $scope = array_shift($parts); + $type = $parts[0] ?? null; + + /** @var PageInterface|null $page */ + $page = null; + switch ($scope) { + case 'self@': + case '@self': + $page = $self; + break; + + case 'page@': + case '@page': + $page = isset($params[0]) ? $this->find($params[0]) : null; + break; + + case 'root@': + case '@root': + $page = $this->root(); + break; + + case 'taxonomy@': + case '@taxonomy': + // Gets a collection of pages by using one of the following formats: + // @taxonomy.category: blog + // @taxonomy.category: [ blog, featured ] + // @taxonomy: { category: [ blog, featured ], level: 1 } + + /** @var Taxonomy $taxonomy_map */ + $taxonomy_map = Grav::instance()['taxonomy']; + + if (!empty($parts)) { + $params = [implode('.', $parts) => $params]; + } + + return $taxonomy_map->findTaxonomy($params); + } + + if (!$page) { + return new Collection(); + } + + // Handle '@page', '@page.modular: false', '@self' and '@self.modular: false'. + if (null === $type || (in_array($type, ['modular', 'modules']) && ($params[0] ?? null) === false)) { + $type = 'children'; + } + + switch ($type) { + case 'all': + $collection = $page->children(); + break; + case 'modules': + case 'modular': + $collection = $page->children()->modules(); + break; + case 'pages': + case 'children': + $collection = $page->children()->pages(); + break; + case 'page': + case 'self': + $collection = !$page->root() ? (new Collection())->addPage($page) : new Collection(); + break; + case 'parent': + $parent = $page->parent(); + $collection = new Collection(); + $collection = $parent ? $collection->addPage($parent) : $collection; + break; + case 'siblings': + $parent = $page->parent(); + if ($parent) { + /** @var Collection $collection */ + $collection = $parent->children(); + $collection = $collection->remove($page->path()); + } else { + $collection = new Collection(); + } + break; + case 'descendants': + $collection = $this->all($page)->remove($page->path())->pages(); + break; + default: + // Unknown type; return empty collection. + $collection = new Collection(); + break; + } + + return $collection; + } + + /** + * Sort sub-pages in a page. + * + * @param PageInterface $page + * @param string|null $order_by + * @param string|null $order_dir + * @return array + */ + public function sort(PageInterface $page, $order_by = null, $order_dir = null, $sort_flags = null) + { + if ($order_by === null) { + $order_by = $page->orderBy(); + } + if ($order_dir === null) { + $order_dir = $page->orderDir(); + } + + $path = $page->path(); + if (null === $path) { + return []; + } + + $children = $this->children[$path] ?? []; + + if (!$children) { + return $children; + } + + if (!isset($this->sort[$path][$order_by])) { + $this->buildSort($path, $children, $order_by, $page->orderManual(), $sort_flags); + } + + $sort = $this->sort[$path][$order_by]; + + if ($order_dir !== 'asc') { + $sort = array_reverse($sort); + } + + return $sort; + } + + /** + * @param Collection $collection + * @param string $orderBy + * @param string $orderDir + * @param array|null $orderManual + * @param int|null $sort_flags + * @return array + * @internal + */ + public function sortCollection(Collection $collection, $orderBy, $orderDir = 'asc', $orderManual = null, $sort_flags = null) + { + $items = $collection->toArray(); + if (!$items) { + return []; + } + + $lookup = md5(json_encode($items) . json_encode($orderManual) . $orderBy . $orderDir); + if (!isset($this->sort[$lookup][$orderBy])) { + $this->buildSort($lookup, $items, $orderBy, $orderManual, $sort_flags); + } + + $sort = $this->sort[$lookup][$orderBy]; + + if ($orderDir !== 'asc') { + $sort = array_reverse($sort); + } + + return $sort; + } + + /** + * Get a page instance. + * + * @param string $path The filesystem full path of the page + * @return PageInterface|null + * @throws RuntimeException + */ + public function get($path) + { + $path = (string)$path; + if ($path === '') { + return null; + } + + // Check for local instances first. + if (array_key_exists($path, $this->instances)) { + return $this->instances[$path]; + } + + $instance = $this->index[$path] ?? null; + if (is_string($instance)) { + if ($this->directory) { + /** @var Language $language */ + $language = $this->grav['language']; + $lang = $language->getActive(); + if ($lang) { + $languages = $language->getFallbackLanguages($lang, true); + $key = $instance; + $instance = null; + foreach ($languages as $code) { + $test = $code ? $key . ':' . $code : $key; + if (($instance = $this->directory->getObject($test, 'flex_key')) !== null) { + break; + } + } + } else { + $instance = $this->directory->getObject($instance, 'flex_key'); + } + } + + if ($instance instanceof PageInterface) { + if ($this->fire_events && method_exists($instance, 'initialize')) { + $instance->initialize(); + } + } else { + /** @var Debugger $debugger */ + $debugger = $this->grav['debugger']; + $debugger->addMessage(sprintf('Flex page %s is missing or broken!', $instance), 'debug'); + } + } + + if ($instance) { + $this->instances[$path] = $instance; + } + + return $instance; + } + + /** + * Get children of the path. + * + * @param string $path + * @return Collection + */ + public function children($path) + { + $children = $this->children[(string)$path] ?? []; + + return new Collection($children, [], $this); + } + + /** + * Get a page ancestor. + * + * @param string $route The relative URL of the page + * @param string|null $path The relative path of the ancestor folder + * @return PageInterface|null + */ + public function ancestor($route, $path = null) + { + if ($path !== null) { + $page = $this->find($route, true); + + if ($page && $page->path() === $path) { + return $page; + } + + $parent = $page ? $page->parent() : null; + if ($parent && !$parent->root()) { + return $this->ancestor($parent->route(), $path); + } + } + + return null; + } + + /** + * Get a page ancestor trait. + * + * @param string $route The relative route of the page + * @param string|null $field The field name of the ancestor to query for + * @return PageInterface|null + */ + public function inherited($route, $field = null) + { + if ($field !== null) { + $page = $this->find($route, true); + + $parent = $page ? $page->parent() : null; + if ($parent && $parent->value('header.' . $field) !== null) { + return $parent; + } + if ($parent && !$parent->root()) { + return $this->inherited($parent->route(), $field); + } + } + + return null; + } + + /** + * Find a page based on route. + * + * @param string $route The route of the page + * @param bool $all If true, return also non-routable pages, otherwise return null if page isn't routable + * @return PageInterface|null + */ + public function find($route, $all = false) + { + $route = urldecode((string)$route); + + // Fetch page if there's a defined route to it. + $path = $this->routes[$route] ?? null; + $page = null !== $path ? $this->get($path) : null; + + // Try without trailing slash + if (null === $page && Utils::endsWith($route, '/')) { + $path = $this->routes[rtrim($route, '/')] ?? null; + $page = null !== $path ? $this->get($path) : null; + } + + if (!$all && !isset($this->grav['admin'])) { + if (null === $page || !$page->routable()) { + // If the page cannot be accessed, look for the site wide routes and wildcards. + $page = $this->findSiteBasedRoute($route) ?? $page; + } + } + + return $page; + } + + /** + * Check site based routes. + * + * @param string $route + * @return PageInterface|null + */ + protected function findSiteBasedRoute($route) + { + /** @var Config $config */ + $config = $this->grav['config']; + + $site_routes = $config->get('site.routes'); + if (!is_array($site_routes)) { + return null; + } + + $page = null; + + // See if route matches one in the site configuration + $site_route = $site_routes[$route] ?? null; + if ($site_route) { + $page = $this->find($site_route); + } else { + // Use reverse order because of B/C (previously matched multiple and returned the last match). + foreach (array_reverse($site_routes, true) as $pattern => $replace) { + $pattern = '#^' . str_replace('/', '\/', ltrim($pattern, '^')) . '#'; + try { + $found = preg_replace($pattern, $replace, $route); + if ($found && $found !== $route) { + $page = $this->find($found); + if ($page) { + return $page; + } + } + } catch (ErrorException $e) { + $this->grav['log']->error('site.routes: ' . $pattern . '-> ' . $e->getMessage()); + } + } + } + + return $page; + } + + /** + * Dispatch URI to a page. + * + * @param string $route The relative URL of the page + * @param bool $all If true, return also non-routable pages, otherwise return null if page isn't routable + * @param bool $redirect If true, allow redirects + * @return PageInterface|null + * @throws Exception + */ + public function dispatch($route, $all = false, $redirect = true) + { + $page = $this->find($route, true); + + // If we want all pages or are in admin, return what we already have. + if ($all || isset($this->grav['admin'])) { + return $page; + } + + if ($page) { + $routable = $page->routable(); + if ($redirect) { + if ($page->redirect()) { + // Follow a redirect page. + $this->grav->redirectLangSafe($page->redirect()); + } + + if (!$routable) { + /** @var Collection $children */ + $children = $page->children()->visible()->routable()->published(); + $child = $children->first(); + if ($child !== null) { + // Redirect to the first visible child as current page isn't routable. + $this->grav->redirectLangSafe($child->route()); + } + } + } + + if ($routable) { + return $page; + } + } + + $route = urldecode((string)$route); + + // The page cannot be reached, look into site wide redirects, routes and wildcards. + $redirectedPage = $this->findSiteBasedRoute($route); + if ($redirectedPage) { + $page = $this->dispatch($redirectedPage->route(), false, $redirect); + } + + /** @var Config $config */ + $config = $this->grav['config']; + + /** @var Uri $uri */ + $uri = $this->grav['uri']; + /** @var \Grav\Framework\Uri\Uri $source_url */ + $source_url = $uri->uri(false); + + // Try Regex style redirects + $site_redirects = $config->get('site.redirects'); + if (is_array($site_redirects)) { + foreach ((array)$site_redirects as $pattern => $replace) { + $pattern = ltrim($pattern, '^'); + $pattern = '#^' . str_replace('/', '\/', $pattern) . '#'; + try { + /** @var string $found */ + $found = preg_replace($pattern, $replace, $source_url); + if ($found && $found !== $source_url) { + $this->grav->redirectLangSafe($found); + } + } catch (ErrorException $e) { + $this->grav['log']->error('site.redirects: ' . $pattern . '-> ' . $e->getMessage()); + } + } + } + + return $page; + } + + /** + * Get root page. + * + * @return PageInterface + * @throws RuntimeException + */ + public function root() + { + /** @var UniformResourceLocator $locator */ + $locator = $this->grav['locator']; + + $path = $locator->findResource('page://'); + $root = is_string($path) ? $this->get(rtrim($path, '/')) : null; + if (null === $root) { + throw new RuntimeException('Internal error'); + } + + return $root; + } + + /** + * Get a blueprint for a page type. + * + * @param string $type + * @return Blueprint + */ + public function blueprints($type) + { + if ($this->blueprints === null) { + $this->blueprints = new Blueprints(self::getTypes()); + } + + try { + $blueprint = $this->blueprints->get($type); + } catch (RuntimeException $e) { + $blueprint = $this->blueprints->get('default'); + } + + if (empty($blueprint->initialized)) { + $blueprint->initialized = true; + $this->grav->fireEvent('onBlueprintCreated', new Event(['blueprint' => $blueprint, 'type' => $type])); + } + + return $blueprint; + } + + /** + * Get all pages + * + * @param PageInterface|null $current + * @return Collection + */ + public function all(PageInterface $current = null) + { + $all = new Collection(); + + /** @var PageInterface $current */ + $current = $current ?: $this->root(); + + if (!$current->root()) { + $all[$current->path()] = ['slug' => $current->slug()]; + } + + foreach ($current->children() as $next) { + $all->append($this->all($next)); + } + + return $all; + } + + /** + * Get available parents raw routes. + * + * @return array + */ + public static function parentsRawRoutes() + { + $rawRoutes = true; + + return self::getParents($rawRoutes); + } + + /** + * Get available parents routes + * + * @param bool $rawRoutes get the raw route or the normal route + * @return array + */ + private static function getParents($rawRoutes) + { + $grav = Grav::instance(); + + /** @var Pages $pages */ + $pages = $grav['pages']; + + $parents = $pages->getList(null, 0, $rawRoutes); + + if (isset($grav['admin'])) { + // Remove current route from parents + + /** @var Admin $admin */ + $admin = $grav['admin']; + + $page = $admin->getPage($admin->route); + $page_route = $page->route(); + if (isset($parents[$page_route])) { + unset($parents[$page_route]); + } + } + + return $parents; + } + + /** + * Get list of route/title of all pages. Title is in HTML. + * + * @param PageInterface|null $current + * @param int $level + * @param bool $rawRoutes + * @param bool $showAll + * @param bool $showFullpath + * @param bool $showSlug + * @param bool $showModular + * @param bool $limitLevels + * @return array + */ + public function getList(PageInterface $current = null, $level = 0, $rawRoutes = false, $showAll = true, $showFullpath = false, $showSlug = false, $showModular = false, $limitLevels = false) + { + if (!$current) { + if ($level) { + throw new RuntimeException('Internal error'); + } + + $current = $this->root(); + } + + $list = []; + + if (!$current->root()) { + if ($rawRoutes) { + $route = $current->rawRoute(); + } else { + $route = $current->route(); + } + + if ($showFullpath) { + $option = htmlspecialchars($current->route()); + } else { + $extra = $showSlug ? '(' . $current->slug() . ') ' : ''; + $option = str_repeat('—-', $level). '▸ ' . $extra . htmlspecialchars($current->title()); + } + + $list[$route] = $option; + } + + if ($limitLevels === false || ($level+1 < $limitLevels)) { + foreach ($current->children() as $next) { + if ($showAll || $next->routable() || ($next->isModule() && $showModular)) { + $list = array_merge($list, $this->getList($next, $level + 1, $rawRoutes, $showAll, $showFullpath, $showSlug, $showModular, $limitLevels)); + } + } + } + + return $list; + } + + /** + * Get available page types. + * + * @return Types + */ + public static function getTypes() + { + if (null === self::$types) { + $grav = Grav::instance(); + + /** @var UniformResourceLocator $locator */ + $locator = $grav['locator']; + + // Prevent calls made before theme:// has been initialized (happens when upgrading old version of Admin plugin). + if (!$locator->isStream('theme://')) { + return new Types(); + } + + $scanBlueprintsAndTemplates = static function (Types $types) use ($grav) { + // Scan blueprints + $event = new TypesEvent(); + $event->types = $types; + $grav->fireEvent('onGetPageBlueprints', $event); + + $types->init(); + + // Try new location first. + $lookup = 'theme://blueprints/pages/'; + if (!is_dir($lookup)) { + $lookup = 'theme://blueprints/'; + } + $types->scanBlueprints($lookup); + + // Scan templates + $event = new TypesEvent(); + $event->types = $types; + $grav->fireEvent('onGetPageTemplates', $event); + + $types->scanTemplates('theme://templates/'); + }; + + if ($grav['config']->get('system.cache.enabled')) { + /** @var Cache $cache */ + $cache = $grav['cache']; + + // Use cached types if possible. + $types_cache_id = md5('types'); + $types = $cache->fetch($types_cache_id); + + if (!$types instanceof Types) { + $types = new Types(); + $scanBlueprintsAndTemplates($types); + $cache->save($types_cache_id, $types); + } + } else { + $types = new Types(); + $scanBlueprintsAndTemplates($types); + } + + // Register custom paths to the locator. + $locator = $grav['locator']; + foreach ($types as $type => $paths) { + foreach ($paths as $k => $path) { + if (strpos($path, 'blueprints://') === 0) { + unset($paths[$k]); + } + } + if ($paths) { + $locator->addPath('blueprints', "pages/$type.yaml", $paths); + } + } + + self::$types = $types; + } + + return self::$types; + } + + /** + * Get available page types. + * + * @return array + */ + public static function types() + { + $types = self::getTypes(); + + return $types->pageSelect(); + } + + /** + * Get available page types. + * + * @return array + */ + public static function modularTypes() + { + $types = self::getTypes(); + + return $types->modularSelect(); + } + + /** + * Get template types based on page type (standard or modular) + * + * @param string|null $type + * @return array + */ + public static function pageTypes($type = null) + { + if (null === $type && isset(Grav::instance()['admin'])) { + /** @var Admin $admin */ + $admin = Grav::instance()['admin']; + + /** @var PageInterface|null $page */ + $page = $admin->page(); + + $type = $page && $page->isModule() ? 'modular' : 'standard'; + } + + switch ($type) { + case 'standard': + return static::types(); + case 'modular': + return static::modularTypes(); + } + + return []; + } + + /** + * Get access levels of the site pages + * + * @return array + */ + public function accessLevels() + { + $accessLevels = []; + foreach ($this->all() as $page) { + if ($page instanceof PageInterface && isset($page->header()->access)) { + if (is_array($page->header()->access)) { + foreach ($page->header()->access as $index => $accessLevel) { + if (is_array($accessLevel)) { + foreach ($accessLevel as $innerIndex => $innerAccessLevel) { + $accessLevels[] = $innerIndex; + } + } else { + $accessLevels[] = $index; + } + } + } else { + $accessLevels[] = $page->header()->access; + } + } + } + + return array_unique($accessLevels); + } + + /** + * Get available parents routes + * + * @return array + */ + public static function parents() + { + $rawRoutes = false; + + return self::getParents($rawRoutes); + } + + /** + * Gets the home route + * + * @return string + */ + public static function getHomeRoute() + { + if (empty(self::$home_route)) { + $grav = Grav::instance(); + + /** @var Config $config */ + $config = $grav['config']; + + /** @var Language $language */ + $language = $grav['language']; + + $home = $config->get('system.home.alias'); + + if ($language->enabled()) { + $home_aliases = $config->get('system.home.aliases'); + if ($home_aliases) { + $active = $language->getActive(); + $default = $language->getDefault(); + + try { + if ($active) { + $home = $home_aliases[$active]; + } else { + $home = $home_aliases[$default]; + } + } catch (ErrorException $e) { + $home = $home_aliases[$default]; + } + } + } + + self::$home_route = trim($home, '/'); + } + + return self::$home_route; + } + + /** + * Needed for testing where we change the home route via config + * + * @return string|null + */ + public static function resetHomeRoute() + { + self::$home_route = null; + + return self::getHomeRoute(); + } + + protected function initFlexPages(): void + { + /** @var Debugger $debugger */ + $debugger = $this->grav['debugger']; + $debugger->addMessage('Pages: Flex Directory'); + + /** @var Flex $flex */ + $flex = $this->grav['flex']; + $directory = $flex->getDirectory('pages'); + + /** @var EventDispatcher $dispatcher */ + $dispatcher = $this->grav['events']; + + // Stop /admin/pages from working, display error instead. + $dispatcher->addListener( + 'onAdminPage', + static function (Event $event) use ($directory) { + $grav = Grav::instance(); + $admin = $grav['admin']; + [$base,$location,] = $admin->getRouteDetails(); + if ($location !== 'pages' || isset($grav['flex_objects'])) { + return; + } + + /** @var PageInterface $page */ + $page = $event['page']; + $page->init(new SplFileInfo('plugin://admin/pages/admin/error.md')); + $page->routable(true); + $header = $page->header(); + $header->title = 'Please install missing plugin'; + $page->content("## Please install and enable **[Flex Objects]({$base}/plugins/flex-objects)** plugin. It is required to edit **Flex Pages**."); + + /** @var Header $header */ + $header = $page->header(); + $menu = $directory->getConfig('admin.menu.list'); + $header->access = $menu['authorize'] ?? ['admin.super']; + }, + 100000 + ); + + $this->directory = $directory; + } + + /** + * Builds pages. + * + * @internal + */ + protected function buildPages(): void + { + /** @var Debugger $debugger */ + $debugger = $this->grav['debugger']; + $debugger->startTimer('build-pages', 'Init frontend routes'); + + if ($this->directory) { + $this->buildFlexPages($this->directory); + } else { + $this->buildRegularPages(); + } + $debugger->stopTimer('build-pages'); + } + + protected function buildFlexPages(FlexDirectory $directory): void + { + /** @var Config $config */ + $config = $this->grav['config']; + + // TODO: right now we are just emulating normal pages, it is inefficient and bad... but works! + /** @var PageCollection|PageIndex $collection */ + $collection = $directory->getIndex(null, 'storage_key'); + $cache = $directory->getCache('index'); + + /** @var Language $language */ + $language = $this->grav['language']; + + $this->pages_cache_id = 'pages-' . md5($collection->getCacheChecksum() . $language->getActive() . $config->checksum()); + + $cached = $cache->get($this->pages_cache_id); + + if ($cached && $this->getVersion() === $cached[0]) { + [, $this->index, $this->routes, $this->children, $taxonomy_map, $this->sort] = $cached; + + /** @var Taxonomy $taxonomy */ + $taxonomy = $this->grav['taxonomy']; + $taxonomy->taxonomy($taxonomy_map); + + return; + } + + /** @var Debugger $debugger */ + $debugger = $this->grav['debugger']; + $debugger->addMessage('Page cache missed, rebuilding Flex Pages..'); + + $root = $collection->getRoot(); + $root_path = $root->path(); + $this->routes = []; + $this->instances = [$root_path => $root]; + $this->index = [$root_path => $root]; + $this->children = []; + $this->sort = []; + + if ($this->fire_events) { + $this->grav->fireEvent('onBuildPagesInitialized'); + } + + /** @var PageInterface $page */ + foreach ($collection as $page) { + $path = $page->path(); + if (null === $path) { + throw new RuntimeException('Internal error'); + } + + if ($page instanceof FlexTranslateInterface) { + $page = $page->hasTranslation() ? $page->getTranslation() : null; + } + + if (!$page instanceof FlexPageObject || $path === $root_path) { + continue; + } + + if ($this->fire_events) { + if (method_exists($page, 'initialize')) { + $page->initialize(); + } else { + // TODO: Deprecated, only used in 1.7 betas. + $this->grav->fireEvent('onPageProcessed', new Event(['page' => $page])); + } + } + + $parent = dirname($path); + + $route = $page->rawRoute(); + + // Skip duplicated empty folders (git revert does not remove those). + // TODO: still not perfect, will only work if the page has been translated. + if (isset($this->routes[$route])) { + $oldPath = $this->routes[$route]; + if ($page->isPage()) { + unset($this->index[$oldPath], $this->children[dirname($oldPath)][$oldPath]); + } else { + continue; + } + } + + $this->routes[$route] = $path; + $this->instances[$path] = $page; + $this->index[$path] = $page->getFlexKey(); + // FIXME: ... better... + $this->children[$parent][$path] = ['slug' => $page->slug()]; + if (!isset($this->children[$path])) { + $this->children[$path] = []; + } + } + + foreach ($this->children as $path => $list) { + $page = $this->instances[$path] ?? null; + if (null === $page) { + continue; + } + // Call onFolderProcessed event. + if ($this->fire_events) { + $this->grav->fireEvent('onFolderProcessed', new Event(['page' => $page])); + } + // Sort the children. + $this->children[$path] = $this->sort($page); + } + + $this->routes = []; + $this->buildRoutes(); + + // cache if needed + if (null !== $cache) { + /** @var Taxonomy $taxonomy */ + $taxonomy = $this->grav['taxonomy']; + $taxonomy_map = $taxonomy->taxonomy(); + + // save pages, routes, taxonomy, and sort to cache + $cache->set($this->pages_cache_id, [$this->getVersion(), $this->index, $this->routes, $this->children, $taxonomy_map, $this->sort]); + } + } + + /** + * @return Page + */ + protected function buildRootPage() + { + $grav = Grav::instance(); + + /** @var UniformResourceLocator $locator */ + $locator = $grav['locator']; + $path = $locator->findResource('page://'); + if (!is_string($path)) { + throw new RuntimeException('Internal Error'); + } + + /** @var Config $config */ + $config = $grav['config']; + + $page = new Page(); + $page->path($path); + $page->orderDir($config->get('system.pages.order.dir')); + $page->orderBy($config->get('system.pages.order.by')); + $page->modified(0); + $page->routable(false); + $page->template('default'); + $page->extension('.md'); + + return $page; + } + + protected function buildRegularPages(): void + { + /** @var Config $config */ + $config = $this->grav['config']; + + /** @var UniformResourceLocator $locator */ + $locator = $this->grav['locator']; + + /** @var Language $language */ + $language = $this->grav['language']; + + $pages_dirs = $this->getPagesPaths(); + + // Set active language + $this->active_lang = $language->getActive(); + + if ($config->get('system.cache.enabled')) { + /** @var Language $language */ + $language = $this->grav['language']; + + // how should we check for last modified? Default is by file + switch ($this->check_method) { + case 'none': + case 'off': + $hash = 0; + break; + case 'folder': + $hash = Folder::lastModifiedFolder($pages_dirs); + break; + case 'hash': + $hash = Folder::hashAllFiles($pages_dirs); + break; + default: + $hash = Folder::lastModifiedFile($pages_dirs); + } + + $this->simple_pages_hash = json_encode($pages_dirs) . $hash . $config->checksum(); + $this->pages_cache_id = md5($this->simple_pages_hash . $language->getActive()); + + /** @var Cache $cache */ + $cache = $this->grav['cache']; + $cached = $cache->fetch($this->pages_cache_id); + if ($cached && $this->getVersion() === $cached[0]) { + [, $this->index, $this->routes, $this->children, $taxonomy_map, $this->sort] = $cached; + + /** @var Taxonomy $taxonomy */ + $taxonomy = $this->grav['taxonomy']; + $taxonomy->taxonomy($taxonomy_map); + + return; + } + + $this->grav['debugger']->addMessage('Page cache missed, rebuilding pages..'); + } else { + $this->grav['debugger']->addMessage('Page cache disabled, rebuilding pages..'); + } + + $this->resetPages($pages_dirs); + } + + protected function getPagesPaths(): array + { + $grav = Grav::instance(); + $locator = $grav['locator']; + $paths = []; + + $dirs = (array) $grav['config']->get('system.pages.dirs', ['page://']); + foreach ($dirs as $dir) { + $path = $locator->findResource($dir); + if (file_exists($path) && !in_array($path, $paths, true)) { + $paths[] = $path; + } + } + + return $paths; + } + + /** + * Accessible method to manually reset the pages cache + * + * @param array $pages_dirs + */ + public function resetPages(array $pages_dirs): void + { + $this->sort = []; + + foreach ($pages_dirs as $dir) { + $this->recurse($dir); + } + + $this->buildRoutes(); + + // cache if needed + if ($this->grav['config']->get('system.cache.enabled')) { + /** @var Cache $cache */ + $cache = $this->grav['cache']; + /** @var Taxonomy $taxonomy */ + $taxonomy = $this->grav['taxonomy']; + + // save pages, routes, taxonomy, and sort to cache + $cache->save($this->pages_cache_id, [$this->getVersion(), $this->index, $this->routes, $this->children, $taxonomy->taxonomy(), $this->sort]); + } + } + + /** + * Recursive function to load & build page relationships. + * + * @param string $directory + * @param PageInterface|null $parent + * @return PageInterface + * @throws RuntimeException + * @internal + */ + protected function recurse(string $directory, PageInterface $parent = null) + { + $directory = rtrim($directory, DS); + $page = new Page; + + /** @var Config $config */ + $config = $this->grav['config']; + + /** @var Language $language */ + $language = $this->grav['language']; + + // Stuff to do at root page + // Fire event for memory and time consuming plugins... + if ($parent === null && $this->fire_events) { + $this->grav->fireEvent('onBuildPagesInitialized'); + } + + $page->path($directory); + if ($parent) { + $page->parent($parent); + } + + $page->orderDir($config->get('system.pages.order.dir')); + $page->orderBy($config->get('system.pages.order.by')); + + // Add into instances + if (!isset($this->index[$page->path()])) { + $this->index[$page->path()] = $page; + $this->instances[$page->path()] = $page; + if ($parent && $page->path()) { + $this->children[$parent->path()][$page->path()] = ['slug' => $page->slug()]; + } + } elseif ($parent !== null) { + throw new RuntimeException('Fatal error when creating page instances.'); + } + + // Build regular expression for all the allowed page extensions. + $page_extensions = $language->getFallbackPageExtensions(); + $regex = '/^[^\.]*(' . implode('|', array_map( + static function ($str) { + return preg_quote($str, '/'); + }, + $page_extensions + )) . ')$/'; + + $folders = []; + $page_found = null; + $page_extension = '.md'; + $last_modified = 0; + + $iterator = new FilesystemIterator($directory); + foreach ($iterator as $file) { + $filename = $file->getFilename(); + + // Ignore all hidden files if set. + if ($this->ignore_hidden && $filename && strpos($filename, '.') === 0) { + continue; + } + + // Handle folders later. + if ($file->isDir()) { + // But ignore all folders in ignore list. + if (!in_array($filename, $this->ignore_folders, true)) { + $folders[] = $file; + } + continue; + } + + // Ignore all files in ignore list. + if (in_array($filename, $this->ignore_files, true)) { + continue; + } + + // Update last modified date to match the last updated file in the folder. + $modified = $file->getMTime(); + if ($modified > $last_modified) { + $last_modified = $modified; + } + + // Page is the one that matches to $page_extensions list with the lowest index number. + if (preg_match($regex, $filename, $matches, PREG_OFFSET_CAPTURE)) { + $ext = $matches[1][0]; + + if ($page_found === null || array_search($ext, $page_extensions, true) < array_search($page_extension, $page_extensions, true)) { + $page_found = $file; + $page_extension = $ext; + } + } + } + + $content_exists = false; + if ($parent && $page_found) { + $page->init($page_found, $page_extension); + + $content_exists = true; + + if ($this->fire_events) { + $this->grav->fireEvent('onPageProcessed', new Event(['page' => $page])); + } + } + + // Now handle all the folders under the page. + /** @var FilesystemIterator $file */ + foreach ($folders as $file) { + $filename = $file->getFilename(); + + // if folder contains separator, continue + if (Utils::contains($file->getFilename(), $config->get('system.param_sep', ':'))) { + continue; + } + + if (!$page->path()) { + $page->path($file->getPath()); + } + + $path = $directory . DS . $filename; + $child = $this->recurse($path, $page); + + if (preg_match('/^(\d+\.)_/', $filename)) { + $child->routable(false); + $child->modularTwig(true); + } + + $this->children[$page->path()][$child->path()] = ['slug' => $child->slug()]; + + if ($this->fire_events) { + $this->grav->fireEvent('onFolderProcessed', new Event(['page' => $page])); + } + } + + if (!$content_exists) { + // Set routable to false if no page found + $page->routable(false); + + // Hide empty folders if option set + if ($config->get('system.pages.hide_empty_folders')) { + $page->visible(false); + } + } + + // Override the modified time if modular + if ($page->template() === 'modular') { + foreach ($page->collection() as $child) { + $modified = $child->modified(); + + if ($modified > $last_modified) { + $last_modified = $modified; + } + } + } + + // Override the modified and ID so that it takes the latest change into account + $page->modified($last_modified); + $page->id($last_modified . md5($page->filePath() ?? '')); + + // Sort based on Defaults or Page Overridden sort order + $this->children[$page->path()] = $this->sort($page); + + return $page; + } + + /** + * @internal + */ + protected function buildRoutes(): void + { + /** @var Taxonomy $taxonomy */ + $taxonomy = $this->grav['taxonomy']; + + // Get the home route + $home = self::resetHomeRoute(); + // Build routes and taxonomy map. + /** @var PageInterface|string $page */ + foreach ($this->index as $path => $page) { + if (is_string($page)) { + $page = $this->get($path); + } + + if (!$page || $page->root()) { + continue; + } + + // process taxonomy + $taxonomy->addTaxonomy($page); + + $page_path = $page->path(); + if (null === $page_path) { + throw new RuntimeException('Internal Error'); + } + + $route = $page->route(); + $raw_route = $page->rawRoute(); + + // add regular route + if ($route) { + if (isset($this->routes[$route]) && $this->routes[$route] !== $page_path) { + $this->grav['debugger']->addMessage("Route '{$route}' already exists: {$this->routes[$route]}, overwriting with {$page_path}"); + } + $this->routes[$route] = $page_path; + } + + // add raw route + if ($raw_route) { + if (isset($this->routes[$raw_route]) && $this->routes[$route] !== $page_path) { + $this->grav['debugger']->addMessage("Raw Route '{$raw_route}' already exists: {$this->routes[$raw_route]}, overwriting with {$page_path}"); + } + $this->routes[$raw_route] = $page_path; + } + + // add canonical route + $route_canonical = $page->routeCanonical(); + if ($route_canonical) { + if (isset($this->routes[$route_canonical]) && $this->routes[$route_canonical] !== $page_path) { + $this->grav['debugger']->addMessage("Canonical Route '{$route_canonical}' already exists: {$this->routes[$route_canonical]}, overwriting with {$page_path}"); + } + $this->routes[$route_canonical] = $page_path; + } + + // add aliases to routes list if they are provided + $route_aliases = $page->routeAliases(); + if ($route_aliases) { + foreach ($route_aliases as $alias) { + if (isset($this->routes[$alias]) && $this->routes[$alias] !== $page_path) { + $this->grav['debugger']->addMessage("Alias Route '{$alias}' already exists: {$this->routes[$alias]}, overwriting with {$page_path}"); + } + $this->routes[$alias] = $page_path; + } + } + } + + // Alias and set default route to home page. + $homeRoute = "/{$home}"; + if ($home && isset($this->routes[$homeRoute])) { + $home = $this->get($this->routes[$homeRoute]); + if ($home) { + $this->routes['/'] = $this->routes[$homeRoute]; + $home->route('/'); + } + } + } + + /** + * @param string $path + * @param array $pages + * @param string $order_by + * @param array|null $manual + * @param int|null $sort_flags + * @throws RuntimeException + * @internal + */ + protected function buildSort($path, array $pages, $order_by = 'default', $manual = null, $sort_flags = null): void + { + $list = []; + $header_query = null; + $header_default = null; + + // do this header query work only once + if (strpos($order_by, 'header.') === 0) { + $query = explode('|', str_replace('header.', '', $order_by), 2); + $header_query = array_shift($query) ?? ''; + $header_default = array_shift($query); + } + + foreach ($pages as $key => $info) { + $child = $this->get($key); + if (!$child) { + throw new RuntimeException("Page does not exist: {$key}"); + } + + switch ($order_by) { + case 'title': + $list[$key] = $child->title(); + break; + case 'date': + $list[$key] = $child->date(); + $sort_flags = SORT_REGULAR; + break; + case 'modified': + $list[$key] = $child->modified(); + $sort_flags = SORT_REGULAR; + break; + case 'publish_date': + $list[$key] = $child->publishDate(); + $sort_flags = SORT_REGULAR; + break; + case 'unpublish_date': + $list[$key] = $child->unpublishDate(); + $sort_flags = SORT_REGULAR; + break; + case 'slug': + $list[$key] = $child->slug(); + break; + case 'basename': + $list[$key] = Utils::basename($key); + break; + case 'folder': + $list[$key] = $child->folder(); + break; + case 'manual': + case 'default': + default: + if (is_string($header_query)) { + $child_header = $child->header(); + if (!$child_header instanceof Header) { + $child_header = new Header((array)$child_header); + } + $header_value = $child_header->get($header_query); + if (is_array($header_value)) { + $list[$key] = implode(',', $header_value); + } elseif ($header_value) { + $list[$key] = $header_value; + } else { + $list[$key] = $header_default ?: $key; + } + $sort_flags = $sort_flags ?: SORT_REGULAR; + break; + } + $list[$key] = $key; + $sort_flags = $sort_flags ?: SORT_REGULAR; + } + } + + if (!$sort_flags) { + $sort_flags = SORT_NATURAL | SORT_FLAG_CASE; + } + + // handle special case when order_by is random + if ($order_by === 'random') { + $list = $this->arrayShuffle($list); + } else { + // else just sort the list according to specified key + if (extension_loaded('intl') && $this->grav['config']->get('system.intl_enabled')) { + $locale = setlocale(LC_COLLATE, '0'); //`setlocale` with a '0' param returns the current locale set + $col = Collator::create($locale); + if ($col) { + $col->setAttribute(Collator::NUMERIC_COLLATION, Collator::ON); + if (($sort_flags & SORT_NATURAL) === SORT_NATURAL) { + $list = preg_replace_callback('~([0-9]+)\.~', static function ($number) { + return sprintf('%032d.', $number[0]); + }, $list); + if (!is_array($list)) { + throw new RuntimeException('Internal Error'); + } + + $list_vals = array_values($list); + if (is_numeric(array_shift($list_vals))) { + $sort_flags = Collator::SORT_REGULAR; + } else { + $sort_flags = Collator::SORT_STRING; + } + } + + $col->asort($list, $sort_flags); + } else { + asort($list, $sort_flags); + } + } else { + asort($list, $sort_flags); + } + } + + + // Move manually ordered items into the beginning of the list. Order of the unlisted items does not change. + if (is_array($manual) && !empty($manual)) { + $new_list = []; + $i = count($manual); + + foreach ($list as $key => $dummy) { + $info = $pages[$key]; + $order = array_search($info['slug'], $manual, true); + if ($order === false) { + $order = $i++; + } + $new_list[$key] = (int)$order; + } + + $list = $new_list; + + // Apply manual ordering to the list. + asort($list, SORT_NUMERIC); + } + + foreach ($list as $key => $sort) { + $info = $pages[$key]; + $this->sort[$path][$order_by][$key] = $info; + } + } + + /** + * Shuffles an associative array + * + * @param array $list + * @return array + */ + protected function arrayShuffle(array $list): array + { + $keys = array_keys($list); + shuffle($keys); + + $new = []; + foreach ($keys as $key) { + $new[$key] = $list[$key]; + } + + return $new; + } + + /** + * @return string + */ + protected function getVersion(): string + { + return $this->directory ? 'flex' : 'regular'; + } + + /** + * Get the Pages cache ID + * + * this is particularly useful to know if pages have changed and you want + * to sync another cache with pages cache - works best in `onPagesInitialized()` + * + * @return null|string + */ + public function getPagesCacheId(): ?string + { + return $this->pages_cache_id; + } + + /** + * Get the simple pages hash that is not md5 encoded, and isn't specific to language + * + * @return null|string + */ + public function getSimplePagesHash(): ?string + { + return $this->simple_pages_hash; + } +} diff --git a/system/src/Grav/Common/Page/Traits/PageFormTrait.php b/system/src/Grav/Common/Page/Traits/PageFormTrait.php new file mode 100644 index 0000000..b99e7b7 --- /dev/null +++ b/system/src/Grav/Common/Page/Traits/PageFormTrait.php @@ -0,0 +1,126 @@ + blueprint, ...], where blueprint follows the regular form blueprint format. + * + * @return array + */ + public function getForms(): array + { + if (null === $this->_forms) { + $header = $this->header(); + + // Call event to allow filling the page header form dynamically (e.g. use case: Comments plugin) + $grav = Grav::instance(); + $grav->fireEvent('onFormPageHeaderProcessed', new Event(['page' => $this, 'header' => $header])); + + $rules = $header->rules ?? null; + if (!is_array($rules)) { + $rules = []; + } + + $forms = []; + + // First grab page.header.form + $form = $this->normalizeForm($header->form ?? null, null, $rules); + if ($form) { + $forms[$form['name']] = $form; + } + + // Append page.header.forms (override singular form if it clashes) + $headerForms = $header->forms ?? null; + if (is_array($headerForms)) { + foreach ($headerForms as $name => $form) { + $form = $this->normalizeForm($form, $name, $rules); + if ($form) { + $forms[$form['name']] = $form; + } + } + } + + $this->_forms = $forms; + } + + return $this->_forms; + } + + /** + * Add forms to this page. + * + * @param array $new + * @param bool $override + * @return $this + */ + public function addForms(array $new, $override = true) + { + // Initialize forms. + $this->forms(); + + foreach ($new as $name => $form) { + $form = $this->normalizeForm($form, $name); + $name = $form['name'] ?? null; + if ($name && ($override || !isset($this->_forms[$name]))) { + $this->_forms[$name] = $form; + } + } + + return $this; + } + + /** + * Alias of $this->getForms(); + * + * @return array + */ + public function forms(): array + { + return $this->getForms(); + } + + /** + * @param array|null $form + * @param string|null $name + * @param array $rules + * @return array|null + */ + protected function normalizeForm($form, $name = null, array $rules = []): ?array + { + if (!is_array($form)) { + return null; + } + + // Ignore numeric indexes on name. + if (!$name || (string)(int)$name === (string)$name) { + $name = null; + } + + $name = $name ?? $form['name'] ?? $this->slug(); + + $formRules = $form['rules'] ?? null; + if (!is_array($formRules)) { + $formRules = []; + } + + return ['name' => $name, 'rules' => $rules + $formRules] + $form; + } + + abstract public function header($var = null); + abstract public function slug($var = null); +} diff --git a/system/src/Grav/Common/Page/Types.php b/system/src/Grav/Common/Page/Types.php new file mode 100644 index 0000000..d9bdc33 --- /dev/null +++ b/system/src/Grav/Common/Page/Types.php @@ -0,0 +1,179 @@ +items[$type])) { + $this->items[$type] = []; + } elseif (null === $blueprint) { + return; + } + + if (null === $blueprint) { + $blueprint = $this->systemBlueprints[$type] ?? $this->systemBlueprints['default'] ?? null; + } + + if ($blueprint) { + array_unshift($this->items[$type], $blueprint); + } + } + + /** + * @return void + */ + public function init() + { + if (empty($this->systemBlueprints)) { + // Register all blueprints from the blueprints stream. + $this->systemBlueprints = $this->findBlueprints('blueprints://pages'); + foreach ($this->systemBlueprints as $type => $blueprint) { + $this->register($type); + } + } + } + + /** + * @param string $uri + * @return void + */ + public function scanBlueprints($uri) + { + if (!is_string($uri)) { + throw new InvalidArgumentException('First parameter must be URI'); + } + + foreach ($this->findBlueprints($uri) as $type => $blueprint) { + $this->register($type, $blueprint); + } + } + + /** + * @param string $uri + * @return void + */ + public function scanTemplates($uri) + { + if (!is_string($uri)) { + throw new InvalidArgumentException('First parameter must be URI'); + } + + $options = [ + 'compare' => 'Filename', + 'pattern' => '|\.html\.twig$|', + 'filters' => [ + 'value' => '|\.html\.twig$|' + ], + 'value' => 'Filename', + 'recursive' => false + ]; + + foreach (Folder::all($uri, $options) as $type) { + $this->register($type); + } + + $modular_uri = rtrim($uri, '/') . '/modular'; + if (is_dir($modular_uri)) { + foreach (Folder::all($modular_uri, $options) as $type) { + $this->register('modular/' . $type); + } + } + } + + /** + * @return array + */ + public function pageSelect() + { + $list = []; + foreach ($this->items as $name => $file) { + if (strpos($name, '/')) { + continue; + } + $list[$name] = ucfirst(str_replace('_', ' ', $name)); + } + ksort($list); + + return $list; + } + + /** + * @return array + */ + public function modularSelect() + { + $list = []; + foreach ($this->items as $name => $file) { + if (strpos($name, 'modular/') !== 0) { + continue; + } + $list[$name] = ucfirst(trim(str_replace('_', ' ', Utils::basename($name)))); + } + ksort($list); + + return $list; + } + + /** + * @param string $uri + * @return array + */ + private function findBlueprints($uri) + { + $options = [ + 'compare' => 'Filename', + 'pattern' => '|\.yaml$|', + 'filters' => [ + 'key' => '|\.yaml$|' + ], + 'key' => 'SubPathName', + 'value' => 'PathName', + ]; + + /** @var UniformResourceLocator $locator */ + $locator = Grav::instance()['locator']; + if ($locator->isStream($uri)) { + $options['value'] = 'Url'; + } + + return Folder::all($uri, $options); + } +} diff --git a/system/src/Grav/Common/Plugin.php b/system/src/Grav/Common/Plugin.php new file mode 100644 index 0000000..7b74c8f --- /dev/null +++ b/system/src/Grav/Common/Plugin.php @@ -0,0 +1,472 @@ +name = $name; + $this->grav = $grav; + + if ($config) { + $this->setConfig($config); + } + } + + /** + * @return ClassLoader|null + * @internal + */ + final public function getAutoloader(): ?ClassLoader + { + return $this->loader; + } + + /** + * @param ClassLoader|null $loader + * @internal + */ + final public function setAutoloader(?ClassLoader $loader): void + { + $this->loader = $loader; + } + + /** + * @param Config $config + * @return $this + */ + public function setConfig(Config $config) + { + $this->config = $config; + + return $this; + } + + /** + * Get configuration of the plugin. + * + * @return array + */ + public function config() + { + return $this->config["plugins.{$this->name}"] ?? []; + } + + /** + * Determine if plugin is running under the admin + * + * @return bool + */ + public function isAdmin() + { + return Utils::isAdminPlugin(); + } + + /** + * Determine if plugin is running under the CLI + * + * @return bool + */ + public function isCli() + { + return defined('GRAV_CLI'); + } + + /** + * Determine if this route is in Admin and active for the plugin + * + * @param string $plugin_route + * @return bool + */ + protected function isPluginActiveAdmin($plugin_route) + { + $active = false; + + /** @var Uri $uri */ + $uri = $this->grav['uri']; + /** @var Config $config */ + $config = $this->config ?? $this->grav['config']; + + if (strpos($uri->path(), $config->get('plugins.admin.route') . '/' . $plugin_route) === false) { + $active = false; + } elseif (isset($uri->paths()[1]) && $uri->paths()[1] === $plugin_route) { + $active = true; + } + + return $active; + } + + /** + * @param array $events + * @return void + */ + protected function enable(array $events) + { + /** @var EventDispatcher $dispatcher */ + $dispatcher = $this->grav['events']; + + foreach ($events as $eventName => $params) { + if (is_string($params)) { + $dispatcher->addListener($eventName, [$this, $params]); + } elseif (is_string($params[0])) { + $dispatcher->addListener($eventName, [$this, $params[0]], $this->getPriority($params, $eventName)); + } else { + foreach ($params as $listener) { + $dispatcher->addListener($eventName, [$this, $listener[0]], $this->getPriority($listener, $eventName)); + } + } + } + } + + /** + * @param array $params + * @param string $eventName + * @return int + */ + private function getPriority($params, $eventName) + { + $override = implode('.', ['priorities', $this->name, $eventName, $params[0]]); + + return $this->grav['config']->get($override) ?? $params[1] ?? 0; + } + + /** + * @param array $events + * @return void + */ + protected function disable(array $events) + { + /** @var EventDispatcher $dispatcher */ + $dispatcher = $this->grav['events']; + + foreach ($events as $eventName => $params) { + if (is_string($params)) { + $dispatcher->removeListener($eventName, [$this, $params]); + } elseif (is_string($params[0])) { + $dispatcher->removeListener($eventName, [$this, $params[0]]); + } else { + foreach ($params as $listener) { + $dispatcher->removeListener($eventName, [$this, $listener[0]]); + } + } + } + } + + /** + * Whether or not an offset exists. + * + * @param string $offset An offset to check for. + * @return bool Returns TRUE on success or FALSE on failure. + */ + #[\ReturnTypeWillChange] + public function offsetExists($offset) + { + if ($offset === 'title') { + $offset = 'name'; + } + + $blueprint = $this->getBlueprint(); + + return isset($blueprint[$offset]); + } + + /** + * Returns the value at specified offset. + * + * @param string $offset The offset to retrieve. + * @return mixed Can return all value types. + */ + #[\ReturnTypeWillChange] + public function offsetGet($offset) + { + if ($offset === 'title') { + $offset = 'name'; + } + + $blueprint = $this->getBlueprint(); + + return $blueprint[$offset] ?? null; + } + + /** + * Assigns a value to the specified offset. + * + * @param string $offset The offset to assign the value to. + * @param mixed $value The value to set. + * @throws LogicException + */ + #[\ReturnTypeWillChange] + public function offsetSet($offset, $value) + { + throw new LogicException(__CLASS__ . ' blueprints cannot be modified.'); + } + + /** + * Unsets an offset. + * + * @param string $offset The offset to unset. + * @throws LogicException + */ + #[\ReturnTypeWillChange] + public function offsetUnset($offset) + { + throw new LogicException(__CLASS__ . ' blueprints cannot be modified.'); + } + + /** + * @return array + */ + public function __debugInfo(): array + { + $array = (array)$this; + + unset($array["\0*\0grav"]); + $array["\0*\0config"] = $this->config(); + + return $array; + } + + /** + * This function will search a string for markdown links in a specific format. The link value can be + * optionally compared against via the $internal_regex and operated on by the callback $function + * provided. + * + * format: [plugin:myplugin_name](function_data) + * + * @param string $content The string to perform operations upon + * @param callable $function The anonymous callback function + * @param string $internal_regex Optional internal regex to extra data from + * @return string + */ + protected function parseLinks($content, $function, $internal_regex = '(.*)') + { + $regex = '/\[plugin:(?:' . preg_quote($this->name, '/') . ')\]\(' . $internal_regex . '\)/i'; + + $result = preg_replace_callback($regex, $function, $content); + \assert($result !== null); + + return $result; + } + + /** + * Merge global and page configurations. + * + * WARNING: This method modifies page header! + * + * @param PageInterface $page The page to merge the configurations with the + * plugin settings. + * @param mixed $deep false = shallow|true = recursive|merge = recursive+unique + * @param array $params Array of additional configuration options to + * merge with the plugin settings. + * @param string $type Is this 'plugins' or 'themes' + * @return Data + */ + protected function mergeConfig(PageInterface $page, $deep = false, $params = [], $type = 'plugins') + { + /** @var Config $config */ + $config = $this->config ?? $this->grav['config']; + + $class_name = $this->name; + $class_name_merged = $class_name . '.merged'; + $defaults = $config->get($type . '.' . $class_name, []); + $page_header = $page->header(); + $header = []; + + if (!isset($page_header->{$class_name_merged}) && isset($page_header->{$class_name})) { + // Get default plugin configurations and retrieve page header configuration + $config = $page_header->{$class_name}; + if (is_bool($config)) { + // Overwrite enabled option with boolean value in page header + $config = ['enabled' => $config]; + } + // Merge page header settings using deep or shallow merging technique + $header = $this->mergeArrays($deep, $defaults, $config); + + // Create new config object and set it on the page object so it's cached for next time + $page->modifyHeader($class_name_merged, new Data($header)); + } elseif (isset($page_header->{$class_name_merged})) { + $merged = $page_header->{$class_name_merged}; + $header = $merged->toArray(); + } + if (empty($header)) { + $header = $defaults; + } + // Merge additional parameter with configuration options + $header = $this->mergeArrays($deep, $header, $params); + + // Return configurations as a new data config class + return new Data($header); + } + + /** + * Merge arrays based on deepness + * + * @param string|bool $deep + * @param array $array1 + * @param array $array2 + * @return array + */ + private function mergeArrays($deep, $array1, $array2) + { + if ($deep === 'merge') { + return Utils::arrayMergeRecursiveUnique($array1, $array2); + } + if ($deep === true) { + return array_replace_recursive($array1, $array2); + } + + return array_merge($array1, $array2); + } + + /** + * Persists to disk the plugin parameters currently stored in the Grav Config object + * + * @param string $name The name of the plugin whose config it should store. + * @return bool + */ + public static function saveConfig($name) + { + if (!$name) { + return false; + } + + $grav = Grav::instance(); + + /** @var UniformResourceLocator $locator */ + $locator = $grav['locator']; + + $filename = 'config://plugins/' . $name . '.yaml'; + $file = YamlFile::instance((string)$locator->findResource($filename, true, true)); + $content = $grav['config']->get('plugins.' . $name); + $file->save($content); + $file->free(); + unset($file); + + return true; + } + + public static function inheritedConfigOption(string $plugin, string $var, PageInterface $page = null, $default = null) + { + if (Utils::isAdminPlugin()) { + $page = Grav::instance()['admin']->page() ?? null; + } else { + $page = $page ?? Grav::instance()['page'] ?? null; + } + + // Try to find var in the page headers + if ($page instanceof PageInterface && $page->exists()) { + // Loop over pages and look for header vars + while ($page && !$page->root()) { + $header = new Data((array)$page->header()); + $value = $header->get("$plugin.$var"); + if (isset($value)) { + return $value; + } + $page = $page->parent(); + } + } + + return Grav::instance()['config']->get("plugins.$plugin.$var", $default); + } + + /** + * Simpler getter for the plugin blueprint + * + * @return Blueprint + */ + public function getBlueprint() + { + if (null === $this->blueprint) { + $this->loadBlueprint(); + \assert($this->blueprint instanceof Blueprint); + } + + return $this->blueprint; + } + + /** + * Load blueprints. + * + * @return void + */ + protected function loadBlueprint() + { + if (null === $this->blueprint) { + $grav = Grav::instance(); + /** @var Plugins $plugins */ + $plugins = $grav['plugins']; + $data = $plugins->get($this->name); + \assert($data !== null); + $this->blueprint = $data->blueprints(); + } + } +} diff --git a/system/src/Grav/Common/Plugins.php b/system/src/Grav/Common/Plugins.php new file mode 100644 index 0000000..2ab1050 --- /dev/null +++ b/system/src/Grav/Common/Plugins.php @@ -0,0 +1,330 @@ +getIterator('plugins://'); + + $plugins = []; + /** @var SplFileInfo $directory */ + foreach ($iterator as $directory) { + if (!$directory->isDir()) { + continue; + } + $plugins[] = $directory->getFilename(); + } + + sort($plugins, SORT_NATURAL | SORT_FLAG_CASE); + + foreach ($plugins as $plugin) { + $object = $this->loadPlugin($plugin); + if ($object) { + $this->add($object); + } + } + } + + /** + * @return $this + */ + public function setup() + { + $blueprints = []; + $formFields = []; + + $grav = Grav::instance(); + + /** @var Config $config */ + $config = $grav['config']; + + /** @var Plugin $plugin */ + foreach ($this->items as $plugin) { + // Setup only enabled plugins. + if ($config["plugins.{$plugin->name}.enabled"] && $plugin instanceof Plugin) { + if (isset($plugin->features['blueprints'])) { + $blueprints["plugin://{$plugin->name}/blueprints"] = $plugin->features['blueprints']; + } + if (method_exists($plugin, 'getFormFieldTypes')) { + $formFields[get_class($plugin)] = $plugin->features['formfields'] ?? 0; + } + } + } + + if ($blueprints) { + // Order by priority. + arsort($blueprints, SORT_NUMERIC); + + /** @var UniformResourceLocator $locator */ + $locator = $grav['locator']; + $locator->addPath('blueprints', '', array_keys($blueprints), ['system', 'blueprints']); + } + + if ($formFields) { + // Order by priority. + arsort($formFields, SORT_NUMERIC); + + $list = []; + foreach ($formFields as $className => $priority) { + $plugin = $this->items[$className]; + $list += $plugin->getFormFieldTypes(); + } + + $this->formFieldTypes = $list; + } + + return $this; + } + + /** + * Registers all plugins. + * + * @return Plugin[] array of Plugin objects + * @throws RuntimeException + */ + public function init() + { + if ($this->plugins_initialized) { + return $this->items; + } + + $grav = Grav::instance(); + + /** @var Config $config */ + $config = $grav['config']; + + /** @var EventDispatcher $events */ + $events = $grav['events']; + + foreach ($this->items as $instance) { + // Register only enabled plugins. + if ($config["plugins.{$instance->name}.enabled"] && $instance instanceof Plugin) { + // Set plugin configuration. + $instance->setConfig($config); + // Register autoloader. + if (method_exists($instance, 'autoload')) { + $instance->setAutoloader($instance->autoload()); + } + // Register event listeners. + $events->addSubscriber($instance); + } + } + + // Plugins Loaded Event + $event = new PluginsLoadedEvent($grav, $this); + $grav->dispatchEvent($event); + + $this->plugins_initialized = true; + + return $this->items; + } + + /** + * Add a plugin + * + * @param Plugin $plugin + * @return void + */ + public function add($plugin) + { + if (is_object($plugin)) { + $this->items[get_class($plugin)] = $plugin; + } + } + + /** + * @return array + */ + public function __debugInfo(): array + { + $array = (array)$this; + + unset($array["\0Grav\Common\Iterator\0iteratorUnset"]); + + return $array; + } + + /** + * @return Plugin[] Index of all plugins by plugin name. + */ + public static function getPlugins(): array + { + /** @var Plugins $plugins */ + $plugins = Grav::instance()['plugins']; + + $list = []; + foreach ($plugins as $instance) { + $list[$instance->name] = $instance; + } + + return $list; + } + + /** + * @param string $name Plugin name + * @return Plugin|null Plugin object or null if plugin cannot be found. + */ + public static function getPlugin(string $name) + { + $list = static::getPlugins(); + + return $list[$name] ?? null; + } + + /** + * Return list of all plugin data with their blueprints. + * + * @return Data[] + */ + public static function all() + { + $grav = Grav::instance(); + + /** @var Plugins $plugins */ + $plugins = $grav['plugins']; + $list = []; + + foreach ($plugins as $instance) { + $name = $instance->name; + + try { + $result = self::get($name); + } catch (Exception $e) { + $exception = new RuntimeException(sprintf('Plugin %s: %s', $name, $e->getMessage()), $e->getCode(), $e); + + /** @var Debugger $debugger */ + $debugger = $grav['debugger']; + $debugger->addMessage("Plugin {$name} cannot be loaded, please check Exceptions tab", 'error'); + $debugger->addException($exception); + + continue; + } + + if ($result) { + $list[$name] = $result; + } + } + + return $list; + } + + /** + * Get a plugin by name + * + * @param string $name + * @return Data|null + */ + public static function get($name) + { + $blueprints = new Blueprints('plugins://'); + $blueprint = $blueprints->get("{$name}/blueprints"); + + // Load default configuration. + $file = CompiledYamlFile::instance("plugins://{$name}/{$name}" . YAML_EXT); + + // ensure this is a valid plugin + if (!$file->exists()) { + return null; + } + + $obj = new Data((array)$file->content(), $blueprint); + + // Override with user configuration. + $obj->merge(Grav::instance()['config']->get('plugins.' . $name) ?: []); + + // Save configuration always to user/config. + $file = CompiledYamlFile::instance("config://plugins/{$name}.yaml"); + $obj->file($file); + + return $obj; + } + + /** + * @param string $name + * @return Plugin|null + */ + protected function loadPlugin($name) + { + // NOTE: ALL THE LOCAL VARIABLES ARE USED INSIDE INCLUDED FILE, DO NOT REMOVE THEM! + $grav = Grav::instance(); + /** @var UniformResourceLocator $locator */ + $locator = $grav['locator']; + $class = null; + + // Start by attempting to load the plugin_name.php file. + $file = $locator->findResource('plugins://' . $name . DS . $name . PLUGIN_EXT); + if (is_file($file)) { + // Local variables available in the file: $grav, $name, $file + $class = include_once $file; + if (!is_object($class) || !is_subclass_of($class, Plugin::class, true)) { + $class = null; + } + } + + // If the class hasn't been initialized yet, guess the class name and create a new instance. + if (null === $class) { + $className = Inflector::camelize($name); + $pluginClassFormat = [ + 'Grav\\Plugin\\' . ucfirst($name). 'Plugin', + 'Grav\\Plugin\\' . $className . 'Plugin', + 'Grav\\Plugin\\' . $className + ]; + + foreach ($pluginClassFormat as $pluginClass) { + if (is_subclass_of($pluginClass, Plugin::class, true)) { + $class = new $pluginClass($name, $grav); + break; + } + } + } + + // Log a warning if plugin cannot be found. + if (null === $class) { + $grav['log']->addWarning( + sprintf("Plugin '%s' enabled but not found! Try clearing cache with `bin/grav clearcache`", $name) + ); + } + + return $class; + } +} diff --git a/system/src/Grav/Common/Processors/AssetsProcessor.php b/system/src/Grav/Common/Processors/AssetsProcessor.php new file mode 100644 index 0000000..dea7546 --- /dev/null +++ b/system/src/Grav/Common/Processors/AssetsProcessor.php @@ -0,0 +1,41 @@ +startTimer(); + $this->container['assets']->init(); + $this->container->fireEvent('onAssetsInitialized'); + $this->stopTimer(); + + return $handler->handle($request); + } +} diff --git a/system/src/Grav/Common/Processors/BackupsProcessor.php b/system/src/Grav/Common/Processors/BackupsProcessor.php new file mode 100644 index 0000000..72a2d04 --- /dev/null +++ b/system/src/Grav/Common/Processors/BackupsProcessor.php @@ -0,0 +1,41 @@ +startTimer(); + $backups = $this->container['backups']; + $backups->init(); + $this->stopTimer(); + + return $handler->handle($request); + } +} diff --git a/system/src/Grav/Common/Processors/DebuggerAssetsProcessor.php b/system/src/Grav/Common/Processors/DebuggerAssetsProcessor.php new file mode 100644 index 0000000..19e56e0 --- /dev/null +++ b/system/src/Grav/Common/Processors/DebuggerAssetsProcessor.php @@ -0,0 +1,40 @@ +startTimer(); + $this->container['debugger']->addAssets(); + $this->stopTimer(); + + return $handler->handle($request); + } +} diff --git a/system/src/Grav/Common/Processors/Events/RequestHandlerEvent.php b/system/src/Grav/Common/Processors/Events/RequestHandlerEvent.php new file mode 100644 index 0000000..7becf22 --- /dev/null +++ b/system/src/Grav/Common/Processors/Events/RequestHandlerEvent.php @@ -0,0 +1,82 @@ +offsetGet('request'); + } + + /** + * @return Route + */ + public function getRoute(): Route + { + return $this->getRequest()->getAttribute('route'); + } + + /** + * @return RequestHandler + */ + public function getHandler(): RequestHandler + { + return $this->offsetGet('handler'); + } + + /** + * @return ResponseInterface|null + */ + public function getResponse(): ?ResponseInterface + { + return $this->offsetGet('response'); + } + + /** + * @param ResponseInterface $response + * @return $this + */ + public function setResponse(ResponseInterface $response): self + { + $this->offsetSet('response', $response); + $this->stopPropagation(); + + return $this; + } + + /** + * @param string $name + * @param MiddlewareInterface $middleware + * @return RequestHandlerEvent + */ + public function addMiddleware(string $name, MiddlewareInterface $middleware): self + { + /** @var RequestHandler $handler */ + $handler = $this['handler']; + $handler->addMiddleware($name, $middleware); + + return $this; + } +} diff --git a/system/src/Grav/Common/Processors/InitializeProcessor.php b/system/src/Grav/Common/Processors/InitializeProcessor.php new file mode 100644 index 0000000..2c5035b --- /dev/null +++ b/system/src/Grav/Common/Processors/InitializeProcessor.php @@ -0,0 +1,461 @@ +processCli(); + } + } + + /** + * @param ServerRequestInterface $request + * @param RequestHandlerInterface $handler + * @return ResponseInterface + */ + public function process(ServerRequestInterface $request, RequestHandlerInterface $handler): ResponseInterface + { + $this->startTimer('_init', 'Initialize'); + + // Load configuration. + $config = $this->initializeConfig(); + + // Initialize logger. + $this->initializeLogger($config); + + // Initialize error handlers. + $this->initializeErrors(); + + // Initialize debugger. + $debugger = $this->initializeDebugger(); + + // Debugger can return response right away. + $response = $this->handleDebuggerRequest($debugger, $request); + if ($response) { + $this->stopTimer('_init'); + + return $response; + } + + // Initialize output buffering. + $this->initializeOutputBuffering($config); + + // Set timezone, locale. + $this->initializeLocale($config); + + // Load plugins. + $this->initializePlugins(); + + // Load pages. + $this->initializePages($config); + + // Load accounts (decides class to be used). + // TODO: remove in 2.0. + $this->container['accounts']; + + // Initialize session (used by URI, see issue #3269). + $this->initializeSession($config); + + // Initialize URI (uses session, see issue #3269). + $this->initializeUri($config); + + // Grav may return redirect response right away. + $redirectCode = (int)$config->get('system.pages.redirect_trailing_slash', 1); + if ($redirectCode) { + $response = $this->handleRedirectRequest($request, $redirectCode > 300 ? $redirectCode : null); + if ($response) { + $this->stopTimer('_init'); + + return $response; + } + } + + $this->stopTimer('_init'); + + // Wrap call to next handler so that debugger can profile it. + /** @var Response $response */ + $response = $debugger->profile(static function () use ($handler, $request) { + return $handler->handle($request); + }); + + // Log both request and response and return the response. + return $debugger->logRequest($request, $response); + } + + public function processCli(): void + { + // Load configuration. + $config = $this->initializeConfig(); + + // Initialize logger. + $this->initializeLogger($config); + + // Disable debugger. + $this->container['debugger']->enabled(false); + + // Set timezone, locale. + $this->initializeLocale($config); + + // Load plugins. + $this->initializePlugins(); + + // Load pages. + $this->initializePages($config); + + // Initialize URI. + $this->initializeUri($config); + + // Load accounts (decides class to be used). + // TODO: remove in 2.0. + $this->container['accounts']; + } + + /** + * @return Config + */ + protected function initializeConfig(): Config + { + $this->startTimer('_init_config', 'Configuration'); + + // Initialize Configuration + $grav = $this->container; + + /** @var Config $config */ + $config = $grav['config']; + $config->init(); + $grav['plugins']->setup(); + + if (defined('GRAV_SCHEMA') && $config->get('versions') === null) { + $filename = USER_DIR . 'config/versions.yaml'; + if (!is_file($filename)) { + $versions = [ + 'core' => [ + 'grav' => [ + 'version' => GRAV_VERSION, + 'schema' => GRAV_SCHEMA + ] + ] + ]; + $config->set('versions', $versions); + + $file = new YamlFile($filename, new YamlFormatter(['inline' => 4])); + $file->save($versions); + } + } + + // Override configuration using the environment. + $prefix = 'GRAV_CONFIG'; + $env = getenv($prefix); + if ($env) { + $cPrefix = $prefix . '__'; + $aPrefix = $prefix . '_ALIAS__'; + $cLen = strlen($cPrefix); + $aLen = strlen($aPrefix); + + $keys = $aliases = []; + $env = $_ENV + $_SERVER; + foreach ($env as $key => $value) { + if (!str_starts_with($key, $prefix)) { + continue; + } + if (str_starts_with($key, $cPrefix)) { + $key = str_replace('__', '.', substr($key, $cLen)); + $keys[$key] = $value; + } elseif (str_starts_with($key, $aPrefix)) { + $key = substr($key, $aLen); + $aliases[$key] = $value; + } + } + $list = []; + foreach ($keys as $key => $value) { + foreach ($aliases as $alias => $real) { + $key = str_replace($alias, $real, $key); + } + $list[$key] = $value; + $config->set($key, $value); + } + } + + $this->stopTimer('_init_config'); + + return $config; + } + + /** + * @param Config $config + * @return Logger + */ + protected function initializeLogger(Config $config): Logger + { + $this->startTimer('_init_logger', 'Logger'); + + $grav = $this->container; + + // Initialize Logging + /** @var Logger $log */ + $log = $grav['log']; + + if ($config->get('system.log.handler', 'file') === 'syslog') { + $log->popHandler(); + + $facility = $config->get('system.log.syslog.facility', 'local6'); + $tag = $config->get('system.log.syslog.tag', 'grav'); + $logHandler = new SyslogHandler($tag, $facility); + $formatter = new LineFormatter("%channel%.%level_name%: %message% %extra%"); + $logHandler->setFormatter($formatter); + + $log->pushHandler($logHandler); + } + + $this->stopTimer('_init_logger'); + + return $log; + } + + /** + * @return Errors + */ + protected function initializeErrors(): Errors + { + $this->startTimer('_init_errors', 'Error Handlers Reset'); + + $grav = $this->container; + + // Initialize Error Handlers + /** @var Errors $errors */ + $errors = $grav['errors']; + $errors->resetHandlers(); + + $this->stopTimer('_init_errors'); + + return $errors; + } + + /** + * @return Debugger + */ + protected function initializeDebugger(): Debugger + { + $this->startTimer('_init_debugger', 'Init Debugger'); + + $grav = $this->container; + + /** @var Debugger $debugger */ + $debugger = $grav['debugger']; + $debugger->init(); + + $this->stopTimer('_init_debugger'); + + return $debugger; + } + + /** + * @param Debugger $debugger + * @param ServerRequestInterface $request + * @return ResponseInterface|null + */ + protected function handleDebuggerRequest(Debugger $debugger, ServerRequestInterface $request): ?ResponseInterface + { + // Clockwork integration. + $clockwork = $debugger->getClockwork(); + if ($clockwork) { + $server = $request->getServerParams(); +// $baseUri = str_replace('\\', '/', dirname(parse_url($server['SCRIPT_NAME'], PHP_URL_PATH))); +// if ($baseUri === '/') { +// $baseUri = ''; +// } + $requestTime = $server['REQUEST_TIME_FLOAT'] ?? GRAV_REQUEST_TIME; + + $request = $request->withAttribute('request_time', $requestTime); + + // Handle clockwork API calls. + $uri = $request->getUri(); + if (Utils::contains($uri->getPath(), '/__clockwork/')) { + return $debugger->debuggerRequest($request); + } + + $this->container['clockwork'] = $clockwork; + } + + return null; + } + + /** + * @param Config $config + */ + protected function initializeOutputBuffering(Config $config): void + { + $this->startTimer('_init_ob', 'Initialize Output Buffering'); + + // Use output buffering to prevent headers from being sent too early. + ob_start(); + if ($config->get('system.cache.gzip') && !@ob_start('ob_gzhandler')) { + // Enable zip/deflate with a fallback in case of if browser does not support compressing. + ob_start(); + } + + $this->stopTimer('_init_ob'); + } + + /** + * @param Config $config + */ + protected function initializeLocale(Config $config): void + { + $this->startTimer('_init_locale', 'Initialize Locale'); + + // Initialize the timezone. + $timezone = $config->get('system.timezone'); + if ($timezone) { + date_default_timezone_set($timezone); + } + + $grav = $this->container; + $grav->setLocale(); + + $this->stopTimer('_init_locale'); + } + + protected function initializePlugins(): Plugins + { + $this->startTimer('_init_plugins_load', 'Load Plugins'); + + $grav = $this->container; + + /** @var Plugins $plugins */ + $plugins = $grav['plugins']; + $plugins->init(); + + $this->stopTimer('_init_plugins_load'); + + return $plugins; + } + + protected function initializePages(Config $config): Pages + { + $this->startTimer('_init_pages_register', 'Load Pages'); + + $grav = $this->container; + + /** @var Pages $pages */ + $pages = $grav['pages']; + // Upgrading from older Grav versions won't work without checking if the method exists. + if (method_exists($pages, 'register')) { + $pages->register(); + } + + $this->stopTimer('_init_pages_register'); + + return $pages; + } + + + protected function initializeUri(Config $config): void + { + $this->startTimer('_init_uri', 'Initialize URI'); + + $grav = $this->container; + + /** @var Uri $uri */ + $uri = $grav['uri']; + $uri->init(); + + $this->stopTimer('_init_uri'); + } + + protected function handleRedirectRequest(RequestInterface $request, int $code = null): ?ResponseInterface + { + if (!in_array($request->getMethod(), ['GET', 'HEAD'])) { + return null; + } + + // Redirect pages with trailing slash if configured to do so. + $uri = $request->getUri(); + $path = $uri->getPath() ?: '/'; + $root = $this->container['uri']->rootUrl(); + + if ($path !== $root && $path !== $root . '/' && Utils::endsWith($path, '/')) { + // Use permanent redirect for SEO reasons. + return $this->container->getRedirectResponse((string)$uri->withPath(rtrim($path, '/')), $code); + } + + return null; + } + + /** + * @param Config $config + */ + protected function initializeSession(Config $config): void + { + // FIXME: Initialize session should happen later after plugins have been loaded. This is a workaround to fix session issues in AWS. + if (isset($this->container['session']) && $config->get('system.session.initialize', true)) { + $this->startTimer('_init_session', 'Start Session'); + + /** @var Session $session */ + $session = $this->container['session']; + + try { + $session->init(); + } catch (SessionException $e) { + $session->init(); + $message = 'Session corruption detected, restarting session...'; + $this->addMessage($message); + $this->container['messages']->add($message, 'error'); + } + + $this->stopTimer('_init_session'); + } + } +} diff --git a/system/src/Grav/Common/Processors/PagesProcessor.php b/system/src/Grav/Common/Processors/PagesProcessor.php new file mode 100644 index 0000000..38a47a4 --- /dev/null +++ b/system/src/Grav/Common/Processors/PagesProcessor.php @@ -0,0 +1,115 @@ +startTimer(); + + // Dump Cache state + $this->container['debugger']->addMessage($this->container['cache']->getCacheStatus()); + + $this->container['pages']->init(); + + $route = $this->container['route']; + + $this->container->fireEvent('onPagesInitialized', new Event( + [ + 'pages' => $this->container['pages'], + 'route' => $route, + 'request' => $request + ] + )); + $this->container->fireEvent('onPageInitialized', new Event( + [ + 'page' => $this->container['page'], + 'route' => $route, + 'request' => $request + ] + )); + + /** @var PageInterface $page */ + $page = $this->container['page']; + + if (!$page->routable()) { + $exception = new RequestException($request, 'Page Not Found', 404); + // If no page found, fire event + $event = new PageEvent([ + 'page' => $page, + 'code' => $exception->getCode(), + 'message' => $exception->getMessage(), + 'exception' => $exception, + 'route' => $route, + 'request' => $request + ]); + $event->page = null; + $event = $this->container->fireEvent('onPageNotFound', $event); + + if (isset($event->page)) { + unset($this->container['page']); + $this->container['page'] = $page = $event->page; + } else { + throw new RuntimeException('Page Not Found', 404); + } + + $this->addMessage("Routed to page {$page->rawRoute()} (type: {$page->template()}) [Not Found fallback]"); + } else { + $this->addMessage("Routed to page {$page->rawRoute()} (type: {$page->template()})"); + + $task = $this->container['task']; + $action = $this->container['action']; + + /** @var Forms $forms */ + $forms = $this->container['forms'] ?? null; + $form = $forms ? $forms->getActiveForm() : null; + + $options = ['page' => $page, 'form' => $form, 'request' => $request]; + if ($task) { + $event = new Event(['task' => $task] + $options); + $this->container->fireEvent('onPageTask', $event); + $this->container->fireEvent('onPageTask.' . $task, $event); + } elseif ($action) { + $event = new Event(['action' => $action] + $options); + $this->container->fireEvent('onPageAction', $event); + $this->container->fireEvent('onPageAction.' . $action, $event); + } + } + + $this->stopTimer(); + + return $handler->handle($request); + } +} diff --git a/system/src/Grav/Common/Processors/PluginsProcessor.php b/system/src/Grav/Common/Processors/PluginsProcessor.php new file mode 100644 index 0000000..320d8f2 --- /dev/null +++ b/system/src/Grav/Common/Processors/PluginsProcessor.php @@ -0,0 +1,41 @@ +startTimer(); + $grav = $this->container; + $grav->fireEvent('onPluginsInitialized'); + $this->stopTimer(); + + return $handler->handle($request); + } +} diff --git a/system/src/Grav/Common/Processors/ProcessorBase.php b/system/src/Grav/Common/Processors/ProcessorBase.php new file mode 100644 index 0000000..2a6244d --- /dev/null +++ b/system/src/Grav/Common/Processors/ProcessorBase.php @@ -0,0 +1,70 @@ +container = $container; + } + + /** + * @param string|null $id + * @param string|null $title + */ + protected function startTimer($id = null, $title = null): void + { + /** @var Debugger $debugger */ + $debugger = $this->container['debugger']; + $debugger->startTimer($id ?? $this->id, $title ?? $this->title); + } + + /** + * @param string|null $id + */ + protected function stopTimer($id = null): void + { + /** @var Debugger $debugger */ + $debugger = $this->container['debugger']; + $debugger->stopTimer($id ?? $this->id); + } + + /** + * @param string $message + * @param string $label + * @param bool $isString + */ + protected function addMessage($message, $label = 'info', $isString = true): void + { + /** @var Debugger $debugger */ + $debugger = $this->container['debugger']; + $debugger->addMessage($message, $label, $isString); + } +} diff --git a/system/src/Grav/Common/Processors/ProcessorInterface.php b/system/src/Grav/Common/Processors/ProcessorInterface.php new file mode 100644 index 0000000..3178f1a --- /dev/null +++ b/system/src/Grav/Common/Processors/ProcessorInterface.php @@ -0,0 +1,20 @@ +startTimer(); + + $container = $this->container; + $output = $container['output']; + + if ($output instanceof ResponseInterface) { + return $output; + } + + /** @var PageInterface $page */ + $page = $this->container['page']; + + // Use internal Grav output. + $container->output = $output; + + ob_start(); + + $event = new Event(['page' => $page, 'output' => &$container->output]); + $container->fireEvent('onOutputGenerated', $event); + + echo $container->output; + + $html = ob_get_clean(); + + // remove any output + $container->output = ''; + + $event = new Event(['page' => $page, 'output' => $html]); + $this->container->fireEvent('onOutputRendered', $event); + + $this->stopTimer(); + + return new Response($page->httpResponseCode(), $page->httpHeaders(), $html); + } +} diff --git a/system/src/Grav/Common/Processors/RequestProcessor.php b/system/src/Grav/Common/Processors/RequestProcessor.php new file mode 100644 index 0000000..97122ea --- /dev/null +++ b/system/src/Grav/Common/Processors/RequestProcessor.php @@ -0,0 +1,66 @@ +startTimer(); + + $header = $request->getHeaderLine('Content-Type'); + $type = trim(strstr($header, ';', true) ?: $header); + if ($type === 'application/json') { + $request = $request->withParsedBody(json_decode($request->getBody()->getContents(), true)); + } + + $uri = $request->getUri(); + $ext = mb_strtolower(Utils::pathinfo($uri->getPath(), PATHINFO_EXTENSION)); + + $request = $request + ->withAttribute('grav', $this->container) + ->withAttribute('time', $_SERVER['REQUEST_TIME_FLOAT'] ?? GRAV_REQUEST_TIME) + ->withAttribute('route', Uri::getCurrentRoute()->withExtension($ext)) + ->withAttribute('referrer', $this->container['uri']->referrer()); + + $event = new RequestHandlerEvent(['request' => $request, 'handler' => $handler]); + /** @var RequestHandlerEvent $event */ + $event = $this->container->fireEvent('onRequestHandlerInit', $event); + $response = $event->getResponse(); + $this->stopTimer(); + + if ($response) { + return $response; + } + + return $handler->handle($request); + } +} diff --git a/system/src/Grav/Common/Processors/SchedulerProcessor.php b/system/src/Grav/Common/Processors/SchedulerProcessor.php new file mode 100644 index 0000000..c3f05cb --- /dev/null +++ b/system/src/Grav/Common/Processors/SchedulerProcessor.php @@ -0,0 +1,42 @@ +startTimer(); + $scheduler = $this->container['scheduler']; + $this->container->fireEvent('onSchedulerInitialized', new Event(['scheduler' => $scheduler])); + $this->stopTimer(); + + return $handler->handle($request); + } +} diff --git a/system/src/Grav/Common/Processors/TasksProcessor.php b/system/src/Grav/Common/Processors/TasksProcessor.php new file mode 100644 index 0000000..ab5caf9 --- /dev/null +++ b/system/src/Grav/Common/Processors/TasksProcessor.php @@ -0,0 +1,71 @@ +startTimer(); + + $task = $this->container['task']; + $action = $this->container['action']; + if ($task || $action) { + $attributes = $request->getAttribute('controller'); + + $controllerClass = $attributes['class'] ?? null; + if ($controllerClass) { + /** @var RequestHandlerInterface $controller */ + $controller = new $controllerClass($attributes['path'] ?? '', $attributes['params'] ?? []); + try { + $response = $controller->handle($request); + + if ($response->getStatusCode() === 418) { + $response = $handler->handle($request); + } + + $this->stopTimer(); + + return $response; + } catch (NotFoundException $e) { + // Task not found: Let it pass through. + } + } + + if ($task) { + $this->container->fireEvent('onTask.' . $task); + } elseif ($action) { + $this->container->fireEvent('onAction.' . $action); + } + } + $this->stopTimer(); + + return $handler->handle($request); + } +} diff --git a/system/src/Grav/Common/Processors/ThemesProcessor.php b/system/src/Grav/Common/Processors/ThemesProcessor.php new file mode 100644 index 0000000..a035f29 --- /dev/null +++ b/system/src/Grav/Common/Processors/ThemesProcessor.php @@ -0,0 +1,40 @@ +startTimer(); + $this->container['themes']->init(); + $this->stopTimer(); + + return $handler->handle($request); + } +} diff --git a/system/src/Grav/Common/Processors/TwigProcessor.php b/system/src/Grav/Common/Processors/TwigProcessor.php new file mode 100644 index 0000000..513add0 --- /dev/null +++ b/system/src/Grav/Common/Processors/TwigProcessor.php @@ -0,0 +1,40 @@ +startTimer(); + $this->container['twig']->init(); + $this->stopTimer(); + + return $handler->handle($request); + } +} diff --git a/system/src/Grav/Common/Scheduler/Cron.php b/system/src/Grav/Common/Scheduler/Cron.php new file mode 100644 index 0000000..d50d100 --- /dev/null +++ b/system/src/Grav/Common/Scheduler/Cron.php @@ -0,0 +1,577 @@ + modified for Grav integration + * @copyright Copyright (c) 2015 - 2024 Trilby Media, LLC. All rights reserved. + * @license MIT License; see LICENSE file for details. + */ + +namespace Grav\Common\Scheduler; + +/* + * Usage examples : + * ---------------- + * + * $cron = new Cron('10-30/5 12 * * *'); + * + * var_dump($cron->getMinutes()); + * // array(5) { + * // [0]=> int(10) + * // [1]=> int(15) + * // [2]=> int(20) + * // [3]=> int(25) + * // [4]=> int(30) + * // } + * + * var_dump($cron->getText('fr')); + * // string(32) "Chaque jour à 12:10,15,20,25,30" + * + * var_dump($cron->getText('en')); + * // string(30) "Every day at 12:10,15,20,25,30" + * + * var_dump($cron->getType()); + * // string(3) "day" + * + * var_dump($cron->getCronHours()); + * // string(2) "12" + * + * var_dump($cron->matchExact(new \DateTime('2012-07-01 13:25:10'))); + * // bool(false) + * + * var_dump($cron->matchExact(new \DateTime('2012-07-01 12:15:20'))); + * // bool(true) + * + * var_dump($cron->matchWithMargin(new \DateTime('2012-07-01 12:32:50'), -3, 5)); + * // bool(true) + */ + +use DateInterval; +use DateTime; +use RuntimeException; +use function count; +use function in_array; +use function is_array; +use function is_string; + +class Cron +{ + public const TYPE_UNDEFINED = ''; + public const TYPE_MINUTE = 'minute'; + public const TYPE_HOUR = 'hour'; + public const TYPE_DAY = 'day'; + public const TYPE_WEEK = 'week'; + public const TYPE_MONTH = 'month'; + public const TYPE_YEAR = 'year'; + /** + * + * @var array + */ + protected $texts = [ + 'fr' => [ + 'empty' => '-tout-', + 'name_minute' => 'minute', + 'name_hour' => 'heure', + 'name_day' => 'jour', + 'name_week' => 'semaine', + 'name_month' => 'mois', + 'name_year' => 'année', + 'text_period' => 'Chaque %s', + 'text_mins' => 'à %s minutes', + 'text_time' => 'à %02s:%02s', + 'text_dow' => 'le %s', + 'text_month' => 'de %s', + 'text_dom' => 'le %s', + 'weekdays' => ['lundi', 'mardi', 'mercredi', 'jeudi', 'vendredi', 'samedi', 'dimanche'], + 'months' => ['janvier', 'février', 'mars', 'avril', 'mai', 'juin', 'juillet', 'août', 'septembre', 'octobre', 'novembre', 'décembre'], + ], + 'en' => [ + 'empty' => '-all-', + 'name_minute' => 'minute', + 'name_hour' => 'hour', + 'name_day' => 'day', + 'name_week' => 'week', + 'name_month' => 'month', + 'name_year' => 'year', + 'text_period' => 'Every %s', + 'text_mins' => 'at %s minutes past the hour', + 'text_time' => 'at %02s:%02s', + 'text_dow' => 'on %s', + 'text_month' => 'of %s', + 'text_dom' => 'on the %s', + 'weekdays' => ['monday', 'tuesday', 'wednesday', 'thursday', 'friday', 'saturday', 'sunday'], + 'months' => ['january', 'february', 'march', 'april', 'may', 'june', 'july', 'august', 'september', 'october', 'november', 'december'], + ], + ]; + + /** + * min hour dom month dow + * @var string + */ + protected $cron = ''; + /** + * + * @var array + */ + protected $minutes = []; + /** + * + * @var array + */ + protected $hours = []; + /** + * + * @var array + */ + protected $months = []; + /** + * 0-7 : sunday, monday, ... saturday, sunday + * @var array + */ + protected $dow = []; + /** + * + * @var array + */ + protected $dom = []; + + /** + * @param string|null $cron + */ + public function __construct($cron = null) + { + if (null !== $cron) { + $this->setCron($cron); + } + } + + /** + * @return string + */ + public function getCron() + { + return implode(' ', [ + $this->getCronMinutes(), + $this->getCronHours(), + $this->getCronDaysOfMonth(), + $this->getCronMonths(), + $this->getCronDaysOfWeek(), + ]); + } + + /** + * @param string $lang 'fr' or 'en' + * @return string + */ + public function getText($lang) + { + // check lang + if (!isset($this->texts[$lang])) { + return $this->getCron(); + } + + $texts = $this->texts[$lang]; + // check type + + $type = $this->getType(); + if ($type === self::TYPE_UNDEFINED) { + return $this->getCron(); + } + + // init + $elements = []; + $elements[] = sprintf($texts['text_period'], $texts['name_' . $type]); + + // hour + if ($type === self::TYPE_HOUR) { + $elements[] = sprintf($texts['text_mins'], $this->getCronMinutes()); + } + + // week + if ($type === self::TYPE_WEEK) { + $dow = $this->getCronDaysOfWeek(); + foreach ($texts['weekdays'] as $i => $wd) { + $dow = str_replace((string) ($i + 1), $wd, $dow); + } + $elements[] = sprintf($texts['text_dow'], $dow); + } + + // month + year + if (in_array($type, [self::TYPE_MONTH, self::TYPE_YEAR], true)) { + $elements[] = sprintf($texts['text_dom'], $this->getCronDaysOfMonth()); + } + + // year + if ($type === self::TYPE_YEAR) { + $months = $this->getCronMonths(); + for ($i = count($texts['months']) - 1; $i >= 0; $i--) { + $months = str_replace((string) ($i + 1), $texts['months'][$i], $months); + } + $elements[] = sprintf($texts['text_month'], $months); + } + + // day + week + month + year + if (in_array($type, [self::TYPE_DAY, self::TYPE_WEEK, self::TYPE_MONTH, self::TYPE_YEAR], true)) { + $elements[] = sprintf($texts['text_time'], $this->getCronHours(), $this->getCronMinutes()); + } + + return str_replace('*', $texts['empty'], implode(' ', $elements)); + } + + /** + * @return string + */ + public function getType() + { + $mask = preg_replace('/[^\* ]/', '-', $this->getCron()); + $mask = preg_replace('/-+/', '-', $mask); + $mask = preg_replace('/[^-\*]/', '', $mask); + + if ($mask === '*****') { + return self::TYPE_MINUTE; + } + + if ($mask === '-****') { + return self::TYPE_HOUR; + } + + if (substr($mask, -3) === '***') { + return self::TYPE_DAY; + } + + if (substr($mask, -3) === '-**') { + return self::TYPE_MONTH; + } + + if (substr($mask, -3) === '**-') { + return self::TYPE_WEEK; + } + + if (substr($mask, -2) === '-*') { + return self::TYPE_YEAR; + } + + return self::TYPE_UNDEFINED; + } + + /** + * @param string $cron + * @return $this + */ + public function setCron($cron) + { + // sanitize + $cron = trim($cron); + $cron = preg_replace('/\s+/', ' ', $cron); + // explode + $elements = explode(' ', $cron); + if (count($elements) !== 5) { + throw new RuntimeException('Bad number of elements'); + } + + $this->cron = $cron; + $this->setMinutes($elements[0]); + $this->setHours($elements[1]); + $this->setDaysOfMonth($elements[2]); + $this->setMonths($elements[3]); + $this->setDaysOfWeek($elements[4]); + + return $this; + } + + /** + * @return string + */ + public function getCronMinutes() + { + return $this->arrayToCron($this->minutes); + } + + /** + * @return string + */ + public function getCronHours() + { + return $this->arrayToCron($this->hours); + } + + /** + * @return string + */ + public function getCronDaysOfMonth() + { + return $this->arrayToCron($this->dom); + } + + /** + * @return string + */ + public function getCronMonths() + { + return $this->arrayToCron($this->months); + } + + /** + * @return string + */ + public function getCronDaysOfWeek() + { + return $this->arrayToCron($this->dow); + } + + /** + * @return array + */ + public function getMinutes() + { + return $this->minutes; + } + + /** + * @return array + */ + public function getHours() + { + return $this->hours; + } + + /** + * @return array + */ + public function getDaysOfMonth() + { + return $this->dom; + } + + /** + * @return array + */ + public function getMonths() + { + return $this->months; + } + + /** + * @return array + */ + public function getDaysOfWeek() + { + return $this->dow; + } + + /** + * @param string|string[] $minutes + * @return $this + */ + public function setMinutes($minutes) + { + $this->minutes = $this->cronToArray($minutes, 0, 59); + + return $this; + } + + /** + * @param string|string[] $hours + * @return $this + */ + public function setHours($hours) + { + $this->hours = $this->cronToArray($hours, 0, 23); + + return $this; + } + + /** + * @param string|string[] $months + * @return $this + */ + public function setMonths($months) + { + $this->months = $this->cronToArray($months, 1, 12); + + return $this; + } + + /** + * @param string|string[] $dow + * @return $this + */ + public function setDaysOfWeek($dow) + { + $this->dow = $this->cronToArray($dow, 0, 7); + + return $this; + } + + /** + * @param string|string[] $dom + * @return $this + */ + public function setDaysOfMonth($dom) + { + $this->dom = $this->cronToArray($dom, 1, 31); + + return $this; + } + + /** + * @param mixed $date + * @param int $min + * @param int $hour + * @param int $day + * @param int $month + * @param int $weekday + * @return DateTime + */ + protected function parseDate($date, &$min, &$hour, &$day, &$month, &$weekday) + { + if (is_numeric($date) && (int)$date == $date) { + $date = new DateTime('@' . $date); + } elseif (is_string($date)) { + $date = new DateTime('@' . strtotime($date)); + } + if ($date instanceof DateTime) { + $min = (int)$date->format('i'); + $hour = (int)$date->format('H'); + $day = (int)$date->format('d'); + $month = (int)$date->format('m'); + $weekday = (int)$date->format('w'); // 0-6 + } else { + throw new RuntimeException('Date format not supported'); + } + + return new DateTime($date->format('Y-m-d H:i:sP')); + } + + /** + * @param int|string|DateTime $date + */ + public function matchExact($date) + { + $date = $this->parseDate($date, $min, $hour, $day, $month, $weekday); + + return + (empty($this->minutes) || in_array($min, $this->minutes, true)) && + (empty($this->hours) || in_array($hour, $this->hours, true)) && + (empty($this->dom) || in_array($day, $this->dom, true)) && + (empty($this->months) || in_array($month, $this->months, true)) && + (empty($this->dow) || in_array($weekday, $this->dow, true) || ($weekday == 0 && in_array(7, $this->dow, true)) || ($weekday == 7 && in_array(0, $this->dow, true)) + ); + } + + /** + * @param int|string|DateTime $date + * @param int $minuteBefore + * @param int $minuteAfter + */ + public function matchWithMargin($date, $minuteBefore = 0, $minuteAfter = 0) + { + if ($minuteBefore > 0) { + throw new RuntimeException('MinuteBefore parameter cannot be positive !'); + } + if ($minuteAfter < 0) { + throw new RuntimeException('MinuteAfter parameter cannot be negative !'); + } + + $date = $this->parseDate($date, $min, $hour, $day, $month, $weekday); + $interval = new DateInterval('PT1M'); // 1 min + if ($minuteBefore !== 0) { + $date->sub(new DateInterval('PT' . abs($minuteBefore) . 'M')); + } + $n = $minuteAfter - $minuteBefore + 1; + for ($i = 0; $i < $n; $i++) { + if ($this->matchExact($date)) { + return true; + } + $date->add($interval); + } + + return false; + } + + /** + * @param array $array + * @return string + */ + protected function arrayToCron($array) + { + $n = count($array); + if (!is_array($array) || $n === 0) { + return '*'; + } + + $cron = [$array[0]]; + $s = $c = $array[0]; + for ($i = 1; $i < $n; $i++) { + if ($array[$i] == $c + 1) { + $c = $array[$i]; + $cron[count($cron) - 1] = $s . '-' . $c; + } else { + $s = $c = $array[$i]; + $cron[] = $c; + } + } + + return implode(',', $cron); + } + + /** + * + * @param array|string $string + * @param int $min + * @param int $max + * @return array + */ + protected function cronToArray($string, $min, $max) + { + $array = []; + if (is_array($string)) { + foreach ($string as $val) { + if (is_numeric($val) && (int)$val == $val && $val >= $min && $val <= $max) { + $array[] = (int)$val; + } + } + } elseif ($string !== '*') { + while ($string !== '') { + // test "*/n" expression + if (preg_match('/^\*\/([0-9]+),?/', $string, $m)) { + for ($i = max(0, $min); $i <= min(59, $max); $i += $m[1]) { + $array[] = (int)$i; + } + $string = substr($string, strlen($m[0])); + continue; + } + // test "a-b/n" expression + if (preg_match('/^([0-9]+)-([0-9]+)\/([0-9]+),?/', $string, $m)) { + for ($i = max($m[1], $min); $i <= min($m[2], $max); $i += $m[3]) { + $array[] = (int)$i; + } + $string = substr($string, strlen($m[0])); + continue; + } + // test "a-b" expression + if (preg_match('/^([0-9]+)-([0-9]+),?/', $string, $m)) { + for ($i = max($m[1], $min); $i <= min($m[2], $max); $i++) { + $array[] = (int)$i; + } + $string = substr($string, strlen($m[0])); + continue; + } + // test "c" expression + if (preg_match('/^([0-9]+),?/', $string, $m)) { + if ($m[1] >= $min && $m[1] <= $max) { + $array[] = (int)$m[1]; + } + $string = substr($string, strlen($m[0])); + continue; + } + + // something goes wrong in the expression + return []; + } + } + sort($array, SORT_NUMERIC); + + return $array; + } +} diff --git a/system/src/Grav/Common/Scheduler/IntervalTrait.php b/system/src/Grav/Common/Scheduler/IntervalTrait.php new file mode 100644 index 0000000..edccec5 --- /dev/null +++ b/system/src/Grav/Common/Scheduler/IntervalTrait.php @@ -0,0 +1,404 @@ +at = $expression; + $this->executionTime = CronExpression::factory($expression); + + return $this; + } + + /** + * Set the execution time to every minute. + * + * @return self + */ + public function everyMinute() + { + return $this->at('* * * * *'); + } + + /** + * Set the execution time to every hour. + * + * @param int|string $minute + * @return self + */ + public function hourly($minute = 0) + { + $c = $this->validateCronSequence($minute); + + return $this->at("{$c['minute']} * * * *"); + } + + /** + * Set the execution time to once a day. + * + * @param int|string $hour + * @param int|string $minute + * @return self + */ + public function daily($hour = 0, $minute = 0) + { + if (is_string($hour)) { + $parts = explode(':', $hour); + $hour = $parts[0]; + $minute = $parts[1] ?? '0'; + } + $c = $this->validateCronSequence($minute, $hour); + + return $this->at("{$c['minute']} {$c['hour']} * * *"); + } + + /** + * Set the execution time to once a week. + * + * @param int|string $weekday + * @param int|string $hour + * @param int|string $minute + * @return self + */ + public function weekly($weekday = 0, $hour = 0, $minute = 0) + { + if (is_string($hour)) { + $parts = explode(':', $hour); + $hour = $parts[0]; + $minute = $parts[1] ?? '0'; + } + $c = $this->validateCronSequence($minute, $hour, null, null, $weekday); + + return $this->at("{$c['minute']} {$c['hour']} * * {$c['weekday']}"); + } + + /** + * Set the execution time to once a month. + * + * @param int|string $month + * @param int|string $day + * @param int|string $hour + * @param int|string $minute + * @return self + */ + public function monthly($month = '*', $day = 1, $hour = 0, $minute = 0) + { + if (is_string($hour)) { + $parts = explode(':', $hour); + $hour = $parts[0]; + $minute = $parts[1] ?? '0'; + } + $c = $this->validateCronSequence($minute, $hour, $day, $month); + + return $this->at("{$c['minute']} {$c['hour']} {$c['day']} {$c['month']} *"); + } + + /** + * Set the execution time to every Sunday. + * + * @param int|string $hour + * @param int|string $minute + * @return self + */ + public function sunday($hour = 0, $minute = 0) + { + return $this->weekly(0, $hour, $minute); + } + + /** + * Set the execution time to every Monday. + * + * @param int|string $hour + * @param int|string $minute + * @return self + */ + public function monday($hour = 0, $minute = 0) + { + return $this->weekly(1, $hour, $minute); + } + + /** + * Set the execution time to every Tuesday. + * + * @param int|string $hour + * @param int|string $minute + * @return self + */ + public function tuesday($hour = 0, $minute = 0) + { + return $this->weekly(2, $hour, $minute); + } + + /** + * Set the execution time to every Wednesday. + * + * @param int|string $hour + * @param int|string $minute + * @return self + */ + public function wednesday($hour = 0, $minute = 0) + { + return $this->weekly(3, $hour, $minute); + } + + /** + * Set the execution time to every Thursday. + * + * @param int|string $hour + * @param int|string $minute + * @return self + */ + public function thursday($hour = 0, $minute = 0) + { + return $this->weekly(4, $hour, $minute); + } + + /** + * Set the execution time to every Friday. + * + * @param int|string $hour + * @param int|string $minute + * @return self + */ + public function friday($hour = 0, $minute = 0) + { + return $this->weekly(5, $hour, $minute); + } + + /** + * Set the execution time to every Saturday. + * + * @param int|string $hour + * @param int|string $minute + * @return self + */ + public function saturday($hour = 0, $minute = 0) + { + return $this->weekly(6, $hour, $minute); + } + + /** + * Set the execution time to every January. + * + * @param int|string $day + * @param int|string $hour + * @param int|string $minute + * @return self + */ + public function january($day = 1, $hour = 0, $minute = 0) + { + return $this->monthly(1, $day, $hour, $minute); + } + + /** + * Set the execution time to every February. + * + * @param int|string $day + * @param int|string $hour + * @param int|string $minute + * @return self + */ + public function february($day = 1, $hour = 0, $minute = 0) + { + return $this->monthly(2, $day, $hour, $minute); + } + + /** + * Set the execution time to every March. + * + * @param int|string $day + * @param int|string $hour + * @param int|string $minute + * @return self + */ + public function march($day = 1, $hour = 0, $minute = 0) + { + return $this->monthly(3, $day, $hour, $minute); + } + + /** + * Set the execution time to every April. + * + * @param int|string $day + * @param int|string $hour + * @param int|string $minute + * @return self + */ + public function april($day = 1, $hour = 0, $minute = 0) + { + return $this->monthly(4, $day, $hour, $minute); + } + + /** + * Set the execution time to every May. + * + * @param int|string $day + * @param int|string $hour + * @param int|string $minute + * @return self + */ + public function may($day = 1, $hour = 0, $minute = 0) + { + return $this->monthly(5, $day, $hour, $minute); + } + + /** + * Set the execution time to every June. + * + * @param int|string $day + * @param int|string $hour + * @param int|string $minute + * @return self + */ + public function june($day = 1, $hour = 0, $minute = 0) + { + return $this->monthly(6, $day, $hour, $minute); + } + + /** + * Set the execution time to every July. + * + * @param int|string $day + * @param int|string $hour + * @param int|string $minute + * @return self + */ + public function july($day = 1, $hour = 0, $minute = 0) + { + return $this->monthly(7, $day, $hour, $minute); + } + + /** + * Set the execution time to every August. + * + * @param int|string $day + * @param int|string $hour + * @param int|string $minute + * @return self + */ + public function august($day = 1, $hour = 0, $minute = 0) + { + return $this->monthly(8, $day, $hour, $minute); + } + + /** + * Set the execution time to every September. + * + * @param int|string $day + * @param int|string $hour + * @param int|string $minute + * @return self + */ + public function september($day = 1, $hour = 0, $minute = 0) + { + return $this->monthly(9, $day, $hour, $minute); + } + + /** + * Set the execution time to every October. + * + * @param int|string $day + * @param int|string $hour + * @param int|string $minute + * @return self + */ + public function october($day = 1, $hour = 0, $minute = 0) + { + return $this->monthly(10, $day, $hour, $minute); + } + + /** + * Set the execution time to every November. + * + * @param int|string $day + * @param int|string $hour + * @param int|string $minute + * @return self + */ + public function november($day = 1, $hour = 0, $minute = 0) + { + return $this->monthly(11, $day, $hour, $minute); + } + + /** + * Set the execution time to every December. + * + * @param int|string $day + * @param int|string $hour + * @param int|string $minute + * @return self + */ + public function december($day = 1, $hour = 0, $minute = 0) + { + return $this->monthly(12, $day, $hour, $minute); + } + + /** + * Validate sequence of cron expression. + * + * @param int|string|null $minute + * @param int|string|null $hour + * @param int|string|null $day + * @param int|string|null $month + * @param int|string|null $weekday + * @return array + */ + private function validateCronSequence($minute = null, $hour = null, $day = null, $month = null, $weekday = null) + { + return [ + 'minute' => $this->validateCronRange($minute, 0, 59), + 'hour' => $this->validateCronRange($hour, 0, 23), + 'day' => $this->validateCronRange($day, 1, 31), + 'month' => $this->validateCronRange($month, 1, 12), + 'weekday' => $this->validateCronRange($weekday, 0, 6), + ]; + } + + /** + * Validate sequence of cron expression. + * + * @param int|string|null $value + * @param int $min + * @param int $max + * @return mixed + */ + private function validateCronRange($value, $min, $max) + { + if ($value === null || $value === '*') { + return '*'; + } + + if (! is_numeric($value) || + ! ($value >= $min && $value <= $max) + ) { + throw new InvalidArgumentException( + "Invalid value: it should be '*' or between {$min} and {$max}." + ); + } + + return $value; + } +} diff --git a/system/src/Grav/Common/Scheduler/Job.php b/system/src/Grav/Common/Scheduler/Job.php new file mode 100644 index 0000000..3b119f4 --- /dev/null +++ b/system/src/Grav/Common/Scheduler/Job.php @@ -0,0 +1,566 @@ +id = Grav::instance()['inflector']->hyphenize($id); + } else { + if (is_string($command)) { + $this->id = md5($command); + } else { + /* @var object $command */ + $this->id = spl_object_hash($command); + } + } + $this->creationTime = new DateTime('now'); + // initialize the directory path for lock files + $this->tempDir = sys_get_temp_dir(); + $this->command = $command; + $this->args = $args; + // Set enabled state + $status = Grav::instance()['config']->get('scheduler.status'); + $this->enabled = !(isset($status[$id]) && $status[$id] === 'disabled'); + } + + /** + * Get the command + * + * @return Closure|string + */ + public function getCommand() + { + return $this->command; + } + + /** + * Get the cron 'at' syntax for this job + * + * @return string + */ + public function getAt() + { + return $this->at; + } + + /** + * Get the status of this job + * + * @return bool + */ + public function getEnabled() + { + return $this->enabled; + } + + /** + * Get optional arguments + * + * @return string|null + */ + public function getArguments() + { + if (is_string($this->args)) { + return $this->args; + } + + return null; + } + + /** + * @return CronExpression + */ + public function getCronExpression() + { + return CronExpression::factory($this->at); + } + + /** + * Get the status of the last run for this job + * + * @return bool + */ + public function isSuccessful() + { + return $this->successful; + } + + /** + * Get the Job id. + * + * @return string + */ + public function getId() + { + return $this->id; + } + + /** + * Check if the Job is due to run. + * It accepts as input a DateTime used to check if + * the job is due. Defaults to job creation time. + * It also default the execution time if not previously defined. + * + * @param DateTime|null $date + * @return bool + */ + public function isDue(DateTime $date = null) + { + // The execution time is being defaulted if not defined + if (!$this->executionTime) { + $this->at('* * * * *'); + } + + $date = $date ?? $this->creationTime; + + return $this->executionTime->isDue($date); + } + + /** + * Check if the Job is overlapping. + * + * @return bool + */ + public function isOverlapping() + { + return $this->lockFile && + file_exists($this->lockFile) && + call_user_func($this->whenOverlapping, filemtime($this->lockFile)) === false; + } + + /** + * Force the Job to run in foreground. + * + * @return $this + */ + public function inForeground() + { + $this->runInBackground = false; + + return $this; + } + + /** + * Sets/Gets an option backlink + * + * @param string|null $link + * @return string|null + */ + public function backlink($link = null) + { + if ($link) { + $this->backlink = $link; + } + return $this->backlink; + } + + + /** + * Check if the Job can run in background. + * + * @return bool + */ + public function runInBackground() + { + return !(is_callable($this->command) || $this->runInBackground === false); + } + + /** + * This will prevent the Job from overlapping. + * It prevents another instance of the same Job of + * being executed if the previous is still running. + * The job id is used as a filename for the lock file. + * + * @param string|null $tempDir The directory path for the lock files + * @param callable|null $whenOverlapping A callback to ignore job overlapping + * @return self + */ + public function onlyOne($tempDir = null, callable $whenOverlapping = null) + { + if ($tempDir === null || !is_dir($tempDir)) { + $tempDir = $this->tempDir; + } + $this->lockFile = implode('/', [ + trim($tempDir), + trim($this->id) . '.lock', + ]); + if ($whenOverlapping) { + $this->whenOverlapping = $whenOverlapping; + } else { + $this->whenOverlapping = static function () { + return false; + }; + } + + return $this; + } + + /** + * Configure the job. + * + * @param array $config + * @return self + */ + public function configure(array $config = []) + { + // Check if config has defined a tempDir + if (isset($config['tempDir']) && is_dir($config['tempDir'])) { + $this->tempDir = $config['tempDir']; + } + + return $this; + } + + /** + * Truth test to define if the job should run if due. + * + * @param callable $fn + * @return self + */ + public function when(callable $fn) + { + $this->truthTest = $fn(); + + return $this; + } + + /** + * Run the job. + * + * @return bool + */ + public function run() + { + // If the truthTest failed, don't run + if ($this->truthTest !== true) { + return false; + } + + // If overlapping, don't run + if ($this->isOverlapping()) { + return false; + } + + // Write lock file if necessary + $this->createLockFile(); + + // Call before if required + if (is_callable($this->before)) { + call_user_func($this->before); + } + + // If command is callable... + if (is_callable($this->command)) { + $this->output = $this->exec(); + } else { + $args = is_string($this->args) ? explode(' ', $this->args) : $this->args; + $command = array_merge([$this->command], $args); + $process = new Process($command); + + $this->process = $process; + + if ($this->runInBackground()) { + $process->start(); + } else { + $process->run(); + $this->finalize(); + } + } + + return true; + } + + /** + * Finish up processing the job + * + * @return void + */ + public function finalize() + { + $process = $this->process; + + if ($process) { + $process->wait(); + + if ($process->isSuccessful()) { + $this->successful = true; + $this->output = $process->getOutput(); + } else { + $this->successful = false; + $this->output = $process->getErrorOutput(); + } + + $this->postRun(); + + unset($this->process); + } + } + + /** + * Things to run after job has run + * + * @return void + */ + private function postRun() + { + if (count($this->outputTo) > 0) { + foreach ($this->outputTo as $file) { + $output_mode = $this->outputMode === 'append' ? FILE_APPEND | LOCK_EX : LOCK_EX; + $timestamp = (new DateTime('now'))->format('c'); + $output = $timestamp . "\n" . str_pad('', strlen($timestamp), '>') . "\n" . $this->output; + file_put_contents($file, $output, $output_mode); + } + } + + // Send output to email + $this->emailOutput(); + + // Call any callback defined + if (is_callable($this->after)) { + call_user_func($this->after, $this->output, $this->returnCode); + } + + $this->removeLockFile(); + } + + /** + * Create the job lock file. + * + * @param mixed $content + * @return void + */ + private function createLockFile($content = null) + { + if ($this->lockFile) { + if ($content === null || !is_string($content)) { + $content = $this->getId(); + } + file_put_contents($this->lockFile, $content); + } + } + + /** + * Remove the job lock file. + * + * @return void + */ + private function removeLockFile() + { + if ($this->lockFile && file_exists($this->lockFile)) { + unlink($this->lockFile); + } + } + + /** + * Execute a callable job. + * + * @return string + * @throws RuntimeException + */ + private function exec() + { + $return_data = ''; + ob_start(); + try { + $return_data = call_user_func_array($this->command, $this->args); + $this->successful = true; + } catch (RuntimeException $e) { + $return_data = $e->getMessage(); + $this->successful = false; + } + $this->output = ob_get_clean() . (is_string($return_data) ? $return_data : ''); + + $this->postRun(); + + return $this->output; + } + + /** + * Set the file/s where to write the output of the job. + * + * @param string|array $filename + * @param bool $append + * @return self + */ + public function output($filename, $append = false) + { + $this->outputTo = is_array($filename) ? $filename : [$filename]; + $this->outputMode = $append === false ? 'overwrite' : 'append'; + + return $this; + } + + /** + * Get the job output. + * + * @return mixed + */ + public function getOutput() + { + return $this->output; + } + + /** + * Set the emails where the output should be sent to. + * The Job should be set to write output to a file + * for this to work. + * + * @param string|array $email + * @return self + */ + public function email($email) + { + if (!is_string($email) && !is_array($email)) { + throw new InvalidArgumentException('The email can be only string or array'); + } + + $this->emailTo = is_array($email) ? $email : [$email]; + // Force the job to run in foreground + $this->inForeground(); + + return $this; + } + + /** + * Email the output of the job, if any. + * + * @return bool + */ + private function emailOutput() + { + if (!count($this->outputTo) || !count($this->emailTo)) { + return false; + } + + if (is_callable('Grav\Plugin\Email\Utils::sendEmail')) { + $subject ='Grav Scheduled Job [' . $this->getId() . ']'; + $content = "

Output from Job ID: {$this->getId()}

\n

Command: {$this->getCommand()}


\n".$this->getOutput()."\n
"; + $to = $this->emailTo; + + \Grav\Plugin\Email\Utils::sendEmail($subject, $content, $to); + } + + return true; + } + + /** + * Set function to be called before job execution + * Job object is injected as a parameter to callable function. + * + * @param callable $fn + * @return self + */ + public function before(callable $fn) + { + $this->before = $fn; + + return $this; + } + + /** + * Set a function to be called after job execution. + * By default this will force the job to run in foreground + * because the output is injected as a parameter of this + * function, but it could be avoided by passing true as a + * second parameter. The job will run in background if it + * meets all the other criteria. + * + * @param callable $fn + * @param bool $runInBackground + * @return self + */ + public function then(callable $fn, $runInBackground = false) + { + $this->after = $fn; + // Force the job to run in foreground + if ($runInBackground === false) { + $this->inForeground(); + } + + return $this; + } +} diff --git a/system/src/Grav/Common/Scheduler/Scheduler.php b/system/src/Grav/Common/Scheduler/Scheduler.php new file mode 100644 index 0000000..d3cefb0 --- /dev/null +++ b/system/src/Grav/Common/Scheduler/Scheduler.php @@ -0,0 +1,447 @@ +get('scheduler.defaults', []); + $this->config = $config; + + $this->status_path = Grav::instance()['locator']->findResource('user-data://scheduler', true, true); + if (!file_exists($this->status_path)) { + Folder::create($this->status_path); + } + } + + /** + * Load saved jobs from config/scheduler.yaml file + * + * @return $this + */ + public function loadSavedJobs() + { + $this->saved_jobs = []; + $saved_jobs = (array) Grav::instance()['config']->get('scheduler.custom_jobs', []); + + foreach ($saved_jobs as $id => $j) { + $args = $j['args'] ?? []; + $id = Grav::instance()['inflector']->hyphenize($id); + $job = $this->addCommand($j['command'], $args, $id); + + if (isset($j['at'])) { + $job->at($j['at']); + } + + if (isset($j['output'])) { + $mode = isset($j['output_mode']) && $j['output_mode'] === 'append'; + $job->output($j['output'], $mode); + } + + if (isset($j['email'])) { + $job->email($j['email']); + } + + // store in saved_jobs + $this->saved_jobs[] = $job; + } + + return $this; + } + + /** + * Get the queued jobs as background/foreground + * + * @param bool $all + * @return array + */ + public function getQueuedJobs($all = false) + { + $background = []; + $foreground = []; + foreach ($this->jobs as $job) { + if ($all || $job->getEnabled()) { + if ($job->runInBackground()) { + $background[] = $job; + } else { + $foreground[] = $job; + } + } + } + return [$background, $foreground]; + } + + /** + * Get all jobs if they are disabled or not as one array + * + * @return Job[] + */ + public function getAllJobs() + { + [$background, $foreground] = $this->loadSavedJobs()->getQueuedJobs(true); + + return array_merge($background, $foreground); + } + + /** + * Get a specific Job based on id + * + * @param string $jobid + * @return Job|null + */ + public function getJob($jobid) + { + $all = $this->getAllJobs(); + foreach ($all as $job) { + if ($jobid == $job->getId()) { + return $job; + } + } + return null; + } + + /** + * Queues a PHP function execution. + * + * @param callable $fn The function to execute + * @param array $args Optional arguments to pass to the php script + * @param string|null $id Optional custom identifier + * @return Job + */ + public function addFunction(callable $fn, $args = [], $id = null) + { + $job = new Job($fn, $args, $id); + $this->queueJob($job->configure($this->config)); + + return $job; + } + + /** + * Queue a raw shell command. + * + * @param string $command The command to execute + * @param array $args Optional arguments to pass to the command + * @param string|null $id Optional custom identifier + * @return Job + */ + public function addCommand($command, $args = [], $id = null) + { + $job = new Job($command, $args, $id); + $this->queueJob($job->configure($this->config)); + + return $job; + } + + /** + * Run the scheduler. + * + * @param DateTime|null $runTime Optional, run at specific moment + * @param bool $force force run even if not due + */ + public function run(DateTime $runTime = null, $force = false) + { + $this->loadSavedJobs(); + + [$background, $foreground] = $this->getQueuedJobs(false); + $alljobs = array_merge($background, $foreground); + + if (null === $runTime) { + $runTime = new DateTime('now'); + } + + // Star processing jobs + foreach ($alljobs as $job) { + if ($job->isDue($runTime) || $force) { + $job->run(); + $this->jobs_run[] = $job; + } + } + + // Finish handling any background jobs + foreach ($background as $job) { + $job->finalize(); + } + + // Store states + $this->saveJobStates(); + + // Store run date + file_put_contents("logs/lastcron.run", (new DateTime("now"))->format("Y-m-d H:i:s"), LOCK_EX); + } + + /** + * Reset all collected data of last run. + * + * Call before run() if you call run() multiple times. + * + * @return $this + */ + public function resetRun() + { + // Reset collected data of last run + $this->executed_jobs = []; + $this->failed_jobs = []; + $this->output_schedule = []; + + return $this; + } + + /** + * Get the scheduler verbose output. + * + * @param string $type Allowed: text, html, array + * @return string|array The return depends on the requested $type + */ + public function getVerboseOutput($type = 'text') + { + switch ($type) { + case 'text': + return implode("\n", $this->output_schedule); + case 'html': + return implode('
', $this->output_schedule); + case 'array': + return $this->output_schedule; + default: + throw new InvalidArgumentException('Invalid output type'); + } + } + + /** + * Remove all queued Jobs. + * + * @return $this + */ + public function clearJobs() + { + $this->jobs = []; + + return $this; + } + + /** + * Helper to get the full Cron command + * + * @return string + */ + public function getCronCommand() + { + $command = $this->getSchedulerCommand(); + + return "(crontab -l; echo \"* * * * * {$command} 1>> /dev/null 2>&1\") | crontab -"; + } + + /** + * @param string|null $php + * @return string + */ + public function getSchedulerCommand($php = null) + { + $phpBinaryFinder = new PhpExecutableFinder(); + $php = $php ?? $phpBinaryFinder->find(); + $command = 'cd ' . str_replace(' ', '\ ', GRAV_ROOT) . ';' . $php . ' bin/grav scheduler'; + + return $command; + } + + /** + * Helper to determine if cron-like job is setup + * 0 - Crontab Not found + * 1 - Crontab Found + * 2 - Error + * + * @return int + */ + public function isCrontabSetup() + { + // Check for external triggers + $last_run = @file_get_contents("logs/lastcron.run"); + if (time() - strtotime($last_run) < 120){ + return 1; + } + + // No external triggers found, so do legacy cron checks + $process = new Process(['crontab', '-l']); + $process->run(); + + if ($process->isSuccessful()) { + $output = $process->getOutput(); + $command = str_replace('/', '\/', $this->getSchedulerCommand('.*')); + $full_command = '/^(?!#).* .* .* .* .* ' . $command . '/m'; + + return preg_match($full_command, $output) ? 1 : 0; + } + + $error = $process->getErrorOutput(); + + return Utils::startsWith($error, 'crontab: no crontab') ? 0 : 2; + } + + /** + * Get the Job states file + * + * @return YamlFile + */ + public function getJobStates() + { + return YamlFile::instance($this->status_path . '/status.yaml'); + } + + /** + * Save job states to statys file + * + * @return void + */ + private function saveJobStates() + { + $now = time(); + $new_states = []; + + foreach ($this->jobs_run as $job) { + if ($job->isSuccessful()) { + $new_states[$job->getId()] = ['state' => 'success', 'last-run' => $now]; + $this->pushExecutedJob($job); + } else { + $new_states[$job->getId()] = ['state' => 'failure', 'last-run' => $now, 'error' => $job->getOutput()]; + $this->pushFailedJob($job); + } + } + + $saved_states = $this->getJobStates(); + $saved_states->save(array_merge($saved_states->content(), $new_states)); + } + + /** + * Try to determine who's running the process + * + * @return false|string + */ + public function whoami() + { + $process = new Process(['whoami']); + $process->run(); + + if ($process->isSuccessful()) { + return trim($process->getOutput()); + } + + return $process->getErrorOutput(); + } + + + /** + * Queue a job for execution in the correct queue. + * + * @param Job $job + * @return void + */ + private function queueJob(Job $job) + { + $this->jobs[] = $job; + + // Store jobs + } + + /** + * Add an entry to the scheduler verbose output array. + * + * @param string $string + * @return void + */ + private function addSchedulerVerboseOutput($string) + { + $now = '[' . (new DateTime('now'))->format('c') . '] '; + $this->output_schedule[] = $now . $string; + // Print to stdoutput in light gray + // echo "\033[37m{$string}\033[0m\n"; + } + + /** + * Push a succesfully executed job. + * + * @param Job $job + * @return Job + */ + private function pushExecutedJob(Job $job) + { + $this->executed_jobs[] = $job; + $command = $job->getCommand(); + $args = $job->getArguments(); + // If callable, log the string Closure + if (is_callable($command)) { + $command = is_string($command) ? $command : 'Closure'; + } + $this->addSchedulerVerboseOutput("Success: {$command} {$args}"); + + return $job; + } + + /** + * Push a failed job. + * + * @param Job $job + * @return Job + */ + private function pushFailedJob(Job $job) + { + $this->failed_jobs[] = $job; + $command = $job->getCommand(); + // If callable, log the string Closure + if (is_callable($command)) { + $command = is_string($command) ? $command : 'Closure'; + } + $output = trim($job->getOutput()); + $this->addSchedulerVerboseOutput("Error: {$command} → {$output}"); + + return $job; + } +} diff --git a/system/src/Grav/Common/Security.php b/system/src/Grav/Common/Security.php new file mode 100644 index 0000000..55bcde5 --- /dev/null +++ b/system/src/Grav/Common/Security.php @@ -0,0 +1,266 @@ +get('security.sanitize_svg')) { + $content = file_get_contents($filepath); + + return static::detectXss($content, $options); + } + + return null; + } + + /** + * Sanitize SVG string for XSS code + * + * @param string $svg + * @return string + */ + public static function sanitizeSvgString(string $svg): string + { + if (Grav::instance()['config']->get('security.sanitize_svg')) { + $sanitizer = new DOMSanitizer(DOMSanitizer::SVG); + $sanitized = $sanitizer->sanitize($svg); + if (is_string($sanitized)) { + $svg = $sanitized; + } + } + + return $svg; + } + + /** + * Sanitize SVG for XSS code + * + * @param string $file + * @return void + */ + public static function sanitizeSVG(string $file): void + { + if (file_exists($file) && Grav::instance()['config']->get('security.sanitize_svg')) { + $sanitizer = new DOMSanitizer(DOMSanitizer::SVG); + $original_svg = file_get_contents($file); + $clean_svg = $sanitizer->sanitize($original_svg); + + // Quarantine bad SVG files and throw exception + if ($clean_svg !== false ) { + file_put_contents($file, $clean_svg); + } else { + $quarantine_file = Utils::basename($file); + $quarantine_dir = 'log://quarantine'; + Folder::mkdir($quarantine_dir); + file_put_contents("$quarantine_dir/$quarantine_file", $original_svg); + unlink($file); + throw new Exception('SVG could not be sanitized, it has been moved to the logs/quarantine folder'); + } + } + } + + /** + * Detect XSS code in Grav pages + * + * @param Pages $pages + * @param bool $route + * @param callable|null $status + * @return array + */ + public static function detectXssFromPages(Pages $pages, $route = true, callable $status = null) + { + $routes = $pages->getList(null, 0, true); + + // Remove duplicate for homepage + unset($routes['/']); + + $list = []; + + // This needs Symfony 4.1 to work + $status && $status([ + 'type' => 'count', + 'steps' => count($routes), + ]); + + foreach (array_keys($routes) as $route) { + $status && $status([ + 'type' => 'progress', + ]); + + try { + $page = $pages->find($route); + if ($page->exists()) { + // call the content to load/cache it + $header = (array) $page->header(); + $content = $page->value('content'); + + $data = ['header' => $header, 'content' => $content]; + $results = static::detectXssFromArray($data); + + if (!empty($results)) { + $list[$page->rawRoute()] = $results; + } + } + } catch (Exception $e) { + continue; + } + } + + return $list; + } + + /** + * Detect XSS in an array or strings such as $_POST or $_GET + * + * @param array $array Array such as $_POST or $_GET + * @param array|null $options Extra options to be passed. + * @param string $prefix Prefix for returned values. + * @return array Returns flatten list of potentially dangerous input values, such as 'data.content'. + */ + public static function detectXssFromArray(array $array, string $prefix = '', array $options = null) + { + if (null === $options) { + $options = static::getXssDefaults(); + } + + $list = [[]]; + foreach ($array as $key => $value) { + if (is_array($value)) { + $list[] = static::detectXssFromArray($value, $prefix . $key . '.', $options); + } + if ($result = static::detectXss($value, $options)) { + $list[] = [$prefix . $key => $result]; + } + } + + return array_merge(...$list); + } + + /** + * Determine if string potentially has a XSS attack. This simple function does not catch all XSS and it is likely to + * + * return false positives because of it tags all potentially dangerous HTML tags and attributes without looking into + * their content. + * + * @param string|null $string The string to run XSS detection logic on + * @param array|null $options + * @return string|null Type of XSS vector if the given `$string` may contain XSS, false otherwise. + * + * Copies the code from: https://github.com/symphonycms/xssfilter/blob/master/extension.driver.php#L138 + */ + public static function detectXss($string, array $options = null): ?string + { + // Skip any null or non string values + if (null === $string || !is_string($string) || empty($string)) { + return null; + } + + if (null === $options) { + $options = static::getXssDefaults(); + } + + $enabled_rules = (array)($options['enabled_rules'] ?? null); + $dangerous_tags = (array)($options['dangerous_tags'] ?? null); + if (!$dangerous_tags) { + $enabled_rules['dangerous_tags'] = false; + } + $invalid_protocols = (array)($options['invalid_protocols'] ?? null); + if (!$invalid_protocols) { + $enabled_rules['invalid_protocols'] = false; + } + $enabled_rules = array_filter($enabled_rules, static function ($val) { return !empty($val); }); + if (!$enabled_rules) { + return null; + } + + // Keep a copy of the original string before cleaning up + $orig = $string; + + // URL decode + $string = urldecode($string); + + // Convert Hexadecimals + $string = (string)preg_replace_callback('!(&#|\\\)[xX]([0-9a-fA-F]+);?!u', static function ($m) { + return chr(hexdec($m[2])); + }, $string); + + // Clean up entities + $string = preg_replace('!(&#[0-9]+);?!u', '$1;', $string); + + // Decode entities + $string = html_entity_decode($string, ENT_NOQUOTES | ENT_HTML5, 'UTF-8'); + + // Strip whitespace characters + $string = preg_replace('!\s!u', ' ', $string); + $stripped = preg_replace('!\s!u', '', $string); + + // Set the patterns we'll test against + $patterns = [ + // Match any attribute starting with "on" or xmlns + 'on_events' => '#(<[^>]+[[a-z\x00-\x20\"\'\/])([\s\/]on|\sxmlns)[a-z].*=>?#iUu', + + // Match javascript:, livescript:, vbscript:, mocha:, feed: and data: protocols + 'invalid_protocols' => '#(' . implode('|', array_map('preg_quote', $invalid_protocols, ['#'])) . ')(:|\&\#58)\S.*?#iUu', + + // Match -moz-bindings + 'moz_binding' => '#-moz-binding[a-z\x00-\x20]*:#u', + + // Match style attributes + 'html_inline_styles' => '#(<[^>]+[a-z\x00-\x20\"\'\/])(style=[^>]*(url\:|x\:expression).*)>?#iUu', + + // Match potentially dangerous tags + 'dangerous_tags' => '#]*>?#ui' + ]; + + // Iterate over rules and return label if fail + foreach ($patterns as $name => $regex) { + if (!empty($enabled_rules[$name])) { + if (preg_match($regex, $string) || preg_match($regex, $stripped) || preg_match($regex, $orig)) { + return $name; + } + } + } + + return null; + } + + public static function getXssDefaults(): array + { + /** @var Config $config */ + $config = Grav::instance()['config']; + + return [ + 'enabled_rules' => $config->get('security.xss_enabled'), + 'dangerous_tags' => array_map('trim', $config->get('security.xss_dangerous_tags')), + 'invalid_protocols' => array_map('trim', $config->get('security.xss_invalid_protocols')), + ]; + } +} diff --git a/system/src/Grav/Common/Service/AccountsServiceProvider.php b/system/src/Grav/Common/Service/AccountsServiceProvider.php new file mode 100644 index 0000000..d0e0e68 --- /dev/null +++ b/system/src/Grav/Common/Service/AccountsServiceProvider.php @@ -0,0 +1,157 @@ +addTypes($config->get('permissions.types', [])); + + $array = $config->get('permissions.actions'); + if (is_array($array)) { + $actions = PermissionsReader::fromArray($array, $permissions->getTypes()); + $permissions->addActions($actions); + } + + $event = new PermissionsRegisterEvent($permissions); + $container->dispatchEvent($event); + + return $permissions; + }; + + $container['accounts'] = function (Container $container) { + $type = $this->initialize($container); + + return $type === 'flex' ? $this->flexAccounts($container) : $this->regularAccounts($container); + }; + + $container['user_groups'] = static function (Container $container) { + /** @var Flex $flex */ + $flex = $container['flex']; + $directory = $flex->getDirectory('user-groups'); + + return $directory ? $directory->getIndex() : null; + }; + + $container['users'] = $container->factory(static function (Container $container) { + user_error('Grav::instance()[\'users\'] is deprecated since Grav 1.6, use Grav::instance()[\'accounts\'] instead', E_USER_DEPRECATED); + + return $container['accounts']; + }); + } + + /** + * @param Container $container + * @return string + */ + protected function initialize(Container $container): string + { + $isDefined = defined('GRAV_USER_INSTANCE'); + $type = strtolower($isDefined ? GRAV_USER_INSTANCE : $container['config']->get('system.accounts.type', 'regular')); + + if ($type === 'flex') { + if (!$isDefined) { + define('GRAV_USER_INSTANCE', 'FLEX'); + } + + /** @var EventDispatcher $dispatcher */ + $dispatcher = $container['events']; + + // Stop /admin/user from working, display error instead. + $dispatcher->addListener( + 'onAdminPage', + static function (Event $event) { + $grav = Grav::instance(); + $admin = $grav['admin']; + [$base,$location,] = $admin->getRouteDetails(); + if ($location !== 'user' || isset($grav['flex_objects'])) { + return; + } + + /** @var PageInterface $page */ + $page = $event['page']; + $page->init(new SplFileInfo('plugin://admin/pages/admin/error.md')); + $page->routable(true); + $header = $page->header(); + $header->title = 'Please install missing plugin'; + $page->content("## Please install and enable **[Flex Objects]({$base}/plugins/flex-objects)** plugin. It is required to edit **Flex User Accounts**."); + + /** @var Header $header */ + $header = $page->header(); + $directory = $grav['accounts']->getFlexDirectory(); + $menu = $directory->getConfig('admin.menu.list'); + $header->access = $menu['authorize'] ?? ['admin.super']; + }, + 100000 + ); + } elseif (!$isDefined) { + define('GRAV_USER_INSTANCE', 'REGULAR'); + } + + return $type; + } + + /** + * @param Container $container + * @return DataUser\UserCollection + */ + protected function regularAccounts(Container $container) + { + // Use User class for backwards compatibility. + return new DataUser\UserCollection(User::class); + } + + /** + * @param Container $container + * @return FlexIndexInterface|null + */ + protected function flexAccounts(Container $container) + { + /** @var Flex $flex */ + $flex = $container['flex']; + $directory = $flex->getDirectory('user-accounts'); + + return $directory ? $directory->getIndex() : null; + } +} diff --git a/system/src/Grav/Common/Service/AssetsServiceProvider.php b/system/src/Grav/Common/Service/AssetsServiceProvider.php new file mode 100644 index 0000000..54bb2f4 --- /dev/null +++ b/system/src/Grav/Common/Service/AssetsServiceProvider.php @@ -0,0 +1,32 @@ +setup(); + + return $backups; + }; + } +} diff --git a/system/src/Grav/Common/Service/ConfigServiceProvider.php b/system/src/Grav/Common/Service/ConfigServiceProvider.php new file mode 100644 index 0000000..6f0ffae --- /dev/null +++ b/system/src/Grav/Common/Service/ConfigServiceProvider.php @@ -0,0 +1,206 @@ +init(); + + return $setup; + }; + + $container['blueprints'] = function ($c) { + return static::blueprints($c); + }; + + $container['config'] = function ($c) { + $config = static::load($c); + + // After configuration has been loaded, we can disable YAML compatibility if strict mode has been enabled. + if (!$config->get('system.strict_mode.yaml_compat', true)) { + YamlFile::globalSettings(['compat' => false, 'native' => true]); + } + + return $config; + }; + + $container['mime'] = function ($c) { + /** @var Config $config */ + $config = $c['config']; + $mimes = $config->get('mime.types', []); + foreach ($config->get('media.types', []) as $ext => $media) { + if (!empty($media['mime'])) { + $mimes[$ext] = array_unique(array_merge([$media['mime']], $mimes[$ext] ?? [])); + } + } + + return MimeTypes::createFromMimes($mimes); + }; + + $container['languages'] = function ($c) { + return static::languages($c); + }; + + $container['language'] = function ($c) { + return new Language($c); + }; + } + + /** + * @param Container $container + * @return mixed + */ + public static function blueprints(Container $container) + { + /** Setup $setup */ + $setup = $container['setup']; + + /** @var UniformResourceLocator $locator */ + $locator = $container['locator']; + + $cache = $locator->findResource('cache://compiled/blueprints', true, true); + + $files = []; + $paths = $locator->findResources('blueprints://config'); + $files += (new ConfigFileFinder)->locateFiles($paths); + $paths = $locator->findResources('plugins://'); + $files += (new ConfigFileFinder)->setBase('plugins')->locateInFolders($paths, 'blueprints'); + $paths = $locator->findResources('themes://'); + $files += (new ConfigFileFinder)->setBase('themes')->locateInFolders($paths, 'blueprints'); + + $blueprints = new CompiledBlueprints($cache, $files, GRAV_ROOT); + + return $blueprints->name("master-{$setup->environment}")->load(); + } + + /** + * @param Container $container + * @return Config + */ + public static function load(Container $container) + { + /** Setup $setup */ + $setup = $container['setup']; + + /** @var UniformResourceLocator $locator */ + $locator = $container['locator']; + + $cache = $locator->findResource('cache://compiled/config', true, true); + + $files = []; + $paths = $locator->findResources('config://'); + $files += (new ConfigFileFinder)->locateFiles($paths); + $paths = $locator->findResources('plugins://'); + $files += (new ConfigFileFinder)->setBase('plugins')->locateInFolders($paths); + $paths = $locator->findResources('themes://'); + $files += (new ConfigFileFinder)->setBase('themes')->locateInFolders($paths); + + $compiled = new CompiledConfig($cache, $files, GRAV_ROOT); + $compiled->setBlueprints(function () use ($container) { + return $container['blueprints']; + }); + + $config = $compiled->name("master-{$setup->environment}")->load(); + $config->environment = $setup->environment; + + return $config; + } + + /** + * @param Container $container + * @return mixed + */ + public static function languages(Container $container) + { + /** @var Setup $setup */ + $setup = $container['setup']; + + /** @var Config $config */ + $config = $container['config']; + + /** @var UniformResourceLocator $locator */ + $locator = $container['locator']; + + $cache = $locator->findResource('cache://compiled/languages', true, true); + $files = []; + + // Process languages only if enabled in configuration. + if ($config->get('system.languages.translations', true)) { + $paths = $locator->findResources('languages://'); + $files += (new ConfigFileFinder)->locateFiles($paths); + $paths = $locator->findResources('plugins://'); + $files += (new ConfigFileFinder)->setBase('plugins')->locateInFolders($paths, 'languages'); + $paths = static::pluginFolderPaths($paths, 'languages'); + $files += (new ConfigFileFinder)->locateFiles($paths); + } + + $languages = new CompiledLanguages($cache, $files, GRAV_ROOT); + + return $languages->name("master-{$setup->environment}")->load(); + } + + /** + * Find specific paths in plugins + * + * @param array $plugins + * @param string $folder_path + * @return array + */ + protected static function pluginFolderPaths($plugins, $folder_path) + { + $paths = []; + + foreach ($plugins as $path) { + $iterator = new DirectoryIterator($path); + + /** @var DirectoryIterator $directory */ + foreach ($iterator as $directory) { + if (!$directory->isDir() || $directory->isDot()) { + continue; + } + + // Path to the languages folder + $lang_path = $directory->getPathName() . '/' . $folder_path; + + // If this folder exists, add it to the list of paths + if (file_exists($lang_path)) { + $paths []= $lang_path; + } + } + } + return $paths; + } +} diff --git a/system/src/Grav/Common/Service/ErrorServiceProvider.php b/system/src/Grav/Common/Service/ErrorServiceProvider.php new file mode 100644 index 0000000..6f6f568 --- /dev/null +++ b/system/src/Grav/Common/Service/ErrorServiceProvider.php @@ -0,0 +1,30 @@ + $config->get('system.flex', [])]); + FlexFormFlash::setFlex($flex); + + $accountsEnabled = $config->get('system.accounts.type', 'regular') === 'flex'; + $pagesEnabled = $config->get('system.pages.type', 'regular') === 'flex'; + + // Add built-in types from Grav. + if ($pagesEnabled) { + $flex->addDirectoryType( + 'pages', + 'blueprints://flex/pages.yaml', + [ + 'enabled' => $pagesEnabled + ] + ); + } + if ($accountsEnabled) { + $flex->addDirectoryType( + 'user-accounts', + 'blueprints://flex/user-accounts.yaml', + [ + 'enabled' => $accountsEnabled, + 'data' => [ + 'storage' => $this->getFlexAccountsStorage($config), + ] + ] + ); + $flex->addDirectoryType( + 'user-groups', + 'blueprints://flex/user-groups.yaml', + [ + 'enabled' => $accountsEnabled + ] + ); + } + + // Call event to register Flex Directories. + $event = new FlexRegisterEvent($flex); + $container->dispatchEvent($event); + + return $flex; + }; + } + + /** + * @param Config $config + * @return array + */ + private function getFlexAccountsStorage(Config $config): array + { + $value = $config->get('system.accounts.storage', 'file'); + if (is_array($value)) { + return $value; + } + + if ($value === 'folder') { + return [ + 'class' => UserFolderStorage::class, + 'options' => [ + 'file' => 'user', + 'pattern' => '{FOLDER}/{KEY:2}/{KEY}/{FILE}{EXT}', + 'key' => 'storage_key', + 'indexed' => true, + 'case_sensitive' => false + ], + ]; + } + + if ($value === 'file') { + return [ + 'class' => UserFileStorage::class, + 'options' => [ + 'pattern' => '{FOLDER}/{KEY}{EXT}', + 'key' => 'username', + 'indexed' => true, + 'case_sensitive' => false + ], + ]; + } + + return []; + } +} diff --git a/system/src/Grav/Common/Service/InflectorServiceProvider.php b/system/src/Grav/Common/Service/InflectorServiceProvider.php new file mode 100644 index 0000000..fcb49aa --- /dev/null +++ b/system/src/Grav/Common/Service/InflectorServiceProvider.php @@ -0,0 +1,32 @@ +findResource('log://grav.log', true, true); + $log->pushHandler(new StreamHandler($log_file, Logger::DEBUG)); + + return $log; + }; + } +} diff --git a/system/src/Grav/Common/Service/OutputServiceProvider.php b/system/src/Grav/Common/Service/OutputServiceProvider.php new file mode 100644 index 0000000..91f507b --- /dev/null +++ b/system/src/Grav/Common/Service/OutputServiceProvider.php @@ -0,0 +1,39 @@ +processSite($page->templateFormat()); + }; + } +} diff --git a/system/src/Grav/Common/Service/PagesServiceProvider.php b/system/src/Grav/Common/Service/PagesServiceProvider.php new file mode 100644 index 0000000..dd1be13 --- /dev/null +++ b/system/src/Grav/Common/Service/PagesServiceProvider.php @@ -0,0 +1,140 @@ +findResource('system://pages/notfound.md'); + $page = new Page(); + $page->init(new SplFileInfo($path)); + $page->routable(false); + + return $page; + }; + + return; + } + + $container['page'] = static function (Grav $grav) { + /** @var Pages $pages */ + $pages = $grav['pages']; + + /** @var Config $config */ + $config = $grav['config']; + + /** @var Uri $uri */ + $uri = $grav['uri']; + + $path = $uri->path() ? urldecode($uri->path()) : '/'; // Don't trim to support trailing slash default routes + $page = $pages->dispatch($path); + + // Redirection tests + if ($page) { + // some debugger override logic + if ($page->debugger() === false) { + $grav['debugger']->enabled(false); + } + + if ($config->get('system.force_ssl')) { + $scheme = $uri->scheme(true); + if ($scheme !== 'https') { + $url = 'https://' . $uri->host() . $uri->uri(); + $grav->redirect($url); + } + } + + $route = $page->route(); + if ($route && \in_array($uri->method(), ['GET', 'HEAD'], true)) { + $pageExtension = $page->urlExtension(); + $url = $pages->route($route) . $pageExtension; + + if ($uri->params()) { + if ($url === '/') { //Avoid double slash + $url = $uri->params(); + } else { + $url .= $uri->params(); + } + } + if ($uri->query()) { + $url .= '?' . $uri->query(); + } + if ($uri->fragment()) { + $url .= '#' . $uri->fragment(); + } + + /** @var Language $language */ + $language = $grav['language']; + + $redirect_default_route = $page->header()->redirect_default_route ?? $config->get('system.pages.redirect_default_route', 0); + $redirectCode = (int) $redirect_default_route; + + // Language-specific redirection scenarios + if ($language->enabled() && ($language->isLanguageInUrl() xor $language->isIncludeDefaultLanguage())) { + $grav->redirect($url, $redirectCode); + } + + // Default route test and redirect + if ($redirectCode) { + $uriExtension = $uri->extension(); + $uriExtension = null !== $uriExtension ? '.' . $uriExtension : ''; + + if ($route !== $path || ($pageExtension !== $uriExtension + && \in_array($pageExtension, ['', '.htm', '.html'], true) + && \in_array($uriExtension, ['', '.htm', '.html'], true))) { + $grav->redirect($url, $redirectCode); + } + } + } + } + + // if page is not found, try some fallback stuff + if (!$page || !$page->routable()) { + // Try fallback URL stuff... + $page = $grav->fallbackUrl($path); + + if (!$page) { + $path = $grav['locator']->findResource('system://pages/notfound.md'); + $page = new Page(); + $page->init(new SplFileInfo($path)); + $page->routable(false); + } + } + + return $page; + }; + } +} diff --git a/system/src/Grav/Common/Service/RequestServiceProvider.php b/system/src/Grav/Common/Service/RequestServiceProvider.php new file mode 100644 index 0000000..ad9858f --- /dev/null +++ b/system/src/Grav/Common/Service/RequestServiceProvider.php @@ -0,0 +1,103 @@ + $headerValue) { + if ('content-type' !== strtolower($headerName)) { + continue; + } + + $contentType = strtolower(trim(explode(';', $headerValue, 2)[0])); + switch ($contentType) { + case 'application/x-www-form-urlencoded': + case 'multipart/form-data': + $post = $_POST; + break 2; + case 'application/json': + case 'application/vnd.api+json': + try { + $json = file_get_contents('php://input'); + $post = json_decode($json, true, 512, JSON_THROW_ON_ERROR); + if (!is_array($post)) { + $post = null; + } + } catch (JsonException $e) { + $post = null; + } + break 2; + } + } + } + + // Remove _url from ngnix routes. + $get = $_GET; + unset($get['_url']); + if (isset($server['QUERY_STRING'])) { + $query = $server['QUERY_STRING']; + if (strpos($query, '_url=') !== false) { + parse_str($query, $query); + unset($query['_url']); + $server['QUERY_STRING'] = http_build_query($query); + } + } + + return $creator->fromArrays($server, $headers, $_COOKIE, $get, $post, $_FILES, fopen('php://input', 'rb') ?: null); + }; + + $container['route'] = $container->factory(function () { + return clone Uri::getCurrentRoute(); + }); + } +} diff --git a/system/src/Grav/Common/Service/SchedulerServiceProvider.php b/system/src/Grav/Common/Service/SchedulerServiceProvider.php new file mode 100644 index 0000000..2fbe417 --- /dev/null +++ b/system/src/Grav/Common/Service/SchedulerServiceProvider.php @@ -0,0 +1,32 @@ +get('system.session.enabled', false); + $cookie_secure = $config->get('system.session.secure', false) + || ($config->get('system.session.secure_https', true) && $uri->scheme(true) === 'https'); + $cookie_httponly = (bool)$config->get('system.session.httponly', true); + $cookie_lifetime = (int)$config->get('system.session.timeout', 1800); + $cookie_domain = $config->get('system.session.domain'); + $cookie_path = $config->get('system.session.path'); + $cookie_samesite = $config->get('system.session.samesite', 'Lax'); + + if (null === $cookie_domain) { + $cookie_domain = $uri->host(); + if ($cookie_domain === 'localhost') { + $cookie_domain = ''; + } + } + + if (null === $cookie_path) { + $cookie_path = '/' . trim(Uri::filterPath($uri->rootUrl(false)), '/'); + } + // Session cookie path requires trailing slash. + $cookie_path = rtrim($cookie_path, '/') . '/'; + + // Activate admin if we're inside the admin path. + $is_admin = false; + if ($config->get('plugins.admin.enabled')) { + $admin_base = '/' . trim($config->get('plugins.admin.route'), '/'); + + // Uri::route() is not processed yet, let's quickly get what we need. + $current_route = str_replace(Uri::filterPath($uri->rootUrl(false)), '', parse_url($uri->url(true), PHP_URL_PATH)); + + // Test to see if path starts with a supported language + admin base + $lang = Utils::pathPrefixedByLangCode($current_route); + $lang_admin_base = '/' . $lang . $admin_base; + + // Check no language, simple language prefix (en) and region specific language prefix (en-US). + if (Utils::startsWith($current_route, $admin_base) || Utils::startsWith($current_route, $lang_admin_base)) { + $cookie_lifetime = $config->get('plugins.admin.session.timeout', 1800); + $enabled = $is_admin = true; + } + } + + // Fix for HUGE session timeouts. + if ($cookie_lifetime > 99999999999) { + $cookie_lifetime = 9999999999; + } + + $session_prefix = $c['inflector']->hyphenize($config->get('system.session.name', 'grav-site')); + $session_uniqueness = $config->get('system.session.uniqueness', 'path') === 'path' ? substr(md5(GRAV_ROOT), 0, 7) : md5($config->get('security.salt')); + + $session_name = $session_prefix . '-' . $session_uniqueness; + + if ($is_admin && $config->get('system.session.split', true)) { + $session_name .= '-admin'; + } + + // Define session service. + $options = [ + 'name' => $session_name, + 'cookie_lifetime' => $cookie_lifetime, + 'cookie_path' => $cookie_path, + 'cookie_domain' => $cookie_domain, + 'cookie_secure' => $cookie_secure, + 'cookie_httponly' => $cookie_httponly, + 'cookie_samesite' => $cookie_samesite + ] + (array) $config->get('system.session.options'); + + $session = new Session($options); + $session->setAutoStart($enabled); + + return $session; + }; + + // Define session message service. + $container['messages'] = function ($c) { + if (!isset($c['session']) || !$c['session']->isStarted()) { + /** @var Debugger $debugger */ + $debugger = $c['debugger']; + $debugger->addMessage('Inactive session: session messages may disappear', 'warming'); + + return new Messages(); + } + + /** @var Session $session */ + $session = $c['session']; + + if (!$session->messages instanceof Messages) { + $session->messages = new Messages(); + } + + return $session->messages; + }; + } +} diff --git a/system/src/Grav/Common/Service/StreamsServiceProvider.php b/system/src/Grav/Common/Service/StreamsServiceProvider.php new file mode 100644 index 0000000..a13ea40 --- /dev/null +++ b/system/src/Grav/Common/Service/StreamsServiceProvider.php @@ -0,0 +1,56 @@ +initializeLocator($locator); + + return $locator; + }; + + $container['streams'] = function (Container $container) { + /** @var Setup $setup */ + $setup = $container['setup']; + + /** @var UniformResourceLocator $locator */ + $locator = $container['locator']; + + // Set locator to both streams. + Stream::setLocator($locator); + ReadOnlyStream::setLocator($locator); + + return new StreamBuilder($setup->getStreams()); + }; + } +} diff --git a/system/src/Grav/Common/Service/TaskServiceProvider.php b/system/src/Grav/Common/Service/TaskServiceProvider.php new file mode 100644 index 0000000..46ab704 --- /dev/null +++ b/system/src/Grav/Common/Service/TaskServiceProvider.php @@ -0,0 +1,55 @@ +getParsedBody(); + + $task = $body['task'] ?? $c['uri']->param('task'); + if (null !== $task) { + $task = htmlspecialchars(strip_tags($task), ENT_QUOTES, 'UTF-8'); + } + + return $task ?: null; + }; + + $container['action'] = function (Grav $c) { + /** @var ServerRequestInterface $request */ + $request = $c['request']; + $body = $request->getParsedBody(); + + $action = $body['action'] ?? $c['uri']->param('action'); + if (null !== $action) { + $action = htmlspecialchars(strip_tags($action), ENT_QUOTES, 'UTF-8'); + } + + return $action ?: null; + }; + } +} diff --git a/system/src/Grav/Common/Session.php b/system/src/Grav/Common/Session.php new file mode 100644 index 0000000..a75e083 --- /dev/null +++ b/system/src/Grav/Common/Session.php @@ -0,0 +1,202 @@ +getInstance() method instead. + */ + public static function instance() + { + user_error(__CLASS__ . '::' . __FUNCTION__ . '() is deprecated since Grav 1.5, use ->getInstance() method instead', E_USER_DEPRECATED); + + return static::getInstance(); + } + + /** + * Initialize session. + * + * Code in this function has been moved into SessionServiceProvider class. + * + * @return void + */ + public function init() + { + if ($this->autoStart && !$this->isStarted()) { + $this->start(); + + $this->autoStart = false; + } + } + + /** + * @param bool $auto + * @return $this + */ + public function setAutoStart($auto) + { + $this->autoStart = (bool)$auto; + + return $this; + } + + /** + * Returns attributes. + * + * @return array Attributes + * @deprecated 1.5 Use ->getAll() method instead. + */ + public function all() + { + user_error(__CLASS__ . '::' . __FUNCTION__ . '() is deprecated since Grav 1.5, use ->getAll() method instead', E_USER_DEPRECATED); + + return $this->getAll(); + } + + /** + * Checks if the session was started. + * + * @return bool + * @deprecated 1.5 Use ->isStarted() method instead. + */ + public function started() + { + user_error(__CLASS__ . '::' . __FUNCTION__ . '() is deprecated since Grav 1.5, use ->isStarted() method instead', E_USER_DEPRECATED); + + return $this->isStarted(); + } + + /** + * Store something in session temporarily. + * + * @param string $name + * @param mixed $object + * @return $this + */ + public function setFlashObject($name, $object) + { + $this->__set($name, serialize($object)); + + return $this; + } + + /** + * Return object and remove it from session. + * + * @param string $name + * @return mixed + */ + public function getFlashObject($name) + { + $serialized = $this->__get($name); + + $object = is_string($serialized) ? unserialize($serialized, ['allowed_classes' => true]) : $serialized; + + $this->__unset($name); + + if ($name === 'files-upload') { + $grav = Grav::instance(); + + // Make sure that Forms 3.0+ has been installed. + if (null === $object && isset($grav['forms'])) { +// user_error( +// __CLASS__ . '::' . __FUNCTION__ . '(\'files-upload\') is deprecated since Grav 1.6, use $form->getFlash()->getLegacyFiles() instead', +// E_USER_DEPRECATED +// ); + + /** @var Uri $uri */ + $uri = $grav['uri']; + /** @var Forms|null $form */ + $form = $grav['forms']->getActiveForm(); // @phpstan-ignore-line (form plugin) + + $sessionField = base64_encode($uri->url); + + /** @var FormFlash|null $flash */ + $flash = $form ? $form->getFlash() : null; // @phpstan-ignore-line (form plugin) + $object = $flash && method_exists($flash, 'getLegacyFiles') ? [$sessionField => $flash->getLegacyFiles()] : null; + } + } + + return $object; + } + + /** + * Store something in cookie temporarily. + * + * @param string $name + * @param mixed $object + * @param int $time + * @return $this + * @throws JsonException + */ + public function setFlashCookieObject($name, $object, $time = 60) + { + setcookie($name, json_encode($object, JSON_THROW_ON_ERROR), $this->getCookieOptions($time)); + + return $this; + } + + /** + * Return object and remove it from the cookie. + * + * @param string $name + * @return mixed|null + * @throws JsonException + */ + public function getFlashCookieObject($name) + { + if (isset($_COOKIE[$name])) { + $cookie = $_COOKIE[$name]; + setcookie($name, '', $this->getCookieOptions(-42000)); + + return json_decode($cookie, false, 512, JSON_THROW_ON_ERROR); + } + + return null; + } + + /** + * @return void + */ + protected function onBeforeSessionStart(): void + { + $event = new BeforeSessionStartEvent($this); + + $grav = Grav::instance(); + $grav->dispatchEvent($event); + } + + /** + * @return void + */ + protected function onSessionStart(): void + { + $event = new SessionStartEvent($this); + + $grav = Grav::instance(); + $grav->dispatchEvent($event); + } +} diff --git a/system/src/Grav/Common/Taxonomy.php b/system/src/Grav/Common/Taxonomy.php new file mode 100644 index 0000000..d9cb930 --- /dev/null +++ b/system/src/Grav/Common/Taxonomy.php @@ -0,0 +1,176 @@ +taxonomy_map = []; + $this->grav = $grav; + } + + /** + * Takes an individual page and processes the taxonomies configured in its header. It + * then adds those taxonomies to the map + * + * @param PageInterface $page the page to process + * @param array|null $page_taxonomy + */ + public function addTaxonomy(PageInterface $page, $page_taxonomy = null) + { + if (!$page->published()) { + return; + } + + if (!$page_taxonomy) { + $page_taxonomy = $page->taxonomy(); + } + + if (empty($page_taxonomy)) { + return; + } + + /** @var Config $config */ + $config = $this->grav['config']; + $taxonomies = (array)$config->get('site.taxonomies'); + foreach ($taxonomies as $taxonomy) { + // Skip invalid taxonomies. + if (!\is_string($taxonomy)) { + continue; + } + $current = $page_taxonomy[$taxonomy] ?? null; + foreach ((array)$current as $item) { + $this->iterateTaxonomy($page, $taxonomy, '', $item); + } + } + } + + /** + * Iterate through taxonomy fields + * + * Reduces [taxonomy_type] to dot-notation where necessary + * + * @param PageInterface $page The Page to process + * @param string $taxonomy Taxonomy type to add + * @param string $key Taxonomy type to concatenate + * @param iterable|string $value Taxonomy value to add or iterate + * @return void + */ + public function iterateTaxonomy(PageInterface $page, string $taxonomy, string $key, $value) + { + if (is_iterable($value)) { + foreach ($value as $identifier => $item) { + $identifier = "{$key}.{$identifier}"; + $this->iterateTaxonomy($page, $taxonomy, $identifier, $item); + } + } elseif (is_string($value)) { + if (!empty($key)) { + $taxonomy .= $key; + } + $this->taxonomy_map[$taxonomy][(string) $value][$page->path()] = ['slug' => $page->slug()]; + } + } + + /** + * Returns a new Page object with the sub-pages containing all the values set for a + * particular taxonomy. + * + * @param array $taxonomies taxonomies to search, eg ['tag'=>['animal','cat']] + * @param string $operator can be 'or' or 'and' (defaults to 'and') + * @return Collection Collection object set to contain matches found in the taxonomy map + */ + public function findTaxonomy($taxonomies, $operator = 'and') + { + $matches = []; + $results = []; + + foreach ((array)$taxonomies as $taxonomy => $items) { + foreach ((array)$items as $item) { + if (isset($this->taxonomy_map[$taxonomy][$item])) { + $matches[] = $this->taxonomy_map[$taxonomy][$item]; + } else { + $matches[] = []; + } + } + } + + if (strtolower($operator) === 'or') { + foreach ($matches as $match) { + $results = array_merge($results, $match); + } + } else { + $results = $matches ? array_pop($matches) : []; + foreach ($matches as $match) { + $results = array_intersect_key($results, $match); + } + } + + return new Collection($results, ['taxonomies' => $taxonomies]); + } + + /** + * Gets and Sets the taxonomy map + * + * @param array|null $var the taxonomy map + * @return array the taxonomy map + */ + public function taxonomy($var = null) + { + if ($var) { + $this->taxonomy_map = $var; + } + + return $this->taxonomy_map; + } + + /** + * Gets item keys per taxonomy + * + * @param string $taxonomy taxonomy name + * @return array keys of this taxonomy + */ + public function getTaxonomyItemKeys($taxonomy) + { + return isset($this->taxonomy_map[$taxonomy]) ? array_keys($this->taxonomy_map[$taxonomy]) : []; + } +} diff --git a/system/src/Grav/Common/Theme.php b/system/src/Grav/Common/Theme.php new file mode 100644 index 0000000..e800245 --- /dev/null +++ b/system/src/Grav/Common/Theme.php @@ -0,0 +1,87 @@ +config["themes.{$this->name}"] ?? []; + } + + /** + * Persists to disk the theme parameters currently stored in the Grav Config object + * + * @param string $name The name of the theme whose config it should store. + * @return bool + */ + public static function saveConfig($name) + { + if (!$name) { + return false; + } + + $grav = Grav::instance(); + + /** @var UniformResourceLocator $locator */ + $locator = $grav['locator']; + + $filename = 'config://themes/' . $name . '.yaml'; + $file = YamlFile::instance((string)$locator->findResource($filename, true, true)); + $content = $grav['config']->get('themes.' . $name); + $file->save($content); + $file->free(); + unset($file); + + return true; + } + + /** + * Load blueprints. + * + * @return void + */ + protected function loadBlueprint() + { + if (!$this->blueprint) { + $grav = Grav::instance(); + /** @var Themes $themes */ + $themes = $grav['themes']; + $data = $themes->get($this->name); + \assert($data !== null); + $this->blueprint = $data->blueprints(); + } + } +} diff --git a/system/src/Grav/Common/Themes.php b/system/src/Grav/Common/Themes.php new file mode 100644 index 0000000..75bd8b1 --- /dev/null +++ b/system/src/Grav/Common/Themes.php @@ -0,0 +1,417 @@ +grav = $grav; + $this->config = $grav['config']; + + // Register instance as autoloader for theme inheritance + spl_autoload_register([$this, 'autoloadTheme']); + } + + /** + * @return void + */ + public function init() + { + /** @var Themes $themes */ + $themes = $this->grav['themes']; + $themes->configure(); + + $this->initTheme(); + } + + /** + * @return void + */ + public function initTheme() + { + if ($this->inited === false) { + /** @var Themes $themes */ + $themes = $this->grav['themes']; + + try { + $instance = $themes->load(); + } catch (InvalidArgumentException $e) { + throw new RuntimeException($this->current() . ' theme could not be found'); + } + + // Register autoloader. + if (method_exists($instance, 'autoload')) { + $instance->autoload(); + } + + // Register event listeners. + if ($instance instanceof EventSubscriberInterface) { + /** @var EventDispatcher $events */ + $events = $this->grav['events']; + $events->addSubscriber($instance); + } + + // Register blueprints. + if (is_dir('theme://blueprints/pages')) { + /** @var UniformResourceLocator $locator */ + $locator = $this->grav['locator']; + $locator->addPath('blueprints', '', ['theme://blueprints'], ['user', 'blueprints']); + } + + // Register form fields. + if (method_exists($instance, 'getFormFieldTypes')) { + /** @var Plugins $plugins */ + $plugins = $this->grav['plugins']; + $plugins->formFieldTypes = $instance->getFormFieldTypes() + $plugins->formFieldTypes; + } + + $this->grav['theme'] = $instance; + + $this->grav->fireEvent('onThemeInitialized'); + + $this->inited = true; + } + } + + /** + * Return list of all theme data with their blueprints. + * + * @return array + */ + public function all() + { + $list = []; + + /** @var UniformResourceLocator $locator */ + $locator = $this->grav['locator']; + + $iterator = $locator->getIterator('themes://'); + + /** @var DirectoryIterator $directory */ + foreach ($iterator as $directory) { + if (!$directory->isDir() || $directory->isDot()) { + continue; + } + + $theme = $directory->getFilename(); + + try { + $result = $this->get($theme); + } catch (Exception $e) { + $exception = new RuntimeException(sprintf('Theme %s: %s', $theme, $e->getMessage()), $e->getCode(), $e); + + /** @var Debugger $debugger */ + $debugger = $this->grav['debugger']; + $debugger->addMessage("Theme {$theme} cannot be loaded, please check Exceptions tab", 'error'); + $debugger->addException($exception); + + continue; + } + + if ($result) { + $list[$theme] = $result; + } + } + ksort($list, SORT_NATURAL | SORT_FLAG_CASE); + + return $list; + } + + /** + * Get theme configuration or throw exception if it cannot be found. + * + * @param string $name + * @return Data|null + * @throws RuntimeException + */ + public function get($name) + { + if (!$name) { + throw new RuntimeException('Theme name not provided.'); + } + + $blueprints = new Blueprints('themes://'); + $blueprint = $blueprints->get("{$name}/blueprints"); + + // Load default configuration. + $file = CompiledYamlFile::instance("themes://{$name}/{$name}" . YAML_EXT); + + // ensure this is a valid theme + if (!$file->exists()) { + return null; + } + + // Find thumbnail. + $thumb = "themes://{$name}/thumbnail.jpg"; + $path = $this->grav['locator']->findResource($thumb, false); + + if ($path) { + $blueprint->set('thumbnail', $this->grav['base_url'] . '/' . $path); + } + + $obj = new Data((array)$file->content(), $blueprint); + + // Override with user configuration. + $obj->merge($this->config->get('themes.' . $name) ?: []); + + // Save configuration always to user/config. + $file = CompiledYamlFile::instance("config://themes/{$name}" . YAML_EXT); + $obj->file($file); + + return $obj; + } + + /** + * Return name of the current theme. + * + * @return string + */ + public function current() + { + return (string)$this->config->get('system.pages.theme'); + } + + /** + * Load current theme. + * + * @return Theme + */ + public function load() + { + // NOTE: ALL THE LOCAL VARIABLES ARE USED INSIDE INCLUDED FILE, DO NOT REMOVE THEM! + $grav = $this->grav; + $config = $this->config; + $name = $this->current(); + $class = null; + + /** @var UniformResourceLocator $locator */ + $locator = $grav['locator']; + + // Start by attempting to load the theme.php file. + $file = $locator('theme://theme.php') ?: $locator("theme://{$name}.php"); + if ($file) { + // Local variables available in the file: $grav, $config, $name, $file + $class = include $file; + if (!\is_object($class) || !is_subclass_of($class, Theme::class, true)) { + $class = null; + } + } elseif (!$locator('theme://') && !defined('GRAV_CLI')) { + $response = new Response(500, [], "Theme '$name' does not exist, unable to display page."); + + $grav->close($response); + } + + // If the class hasn't been initialized yet, guess the class name and create a new instance. + if (null === $class) { + $themeClassFormat = [ + 'Grav\\Theme\\' . Inflector::camelize($name), + 'Grav\\Theme\\' . ucfirst($name) + ]; + + foreach ($themeClassFormat as $themeClass) { + if (is_subclass_of($themeClass, Theme::class, true)) { + $class = new $themeClass($grav, $config, $name); + break; + } + } + } + + // Finally if everything else fails, just create a new instance from the default Theme class. + if (null === $class) { + $class = new Theme($grav, $config, $name); + } + + $this->config->set('theme', $config->get('themes.' . $name)); + + return $class; + } + + /** + * Configure and prepare streams for current template. + * + * @return void + * @throws InvalidArgumentException + */ + public function configure() + { + $name = $this->current(); + $config = $this->config; + + $this->loadConfiguration($name, $config); + + /** @var UniformResourceLocator $locator */ + $locator = $this->grav['locator']; + + $registered = stream_get_wrappers(); + + $schemes = $config->get("themes.{$name}.streams.schemes", []); + $schemes += [ + 'theme' => [ + 'type' => 'ReadOnlyStream', + 'paths' => $locator->findResources("themes://{$name}", false) + ] + ]; + + foreach ($schemes as $scheme => $config) { + if (isset($config['paths'])) { + $locator->addPath($scheme, '', $config['paths']); + } + if (isset($config['prefixes'])) { + foreach ($config['prefixes'] as $prefix => $paths) { + $locator->addPath($scheme, $prefix, $paths); + } + } + + if (in_array($scheme, $registered, true)) { + stream_wrapper_unregister($scheme); + } + $type = !empty($config['type']) ? $config['type'] : 'ReadOnlyStream'; + if ($type[0] !== '\\') { + $type = '\\RocketTheme\\Toolbox\\StreamWrapper\\' . $type; + } + + if (!stream_wrapper_register($scheme, $type)) { + throw new InvalidArgumentException("Stream '{$type}' could not be initialized."); + } + } + + // Load languages after streams has been properly initialized + $this->loadLanguages($this->config); + } + + /** + * Load theme configuration. + * + * @param string $name Theme name + * @param Config $config Configuration class + * @return void + */ + protected function loadConfiguration($name, Config $config) + { + $themeConfig = CompiledYamlFile::instance("themes://{$name}/{$name}" . YAML_EXT)->content(); + $config->joinDefaults("themes.{$name}", $themeConfig); + } + + /** + * Load theme languages. + * Reads ALL language files from theme stream and merges them. + * + * @param Config $config Configuration class + * @return void + */ + protected function loadLanguages(Config $config) + { + /** @var UniformResourceLocator $locator */ + $locator = $this->grav['locator']; + + if ($config->get('system.languages.translations', true)) { + $language_files = array_reverse($locator->findResources('theme://languages' . YAML_EXT)); + foreach ($language_files as $language_file) { + $language = CompiledYamlFile::instance($language_file)->content(); + $this->grav['languages']->mergeRecursive($language); + } + $languages_folders = array_reverse($locator->findResources('theme://languages')); + foreach ($languages_folders as $languages_folder) { + $languages = []; + $iterator = new DirectoryIterator($languages_folder); + foreach ($iterator as $file) { + if ($file->getExtension() !== 'yaml') { + continue; + } + $languages[$file->getBasename('.yaml')] = CompiledYamlFile::instance($file->getPathname())->content(); + } + $this->grav['languages']->mergeRecursive($languages); + } + } + } + + /** + * Autoload theme classes for inheritance + * + * @param string $class Class name + * @return mixed|false FALSE if unable to load $class; Class name if + * $class is successfully loaded + */ + protected function autoloadTheme($class) + { + $prefix = 'Grav\\Theme\\'; + if (false !== strpos($class, $prefix)) { + // Remove prefix from class + $class = substr($class, strlen($prefix)); + $locator = $this->grav['locator']; + + // First try lowercase version of the classname. + $path = strtolower($class); + $file = $locator("themes://{$path}/theme.php") ?: $locator("themes://{$path}/{$path}.php"); + + if ($file) { + return include_once $file; + } + + // Replace namespace tokens to directory separators + $path = $this->grav['inflector']->hyphenize($class); + $file = $locator("themes://{$path}/theme.php") ?: $locator("themes://{$path}/{$path}.php"); + + // Load class + if ($file) { + return include_once $file; + } + + // Try Old style theme classes + $path = preg_replace('#\\\|_(?!.+\\\)#', '/', $class); + \assert(null !== $path); + + $path = strtolower($path); + $file = $locator("themes://{$path}/theme.php") ?: $locator("themes://{$path}/{$path}.php"); + + // Load class + if ($file) { + return include_once $file; + } + } + + return false; + } +} diff --git a/system/src/Grav/Common/Twig/Exception/TwigException.php b/system/src/Grav/Common/Twig/Exception/TwigException.php new file mode 100644 index 0000000..19e0529 --- /dev/null +++ b/system/src/Grav/Common/Twig/Exception/TwigException.php @@ -0,0 +1,21 @@ +locator = Grav::instance()['locator']; + } + + /** + * @return TwigFilter[] + */ + public function getFilters() + { + return [ + new TwigFilter('file_exists', [$this, 'file_exists']), + new TwigFilter('fileatime', [$this, 'fileatime']), + new TwigFilter('filectime', [$this, 'filectime']), + new TwigFilter('filemtime', [$this, 'filemtime']), + new TwigFilter('filesize', [$this, 'filesize']), + new TwigFilter('filetype', [$this, 'filetype']), + new TwigFilter('is_dir', [$this, 'is_dir']), + new TwigFilter('is_file', [$this, 'is_file']), + new TwigFilter('is_link', [$this, 'is_link']), + new TwigFilter('is_readable', [$this, 'is_readable']), + new TwigFilter('is_writable', [$this, 'is_writable']), + new TwigFilter('is_writeable', [$this, 'is_writable']), + new TwigFilter('lstat', [$this, 'lstat']), + new TwigFilter('getimagesize', [$this, 'getimagesize']), + new TwigFilter('exif_read_data', [$this, 'exif_read_data']), + new TwigFilter('read_exif_data', [$this, 'exif_read_data']), + new TwigFilter('exif_imagetype', [$this, 'exif_imagetype']), + new TwigFilter('hash_file', [$this, 'hash_file']), + new TwigFilter('hash_hmac_file', [$this, 'hash_hmac_file']), + new TwigFilter('md5_file', [$this, 'md5_file']), + new TwigFilter('sha1_file', [$this, 'sha1_file']), + new TwigFilter('get_meta_tags', [$this, 'get_meta_tags']), + new TwigFilter('pathinfo', [$this, 'pathinfo']), + ]; + } + + /** + * Return a list of all functions. + * + * @return TwigFunction[] + */ + public function getFunctions() + { + return [ + new TwigFunction('file_exists', [$this, 'file_exists']), + new TwigFunction('fileatime', [$this, 'fileatime']), + new TwigFunction('filectime', [$this, 'filectime']), + new TwigFunction('filemtime', [$this, 'filemtime']), + new TwigFunction('filesize', [$this, 'filesize']), + new TwigFunction('filetype', [$this, 'filetype']), + new TwigFunction('is_dir', [$this, 'is_dir']), + new TwigFunction('is_file', [$this, 'is_file']), + new TwigFunction('is_link', [$this, 'is_link']), + new TwigFunction('is_readable', [$this, 'is_readable']), + new TwigFunction('is_writable', [$this, 'is_writable']), + new TwigFunction('is_writeable', [$this, 'is_writable']), + new TwigFunction('lstat', [$this, 'lstat']), + new TwigFunction('getimagesize', [$this, 'getimagesize']), + new TwigFunction('exif_read_data', [$this, 'exif_read_data']), + new TwigFunction('read_exif_data', [$this, 'exif_read_data']), + new TwigFunction('exif_imagetype', [$this, 'exif_imagetype']), + new TwigFunction('hash_file', [$this, 'hash_file']), + new TwigFunction('hash_hmac_file', [$this, 'hash_hmac_file']), + new TwigFunction('md5_file', [$this, 'md5_file']), + new TwigFunction('sha1_file', [$this, 'sha1_file']), + new TwigFunction('get_meta_tags', [$this, 'get_meta_tags']), + new TwigFunction('pathinfo', [$this, 'pathinfo']), + ]; + } + + /** + * @param string $filename + * @return bool + */ + public function file_exists($filename): bool + { + if (!$this->checkFilename($filename)) { + return false; + } + + return file_exists($filename); + } + + /** + * @param string $filename + * @return int|false + */ + public function fileatime($filename) + { + if (!$this->checkFilename($filename)) { + return false; + } + + return fileatime($filename); + } + + /** + * @param string $filename + * @return int|false + */ + public function filectime($filename) + { + if (!$this->checkFilename($filename)) { + return false; + } + + return filectime($filename); + } + + /** + * @param string $filename + * @return int|false + */ + public function filemtime($filename) + { + if (!$this->checkFilename($filename)) { + return false; + } + + return filemtime($filename); + } + + /** + * @param string $filename + * @return int|false + */ + public function filesize($filename) + { + if (!$this->checkFilename($filename)) { + return false; + } + + return filesize($filename); + } + + /** + * @param string $filename + * @return string|false + */ + public function filetype($filename) + { + if (!$this->checkFilename($filename)) { + return false; + } + + return filetype($filename); + } + + /** + * @param string $filename + * @return bool + */ + public function is_dir($filename): bool + { + if (!$this->checkFilename($filename)) { + return false; + } + + return is_dir($filename); + } + + /** + * @param string $filename + * @return bool + */ + public function is_file($filename): bool + { + if (!$this->checkFilename($filename)) { + return false; + } + + return is_file($filename); + } + + /** + * @param string $filename + * @return bool + */ + public function is_link($filename): bool + { + if (!$this->checkFilename($filename)) { + return false; + } + + return is_link($filename); + } + + /** + * @param string $filename + * @return bool + */ + public function is_readable($filename): bool + { + if (!$this->checkFilename($filename)) { + return false; + } + + return is_readable($filename); + } + + /** + * @param string $filename + * @return bool + */ + public function is_writable($filename): bool + { + if (!$this->checkFilename($filename)) { + return false; + } + + return is_writable($filename); + } + + /** + * @param string $filename + * @return array|false + */ + public function lstat($filename) + { + if (!$this->checkFilename($filename)) { + return false; + } + + return lstat($filename); + } + + /** + * @param string $filename + * @return array|false + */ + public function getimagesize($filename) + { + if (!$this->checkFilename($filename)) { + return false; + } + + return getimagesize($filename); + } + + /** + * @param string $filename + * @param string|null $required_sections + * @param bool $as_arrays + * @param bool $read_thumbnail + * @return array|false + */ + public function exif_read_data($filename, ?string $required_sections, bool $as_arrays = false, bool $read_thumbnail = false) + { + if (!Utils::functionExists('exif_read_data') || !$this->checkFilename($filename)) { + return false; + } + + return exif_read_data($filename, $required_sections, $as_arrays, $read_thumbnail); + } + + /** + * @param string $filename + * @return int|false + */ + public function exif_imagetype($filename) + { + if (!Utils::functionExists('exif_imagetype') || !$this->checkFilename($filename)) { + return false; + } + + return @exif_imagetype($filename); + } + + /** + * @param string $algo + * @param string $filename + * @param bool $binary + * @return string|false + */ + public function hash_file(string $algo, string $filename, bool $binary = false) + { + if (!$this->checkFilename($filename)) { + return false; + } + + return hash_file($algo, $filename, $binary); + } + + /** + * @param string $algo + * @param string $filename + * @param string $key + * @param bool $binary + * @return string|false + */ + public function hash_hmac_file(string $algo, string $filename, string $key, bool $binary = false) + { + if (!$this->checkFilename($filename)) { + return false; + } + + return hash_hmac_file($algo, $filename, $key, $binary); + } + + /** + * @param string $filename + * @param bool $binary + * @return string|false + */ + public function md5_file($filename, bool $binary = false) + { + if (!$this->checkFilename($filename)) { + return false; + } + + return md5_file($filename, $binary); + } + + /** + * @param string $filename + * @param bool $binary + * @return string|false + */ + public function sha1_file($filename, bool $binary = false) + { + if (!$this->checkFilename($filename)) { + return false; + } + + return sha1_file($filename, $binary); + } + + /** + * @param string $filename + * @return array|false + */ + public function get_meta_tags($filename) + { + if (!$this->checkFilename($filename)) { + return false; + } + + return get_meta_tags($filename); + } + + /** + * @param string $path + * @param int|null $flags + * @return string|string[] + */ + public function pathinfo($path, $flags = null) + { + return Utils::pathinfo($path, $flags); + } + + /** + * @param string $filename + * @return bool + */ + private function checkFilename($filename): bool + { + return is_string($filename) && (!str_contains($filename, '://') || $this->locator->isStream($filename)); + } +} diff --git a/system/src/Grav/Common/Twig/Extension/GravExtension.php b/system/src/Grav/Common/Twig/Extension/GravExtension.php new file mode 100644 index 0000000..3e30a02 --- /dev/null +++ b/system/src/Grav/Common/Twig/Extension/GravExtension.php @@ -0,0 +1,1756 @@ +grav = Grav::instance(); + $this->debugger = $this->grav['debugger'] ?? null; + $this->config = $this->grav['config']; + } + + /** + * Register some standard globals + * + * @return array + */ + public function getGlobals(): array + { + return [ + 'grav' => $this->grav, + ]; + } + + /** + * Return a list of all filters. + * + * @return array + */ + public function getFilters(): array + { + return [ + new TwigFilter('*ize', [$this, 'inflectorFilter']), + new TwigFilter('absolute_url', [$this, 'absoluteUrlFilter']), + new TwigFilter('contains', [$this, 'containsFilter']), + new TwigFilter('chunk_split', [$this, 'chunkSplitFilter']), + new TwigFilter('nicenumber', [$this, 'niceNumberFunc']), + new TwigFilter('nicefilesize', [$this, 'niceFilesizeFunc']), + new TwigFilter('nicetime', [$this, 'nicetimeFunc']), + new TwigFilter('defined', [$this, 'definedDefaultFilter']), + new TwigFilter('ends_with', [$this, 'endsWithFilter']), + new TwigFilter('fieldName', [$this, 'fieldNameFilter']), + new TwigFilter('parent_field', [$this, 'fieldParentFilter']), + new TwigFilter('ksort', [$this, 'ksortFilter']), + new TwigFilter('ltrim', [$this, 'ltrimFilter']), + new TwigFilter('markdown', [$this, 'markdownFunction'], ['needs_context' => true, 'is_safe' => ['html']]), + new TwigFilter('md5', [$this, 'md5Filter']), + new TwigFilter('base32_encode', [$this, 'base32EncodeFilter']), + new TwigFilter('base32_decode', [$this, 'base32DecodeFilter']), + new TwigFilter('base64_encode', [$this, 'base64EncodeFilter']), + new TwigFilter('base64_decode', [$this, 'base64DecodeFilter']), + new TwigFilter('randomize', [$this, 'randomizeFilter']), + new TwigFilter('modulus', [$this, 'modulusFilter']), + new TwigFilter('rtrim', [$this, 'rtrimFilter']), + new TwigFilter('pad', [$this, 'padFilter']), + new TwigFilter('regex_replace', [$this, 'regexReplace']), + new TwigFilter('safe_email', [$this, 'safeEmailFilter'], ['is_safe' => ['html']]), + new TwigFilter('safe_truncate', [Utils::class, 'safeTruncate']), + new TwigFilter('safe_truncate_html', [Utils::class, 'safeTruncateHTML']), + new TwigFilter('sort_by_key', [$this, 'sortByKeyFilter']), + new TwigFilter('starts_with', [$this, 'startsWithFilter']), + new TwigFilter('truncate', [Utils::class, 'truncate']), + new TwigFilter('truncate_html', [Utils::class, 'truncateHTML']), + new TwigFilter('json_decode', [$this, 'jsonDecodeFilter']), + new TwigFilter('array_unique', 'array_unique'), + new TwigFilter('basename', 'basename'), + new TwigFilter('dirname', 'dirname'), + new TwigFilter('print_r', [$this, 'print_r']), + new TwigFilter('yaml_encode', [$this, 'yamlEncodeFilter']), + new TwigFilter('yaml_decode', [$this, 'yamlDecodeFilter']), + new TwigFilter('nicecron', [$this, 'niceCronFilter']), + new TwigFilter('replace_last', [$this, 'replaceLastFilter']), + + // Translations + new TwigFilter('t', [$this, 'translate'], ['needs_environment' => true]), + new TwigFilter('tl', [$this, 'translateLanguage']), + new TwigFilter('ta', [$this, 'translateArray']), + + // Casting values + new TwigFilter('string', [$this, 'stringFilter']), + new TwigFilter('int', [$this, 'intFilter'], ['is_safe' => ['all']]), + new TwigFilter('bool', [$this, 'boolFilter']), + new TwigFilter('float', [$this, 'floatFilter'], ['is_safe' => ['all']]), + new TwigFilter('array', [$this, 'arrayFilter']), + new TwigFilter('yaml', [$this, 'yamlFilter']), + + // Object Types + new TwigFilter('get_type', [$this, 'getTypeFunc']), + new TwigFilter('of_type', [$this, 'ofTypeFunc']), + + // PHP methods + new TwigFilter('count', 'count'), + new TwigFilter('array_diff', 'array_diff'), + + // Security fixes + new TwigFilter('filter', [$this, 'filterFunc'], ['needs_environment' => true]), + new TwigFilter('map', [$this, 'mapFunc'], ['needs_environment' => true]), + new TwigFilter('reduce', [$this, 'reduceFunc'], ['needs_environment' => true]), + ]; + } + + /** + * Return a list of all functions. + * + * @return array + */ + public function getFunctions(): array + { + return [ + new TwigFunction('array', [$this, 'arrayFilter']), + new TwigFunction('array_key_value', [$this, 'arrayKeyValueFunc']), + new TwigFunction('array_key_exists', 'array_key_exists'), + new TwigFunction('array_unique', 'array_unique'), + new TwigFunction('array_intersect', [$this, 'arrayIntersectFunc']), + new TwigFunction('array_diff', 'array_diff'), + new TwigFunction('authorize', [$this, 'authorize']), + new TwigFunction('debug', [$this, 'dump'], ['needs_context' => true, 'needs_environment' => true]), + new TwigFunction('dump', [$this, 'dump'], ['needs_context' => true, 'needs_environment' => true]), + new TwigFunction('vardump', [$this, 'vardumpFunc']), + new TwigFunction('print_r', [$this, 'print_r']), + new TwigFunction('http_response_code', 'http_response_code'), + new TwigFunction('evaluate', [$this, 'evaluateStringFunc'], ['needs_context' => true]), + new TwigFunction('evaluate_twig', [$this, 'evaluateTwigFunc'], ['needs_context' => true]), + new TwigFunction('gist', [$this, 'gistFunc']), + new TwigFunction('nonce_field', [$this, 'nonceFieldFunc']), + new TwigFunction('pathinfo', 'pathinfo'), + new TwigFunction('parseurl', 'parse_url'), + new TwigFunction('random_string', [$this, 'randomStringFunc']), + new TwigFunction('repeat', [$this, 'repeatFunc']), + new TwigFunction('regex_replace', [$this, 'regexReplace']), + new TwigFunction('regex_filter', [$this, 'regexFilter']), + new TwigFunction('regex_match', [$this, 'regexMatch']), + new TwigFunction('regex_split', [$this, 'regexSplit']), + new TwigFunction('string', [$this, 'stringFilter']), + new TwigFunction('url', [$this, 'urlFunc']), + new TwigFunction('json_decode', [$this, 'jsonDecodeFilter']), + new TwigFunction('get_cookie', [$this, 'getCookie']), + new TwigFunction('redirect_me', [$this, 'redirectFunc']), + new TwigFunction('range', [$this, 'rangeFunc']), + new TwigFunction('isajaxrequest', [$this, 'isAjaxFunc']), + new TwigFunction('exif', [$this, 'exifFunc']), + new TwigFunction('media_directory', [$this, 'mediaDirFunc']), + new TwigFunction('body_class', [$this, 'bodyClassFunc'], ['needs_context' => true]), + new TwigFunction('theme_var', [$this, 'themeVarFunc'], ['needs_context' => true]), + new TwigFunction('header_var', [$this, 'pageHeaderVarFunc'], ['needs_context' => true]), + new TwigFunction('read_file', [$this, 'readFileFunc']), + new TwigFunction('nicenumber', [$this, 'niceNumberFunc']), + new TwigFunction('nicefilesize', [$this, 'niceFilesizeFunc']), + new TwigFunction('nicetime', [$this, 'nicetimeFunc']), + new TwigFunction('cron', [$this, 'cronFunc']), + new TwigFunction('svg_image', [$this, 'svgImageFunction']), + new TwigFunction('xss', [$this, 'xssFunc']), + new TwigFunction('unique_id', [$this, 'uniqueId']), + + // Translations + new TwigFunction('t', [$this, 'translate'], ['needs_environment' => true]), + new TwigFunction('tl', [$this, 'translateLanguage']), + new TwigFunction('ta', [$this, 'translateArray']), + + // Object Types + new TwigFunction('get_type', [$this, 'getTypeFunc']), + new TwigFunction('of_type', [$this, 'ofTypeFunc']), + + // PHP methods + new TwigFunction('is_numeric', 'is_numeric'), + new TwigFunction('is_iterable', 'is_iterable'), + new TwigFunction('is_countable', 'is_countable'), + new TwigFunction('is_null', 'is_null'), + new TwigFunction('is_string', 'is_string'), + new TwigFunction('is_array', 'is_array'), + new TwigFunction('is_object', 'is_object'), + new TwigFunction('count', 'count'), + new TwigFunction('array_diff', 'array_diff'), + new TwigFunction('parse_url', 'parse_url'), + + // Security fixes + new TwigFunction('filter', [$this, 'filterFunc'], ['needs_environment' => true]), + new TwigFunction('map', [$this, 'mapFunc'], ['needs_environment' => true]), + new TwigFunction('reduce', [$this, 'reduceFunc'], ['needs_environment' => true]), + ]; + } + + /** + * @return array + */ + public function getTokenParsers(): array + { + return [ + new TwigTokenParserRender(), + new TwigTokenParserThrow(), + new TwigTokenParserTryCatch(), + new TwigTokenParserScript(), + new TwigTokenParserStyle(), + new TwigTokenParserLink(), + new TwigTokenParserMarkdown(), + new TwigTokenParserSwitch(), + new TwigTokenParserCache(), + ]; + } + + /** + * @param mixed $var + * @return string + */ + public function print_r($var) + { + return print_r($var, true); + } + + /** + * Filters field name by changing dot notation into array notation. + * + * @param string $str + * @return string + */ + public function fieldNameFilter($str) + { + $path = explode('.', rtrim($str, '.')); + + return array_shift($path) . ($path ? '[' . implode('][', $path) . ']' : ''); + } + + /** + * Filters field name by changing dot notation into array notation. + * + * @param string $str + * @return string + */ + public function fieldParentFilter($str) + { + $path = explode('.', rtrim($str, '.')); + array_pop($path); + + return implode('.', $path); + } + + /** + * Protects email address. + * + * @param string $str + * @return string + */ + public function safeEmailFilter($str) + { + static $list = [ + '"' => '"', + "'" => ''', + '&' => '&', + '<' => '<', + '>' => '>', + '@' => '@' + ]; + + $characters = mb_str_split($str, 1, 'UTF-8'); + + $encoded = ''; + foreach ($characters as $chr) { + $encoded .= $list[$chr] ?? (random_int(0, 1) ? '&#' . mb_ord($chr) . ';' : $chr); + } + + return $encoded; + } + + /** + * Returns array in a random order. + * + * @param array|Traversable $original + * @param int $offset Can be used to return only slice of the array. + * @return array + */ + public function randomizeFilter($original, $offset = 0) + { + if ($original instanceof Traversable) { + $original = iterator_to_array($original, false); + } + + if (!is_array($original)) { + return $original; + } + + $sorted = []; + $random = array_slice($original, $offset); + shuffle($random); + + $sizeOf = count($original); + for ($x = 0; $x < $sizeOf; $x++) { + if ($x < $offset) { + $sorted[] = $original[$x]; + } else { + $sorted[] = array_shift($random); + } + } + + return $sorted; + } + + /** + * Returns the modulus of an integer + * + * @param string|int $number + * @param int $divider + * @param array|null $items array of items to select from to return + * @return int + */ + public function modulusFilter($number, $divider, $items = null) + { + if (is_string($number)) { + $number = strlen($number); + } + + $remainder = $number % $divider; + + if (is_array($items)) { + return $items[$remainder] ?? $items[0]; + } + + return $remainder; + } + + /** + * Inflector supports following notations: + * + * `{{ 'person'|pluralize }} => people` + * `{{ 'shoes'|singularize }} => shoe` + * `{{ 'welcome page'|titleize }} => "Welcome Page"` + * `{{ 'send_email'|camelize }} => SendEmail` + * `{{ 'CamelCased'|underscorize }} => camel_cased` + * `{{ 'Something Text'|hyphenize }} => something-text` + * `{{ 'something_text_to_read'|humanize }} => "Something text to read"` + * `{{ '181'|monthize }} => 5` + * `{{ '10'|ordinalize }} => 10th` + * + * @param string $action + * @param string $data + * @param int|null $count + * @return string + */ + public function inflectorFilter($action, $data, $count = null) + { + $action .= 'ize'; + + /** @var Inflector $inflector */ + $inflector = $this->grav['inflector']; + + if (in_array( + $action, + ['titleize', 'camelize', 'underscorize', 'hyphenize', 'humanize', 'ordinalize', 'monthize'], + true + )) { + return $inflector->{$action}($data); + } + + if (in_array($action, ['pluralize', 'singularize'], true)) { + return $count ? $inflector->{$action}($data, $count) : $inflector->{$action}($data); + } + + return $data; + } + + /** + * Return MD5 hash from the input. + * + * @param string $str + * @return string + */ + public function md5Filter($str) + { + return md5($str); + } + + /** + * Return Base32 encoded string + * + * @param string $str + * @return string + */ + public function base32EncodeFilter($str) + { + return Base32::encode($str); + } + + /** + * Return Base32 decoded string + * + * @param string $str + * @return string + */ + public function base32DecodeFilter($str) + { + return Base32::decode($str); + } + + /** + * Return Base64 encoded string + * + * @param string $str + * @return string + */ + public function base64EncodeFilter($str) + { + return base64_encode((string) $str); + } + + /** + * Return Base64 decoded string + * + * @param string $str + * @return string|false + */ + public function base64DecodeFilter($str) + { + return base64_decode($str); + } + + /** + * Sorts a collection by key + * + * @param array $input + * @param string $filter + * @param int $direction + * @param int $sort_flags + * @return array + */ + public function sortByKeyFilter($input, $filter, $direction = SORT_ASC, $sort_flags = SORT_REGULAR) + { + return Utils::sortArrayByKey($input, $filter, $direction, $sort_flags); + } + + /** + * Return ksorted collection. + * + * @param array|null $array + * @return array + */ + public function ksortFilter($array) + { + if (null === $array) { + $array = []; + } + ksort($array); + + return $array; + } + + /** + * Wrapper for chunk_split() function + * + * @param string $value + * @param int $chars + * @param string $split + * @return string + */ + public function chunkSplitFilter($value, $chars, $split = '-') + { + return chunk_split($value, $chars, $split); + } + + /** + * determine if a string contains another + * + * @param string $haystack + * @param string $needle + * @return string|bool + * @todo returning $haystack here doesn't make much sense + */ + public function containsFilter($haystack, $needle) + { + if (empty($needle)) { + return $haystack; + } + + return (strpos($haystack, (string) $needle) !== false); + } + + /** + * Gets a human readable output for cron syntax + * + * @param string $at + * @return string + */ + public function niceCronFilter($at) + { + $cron = new Cron($at); + return $cron->getText('en'); + } + + /** + * @param string|mixed $str + * @param string $search + * @param string $replace + * @return string|mixed + */ + public function replaceLastFilter($str, $search, $replace) + { + if (is_string($str) && ($pos = mb_strrpos($str, $search)) !== false) { + $str = mb_substr($str, 0, $pos) . $replace . mb_substr($str, $pos + mb_strlen($search)); + } + + return $str; + } + + /** + * Get Cron object for a crontab 'at' format + * + * @param string $at + * @return CronExpression + */ + public function cronFunc($at) + { + return CronExpression::factory($at); + } + + /** + * displays a facebook style 'time ago' formatted date/time + * + * @param string $date + * @param bool $long_strings + * @param bool $show_tense + * @return string + */ + public function nicetimeFunc($date, $long_strings = true, $show_tense = true) + { + if (empty($date)) { + return $this->grav['language']->translate('GRAV.NICETIME.NO_DATE_PROVIDED'); + } + + if ($long_strings) { + $periods = [ + 'NICETIME.SECOND', + 'NICETIME.MINUTE', + 'NICETIME.HOUR', + 'NICETIME.DAY', + 'NICETIME.WEEK', + 'NICETIME.MONTH', + 'NICETIME.YEAR', + 'NICETIME.DECADE' + ]; + } else { + $periods = [ + 'NICETIME.SEC', + 'NICETIME.MIN', + 'NICETIME.HR', + 'NICETIME.DAY', + 'NICETIME.WK', + 'NICETIME.MO', + 'NICETIME.YR', + 'NICETIME.DEC' + ]; + } + + $lengths = ['60', '60', '24', '7', '4.35', '12', '10']; + + $now = time(); + + // check if unix timestamp + if ((string)(int)$date === (string)$date) { + $unix_date = $date; + } else { + $unix_date = strtotime($date); + } + + // check validity of date + if (empty($unix_date)) { + return $this->grav['language']->translate('GRAV.NICETIME.BAD_DATE'); + } + + // is it future date or past date + if ($now > $unix_date) { + $difference = $now - $unix_date; + $tense = $this->grav['language']->translate('GRAV.NICETIME.AGO'); + } elseif ($now == $unix_date) { + $difference = $now - $unix_date; + $tense = $this->grav['language']->translate('GRAV.NICETIME.JUST_NOW'); + } else { + $difference = $unix_date - $now; + $tense = $this->grav['language']->translate('GRAV.NICETIME.FROM_NOW'); + } + + for ($j = 0; $difference >= $lengths[$j] && $j < count($lengths) - 1; $j++) { + $difference /= $lengths[$j]; + } + + $difference = round($difference); + + if ($difference != 1) { + $periods[$j] .= '_PLURAL'; + } + + if ($this->grav['language']->getTranslation( + $this->grav['language']->getLanguage(), + $periods[$j] . '_MORE_THAN_TWO' + ) + ) { + if ($difference > 2) { + $periods[$j] .= '_MORE_THAN_TWO'; + } + } + + $periods[$j] = $this->grav['language']->translate('GRAV.'.$periods[$j]); + + if ($now == $unix_date) { + return $tense; + } + + $time = "{$difference} {$periods[$j]}"; + $time .= $show_tense ? " {$tense}" : ''; + + return $time; + } + + /** + * Allow quick check of a string for XSS Vulnerabilities + * + * @param string|array $data + * @return bool|string|array + */ + public function xssFunc($data) + { + if (!is_array($data)) { + return Security::detectXss($data); + } + + $results = Security::detectXssFromArray($data); + $results_parts = array_map(static function ($value, $key) { + return $key.': \''.$value . '\''; + }, array_values($results), array_keys($results)); + + return implode(', ', $results_parts); + } + + /** + * Generates a random string with configurable length, prefix and suffix. + * Unlike the built-in `uniqid()`, this string is non-conflicting and safe + * + * @param int $length + * @param array $options + * @return string + * @throws \Exception + */ + public function uniqueId(int $length = 9, array $options = ['prefix' => '', 'suffix' => '']): string + { + return Utils::uniqueId($length, $options); + } + + /** + * @param string $string + * @return string + */ + public function absoluteUrlFilter($string) + { + $url = $this->grav['uri']->base(); + $string = preg_replace('/((?:href|src) *= *[\'"](?!(http|ftp)))/i', "$1$url", $string); + + return $string; + } + + /** + * @param array $context + * @param string $string + * @param bool $block Block or Line processing + * @return string + */ + public function markdownFunction($context, $string, $block = true) + { + $page = $context['page'] ?? null; + return Utils::processMarkdown($string, $block, $page); + } + + /** + * @param string $haystack + * @param string $needle + * @return bool + */ + public function startsWithFilter($haystack, $needle) + { + return Utils::startsWith($haystack, $needle); + } + + /** + * @param string $haystack + * @param string $needle + * @return bool + */ + public function endsWithFilter($haystack, $needle) + { + return Utils::endsWith($haystack, $needle); + } + + /** + * @param mixed $value + * @param null $default + * @return mixed|null + */ + public function definedDefaultFilter($value, $default = null) + { + return $value ?? $default; + } + + /** + * @param string $value + * @param string|null $chars + * @return string + */ + public function rtrimFilter($value, $chars = null) + { + return null !== $chars ? rtrim($value, $chars) : rtrim($value); + } + + /** + * @param string $value + * @param string|null $chars + * @return string + */ + public function ltrimFilter($value, $chars = null) + { + return null !== $chars ? ltrim($value, $chars) : ltrim($value); + } + + /** + * Returns a string from a value. If the value is array, return it json encoded + * + * @param mixed $value + * @return string + */ + public function stringFilter($value) + { + // Format the array as a string + if (is_array($value)) { + return json_encode($value); + } + + // Boolean becomes '1' or '0' + if (is_bool($value)) { + $value = (int)$value; + } + + // Cast the other values to string. + return (string)$value; + } + + /** + * Casts input to int. + * + * @param mixed $input + * @return int + */ + public function intFilter($input) + { + return (int) $input; + } + + /** + * Casts input to bool. + * + * @param mixed $input + * @return bool + */ + public function boolFilter($input) + { + return (bool) $input; + } + + /** + * Casts input to float. + * + * @param mixed $input + * @return float + */ + public function floatFilter($input) + { + return (float) $input; + } + + /** + * Casts input to array. + * + * @param mixed $input + * @return array + */ + public function arrayFilter($input) + { + if (is_array($input)) { + return $input; + } + + if (is_object($input)) { + if (method_exists($input, 'toArray')) { + return $input->toArray(); + } + + if ($input instanceof Iterator) { + return iterator_to_array($input); + } + } + + return (array)$input; + } + + /** + * @param array|object $value + * @param int|null $inline + * @param int|null $indent + * @return string + */ + public function yamlFilter($value, $inline = null, $indent = null): string + { + return Yaml::dump($value, $inline, $indent); + } + + /** + * @param Environment $twig + * @return string + */ + public function translate(Environment $twig, ...$args) + { + // If admin and tu filter provided, use it + if (isset($this->grav['admin'])) { + $numargs = count($args); + $lang = null; + + if (($numargs === 3 && is_array($args[1])) || ($numargs === 2 && !is_array($args[1]))) { + $lang = array_pop($args); + /** @var Language $language */ + $language = $this->grav['language']; + if (is_string($lang) && !$language->getLanguageCode($lang)) { + $args[] = $lang; + $lang = null; + } + } elseif ($numargs === 2 && is_array($args[1])) { + $subs = array_pop($args); + $args = array_merge($args, $subs); + } + + return $this->grav['admin']->translate($args, $lang); + } + + $translation = $this->grav['language']->translate($args); + + if ($this->config->get('system.languages.debug', false)) { + $debugger = $this->grav['debugger']; + $debugger->addMessage("$args[0] -> $translation", 'debug'); + } + + return $translation; + } + + /** + * Translate Strings + * + * @param string|array $args + * @param array|null $languages + * @param bool $array_support + * @param bool $html_out + * @return string + */ + public function translateLanguage($args, array $languages = null, $array_support = false, $html_out = false) + { + /** @var Language $language */ + $language = $this->grav['language']; + + return $language->translate($args, $languages, $array_support, $html_out); + } + + /** + * @param string $key + * @param string $index + * @param array|null $lang + * @return string + */ + public function translateArray($key, $index, $lang = null) + { + /** @var Language $language */ + $language = $this->grav['language']; + + return $language->translateArray($key, $index, $lang); + } + + /** + * Repeat given string x times. + * + * @param string $input + * @param int $multiplier + * + * @return string + */ + public function repeatFunc($input, $multiplier) + { + return str_repeat($input, (int) $multiplier); + } + + /** + * Return URL to the resource. + * + * @example {{ url('theme://images/logo.png')|default('http://www.placehold.it/150x100/f4f4f4') }} + * + * @param string $input Resource to be located. + * @param bool $domain True to include domain name. + * @param bool $failGracefully If true, return URL even if the file does not exist. + * @return string|false Returns url to the resource or null if resource was not found. + */ + public function urlFunc($input, $domain = false, $failGracefully = false) + { + return Utils::url($input, $domain, $failGracefully); + } + + /** + * This function will evaluate Twig $twig through the $environment, and return its results. + * + * @param array $context + * @param string $twig + * @return mixed + */ + public function evaluateTwigFunc($context, $twig) + { + + $loader = new FilesystemLoader('.'); + $env = new Environment($loader); + $env->addExtension($this); + + $template = $env->createTemplate($twig); + + return $template->render($context); + } + + /** + * This function will evaluate a $string through the $environment, and return its results. + * + * @param array $context + * @param string $string + * @return mixed + */ + public function evaluateStringFunc($context, $string) + { + return $this->evaluateTwigFunc($context, "{{ $string }}"); + } + + /** + * Based on Twig\Extension\Debug / twig_var_dump + * (c) 2011 Fabien Potencier + * + * @param Environment $env + * @param array $context + */ + public function dump(Environment $env, $context) + { + if (!$env->isDebug() || !$this->debugger) { + return; + } + + $count = func_num_args(); + if (2 === $count) { + $data = []; + foreach ($context as $key => $value) { + if (is_object($value)) { + if (method_exists($value, 'toArray')) { + $data[$key] = $value->toArray(); + } else { + $data[$key] = 'Object (' . get_class($value) . ')'; + } + } else { + $data[$key] = $value; + } + } + $this->debugger->addMessage($data, 'debug'); + } else { + for ($i = 2; $i < $count; $i++) { + $var = func_get_arg($i); + $this->debugger->addMessage($var, 'debug'); + } + } + } + + /** + * Output a Gist + * + * @param string $id + * @param string|false $file + * @return string + */ + public function gistFunc($id, $file = false) + { + $url = 'https://gist.github.com/' . $id . '.js'; + if ($file) { + $url .= '?file=' . $file; + } + return ''; + } + + /** + * Generate a random string + * + * @param int $count + * @return string + */ + public function randomStringFunc($count = 5) + { + return Utils::generateRandomString($count); + } + + /** + * Pad a string to a certain length with another string + * + * @param string $input + * @param int $pad_length + * @param string $pad_string + * @param int $pad_type + * @return string + */ + public static function padFilter($input, $pad_length, $pad_string = ' ', $pad_type = STR_PAD_RIGHT) + { + return str_pad($input, (int)$pad_length, $pad_string, $pad_type); + } + + /** + * Workaround for twig associative array initialization + * Returns a key => val array + * + * @param string $key key of item + * @param string $val value of item + * @param array|null $current_array optional array to add to + * @return array + */ + public function arrayKeyValueFunc($key, $val, $current_array = null) + { + if (empty($current_array)) { + return array($key => $val); + } + + $current_array[$key] = $val; + + return $current_array; + } + + /** + * Wrapper for array_intersect() method + * + * @param array|Collection $array1 + * @param array|Collection $array2 + * @return array|Collection + */ + public function arrayIntersectFunc($array1, $array2) + { + if ($array1 instanceof Collection && $array2 instanceof Collection) { + return $array1->intersect($array2)->toArray(); + } + + return array_intersect($array1, $array2); + } + + /** + * Translate a string + * + * @return string + */ + public function translateFunc() + { + return $this->grav['language']->translate(func_get_args()); + } + + /** + * Authorize an action. Returns true if the user is logged in and + * has the right to execute $action. + * + * @param string|array $action An action or a list of actions. Each + * entry can be a string like 'group.action' + * or without dot notation an associative + * array. + * @return bool Returns TRUE if the user is authorized to + * perform the action, FALSE otherwise. + */ + public function authorize($action) + { + // Admin can use Flex users even if the site does not; make sure we use the right version of the user. + $admin = $this->grav['admin'] ?? null; + if ($admin) { + $user = $admin->user; + } else { + /** @var UserInterface|null $user */ + $user = $this->grav['user'] ?? null; + } + + if (!$user) { + return false; + } + + if (is_array($action)) { + if (Utils::isAssoc($action)) { + // Handle nested access structure. + $actions = Utils::arrayFlattenDotNotation($action); + } else { + // Handle simple access list. + $actions = array_combine($action, array_fill(0, count($action), true)); + } + } else { + // Handle single action. + $actions = [(string)$action => true]; + } + + $count = count($actions); + foreach ($actions as $act => $authenticated) { + // Ignore 'admin.super' if it's not the only value to be checked. + if ($act === 'admin.super' && $count > 1 && $user instanceof FlexObjectInterface) { + continue; + } + + $auth = $user->authorize($act) ?? false; + if (is_bool($auth) && $auth === Utils::isPositive($authenticated)) { + return true; + } + } + + return false; + } + + /** + * Used to add a nonce to a form. Call {{ nonce_field('action') }} specifying a string representing the action. + * + * For maximum protection, ensure that the string representing the action is as specific as possible + * + * @param string $action the action + * @param string $nonceParamName a custom nonce param name + * @return string the nonce input field + */ + public function nonceFieldFunc($action, $nonceParamName = 'nonce') + { + $string = ''; + + return $string; + } + + /** + * Decodes string from JSON. + * + * @param string $str + * @param bool $assoc + * @param int $depth + * @param int $options + * @return array + */ + public function jsonDecodeFilter($str, $assoc = false, $depth = 512, $options = 0) + { + if ($str === null) { + $str = ''; + } + return json_decode(html_entity_decode($str, ENT_COMPAT | ENT_HTML401, 'UTF-8'), $assoc, $depth, $options); + } + + /** + * Used to retrieve a cookie value + * + * @param string $key The cookie name to retrieve + * @return string + */ + public function getCookie($key) + { + $cookie_value = filter_input(INPUT_COOKIE, $key); + + if ($cookie_value === null) { + return null; + } + + return htmlspecialchars(strip_tags($cookie_value), ENT_QUOTES, 'UTF-8'); + } + + /** + * Twig wrapper for PHP's preg_replace method + * + * @param string|string[] $subject the content to perform the replacement on + * @param string|string[] $pattern the regex pattern to use for matches + * @param string|string[] $replace the replacement value either as a string or an array of replacements + * @param int $limit the maximum possible replacements for each pattern in each subject + * @return string|string[]|null the resulting content + */ + public function regexReplace($subject, $pattern, $replace, $limit = -1) + { + return preg_replace($pattern, $replace, $subject, $limit); + } + + /** + * Twig wrapper for PHP's preg_grep method + * + * @param array $array + * @param string $regex + * @param int $flags + * @return array + */ + public function regexFilter($array, $regex, $flags = 0) + { + return preg_grep($regex, $array, $flags); + } + + /** + * Twig wrapper for PHP's preg_match method + * + * @param string $subject the content to perform the match on + * @param string $pattern the regex pattern to use for match + * @param int $flags + * @param int $offset + * @return array|false returns the matches if there is at least one match in the subject for a given pattern or null if not. + */ + public function regexMatch($subject, $pattern, $flags = 0, $offset = 0) + { + if (preg_match($pattern, $subject, $matches, $flags, $offset) === false) { + return false; + } + + return $matches; + } + + /** + * Twig wrapper for PHP's preg_split method + * + * @param string $subject the content to perform the split on + * @param string $pattern the regex pattern to use for split + * @param int $limit the maximum possible splits for the given pattern + * @param int $flags + * @return array|false the resulting array after performing the split operation + */ + public function regexSplit($subject, $pattern, $limit = -1, $flags = 0) + { + return preg_split($pattern, $subject, $limit, $flags); + } + + /** + * redirect browser from twig + * + * @param string $url the url to redirect to + * @param int $statusCode statusCode, default 303 + * @return void + */ + public function redirectFunc($url, $statusCode = 303) + { + $response = new Response($statusCode, ['location' => $url]); + + $this->grav->close($response); + } + + /** + * Generates an array containing a range of elements, optionally stepped + * + * @param int $start Minimum number, default 0 + * @param int $end Maximum number, default `getrandmax()` + * @param int $step Increment between elements in the sequence, default 1 + * @return array + */ + public function rangeFunc($start = 0, $end = 100, $step = 1) + { + return range($start, $end, $step); + } + + /** + * Check if HTTP_X_REQUESTED_WITH has been set to xmlhttprequest, + * in which case we may unsafely assume ajax. Non critical use only. + * + * @return bool True if HTTP_X_REQUESTED_WITH exists and has been set to xmlhttprequest + */ + public function isAjaxFunc() + { + return ( + !empty($_SERVER['HTTP_X_REQUESTED_WITH']) + && strtolower($_SERVER['HTTP_X_REQUESTED_WITH']) === 'xmlhttprequest'); + } + + /** + * Get the Exif data for a file + * + * @param string $image + * @param bool $raw + * @return mixed + */ + public function exifFunc($image, $raw = false) + { + if (isset($this->grav['exif'])) { + /** @var UniformResourceLocator $locator */ + $locator = $this->grav['locator']; + + if ($locator->isStream($image)) { + $image = $locator->findResource($image); + } + + $exif_reader = $this->grav['exif']->getReader(); + + if ($image && file_exists($image) && $this->config->get('system.media.auto_metadata_exif') && $exif_reader) { + $exif_data = $exif_reader->read($image); + + if ($exif_data) { + if ($raw) { + return $exif_data->getRawData(); + } + + return $exif_data->getData(); + } + } + } + + return null; + } + + /** + * Simple function to read a file based on a filepath and output it + * + * @param string $filepath + * @return bool|string + */ + public function readFileFunc($filepath) + { + /** @var UniformResourceLocator $locator */ + $locator = $this->grav['locator']; + + if ($locator->isStream($filepath)) { + $filepath = $locator->findResource($filepath); + } + + if ($filepath && file_exists($filepath)) { + return file_get_contents($filepath); + } + + return false; + } + + /** + * Process a folder as Media and return a media object + * + * @param string $media_dir + * @return Media|null + */ + public function mediaDirFunc($media_dir) + { + /** @var UniformResourceLocator $locator */ + $locator = $this->grav['locator']; + + if ($locator->isStream($media_dir)) { + $media_dir = $locator->findResource($media_dir); + } + + if ($media_dir && file_exists($media_dir)) { + return new Media($media_dir); + } + + return null; + } + + /** + * Dump a variable to the browser + * + * @param mixed $var + * @return void + */ + public function vardumpFunc($var) + { + dump($var); + } + + /** + * Returns a nicer more readable filesize based on bytes + * + * @param int $bytes + * @return string + */ + public function niceFilesizeFunc($bytes) + { + return Utils::prettySize($bytes); + } + + /** + * Returns a nicer more readable number + * + * @param int|float|string $n + * @return string|bool + */ + public function niceNumberFunc($n) + { + if (!is_float($n) && !is_int($n)) { + if (!is_string($n) || $n === '') { + return false; + } + + // Strip any thousand formatting and find the first number. + $list = array_filter(preg_split("/\D+/", str_replace(',', '', $n))); + $n = reset($list); + + if (!is_numeric($n)) { + return false; + } + + $n = (float)$n; + } + + // now filter it; + if ($n > 1000000000000) { + return round($n/1000000000000, 2).' t'; + } + if ($n > 1000000000) { + return round($n/1000000000, 2).' b'; + } + if ($n > 1000000) { + return round($n/1000000, 2).' m'; + } + if ($n > 1000) { + return round($n/1000, 2).' k'; + } + + return number_format($n); + } + + /** + * Get a theme variable + * Will try to get the variable for the current page, if not found, it tries it's parent page on up to root. + * If still not found, will use the theme's configuration value, + * If still not found, will use the $default value passed in + * + * @param array $context Twig Context + * @param string $var variable to be found (using dot notation) + * @param null $default the default value to be used as last resort + * @param PageInterface|null $page an optional page to use for the current page + * @param bool $exists toggle to simply return the page where the variable is set, else null + * @return mixed + */ + public function themeVarFunc($context, $var, $default = null, $page = null, $exists = false) + { + $page = $page ?? $context['page'] ?? Grav::instance()['page'] ?? null; + + // Try to find var in the page headers + if ($page instanceof PageInterface && $page->exists()) { + // Loop over pages and look for header vars + while ($page && !$page->root()) { + $header = new Data((array)$page->header()); + $value = $header->get($var); + if (isset($value)) { + if ($exists) { + return $page; + } + + return $value; + } + $page = $page->parent(); + } + } + + if ($exists) { + return false; + } + + return Grav::instance()['config']->get('theme.' . $var, $default); + } + + /** + * Look for a page header variable in an array of pages working its way through until a value is found + * + * @param array $context + * @param string $var the variable to look for in the page header + * @param string|string[]|null $pages array of pages to check (current page upwards if not null) + * @return mixed + * @deprecated 1.7 Use themeVarFunc() instead + */ + public function pageHeaderVarFunc($context, $var, $pages = null) + { + if (is_array($pages)) { + $page = array_shift($pages); + } else { + $page = null; + } + return $this->themeVarFunc($context, $var, null, $page); + } + + /** + * takes an array of classes, and if they are not set on body_classes + * look to see if they are set in theme config + * + * @param array $context + * @param string|string[] $classes + * @return string + */ + public function bodyClassFunc($context, $classes) + { + + $header = $context['page']->header(); + $body_classes = $header->body_classes ?? ''; + + foreach ((array)$classes as $class) { + if (!empty($body_classes) && Utils::contains($body_classes, $class)) { + continue; + } + + $val = $this->config->get('theme.' . $class, false) ? $class : false; + $body_classes .= $val ? ' ' . $val : ''; + } + + return $body_classes; + } + + /** + * Returns the content of an SVG image and adds extra classes as needed + * + * @param string $path + * @param string|null $classes + * @return string|string[]|null + */ + public static function svgImageFunction($path, $classes = null, $strip_style = false) + { + $path = Utils::fullPath($path); + + $classes = $classes ?: ''; + + if (file_exists($path) && !is_dir($path)) { + $svg = file_get_contents($path); + $classes = " inline-block $classes"; + $matched = false; + + //Remove xml tag if it exists + $svg = preg_replace('/^<\?xml.*\?>/','', $svg); + + //Strip style if needed + if ($strip_style) { + $svg = preg_replace('//s', '', $svg); + } + + //Look for existing class + $svg = preg_replace_callback('/^]*(class=\"([^"]*)\")[^>]*>/', function($matches) use ($classes, &$matched) { + if (isset($matches[2])) { + $new_classes = $matches[2] . $classes; + $matched = true; + return str_replace($matches[1], "class=\"$new_classes\"", $matches[0]); + } + return $matches[0]; + }, $svg + ); + + // no matches found just add the class + if (!$matched) { + $classes = trim($classes); + $svg = str_replace('jsonSerialize(); + } elseif (method_exists($data, 'toArray')) { + $data = $data->toArray(); + } else { + $data = json_decode(json_encode($data), true); + } + } + + return Yaml::dump($data, $inline); + } + + /** + * Decode/Parse data from YAML format + * + * @param string $data + * @return array + */ + public function yamlDecodeFilter($data) + { + return Yaml::parse($data); + } + + /** + * Function/Filter to return the type of variable + * + * @param mixed $var + * @return string + */ + public function getTypeFunc($var) + { + return gettype($var); + } + + /** + * Function/Filter to test type of variable + * + * @param mixed $var + * @param string|null $typeTest + * @param string|null $className + * @return bool + */ + public function ofTypeFunc($var, $typeTest = null, $className = null) + { + + switch ($typeTest) { + default: + return false; + + case 'array': + return is_array($var); + + case 'bool': + return is_bool($var); + + case 'class': + return is_object($var) === true && get_class($var) === $className; + + case 'float': + return is_float($var); + + case 'int': + return is_int($var); + + case 'numeric': + return is_numeric($var); + + case 'object': + return is_object($var); + + case 'scalar': + return is_scalar($var); + + case 'string': + return is_string($var); + } + } + + /** + * @param Environment $env + * @param array $array + * @param callable|string $arrow + * @return array|CallbackFilterIterator + * @throws RuntimeError + */ + function filterFunc(Environment $env, $array, $arrow) + { + if (!$arrow instanceof \Closure && !is_string($arrow) || Utils::isDangerousFunction($arrow)) { + throw new RuntimeError('Twig |filter("' . $arrow . '") is not allowed.'); + } + + return twig_array_filter($env, $array, $arrow); + } + + /** + * @param Environment $env + * @param array $array + * @param callable|string $arrow + * @return array|CallbackFilterIterator + * @throws RuntimeError + */ + function mapFunc(Environment $env, $array, $arrow) + { + if (!$arrow instanceof \Closure && !is_string($arrow) || Utils::isDangerousFunction($arrow)) { + throw new RuntimeError('Twig |map("' . $arrow . '") is not allowed.'); + } + + return twig_array_map($env, $array, $arrow); + } + + /** + * @param Environment $env + * @param array $array + * @param callable|string $arrow + * @return array|CallbackFilterIterator + * @throws RuntimeError + */ + function reduceFunc(Environment $env, $array, $arrow) + { + if (!$arrow instanceof \Closure && !is_string($arrow) || Utils::isDangerousFunction($arrow)) { + throw new RuntimeError('Twig |reduce("' . $arrow . '") is not allowed.'); + } + + return twig_array_map($env, $array, $arrow); + } +} diff --git a/system/src/Grav/Common/Twig/Node/TwigNodeCache.php b/system/src/Grav/Common/Twig/Node/TwigNodeCache.php new file mode 100644 index 0000000..39b3d08 --- /dev/null +++ b/system/src/Grav/Common/Twig/Node/TwigNodeCache.php @@ -0,0 +1,93 @@ + $body]; + + if ($key !== null) { + $nodes['key'] = $key; + } + + if ($lifetime !== null) { + $nodes['lifetime'] = $lifetime; + } + + parent::__construct($nodes, $defaults, $lineno, $tag); + } + + public function compile(Compiler $compiler): void + { + $compiler->addDebugInfo($this); + + + // Generate the cache key + if ($this->hasNode('key')) { + $compiler + ->write('$key = "twigcache-" . ') + ->subcompile($this->getNode('key')) + ->raw(";\n"); + } else { + $compiler + ->write('$key = ') + ->string($this->getAttribute('key')) + ->raw(";\n"); + } + + // Set the cache timeout + if ($this->hasNode('lifetime')) { + $compiler + ->write('$lifetime = ') + ->subcompile($this->getNode('lifetime')) + ->raw(";\n"); + } else { + $compiler + ->write('$lifetime = ') + ->write($this->getAttribute('lifetime')) + ->raw(";\n"); + } + + $compiler + ->write("\$cache = \\Grav\\Common\\Grav::instance()['cache'];\n") + ->write("\$cache_body = \$cache->fetch(\$key);\n") + ->write("if (\$cache_body === false) {\n") + ->indent() + ->write("\\Grav\\Common\\Grav::instance()['debugger']->addMessage(\"Cache Key: \$key, Lifetime: \$lifetime\");\n") + ->write("ob_start();\n") + ->indent() + ->subcompile($this->getNode('body')) + ->outdent() + ->write("\n") + ->write("\$cache_body = ob_get_clean();\n") + ->write("\$cache->save(\$key, \$cache_body, \$lifetime);\n") + ->outdent() + ->write("}\n") + ->write("echo '' === \$cache_body ? '' : new Markup(\$cache_body, \$this->env->getCharset());\n"); + } +} \ No newline at end of file diff --git a/system/src/Grav/Common/Twig/Node/TwigNodeLink.php b/system/src/Grav/Common/Twig/Node/TwigNodeLink.php new file mode 100644 index 0000000..17a8fd3 --- /dev/null +++ b/system/src/Grav/Common/Twig/Node/TwigNodeLink.php @@ -0,0 +1,114 @@ + $file, 'group' => $group, 'priority' => $priority, 'attributes' => $attributes]; + $nodes = array_filter($nodes); + + parent::__construct($nodes, ['rel' => $rel], $lineno, $tag); + } + + /** + * Compiles the node to PHP. + * + * @param Compiler $compiler A Twig Compiler instance + * @return void + * @throws LogicException + */ + public function compile(Compiler $compiler): void + { + $compiler->addDebugInfo($this); + if (!$this->hasNode('file')) { + return; + } + + $compiler->write('$attributes = [\'rel\' => \'' . $this->getAttribute('rel') . '\'];' . "\n"); + if ($this->hasNode('attributes')) { + $compiler + ->write('$attributes += ') + ->subcompile($this->getNode('attributes')) + ->raw(';' . PHP_EOL) + ->write('if (!is_array($attributes)) {' . PHP_EOL) + ->indent() + ->write("throw new UnexpectedValueException('{% {$this->tagName} with x %}: x is not an array');" . PHP_EOL) + ->outdent() + ->write('}' . PHP_EOL); + } + + if ($this->hasNode('group')) { + $compiler + ->write('$group = ') + ->subcompile($this->getNode('group')) + ->raw(';' . PHP_EOL) + ->write('if (!is_string($group)) {' . PHP_EOL) + ->indent() + ->write("throw new UnexpectedValueException('{% {$this->tagName} in x %}: x is not a string');" . PHP_EOL) + ->outdent() + ->write('}' . PHP_EOL); + } else { + $compiler->write('$group = \'head\';' . PHP_EOL); + } + + if ($this->hasNode('priority')) { + $compiler + ->write('$priority = (int)(') + ->subcompile($this->getNode('priority')) + ->raw(');' . PHP_EOL); + } else { + $compiler->write('$priority = 10;' . PHP_EOL); + } + + $compiler->write("\$assets = \\Grav\\Common\\Grav::instance()['assets'];" . PHP_EOL); + $compiler->write("\$block = \$context['block'] ?? null;" . PHP_EOL); + + $compiler + ->write('$file = (string)(') + ->subcompile($this->getNode('file')) + ->raw(');' . PHP_EOL); + + // Assets support. + $compiler->write('$assets->addLink($file, [\'group\' => $group, \'priority\' => $priority] + $attributes);' . PHP_EOL); + + // HtmlBlock support. + $compiler + ->write('if ($block instanceof \Grav\Framework\ContentBlock\HtmlBlock) {' . PHP_EOL) + ->indent() + ->write('$block->addLink([\'href\'=> $file] + $attributes, $priority, $group);' . PHP_EOL) + ->outdent() + ->write('}' . PHP_EOL); + } +} diff --git a/system/src/Grav/Common/Twig/Node/TwigNodeMarkdown.php b/system/src/Grav/Common/Twig/Node/TwigNodeMarkdown.php new file mode 100644 index 0000000..f671709 --- /dev/null +++ b/system/src/Grav/Common/Twig/Node/TwigNodeMarkdown.php @@ -0,0 +1,52 @@ + $body], [], $lineno, $tag); + } + + /** + * Compiles the node to PHP. + * + * @param Compiler $compiler A Twig Compiler instance + * @return void + */ + public function compile(Compiler $compiler): void + { + $compiler + ->addDebugInfo($this) + ->write('ob_start();' . PHP_EOL) + ->subcompile($this->getNode('body')) + ->write('$content = ob_get_clean();' . PHP_EOL) + ->write('preg_match("/^\s*/", $content, $matches);' . PHP_EOL) + ->write('$lines = explode("\n", $content);' . PHP_EOL) + ->write('$content = preg_replace(\'/^\' . $matches[0]. \'/\', "", $lines);' . PHP_EOL) + ->write('$content = join("\n", $content);' . PHP_EOL) + ->write('echo $this->env->getExtension(\'Grav\Common\Twig\Extension\GravExtension\')->markdownFunction($context, $content);' . PHP_EOL); + } +} diff --git a/system/src/Grav/Common/Twig/Node/TwigNodeRender.php b/system/src/Grav/Common/Twig/Node/TwigNodeRender.php new file mode 100644 index 0000000..eca9a66 --- /dev/null +++ b/system/src/Grav/Common/Twig/Node/TwigNodeRender.php @@ -0,0 +1,84 @@ + $object, 'layout' => $layout, 'context' => $context]; + $nodes = array_filter($nodes); + + parent::__construct($nodes, [], $lineno, $tag); + } + + /** + * Compiles the node to PHP. + * + * @param Compiler $compiler A Twig Compiler instance + * @return void + * @throws LogicException + */ + public function compile(Compiler $compiler): void + { + $compiler->addDebugInfo($this); + $compiler->write('$object = ')->subcompile($this->getNode('object'))->raw(';' . PHP_EOL); + + if ($this->hasNode('layout')) { + $layout = $this->getNode('layout'); + $compiler->write('$layout = ')->subcompile($layout)->raw(';' . PHP_EOL); + } else { + $compiler->write('$layout = null;' . PHP_EOL); + } + + if ($this->hasNode('context')) { + $context = $this->getNode('context'); + $compiler->write('$attributes = ')->subcompile($context)->raw(';' . PHP_EOL); + } else { + $compiler->write('$attributes = null;' . PHP_EOL); + } + + $compiler + ->write('$html = $object->render($layout, $attributes ?? []);' . PHP_EOL) + ->write('$block = $context[\'block\'] ?? null;' . PHP_EOL) + ->write('if ($block instanceof \Grav\Framework\ContentBlock\ContentBlock && $html instanceof \Grav\Framework\ContentBlock\ContentBlock) {' . PHP_EOL) + ->indent() + ->write('$block->addBlock($html);' . PHP_EOL) + ->write('echo $html->getToken();' . PHP_EOL) + ->outdent() + ->write('} else {' . PHP_EOL) + ->indent() + ->write('\Grav\Common\Assets\BlockAssets::registerAssets($html);' . PHP_EOL) + ->write('echo (string)$html;' . PHP_EOL) + ->outdent() + ->write('}' . PHP_EOL) + ; + } +} diff --git a/system/src/Grav/Common/Twig/Node/TwigNodeScript.php b/system/src/Grav/Common/Twig/Node/TwigNodeScript.php new file mode 100644 index 0000000..b9172d0 --- /dev/null +++ b/system/src/Grav/Common/Twig/Node/TwigNodeScript.php @@ -0,0 +1,142 @@ + $body, 'file' => $file, 'group' => $group, 'priority' => $priority, 'attributes' => $attributes]; + $nodes = array_filter($nodes); + + parent::__construct($nodes, ['type' => $type], $lineno, $tag); + } + + /** + * Compiles the node to PHP. + * + * @param Compiler $compiler A Twig Compiler instance + * @return void + * @throws LogicException + */ + public function compile(Compiler $compiler): void + { + $compiler->addDebugInfo($this); + + if ($this->hasNode('attributes')) { + $compiler + ->write('$attributes = ') + ->subcompile($this->getNode('attributes')) + ->raw(';' . PHP_EOL) + ->write('if (!is_array($attributes)) {' . PHP_EOL) + ->indent() + ->write("throw new UnexpectedValueException('{% {$this->tagName} with x %}: x is not an array');" . PHP_EOL) + ->outdent() + ->write('}' . PHP_EOL); + } else { + $compiler->write('$attributes = [];' . PHP_EOL); + } + + if ($this->hasNode('group')) { + $compiler + ->write('$group = ') + ->subcompile($this->getNode('group')) + ->raw(';' . PHP_EOL) + ->write('if (!is_string($group)) {' . PHP_EOL) + ->indent() + ->write("throw new UnexpectedValueException('{% {$this->tagName} in x %}: x is not a string');" . PHP_EOL) + ->outdent() + ->write('}' . PHP_EOL); + } else { + $compiler->write('$group = \'head\';' . PHP_EOL); + } + + if ($this->hasNode('priority')) { + $compiler + ->write('$priority = (int)(') + ->subcompile($this->getNode('priority')) + ->raw(');' . PHP_EOL); + } else { + $compiler->write('$priority = 10;' . PHP_EOL); + } + + $compiler->write("\$assets = \\Grav\\Common\\Grav::instance()['assets'];" . PHP_EOL); + $compiler->write("\$block = \$context['block'] ?? null;" . PHP_EOL); + + if ($this->hasNode('file')) { + // JS file. + $compiler + ->write('$file = (string)(') + ->subcompile($this->getNode('file')) + ->raw(');' . PHP_EOL); + + $method = $this->getAttribute('type') === 'module' ? 'addJsModule' : 'addJs'; + + // Assets support. + $compiler->write('$assets->' . $method . '($file, [\'group\' => $group, \'priority\' => $priority] + $attributes);' . PHP_EOL); + + $method = $this->getAttribute('type') === 'module' ? 'addModule' : 'addScript'; + + // HtmlBlock support. + $compiler + ->write('if ($block instanceof \Grav\Framework\ContentBlock\HtmlBlock) {' . PHP_EOL) + ->indent() + ->write('$block->' . $method . '([\'src\'=> $file] + $attributes, $priority, $group);' . PHP_EOL) + ->outdent() + ->write('}' . PHP_EOL); + + } else { + // Inline script. + $compiler + ->write('ob_start();' . PHP_EOL) + ->subcompile($this->getNode('body')) + ->write('$content = ob_get_clean();' . PHP_EOL); + + $method = $this->getAttribute('type') === 'module' ? 'addInlineJsModule' : 'addInlineJs'; + + // Assets support. + $compiler->write('$assets->' . $method . '($content, [\'group\' => $group, \'priority\' => $priority] + $attributes);' . PHP_EOL); + + $method = $this->getAttribute('type') === 'module' ? 'addInlineModule' : 'addInlineScript'; + + // HtmlBlock support. + $compiler + ->write('if ($block instanceof \Grav\Framework\ContentBlock\HtmlBlock) {' . PHP_EOL) + ->indent() + ->write('$block->' . $method . '([\'content\'=> $content] + $attributes, $priority, $group);' . PHP_EOL) + ->outdent() + ->write('}' . PHP_EOL); + } + } +} diff --git a/system/src/Grav/Common/Twig/Node/TwigNodeStyle.php b/system/src/Grav/Common/Twig/Node/TwigNodeStyle.php new file mode 100644 index 0000000..4ba112d --- /dev/null +++ b/system/src/Grav/Common/Twig/Node/TwigNodeStyle.php @@ -0,0 +1,133 @@ + $body, 'file' => $file, 'group' => $group, 'priority' => $priority, 'attributes' => $attributes]; + $nodes = array_filter($nodes); + + parent::__construct($nodes, [], $lineno, $tag); + } + + /** + * Compiles the node to PHP. + * + * @param Compiler $compiler A Twig Compiler instance + * @return void + * @throws LogicException + */ + public function compile(Compiler $compiler): void + { + $compiler->addDebugInfo($this); + + if ($this->hasNode('attributes')) { + $compiler + ->write('$attributes = ') + ->subcompile($this->getNode('attributes')) + ->raw(';' . PHP_EOL) + ->write('if (!is_array($attributes)) {' . PHP_EOL) + ->indent() + ->write("throw new UnexpectedValueException('{% {$this->tagName} with x %}: x is not an array');" . PHP_EOL) + ->outdent() + ->write('}' . PHP_EOL); + } else { + $compiler->write('$attributes = [];' . PHP_EOL); + } + + if ($this->hasNode('group')) { + $compiler + ->write('$group = ') + ->subcompile($this->getNode('group')) + ->raw(';' . PHP_EOL) + ->write('if (!is_string($group)) {' . PHP_EOL) + ->indent() + ->write("throw new UnexpectedValueException('{% {$this->tagName} in x %}: x is not a string');" . PHP_EOL) + ->outdent() + ->write('}' . PHP_EOL); + } else { + $compiler->write('$group = \'head\';' . PHP_EOL); + } + + if ($this->hasNode('priority')) { + $compiler + ->write('$priority = (int)(') + ->subcompile($this->getNode('priority')) + ->raw(');' . PHP_EOL); + } else { + $compiler->write('$priority = 10;' . PHP_EOL); + } + + $compiler->write("\$assets = \\Grav\\Common\\Grav::instance()['assets'];" . PHP_EOL); + $compiler->write("\$block = \$context['block'] ?? null;" . PHP_EOL); + + if ($this->hasNode('file')) { + // CSS file. + $compiler + ->write('$file = (string)(') + ->subcompile($this->getNode('file')) + ->raw(');' . PHP_EOL); + + // Assets support. + $compiler->write('$assets->addCss($file, [\'group\' => $group, \'priority\' => $priority] + $attributes);' . PHP_EOL); + + // HtmlBlock support. + $compiler + ->write('if ($block instanceof \Grav\Framework\ContentBlock\HtmlBlock) {' . PHP_EOL) + ->indent() + ->write('$block->addStyle([\'href\'=> $file] + $attributes, $priority, $group);' . PHP_EOL) + ->outdent() + ->write('}' . PHP_EOL); + + } else { + // Inline style. + $compiler + ->write('ob_start();' . PHP_EOL) + ->subcompile($this->getNode('body')) + ->write('$content = ob_get_clean();' . PHP_EOL); + + // Assets support. + $compiler->write('$assets->addInlineCss($content, [\'group\' => $group, \'priority\' => $priority] + $attributes);' . PHP_EOL); + + // HtmlBlock support. + $compiler + ->write('if ($block instanceof \Grav\Framework\ContentBlock\HtmlBlock) {' . PHP_EOL) + ->indent() + ->write('$block->addInlineStyle([\'content\'=> $content] + $attributes, $priority, $group);' . PHP_EOL) + ->outdent() + ->write('}' . PHP_EOL); + } + } +} diff --git a/system/src/Grav/Common/Twig/Node/TwigNodeSwitch.php b/system/src/Grav/Common/Twig/Node/TwigNodeSwitch.php new file mode 100644 index 0000000..8dcc9dd --- /dev/null +++ b/system/src/Grav/Common/Twig/Node/TwigNodeSwitch.php @@ -0,0 +1,88 @@ + $value, 'cases' => $cases, 'default' => $default]; + $nodes = array_filter($nodes); + + parent::__construct($nodes, [], $lineno, $tag); + } + + /** + * Compiles the node to PHP. + * + * @param Compiler $compiler A Twig Compiler instance + * @return void + */ + public function compile(Compiler $compiler): void + { + $compiler + ->addDebugInfo($this) + ->write('switch (') + ->subcompile($this->getNode('value')) + ->raw(") {\n") + ->indent(); + + /** @var Node $case */ + foreach ($this->getNode('cases') as $case) { + if (!$case->hasNode('body')) { + continue; + } + + foreach ($case->getNode('values') as $value) { + $compiler + ->write('case ') + ->subcompile($value) + ->raw(":\n"); + } + + $compiler + ->write("{\n") + ->indent() + ->subcompile($case->getNode('body')) + ->write("break;\n") + ->outdent() + ->write("}\n"); + } + + if ($this->hasNode('default')) { + $compiler + ->write("default:\n") + ->write("{\n") + ->indent() + ->subcompile($this->getNode('default')) + ->outdent() + ->write("}\n"); + } + + $compiler + ->outdent() + ->write("}\n"); + } +} diff --git a/system/src/Grav/Common/Twig/Node/TwigNodeThrow.php b/system/src/Grav/Common/Twig/Node/TwigNodeThrow.php new file mode 100644 index 0000000..fb65c71 --- /dev/null +++ b/system/src/Grav/Common/Twig/Node/TwigNodeThrow.php @@ -0,0 +1,52 @@ + $message], ['code' => $code], $lineno, $tag); + } + + /** + * Compiles the node to PHP. + * + * @param Compiler $compiler A Twig Compiler instance + * @return void + * @throws LogicException + */ + public function compile(Compiler $compiler): void + { + $compiler->addDebugInfo($this); + + $compiler + ->write('throw new \Grav\Common\Twig\Exception\TwigException(') + ->subcompile($this->getNode('message')) + ->write(', ') + ->write($this->getAttribute('code') ?: 500) + ->write(");\n"); + } +} diff --git a/system/src/Grav/Common/Twig/Node/TwigNodeTryCatch.php b/system/src/Grav/Common/Twig/Node/TwigNodeTryCatch.php new file mode 100644 index 0000000..ddaf49d --- /dev/null +++ b/system/src/Grav/Common/Twig/Node/TwigNodeTryCatch.php @@ -0,0 +1,67 @@ + $try, 'catch' => $catch]; + $nodes = array_filter($nodes); + + parent::__construct($nodes, [], $lineno, $tag); + } + + /** + * Compiles the node to PHP. + * + * @param Compiler $compiler A Twig Compiler instance + * @return void + * @throws LogicException + */ + public function compile(Compiler $compiler): void + { + $compiler->addDebugInfo($this); + + $compiler->write('try {'); + + $compiler + ->indent() + ->subcompile($this->getNode('try')) + ->outdent() + ->write('} catch (\Exception $e) {' . "\n") + ->indent() + ->write('if (isset($context[\'grav\'][\'debugger\'])) $context[\'grav\'][\'debugger\']->addException($e);' . "\n") + ->write('$context[\'e\'] = $e;' . "\n"); + + if ($this->hasNode('catch')) { + $compiler->subcompile($this->getNode('catch')); + } + + $compiler + ->outdent() + ->write("}\n"); + } +} diff --git a/system/src/Grav/Common/Twig/TokenParser/TwigTokenParserCache.php b/system/src/Grav/Common/Twig/TokenParser/TwigTokenParserCache.php new file mode 100644 index 0000000..831abf0 --- /dev/null +++ b/system/src/Grav/Common/Twig/TokenParser/TwigTokenParserCache.php @@ -0,0 +1,74 @@ +parser->getStream(); + $lineno = $token->getLine(); + + // Parse the optional key and timeout parameters + $defaults = [ + 'key' => $this->parser->getVarName() . $lineno, + 'lifetime' => Grav::instance()['cache']->getLifetime() + ]; + + $key = null; + $lifetime = null; + while (!$stream->test(Token::BLOCK_END_TYPE)) { + if ($stream->test(Token::STRING_TYPE)) { + $key = $this->parser->getExpressionParser()->parseExpression(); + } elseif ($stream->test(Token::NUMBER_TYPE)) { + $lifetime = $this->parser->getExpressionParser()->parseExpression(); + } else { + throw new \Twig\Error\SyntaxError("Unexpected token type in cache tag.", $token->getLine(), $stream->getSourceContext()); + } + } + + $stream->expect(Token::BLOCK_END_TYPE); + + // Parse the content inside the cache block + $body = $this->parser->subparse([$this, 'decideCacheEnd'], true); + + $stream->expect(Token::BLOCK_END_TYPE); + + return new TwigNodeCache($body, $key, $lifetime, $defaults, $lineno, $this->getTag()); + } + + public function decideCacheEnd(Token $token): bool + { + return $token->test('endcache'); + } + + public function getTag(): string + { + return 'cache'; + } +} \ No newline at end of file diff --git a/system/src/Grav/Common/Twig/TokenParser/TwigTokenParserLink.php b/system/src/Grav/Common/Twig/TokenParser/TwigTokenParserLink.php new file mode 100644 index 0000000..737d05f --- /dev/null +++ b/system/src/Grav/Common/Twig/TokenParser/TwigTokenParserLink.php @@ -0,0 +1,109 @@ +getLine(); + + [$rel, $file, $group, $priority, $attributes] = $this->parseArguments($token); + + return new TwigNodeLink($rel, $file, $group, $priority, $attributes, $lineno, $this->getTag()); + } + + /** + * @param Token $token + * @return array + */ + protected function parseArguments(Token $token): array + { + $stream = $this->parser->getStream(); + + + $rel = null; + if ($stream->test(Token::NAME_TYPE, $this->rel)) { + $rel = $stream->getCurrent()->getValue(); + $stream->next(); + } + + $file = null; + if (!$stream->test(Token::NAME_TYPE) && !$stream->test(Token::BLOCK_END_TYPE)) { + $file = $this->parser->getExpressionParser()->parseExpression(); + } + + $group = null; + if ($stream->nextIf(Token::NAME_TYPE, 'at')) { + $group = $this->parser->getExpressionParser()->parseExpression(); + } + + $priority = null; + if ($stream->nextIf(Token::NAME_TYPE, 'priority')) { + $stream->expect(Token::PUNCTUATION_TYPE, ':'); + $priority = $this->parser->getExpressionParser()->parseExpression(); + } + + $attributes = null; + if ($stream->nextIf(Token::NAME_TYPE, 'with')) { + $attributes = $this->parser->getExpressionParser()->parseExpression(); + } + + $stream->expect(Token::BLOCK_END_TYPE); + + return [$rel, $file, $group, $priority, $attributes]; + } + + /** + * Gets the tag name associated with this token parser. + * + * @return string The tag name + */ + public function getTag(): string + { + return 'link'; + } +} diff --git a/system/src/Grav/Common/Twig/TokenParser/TwigTokenParserMarkdown.php b/system/src/Grav/Common/Twig/TokenParser/TwigTokenParserMarkdown.php new file mode 100644 index 0000000..581df50 --- /dev/null +++ b/system/src/Grav/Common/Twig/TokenParser/TwigTokenParserMarkdown.php @@ -0,0 +1,59 @@ +getLine(); + $this->parser->getStream()->expect(Token::BLOCK_END_TYPE); + $body = $this->parser->subparse([$this, 'decideMarkdownEnd'], true); + $this->parser->getStream()->expect(Token::BLOCK_END_TYPE); + return new TwigNodeMarkdown($body, $lineno, $this->getTag()); + } + /** + * Decide if current token marks end of Markdown block. + * + * @param Token $token + * @return bool + */ + public function decideMarkdownEnd(Token $token): bool + { + return $token->test('endmarkdown'); + } + /** + * {@inheritdoc} + */ + public function getTag(): string + { + return 'markdown'; + } +} diff --git a/system/src/Grav/Common/Twig/TokenParser/TwigTokenParserRender.php b/system/src/Grav/Common/Twig/TokenParser/TwigTokenParserRender.php new file mode 100644 index 0000000..f892ea2 --- /dev/null +++ b/system/src/Grav/Common/Twig/TokenParser/TwigTokenParserRender.php @@ -0,0 +1,74 @@ +getLine(); + + [$object, $layout, $context] = $this->parseArguments($token); + + return new TwigNodeRender($object, $layout, $context, $lineno, $this->getTag()); + } + + /** + * @param Token $token + * @return array + */ + protected function parseArguments(Token $token): array + { + $stream = $this->parser->getStream(); + + $object = $this->parser->getExpressionParser()->parseExpression(); + + $layout = null; + if ($stream->nextIf(Token::NAME_TYPE, 'layout')) { + $stream->expect(Token::PUNCTUATION_TYPE, ':'); + $layout = $this->parser->getExpressionParser()->parseExpression(); + } + + $context = null; + if ($stream->nextIf(Token::NAME_TYPE, 'with')) { + $context = $this->parser->getExpressionParser()->parseExpression(); + } + + $stream->expect(Token::BLOCK_END_TYPE); + + return [$object, $layout, $context]; + } + + /** + * Gets the tag name associated with this token parser. + * + * @return string The tag name + */ + public function getTag(): string + { + return 'render'; + } +} diff --git a/system/src/Grav/Common/Twig/TokenParser/TwigTokenParserScript.php b/system/src/Grav/Common/Twig/TokenParser/TwigTokenParserScript.php new file mode 100644 index 0000000..073d93d --- /dev/null +++ b/system/src/Grav/Common/Twig/TokenParser/TwigTokenParserScript.php @@ -0,0 +1,132 @@ +getLine(); + $stream = $this->parser->getStream(); + + [$type, $file, $group, $priority, $attributes] = $this->parseArguments($token); + + $content = null; + if ($file === null) { + $content = $this->parser->subparse([$this, 'decideBlockEnd'], true); + $stream->expect(Token::BLOCK_END_TYPE); + } + + return new TwigNodeScript($content, $type, $file, $group, $priority, $attributes, $lineno, $this->getTag()); + } + + /** + * @param Token $token + * @return array + */ + protected function parseArguments(Token $token): array + { + $stream = $this->parser->getStream(); + + // Look for deprecated {% script ... in ... %} + if (!$stream->test(Token::BLOCK_END_TYPE) && !$stream->test(Token::OPERATOR_TYPE, 'in')) { + $i = 0; + do { + $token = $stream->look(++$i); + if ($token->test(Token::BLOCK_END_TYPE)) { + break; + } + if ($token->test(Token::OPERATOR_TYPE, 'in') && $stream->look($i+1)->test(Token::STRING_TYPE)) { + user_error("Twig: Using {% script ... in ... %} is deprecated, use {% script ... at ... %} instead", E_USER_DEPRECATED); + + break; + } + } while (true); + } + + $type = null; + if ($stream->test(Token::NAME_TYPE, 'module')) { + $type = $stream->getCurrent()->getValue(); + $stream->next(); + } + + $file = null; + if (!$stream->test(Token::NAME_TYPE) && !$stream->test(Token::OPERATOR_TYPE, 'in') && !$stream->test(Token::BLOCK_END_TYPE)) { + $file = $this->parser->getExpressionParser()->parseExpression(); + } + + $group = null; + if ($stream->nextIf(Token::NAME_TYPE, 'at') || $stream->nextIf(Token::OPERATOR_TYPE, 'in')) { + $group = $this->parser->getExpressionParser()->parseExpression(); + } + + $priority = null; + if ($stream->nextIf(Token::NAME_TYPE, 'priority')) { + $stream->expect(Token::PUNCTUATION_TYPE, ':'); + $priority = $this->parser->getExpressionParser()->parseExpression(); + } + + $attributes = null; + if ($stream->nextIf(Token::NAME_TYPE, 'with')) { + $attributes = $this->parser->getExpressionParser()->parseExpression(); + } + + $stream->expect(Token::BLOCK_END_TYPE); + + return [$type, $file, $group, $priority, $attributes]; + } + + /** + * @param Token $token + * @return bool + */ + public function decideBlockEnd(Token $token): bool + { + return $token->test('endscript'); + } + + /** + * Gets the tag name associated with this token parser. + * + * @return string The tag name + */ + public function getTag(): string + { + return 'script'; + } +} diff --git a/system/src/Grav/Common/Twig/TokenParser/TwigTokenParserStyle.php b/system/src/Grav/Common/Twig/TokenParser/TwigTokenParserStyle.php new file mode 100644 index 0000000..590394d --- /dev/null +++ b/system/src/Grav/Common/Twig/TokenParser/TwigTokenParserStyle.php @@ -0,0 +1,119 @@ +getLine(); + $stream = $this->parser->getStream(); + + [$file, $group, $priority, $attributes] = $this->parseArguments($token); + + $content = null; + if (!$file) { + $content = $this->parser->subparse([$this, 'decideBlockEnd'], true); + $stream->expect(Token::BLOCK_END_TYPE); + } + + return new TwigNodeStyle($content, $file, $group, $priority, $attributes, $lineno, $this->getTag()); + } + + /** + * @param Token $token + * @return array + */ + protected function parseArguments(Token $token): array + { + $stream = $this->parser->getStream(); + + // Look for deprecated {% style ... in ... %} + if (!$stream->test(Token::BLOCK_END_TYPE) && !$stream->test(Token::OPERATOR_TYPE, 'in')) { + $i = 0; + do { + $token = $stream->look(++$i); + if ($token->test(Token::BLOCK_END_TYPE)) { + break; + } + if ($token->test(Token::OPERATOR_TYPE, 'in') && $stream->look($i+1)->test(Token::STRING_TYPE)) { + user_error("Twig: Using {% style ... in ... %} is deprecated, use {% style ... at ... %} instead", E_USER_DEPRECATED); + + break; + } + } while (true); + } + + $file = null; + if (!$stream->test(Token::NAME_TYPE) && !$stream->test(Token::OPERATOR_TYPE, 'in') && !$stream->test(Token::BLOCK_END_TYPE)) { + $file = $this->parser->getExpressionParser()->parseExpression(); + } + + $group = null; + if ($stream->nextIf(Token::NAME_TYPE, 'at') || $stream->nextIf(Token::OPERATOR_TYPE, 'in')) { + $group = $this->parser->getExpressionParser()->parseExpression(); + } + + $priority = null; + if ($stream->nextIf(Token::NAME_TYPE, 'priority')) { + $stream->expect(Token::PUNCTUATION_TYPE, ':'); + $priority = $this->parser->getExpressionParser()->parseExpression(); + } + + $attributes = null; + if ($stream->nextIf(Token::NAME_TYPE, 'with')) { + $attributes = $this->parser->getExpressionParser()->parseExpression(); + } + + $stream->expect(Token::BLOCK_END_TYPE); + + return [$file, $group, $priority, $attributes]; + } + + /** + * @param Token $token + * @return bool + */ + public function decideBlockEnd(Token $token): bool + { + return $token->test('endstyle'); + } + + /** + * Gets the tag name associated with this token parser. + * + * @return string The tag name + */ + public function getTag(): string + { + return 'style'; + } +} diff --git a/system/src/Grav/Common/Twig/TokenParser/TwigTokenParserSwitch.php b/system/src/Grav/Common/Twig/TokenParser/TwigTokenParserSwitch.php new file mode 100644 index 0000000..c2806f8 --- /dev/null +++ b/system/src/Grav/Common/Twig/TokenParser/TwigTokenParserSwitch.php @@ -0,0 +1,132 @@ +getLine(); + $stream = $this->parser->getStream(); + + $name = $this->parser->getExpressionParser()->parseExpression(); + $stream->expect(Token::BLOCK_END_TYPE); + + // There can be some whitespace between the {% switch %} and first {% case %} tag. + while ($stream->getCurrent()->getType() === Token::TEXT_TYPE && trim($stream->getCurrent()->getValue()) === '') { + $stream->next(); + } + + $stream->expect(Token::BLOCK_START_TYPE); + + $expressionParser = $this->parser->getExpressionParser(); + + $default = null; + $cases = []; + $end = false; + + while (!$end) { + $next = $stream->next(); + + switch ($next->getValue()) { + case 'case': + $values = []; + + while (true) { + $values[] = $expressionParser->parsePrimaryExpression(); + // Multiple allowed values? + if ($stream->test(Token::OPERATOR_TYPE, 'or')) { + $stream->next(); + } else { + break; + } + } + + $stream->expect(Token::BLOCK_END_TYPE); + $body = $this->parser->subparse([$this, 'decideIfFork']); + $cases[] = new Node([ + 'values' => new Node($values), + 'body' => $body + ]); + break; + + case 'default': + $stream->expect(Token::BLOCK_END_TYPE); + $default = $this->parser->subparse([$this, 'decideIfEnd']); + break; + + case 'endswitch': + $end = true; + break; + + default: + throw new SyntaxError(sprintf('Unexpected end of template. Twig was looking for the following tags "case", "default", or "endswitch" to close the "switch" block started at line %d)', $lineno), -1); + } + } + + $stream->expect(Token::BLOCK_END_TYPE); + + return new TwigNodeSwitch($name, new Node($cases), $default, $lineno, $this->getTag()); + } + + /** + * Decide if current token marks switch logic. + * + * @param Token $token + * @return bool + */ + public function decideIfFork(Token $token): bool + { + return $token->test(['case', 'default', 'endswitch']); + } + + /** + * Decide if current token marks end of swtich block. + * + * @param Token $token + * @return bool + */ + public function decideIfEnd(Token $token): bool + { + return $token->test(['endswitch']); + } + + /** + * {@inheritdoc} + */ + public function getTag(): string + { + return 'switch'; + } +} diff --git a/system/src/Grav/Common/Twig/TokenParser/TwigTokenParserThrow.php b/system/src/Grav/Common/Twig/TokenParser/TwigTokenParserThrow.php new file mode 100644 index 0000000..3b517af --- /dev/null +++ b/system/src/Grav/Common/Twig/TokenParser/TwigTokenParserThrow.php @@ -0,0 +1,55 @@ + + * {% throw 404 'Not Found' %} + * + */ +class TwigTokenParserThrow extends AbstractTokenParser +{ + /** + * Parses a token and returns a node. + * + * @param Token $token + * @return TwigNodeThrow + * @throws SyntaxError + */ + public function parse(Token $token) + { + $lineno = $token->getLine(); + $stream = $this->parser->getStream(); + + $code = $stream->expect(Token::NUMBER_TYPE)->getValue(); + $message = $this->parser->getExpressionParser()->parseExpression(); + $stream->expect(Token::BLOCK_END_TYPE); + + return new TwigNodeThrow((int)$code, $message, $lineno, $this->getTag()); + } + + /** + * Gets the tag name associated with this token parser. + * + * @return string The tag name + */ + public function getTag(): string + { + return 'throw'; + } +} diff --git a/system/src/Grav/Common/Twig/TokenParser/TwigTokenParserTryCatch.php b/system/src/Grav/Common/Twig/TokenParser/TwigTokenParserTryCatch.php new file mode 100644 index 0000000..dcb183b --- /dev/null +++ b/system/src/Grav/Common/Twig/TokenParser/TwigTokenParserTryCatch.php @@ -0,0 +1,81 @@ + + * {% try %} + *
  • {{ user.get('name') }}
    • + * {% catch %} + * {{ e.message }} + * {% endcatch %} + * + */ +class TwigTokenParserTryCatch extends AbstractTokenParser +{ + /** + * Parses a token and returns a node. + * + * @param Token $token + * @return TwigNodeTryCatch + * @throws SyntaxError + */ + public function parse(Token $token) + { + $lineno = $token->getLine(); + $stream = $this->parser->getStream(); + + $stream->expect(Token::BLOCK_END_TYPE); + $try = $this->parser->subparse([$this, 'decideCatch']); + $stream->next(); + $stream->expect(Token::BLOCK_END_TYPE); + $catch = $this->parser->subparse([$this, 'decideEnd']); + $stream->next(); + $stream->expect(Token::BLOCK_END_TYPE); + + return new TwigNodeTryCatch($try, $catch, $lineno, $this->getTag()); + } + + /** + * @param Token $token + * @return bool + */ + public function decideCatch(Token $token): bool + { + return $token->test(['catch']); + } + + /** + * @param Token $token + * @return bool + */ + public function decideEnd(Token $token): bool + { + return $token->test(['endtry']) || $token->test(['endcatch']); + } + + /** + * Gets the tag name associated with this token parser. + * + * @return string The tag name + */ + public function getTag(): string + { + return 'try'; + } +} diff --git a/system/src/Grav/Common/Twig/Twig.php b/system/src/Grav/Common/Twig/Twig.php new file mode 100644 index 0000000..14f33f0 --- /dev/null +++ b/system/src/Grav/Common/Twig/Twig.php @@ -0,0 +1,571 @@ +grav = $grav; + $this->twig_paths = []; + } + + /** + * Twig initialization that sets the twig loader chain, then the environment, then extensions + * and also the base set of twig vars + * + * @return $this + */ + public function init() + { + if (null === $this->twig) { + /** @var Config $config */ + $config = $this->grav['config']; + /** @var UniformResourceLocator $locator */ + $locator = $this->grav['locator']; + /** @var Language $language */ + $language = $this->grav['language']; + + $active_language = $language->getActive(); + + // handle language templates if available + if ($language->enabled()) { + $lang_templates = $locator->findResource('theme://templates/' . ($active_language ?: $language->getDefault())); + if ($lang_templates) { + $this->twig_paths[] = $lang_templates; + } + } + + $this->twig_paths = array_merge($this->twig_paths, $locator->findResources('theme://templates')); + + $this->grav->fireEvent('onTwigTemplatePaths'); + + // Add Grav core templates location + $core_templates = array_merge($locator->findResources('system://templates'), $locator->findResources('system://templates/testing')); + $this->twig_paths = array_merge($this->twig_paths, $core_templates); + + $this->loader = new FilesystemLoader($this->twig_paths); + + // Register all other prefixes as namespaces in twig + foreach ($locator->getPaths('theme') as $prefix => $_) { + if ($prefix === '') { + continue; + } + + $twig_paths = []; + + // handle language templates if available + if ($language->enabled()) { + $lang_templates = $locator->findResource('theme://'.$prefix.'templates/' . ($active_language ?: $language->getDefault())); + if ($lang_templates) { + $twig_paths[] = $lang_templates; + } + } + + $twig_paths = array_merge($twig_paths, $locator->findResources('theme://'.$prefix.'templates')); + + $namespace = trim($prefix, '/'); + $this->loader->setPaths($twig_paths, $namespace); + } + + $this->grav->fireEvent('onTwigLoader'); + + $this->loaderArray = new ArrayLoader([]); + $loader_chain = new ChainLoader([$this->loaderArray, $this->loader]); + + $params = $config->get('system.twig'); + if (!empty($params['cache'])) { + $cachePath = $locator->findResource('cache://twig', true, true); + $params['cache'] = new FilesystemCache($cachePath, FilesystemCache::FORCE_BYTECODE_INVALIDATION); + } + + if (!$config->get('system.strict_mode.twig_compat', false)) { + // Force autoescape on for all files if in strict mode. + $params['autoescape'] = 'html'; + } elseif (!empty($this->autoescape)) { + $params['autoescape'] = $this->autoescape ? 'html' : false; + } + + if (empty($params['autoescape'])) { + user_error('Grav 2.0 will have Twig auto-escaping forced on (can be emulated by turning off \'system.strict_mode.twig_compat\' setting in your configuration)', E_USER_DEPRECATED); + } + + $this->twig = new TwigEnvironment($loader_chain, $params); + + $this->twig->registerUndefinedFunctionCallback(function (string $name) use ($config) { + $allowed = $config->get('system.twig.safe_functions'); + if (is_array($allowed) && in_array($name, $allowed, true) && function_exists($name)) { + return new TwigFunction($name, $name); + } + if ($config->get('system.twig.undefined_functions')) { + if (function_exists($name)) { + if (!Utils::isDangerousFunction($name)) { + user_error("PHP function {$name}() was used as Twig function. This is deprecated in Grav 1.7. Please add it to system configuration: `system.twig.safe_functions`", E_USER_DEPRECATED); + + return new TwigFunction($name, $name); + } + + /** @var Debugger $debugger */ + $debugger = $this->grav['debugger']; + $debugger->addException(new RuntimeException("Blocked potentially dangerous PHP function {$name}() being used as Twig function. If you really want to use it, please add it to system configuration: `system.twig.safe_functions`")); + } + + return new TwigFunction($name, static function () {}); + } + + return false; + }); + + $this->twig->registerUndefinedFilterCallback(function (string $name) use ($config) { + $allowed = $config->get('system.twig.safe_filters'); + if (is_array($allowed) && in_array($name, $allowed, true) && function_exists($name)) { + return new TwigFilter($name, $name); + } + if ($config->get('system.twig.undefined_filters')) { + if (function_exists($name)) { + if (!Utils::isDangerousFunction($name)) { + user_error("PHP function {$name}() used as Twig filter. This is deprecated in Grav 1.7. Please add it to system configuration: `system.twig.safe_filters`", E_USER_DEPRECATED); + + return new TwigFilter($name, $name); + } + + /** @var Debugger $debugger */ + $debugger = $this->grav['debugger']; + $debugger->addException(new RuntimeException("Blocked potentially dangerous PHP function {$name}() being used as Twig filter. If you really want to use it, please add it to system configuration: `system.twig.safe_filters`")); + } + + return new TwigFilter($name, static function () {}); + } + + return false; + }); + + $this->grav->fireEvent('onTwigInitialized'); + + // set default date format if set in config + if ($config->get('system.pages.dateformat.long')) { + /** @var CoreExtension $extension */ + $extension = $this->twig->getExtension(CoreExtension::class); + $extension->setDateFormat($config->get('system.pages.dateformat.long')); + } + // enable the debug extension if required + if ($config->get('system.twig.debug')) { + $this->twig->addExtension(new DebugExtension()); + } + $this->twig->addExtension(new GravExtension()); + $this->twig->addExtension(new FilesystemExtension()); + $this->twig->addExtension(new DeferredExtension()); + $this->twig->addExtension(new StringLoaderExtension()); + + /** @var Debugger $debugger */ + $debugger = $this->grav['debugger']; + $debugger->addTwigProfiler($this->twig); + + $this->grav->fireEvent('onTwigExtensions'); + + /** @var Pages $pages */ + $pages = $this->grav['pages']; + + // Set some standard variables for twig + $this->twig_vars += [ + 'config' => $config, + 'system' => $config->get('system'), + 'theme' => $config->get('theme'), + 'site' => $config->get('site'), + 'uri' => $this->grav['uri'], + 'assets' => $this->grav['assets'], + 'taxonomy' => $this->grav['taxonomy'], + 'browser' => $this->grav['browser'], + 'base_dir' => GRAV_ROOT, + 'home_url' => $pages->homeUrl($active_language), + 'base_url' => $pages->baseUrl($active_language), + 'base_url_absolute' => $pages->baseUrl($active_language, true), + 'base_url_relative' => $pages->baseUrl($active_language, false), + 'base_url_simple' => $this->grav['base_url'], + 'theme_dir' => $locator->findResource('theme://'), + 'theme_url' => $this->grav['base_url'] . '/' . $locator->findResource('theme://', false), + 'html_lang' => $this->grav['language']->getActive() ?: $config->get('site.default_lang', 'en'), + 'language_codes' => new LanguageCodes, + ]; + } + + return $this; + } + + /** + * @return Environment + */ + public function twig() + { + return $this->twig; + } + + /** + * @return FilesystemLoader + */ + public function loader() + { + return $this->loader; + } + + /** + * @return Profile + */ + public function profile() + { + return $this->profile; + } + + + /** + * Adds or overrides a template. + * + * @param string $name The template name + * @param string $template The template source + */ + public function setTemplate($name, $template) + { + $this->loaderArray->setTemplate($name, $template); + } + + /** + * Twig process that renders a page item. It supports two variations: + * 1) Handles modular pages by rendering a specific page based on its modular twig template + * 2) Renders individual page items for twig processing before the site rendering + * + * @param PageInterface $item The page item to render + * @param string|null $content Optional content override + * + * @return string The rendered output + */ + public function processPage(PageInterface $item, $content = null) + { + $content = $content ?? $item->content(); + + // override the twig header vars for local resolution + $this->grav->fireEvent('onTwigPageVariables', new Event(['page' => $item])); + $twig_vars = $this->twig_vars; + + $twig_vars['page'] = $item; + $twig_vars['media'] = $item->media(); + $twig_vars['header'] = $item->header(); + $local_twig = clone $this->twig; + + $output = ''; + + try { + if ($item->isModule()) { + $twig_vars['content'] = $content; + $template = $this->getPageTwigTemplate($item); + $output = $content = $local_twig->render($template, $twig_vars); + } + + // Process in-page Twig + if ($item->shouldProcess('twig')) { + $name = '@Page:' . $item->path(); + $this->setTemplate($name, $content); + $output = $local_twig->render($name, $twig_vars); + } + + } catch (LoaderError $e) { + throw new RuntimeException($e->getRawMessage(), 400, $e); + } + + return $output; + } + + /** + * Process a Twig template directly by using a template name + * and optional array of variables + * + * @param string $template template to render with + * @param array $vars Optional variables + * + * @return string + */ + public function processTemplate($template, $vars = []) + { + // override the twig header vars for local resolution + $this->grav->fireEvent('onTwigTemplateVariables'); + $vars += $this->twig_vars; + + try { + $output = $this->twig->render($template, $vars); + } catch (LoaderError $e) { + throw new RuntimeException($e->getRawMessage(), 404, $e); + } + + return $output; + } + + + /** + * Process a Twig template directly by using a Twig string + * and optional array of variables + * + * @param string $string string to render. + * @param array $vars Optional variables + * + * @return string + */ + public function processString($string, array $vars = []) + { + // override the twig header vars for local resolution + $this->grav->fireEvent('onTwigStringVariables'); + $vars += $this->twig_vars; + + $name = '@Var:' . $string; + $this->setTemplate($name, $string); + + try { + $output = $this->twig->render($name, $vars); + } catch (LoaderError $e) { + throw new RuntimeException($e->getRawMessage(), 404, $e); + } + + return $output; + } + + /** + * Twig process that renders the site layout. This is the main twig process that renders the overall + * page and handles all the layout for the site display. + * + * @param string|null $format Output format (defaults to HTML). + * @param array $vars + * @return string the rendered output + * @throws RuntimeException + */ + public function processSite($format = null, array $vars = []) + { + try { + $grav = $this->grav; + + // set the page now its been processed + $grav->fireEvent('onTwigSiteVariables'); + + /** @var Pages $pages */ + $pages = $grav['pages']; + + /** @var PageInterface $page */ + $page = $grav['page']; + + $twig_vars = $this->twig_vars; + $twig_vars['theme'] = $grav['config']->get('theme'); + $twig_vars['pages'] = $pages->root(); + $twig_vars['page'] = $page; + $twig_vars['header'] = $page->header(); + $twig_vars['media'] = $page->media(); + $twig_vars['content'] = $page->content(); + + // determine if params are set, if so disable twig cache + $params = $grav['uri']->params(null, true); + if (!empty($params)) { + $this->twig->setCache(false); + } + + // Get Twig template layout + $template = $this->getPageTwigTemplate($page, $format); + $page->templateFormat($format); + + $output = $this->twig->render($template, $vars + $twig_vars); + } catch (LoaderError $e) { + throw new RuntimeException($e->getMessage(), 400, $e); + } catch (RuntimeError $e) { + $prev = $e->getPrevious(); + if ($prev instanceof TwigException) { + $code = $prev->getCode() ?: 500; + // Fire onPageNotFound event. + $event = new Event([ + 'page' => $page, + 'code' => $code, + 'message' => $prev->getMessage(), + 'exception' => $prev, + 'route' => $grav['route'], + 'request' => $grav['request'] + ]); + $event = $grav->fireEvent("onDisplayErrorPage.{$code}", $event); + $newPage = $event['page']; + if ($newPage && $newPage !== $page) { + unset($grav['page']); + $grav['page'] = $newPage; + + return $this->processSite($newPage->templateFormat(), $vars); + } + } + + throw $e; + } + + return $output; + } + + /** + * Wraps the FilesystemLoader addPath method (should be used only in `onTwigLoader()` event + * @param string $template_path + * @param string $namespace + * @throws LoaderError + */ + public function addPath($template_path, $namespace = '__main__') + { + $this->loader->addPath($template_path, $namespace); + } + + /** + * Wraps the FilesystemLoader prependPath method (should be used only in `onTwigLoader()` event + * @param string $template_path + * @param string $namespace + * @throws LoaderError + */ + public function prependPath($template_path, $namespace = '__main__') + { + $this->loader->prependPath($template_path, $namespace); + } + + /** + * Simple helper method to get the twig template if it has already been set, else return + * the one being passed in + * NOTE: Modular pages that are injected should not use this pre-set template as it's usually set at the page level + * + * @param string $template the template name + * @return string the template name + */ + public function template(string $template): string + { + if (isset($this->template)) { + $template = $this->template; + unset($this->template); + } + + return $template; + } + + /** + * @param PageInterface $page + * @param string|null $format + * @return string + */ + public function getPageTwigTemplate($page, &$format = null) + { + $template = $page->template(); + $default = $page->isModule() ? 'modular/default' : 'default'; + $extension = $format ?: $page->templateFormat(); + $twig_extension = $extension ? '.'. $extension .TWIG_EXT : TEMPLATE_EXT; + $template_file = $this->template($template . $twig_extension); + + // TODO: no longer needed in Twig 3. + /** @var ExistsLoaderInterface $loader */ + $loader = $this->twig->getLoader(); + if ($loader->exists($template_file)) { + // template.xxx.twig + $page_template = $template_file; + } elseif ($twig_extension !== TEMPLATE_EXT && $loader->exists($template . TEMPLATE_EXT)) { + // template.html.twig + $page_template = $template . TEMPLATE_EXT; + $format = 'html'; + } elseif ($loader->exists($default . $twig_extension)) { + // default.xxx.twig + $page_template = $default . $twig_extension; + } else { + // default.html.twig + $page_template = $default . TEMPLATE_EXT; + $format = 'html'; + } + + return $page_template; + + } + + /** + * Overrides the autoescape setting + * + * @param bool $state + * @return void + * @deprecated 1.5 Auto-escape should always be turned on to protect against XSS issues (can be disabled per template file). + */ + public function setAutoescape($state) + { + if (!$state) { + user_error(__CLASS__ . '::' . __FUNCTION__ . '(false) is deprecated since Grav 1.5', E_USER_DEPRECATED); + } + + $this->autoescape = (bool) $state; + } +} diff --git a/system/src/Grav/Common/Twig/TwigClockworkDataSource.php b/system/src/Grav/Common/Twig/TwigClockworkDataSource.php new file mode 100644 index 0000000..ef1888e --- /dev/null +++ b/system/src/Grav/Common/Twig/TwigClockworkDataSource.php @@ -0,0 +1,58 @@ +twig = $twig; + } + + /** + * Register the Twig profiler extension + */ + public function listenToEvents(): void + { + $this->twig->addExtension(new ProfilerExtension($this->profile = new Profile())); + } + + /** + * Adds rendered views to the request + * + * @param Request $request + * @return Request + */ + public function resolve(Request $request) + { + $timeline = (new TwigClockworkDumper())->dump($this->profile); + + $request->viewsData = array_merge($request->viewsData, $timeline->finalize()); + + return $request; + } +} diff --git a/system/src/Grav/Common/Twig/TwigClockworkDumper.php b/system/src/Grav/Common/Twig/TwigClockworkDumper.php new file mode 100644 index 0000000..904c457 --- /dev/null +++ b/system/src/Grav/Common/Twig/TwigClockworkDumper.php @@ -0,0 +1,72 @@ +dumpProfile($profile, $timeline); + + return $timeline; + } + + /** + * @param Profile $profile + * @param Timeline $timeline + * @param null $parent + */ + public function dumpProfile(Profile $profile, Timeline $timeline, $parent = null) + { + $id = $this->lastId++; + + if ($profile->isRoot()) { + $name = $profile->getName(); + } elseif ($profile->isTemplate()) { + $name = $profile->getTemplate(); + } else { + $name = $profile->getTemplate() . '::' . $profile->getType() . '(' . $profile->getName() . ')'; + } + + foreach ($profile as $p) { + $this->dumpProfile($p, $timeline, $id); + } + + $data = $profile->__serialize(); + + $timeline->event($name, [ + 'name' => $id, + 'start' => $data[3]['wt'] ?? null, + 'end' => $data[4]['wt'] ?? null, + 'data' => [ + 'data' => [], + 'memoryUsage' => $data[4]['mu'] ?? null, + 'parent' => $parent + ] + ]); + } +} diff --git a/system/src/Grav/Common/Twig/TwigEnvironment.php b/system/src/Grav/Common/Twig/TwigEnvironment.php new file mode 100644 index 0000000..9de7929 --- /dev/null +++ b/system/src/Grav/Common/Twig/TwigEnvironment.php @@ -0,0 +1,60 @@ +getLoader(); + if (!$loader->exists($name)) { + continue; + } + } + + // Throws LoaderError: Unable to find template "%s". + return $this->loadTemplate($name); + } + + throw new LoaderError(sprintf('Unable to find one of the following templates: "%s".', implode('", "', $names))); + } +} diff --git a/system/src/Grav/Common/Twig/TwigExtension.php b/system/src/Grav/Common/Twig/TwigExtension.php new file mode 100644 index 0000000..14310e7 --- /dev/null +++ b/system/src/Grav/Common/Twig/TwigExtension.php @@ -0,0 +1,21 @@ +get('system.twig.umask_fix', false); + } + + if (self::$umask) { + $dir = dirname($file); + if (!is_dir($dir)) { + $old = umask(0002); + Folder::create($dir); + umask($old); + } + parent::writeCacheFile($file, $content); + chmod($file, 0775); + } else { + parent::writeCacheFile($file, $content); + } + } +} diff --git a/system/src/Grav/Common/Uri.php b/system/src/Grav/Common/Uri.php new file mode 100644 index 0000000..9d3ef5b --- /dev/null +++ b/system/src/Grav/Common/Uri.php @@ -0,0 +1,1529 @@ +createFromString($env); + } else { + $this->createFromEnvironment(is_array($env) ? $env : $_SERVER); + } + } + + /** + * Initialize the URI class with a url passed via parameter. + * Used for testing purposes. + * + * @param string $url the URL to use in the class + * @return $this + */ + public function initializeWithUrl($url = '') + { + if ($url) { + $this->createFromString($url); + } + + return $this; + } + + /** + * Initialize the URI class by providing url and root_path arguments + * + * @param string $url + * @param string $root_path + * @return $this + */ + public function initializeWithUrlAndRootPath($url, $root_path) + { + $this->initializeWithUrl($url); + $this->root_path = $root_path; + + return $this; + } + + /** + * Validate a hostname + * + * @param string $hostname The hostname + * @return bool + */ + public function validateHostname($hostname) + { + return (bool)preg_match(static::HOSTNAME_REGEX, $hostname); + } + + /** + * Initializes the URI object based on the url set on the object + * + * @return void + */ + public function init() + { + $grav = Grav::instance(); + + /** @var Config $config */ + $config = $grav['config']; + + /** @var Language $language */ + $language = $grav['language']; + + // add the port to the base for non-standard ports + if ($this->port && $config->get('system.reverse_proxy_setup') === false) { + $this->base .= ':' . $this->port; + } + + // Handle custom base + $custom_base = rtrim($grav['config']->get('system.custom_base_url', ''), '/'); + if ($custom_base) { + $custom_parts = parse_url($custom_base); + if ($custom_parts === false) { + throw new RuntimeException('Bad configuration: system.custom_base_url'); + } + $orig_root_path = $this->root_path; + $this->root_path = isset($custom_parts['path']) ? rtrim($custom_parts['path'], '/') : ''; + if (isset($custom_parts['scheme'])) { + $this->base = $custom_parts['scheme'] . '://' . $custom_parts['host']; + $this->port = $custom_parts['port'] ?? null; + if ($this->port && $config->get('system.reverse_proxy_setup') === false) { + $this->base .= ':' . $this->port; + } + $this->root = $custom_base; + } else { + $this->root = $this->base . $this->root_path; + } + $this->uri = Utils::replaceFirstOccurrence($orig_root_path, $this->root_path, $this->uri); + } else { + $this->root = $this->base . $this->root_path; + } + + $this->url = $this->base . $this->uri; + + $uri = Utils::replaceFirstOccurrence(static::filterPath($this->root), '', $this->url); + + // remove the setup.php based base if set: + $setup_base = $grav['pages']->base(); + if ($setup_base) { + $uri = preg_replace('|^' . preg_quote($setup_base, '|') . '|', '', $uri); + } + $this->setup_base = $setup_base; + + // process params + $uri = $this->processParams($uri, $config->get('system.param_sep')); + + // set active language + $uri = $language->setActiveFromUri($uri); + + // split the URL and params (and make sure that the path isn't seen as domain) + $bits = parse_url('http://domain.com' . $uri); + + //process fragment + if (isset($bits['fragment'])) { + $this->fragment = $bits['fragment']; + } + + // Get the path. If there's no path, make sure pathinfo() still returns dirname variable + $path = $bits['path'] ?? '/'; + + // remove the extension if there is one set + $parts = Utils::pathinfo($path); + + // set the original basename + $this->basename = $parts['basename']; + + // set the extension + if (isset($parts['extension'])) { + $this->extension = $parts['extension']; + } + + // Strip the file extension for valid page types + if ($this->isValidExtension($this->extension)) { + $path = Utils::replaceLastOccurrence(".{$this->extension}", '', $path); + } + + // set the new url + $this->url = $this->root . $path; + $this->path = static::cleanPath($path); + $this->content_path = trim(Utils::replaceFirstOccurrence($this->base, '', $this->path), '/'); + if ($this->content_path !== '') { + $this->paths = explode('/', $this->content_path); + } + + // Set some Grav stuff + $grav['base_url_absolute'] = $config->get('system.custom_base_url') ?: $this->rootUrl(true); + $grav['base_url_relative'] = $this->rootUrl(false); + $grav['base_url'] = $config->get('system.absolute_urls') ? $grav['base_url_absolute'] : $grav['base_url_relative']; + + RouteFactory::setRoot($this->root_path . $setup_base); + RouteFactory::setLanguage($language->getLanguageURLPrefix()); + RouteFactory::setParamValueDelimiter($config->get('system.param_sep')); + } + + /** + * Return URI path. + * + * @param int|null $id + * @return string|string[] + */ + public function paths($id = null) + { + if ($id !== null) { + return $this->paths[$id]; + } + + return $this->paths; + } + + /** + * Return route to the current URI. By default route doesn't include base path. + * + * @param bool $absolute True to include full path. + * @param bool $domain True to include domain. Works only if first parameter is also true. + * @return string + */ + public function route($absolute = false, $domain = false) + { + return ($absolute ? $this->rootUrl($domain) : '') . '/' . implode('/', $this->paths); + } + + /** + * Return full query string or a single query attribute. + * + * @param string|null $id Optional attribute. Get a single query attribute if set + * @param bool $raw If true and $id is not set, return the full query array. Otherwise return the query string + * + * @return string|array Returns an array if $id = null and $raw = true + */ + public function query($id = null, $raw = false) + { + if ($id !== null) { + return $this->queries[$id] ?? null; + } + + if ($raw) { + return $this->queries; + } + + if (!$this->queries) { + return ''; + } + + return http_build_query($this->queries); + } + + /** + * Return all or a single query parameter as a URI compatible string. + * + * @param string|null $id Optional parameter name. + * @param boolean $array return the array format or not + * @return null|string|array + */ + public function params($id = null, $array = false) + { + $config = Grav::instance()['config']; + $sep = $config->get('system.param_sep'); + + $params = null; + if ($id === null) { + if ($array) { + return $this->params; + } + $output = []; + foreach ($this->params as $key => $value) { + $output[] = "{$key}{$sep}{$value}"; + $params = '/' . implode('/', $output); + } + } elseif (isset($this->params[$id])) { + if ($array) { + return $this->params[$id]; + } + $params = "/{$id}{$sep}{$this->params[$id]}"; + } + + return $params; + } + + /** + * Get URI parameter. + * + * @param string $id + * @param string|false|null $default + * @return string|false|null + */ + public function param($id, $default = false) + { + if (isset($this->params[$id])) { + return html_entity_decode(rawurldecode($this->params[$id]), ENT_COMPAT | ENT_HTML401, 'UTF-8'); + } + + return $default; + } + + /** + * Gets the Fragment portion of a URI (eg #target) + * + * @param string|null $fragment + * @return string|null + */ + public function fragment($fragment = null) + { + if ($fragment !== null) { + $this->fragment = $fragment; + } + return $this->fragment; + } + + /** + * Return URL. + * + * @param bool $include_host Include hostname. + * @return string + */ + public function url($include_host = false) + { + if ($include_host) { + return $this->url; + } + + $url = Utils::replaceFirstOccurrence($this->base, '', rtrim($this->url, '/')); + + return $url ?: '/'; + } + + /** + * Return the Path + * + * @return string The path of the URI + */ + public function path() + { + return $this->path; + } + + /** + * Return the Extension of the URI + * + * @param string|null $default + * @return string|null The extension of the URI + */ + public function extension($default = null) + { + if (!$this->extension) { + $this->extension = $default; + } + + return $this->extension; + } + + /** + * @return string + */ + public function method() + { + $method = isset($_SERVER['REQUEST_METHOD']) ? strtoupper($_SERVER['REQUEST_METHOD']) : 'GET'; + + if ($method === 'POST' && isset($_SERVER['HTTP_X_HTTP_METHOD_OVERRIDE'])) { + $method = strtoupper($_SERVER['HTTP_X_HTTP_METHOD_OVERRIDE']); + } + + return $method; + } + + /** + * Return the scheme of the URI + * + * @param bool|null $raw + * @return string The scheme of the URI + */ + public function scheme($raw = false) + { + if (!$raw) { + $scheme = ''; + if ($this->scheme) { + $scheme = $this->scheme . '://'; + } elseif ($this->host) { + $scheme = '//'; + } + + return $scheme; + } + + return $this->scheme; + } + + + /** + * Return the host of the URI + * + * @return string|null The host of the URI + */ + public function host() + { + return $this->host; + } + + /** + * Return the port number if it can be figured out + * + * @param bool $raw + * @return int|null + */ + public function port($raw = false) + { + $port = $this->port; + // If not in raw mode and port is not set or is 0, figure it out from scheme. + if (!$raw && !$port) { + if ($this->scheme === 'http') { + $this->port = 80; + } elseif ($this->scheme === 'https') { + $this->port = 443; + } + } + + return $this->port ?: null; + } + + /** + * Return user + * + * @return string|null + */ + public function user() + { + return $this->user; + } + + /** + * Return password + * + * @return string|null + */ + public function password() + { + return $this->password; + } + + /** + * Gets the environment name + * + * @return string + */ + public function environment() + { + return $this->env; + } + + + /** + * Return the basename of the URI + * + * @return string The basename of the URI + */ + public function basename() + { + return $this->basename; + } + + /** + * Return the full uri + * + * @param bool $include_root + * @return string + */ + public function uri($include_root = true) + { + if ($include_root) { + return $this->uri; + } + + return Utils::replaceFirstOccurrence($this->root_path, '', $this->uri); + } + + /** + * Return the base of the URI + * + * @return string The base of the URI + */ + public function base() + { + return $this->base; + } + + /** + * Return the base relative URL including the language prefix + * or the base relative url if multi-language is not enabled + * + * @return string The base of the URI + */ + public function baseIncludingLanguage() + { + $grav = Grav::instance(); + + /** @var Pages $pages */ + $pages = $grav['pages']; + + return $pages->baseUrl(null, false); + } + + /** + * Return root URL to the site. + * + * @param bool $include_host Include hostname. + * @return string + */ + public function rootUrl($include_host = false) + { + if ($include_host) { + return $this->root; + } + + return Utils::replaceFirstOccurrence($this->base, '', $this->root); + } + + /** + * Return current page number. + * + * @return int + */ + public function currentPage() + { + $page = (int)($this->params['page'] ?? 1); + + return max(1, $page); + } + + /** + * Return relative path to the referrer defaulting to current or given page. + * + * You should set the third parameter to `true` for redirects as long as you came from the same sub-site and language. + * + * @param string|null $default + * @param string|null $attributes + * @param bool $withoutBaseRoute + * @return string + */ + public function referrer($default = null, $attributes = null, bool $withoutBaseRoute = false) + { + $referrer = $_SERVER['HTTP_REFERER'] ?? null; + + // Check that referrer came from our site. + if ($withoutBaseRoute) { + /** @var Pages $pages */ + $pages = Grav::instance()['pages']; + $base = $pages->baseUrl(null, true); + } else { + $base = $this->rootUrl(true); + } + + // Referrer should always have host set and it should come from the same base address. + if (!is_string($referrer) || !str_starts_with($referrer, $base)) { + $referrer = $default ?: $this->route(true, true); + } + + // Relative path from grav root. + $referrer = substr($referrer, strlen($base)); + if ($attributes) { + $referrer .= $attributes; + } + + return $referrer; + } + + /** + * @return string + */ + #[\ReturnTypeWillChange] + public function __toString() + { + return static::buildUrl($this->toArray()); + } + + /** + * @return string + */ + public function toOriginalString() + { + return static::buildUrl($this->toArray(true)); + } + + /** + * @param bool $full + * @return array + */ + public function toArray($full = false) + { + if ($full === true) { + $root_path = $this->root_path ?? ''; + $extension = isset($this->extension) && $this->isValidExtension($this->extension) ? '.' . $this->extension : ''; + $path = $root_path . $this->path . $extension; + } else { + $path = $this->path; + } + + return [ + 'scheme' => $this->scheme, + 'host' => $this->host, + 'port' => $this->port ?: null, + 'user' => $this->user, + 'pass' => $this->password, + 'path' => $path, + 'params' => $this->params, + 'query' => $this->query, + 'fragment' => $this->fragment + ]; + } + + /** + * Calculate the parameter regex based on the param_sep setting + * + * @return string + */ + public static function paramsRegex() + { + return '/\/{1,}([^\:\#\/\?]*' . Grav::instance()['config']->get('system.param_sep') . '[^\:\#\/\?]*)/'; + } + + /** + * Return the IP address of the current user + * + * @return string ip address + */ + public static function ip() + { + $ip = 'UNKNOWN'; + + if (getenv('HTTP_CLIENT_IP')) { + $ip = getenv('HTTP_CLIENT_IP'); + } elseif (getenv('HTTP_CF_CONNECTING_IP')) { + $ip = getenv('HTTP_CF_CONNECTING_IP'); + } elseif (getenv('HTTP_X_FORWARDED_FOR') && Grav::instance()['config']->get('system.http_x_forwarded.ip')) { + $ips = array_map('trim', explode(',', getenv('HTTP_X_FORWARDED_FOR'))); + $ip = array_shift($ips); + } elseif (getenv('HTTP_X_FORWARDED') && Grav::instance()['config']->get('system.http_x_forwarded.ip')) { + $ip = getenv('HTTP_X_FORWARDED'); + } elseif (getenv('HTTP_FORWARDED_FOR')) { + $ip = getenv('HTTP_FORWARDED_FOR'); + } elseif (getenv('HTTP_FORWARDED')) { + $ip = getenv('HTTP_FORWARDED'); + } elseif (getenv('REMOTE_ADDR')) { + $ip = getenv('REMOTE_ADDR'); + } + + return $ip; + } + + /** + * Returns current Uri. + * + * @return \Grav\Framework\Uri\Uri + */ + public static function getCurrentUri() + { + if (!static::$currentUri) { + static::$currentUri = UriFactory::createFromEnvironment($_SERVER); + } + + return static::$currentUri; + } + + /** + * Returns current route. + * + * @return Route + */ + public static function getCurrentRoute() + { + if (!static::$currentRoute) { + /** @var Uri $uri */ + $uri = Grav::instance()['uri']; + + static::$currentRoute = RouteFactory::createFromLegacyUri($uri); + } + + return static::$currentRoute; + } + + /** + * Is this an external URL? if it starts with `http` then yes, else false + * + * @param string $url the URL in question + * @return bool is eternal state + */ + public static function isExternal($url) + { + return (0 === strpos($url, 'http://') || 0 === strpos($url, 'https://') || 0 === strpos($url, '//')); + } + + /** + * The opposite of built-in PHP method parse_url() + * + * @param array $parsed_url + * @return string + */ + public static function buildUrl($parsed_url) + { + $scheme = isset($parsed_url['scheme']) ? $parsed_url['scheme'] . ':' : ''; + $authority = isset($parsed_url['host']) ? '//' : ''; + $host = $parsed_url['host'] ?? ''; + $port = isset($parsed_url['port']) ? ':' . $parsed_url['port'] : ''; + $user = $parsed_url['user'] ?? ''; + $pass = isset($parsed_url['pass']) ? ':' . $parsed_url['pass'] : ''; + $pass = ($user || $pass) ? "{$pass}@" : ''; + $path = $parsed_url['path'] ?? ''; + $path = !empty($parsed_url['params']) ? rtrim($path, '/') . static::buildParams($parsed_url['params']) : $path; + $query = !empty($parsed_url['query']) ? '?' . $parsed_url['query'] : ''; + $fragment = isset($parsed_url['fragment']) ? '#' . $parsed_url['fragment'] : ''; + + return "{$scheme}{$authority}{$user}{$pass}{$host}{$port}{$path}{$query}{$fragment}"; + } + + /** + * @param array $params + * @return string + */ + public static function buildParams(array $params) + { + if (!$params) { + return ''; + } + + $grav = Grav::instance(); + $sep = $grav['config']->get('system.param_sep'); + + $output = []; + foreach ($params as $key => $value) { + $output[] = "{$key}{$sep}{$value}"; + } + + return '/' . implode('/', $output); + } + + /** + * Converts links from absolute '/' or relative (../..) to a Grav friendly format + * + * @param PageInterface $page the current page to use as reference + * @param string|array $url the URL as it was written in the markdown + * @param string $type the type of URL, image | link + * @param bool $absolute if null, will use system default, if true will use absolute links internally + * @param bool $route_only only return the route, not full URL path + * @return string|array the more friendly formatted url + */ + public static function convertUrl(PageInterface $page, $url, $type = 'link', $absolute = false, $route_only = false) + { + $grav = Grav::instance(); + + $uri = $grav['uri']; + + // Link processing should prepend language + $language = $grav['language']; + $language_append = ''; + if ($type === 'link' && $language->enabled()) { + $language_append = $language->getLanguageURLPrefix(); + } + + // Handle Excerpt style $url array + $url_path = is_array($url) ? $url['path'] : $url; + + $external = false; + $base = $grav['base_url_relative']; + $base_url = rtrim($base . $grav['pages']->base(), '/') . $language_append; + $pages_dir = $grav['locator']->findResource('page://'); + + // if absolute and starts with a base_url move on + if (isset($url['scheme']) && Utils::startsWith($url['scheme'], 'http')) { + $external = true; + } elseif ($url_path === '' && isset($url['fragment'])) { + $external = true; + } elseif ($url_path === '/' || ($base_url !== '' && Utils::startsWith($url_path, $base_url))) { + $url_path = $base_url . $url_path; + } else { + // see if page is relative to this or absolute + if (Utils::startsWith($url_path, '/')) { + $normalized_url = Utils::normalizePath($base_url . $url_path); + $normalized_path = Utils::normalizePath($pages_dir . $url_path); + } else { + $page_route = ($page->home() && !empty($url_path)) ? $page->rawRoute() : $page->route(); + $normalized_url = $base_url . Utils::normalizePath(rtrim($page_route, '/') . '/' . $url_path); + $normalized_path = Utils::normalizePath($page->path() . '/' . $url_path); + } + + // special check to see if path checking is required. + $just_path = Utils::replaceFirstOccurrence($normalized_url, '', $normalized_path); + if ($normalized_url === '/' || $just_path === $page->path()) { + $url_path = $normalized_url; + } else { + $url_bits = static::parseUrl($normalized_path); + $full_path = $url_bits['path']; + $raw_full_path = rawurldecode($full_path); + + if (file_exists($raw_full_path)) { + $full_path = $raw_full_path; + } elseif (!file_exists($full_path)) { + $full_path = false; + } + + if ($full_path) { + $path_info = Utils::pathinfo($full_path); + $page_path = $path_info['dirname']; + $filename = ''; + + if ($url_path === '..') { + $page_path = $full_path; + } else { + // save the filename if a file is part of the path + if (is_file($full_path)) { + if ($path_info['extension'] !== 'md') { + $filename = '/' . $path_info['basename']; + } + } else { + $page_path = $full_path; + } + } + + // get page instances and try to find one that fits + $instances = $grav['pages']->instances(); + if (isset($instances[$page_path])) { + /** @var PageInterface $target */ + $target = $instances[$page_path]; + $url_bits['path'] = $base_url . rtrim($target->route(), '/') . $filename; + + $url_path = Uri::buildUrl($url_bits); + } else { + $url_path = $normalized_url; + } + } else { + $url_path = $normalized_url; + } + } + } + + // handle absolute URLs + if (is_array($url) && !$external && ($absolute === true || $grav['config']->get('system.absolute_urls', false))) { + $url['scheme'] = $uri->scheme(true); + $url['host'] = $uri->host(); + $url['port'] = $uri->port(true); + + // check if page exists for this route, and if so, check if it has SSL enabled + $pages = $grav['pages']; + $routes = $pages->routes(); + + // if this is an image, get the proper path + $url_bits = Utils::pathinfo($url_path); + if (isset($url_bits['extension'])) { + $target_path = $url_bits['dirname']; + } else { + $target_path = $url_path; + } + + // strip base from this path + $target_path = Utils::replaceFirstOccurrence($uri->rootUrl(), '', $target_path); + + // set to / if root + if (empty($target_path)) { + $target_path = '/'; + } + + // look to see if this page exists and has ssl enabled + if (isset($routes[$target_path])) { + $target_page = $pages->get($routes[$target_path]); + if ($target_page) { + $ssl_enabled = $target_page->ssl(); + if ($ssl_enabled !== null) { + if ($ssl_enabled) { + $url['scheme'] = 'https'; + } else { + $url['scheme'] = 'http'; + } + } + } + } + } + + // Handle route only + if ($route_only) { + $url_path = Utils::replaceFirstOccurrence(static::filterPath($base_url), '', $url_path); + } + + // transform back to string/array as needed + if (is_array($url)) { + $url['path'] = $url_path; + } else { + $url = $url_path; + } + + return $url; + } + + /** + * @param string $url + * @return array|false + */ + public static function parseUrl($url) + { + $grav = Grav::instance(); + + // Remove extra slash from streams, parse_url() doesn't like it. + if ($pos = strpos($url, ':///')) { + $url = substr_replace($url, '://', $pos, 4); + } + + $encodedUrl = preg_replace_callback( + '%[^:/@?&=#]+%usD', + static function ($matches) { + return rawurlencode($matches[0]); + }, + $url + ); + + $parts = parse_url($encodedUrl); + + if (false === $parts) { + return false; + } + + foreach ($parts as $name => $value) { + $parts[$name] = rawurldecode($value); + } + + if (!isset($parts['path'])) { + $parts['path'] = ''; + } + + [$stripped_path, $params] = static::extractParams($parts['path'], $grav['config']->get('system.param_sep')); + + if (!empty($params)) { + $parts['path'] = $stripped_path; + $parts['params'] = $params; + } + + return $parts; + } + + /** + * @param string $uri + * @param string $delimiter + * @return array + */ + public static function extractParams($uri, $delimiter) + { + $params = []; + + if (strpos($uri, $delimiter) !== false) { + preg_match_all(static::paramsRegex(), $uri, $matches, PREG_SET_ORDER); + + foreach ($matches as $match) { + $param = explode($delimiter, $match[1]); + if (count($param) === 2) { + $plain_var = htmlspecialchars(strip_tags(rawurldecode($param[1])), ENT_QUOTES, 'UTF-8'); + $params[$param[0]] = $plain_var; + $uri = str_replace($match[0], '', $uri); + } + } + } + + return [$uri, $params]; + } + + /** + * Converts links from absolute '/' or relative (../..) to a Grav friendly format + * + * @param PageInterface $page the current page to use as reference + * @param string $markdown_url the URL as it was written in the markdown + * @param string $type the type of URL, image | link + * @param bool|null $relative if null, will use system default, if true will use relative links internally + * + * @return string the more friendly formatted url + */ + public static function convertUrlOld(PageInterface $page, $markdown_url, $type = 'link', $relative = null) + { + $grav = Grav::instance(); + + $language = $grav['language']; + + // Link processing should prepend language + $language_append = ''; + if ($type === 'link' && $language->enabled()) { + $language_append = $language->getLanguageURLPrefix(); + } + $pages_dir = $grav['locator']->findResource('page://'); + if ($relative === null) { + $base = $grav['base_url']; + } else { + $base = $relative ? $grav['base_url_relative'] : $grav['base_url_absolute']; + } + + $base_url = rtrim($base . $grav['pages']->base(), '/') . $language_append; + + // if absolute and starts with a base_url move on + if (Utils::pathinfo($markdown_url, PATHINFO_DIRNAME) === '.' && $page->url() === '/') { + return '/' . $markdown_url; + } + // no path to convert + if ($base_url !== '' && Utils::startsWith($markdown_url, $base_url)) { + return $markdown_url; + } + // if contains only a fragment + if (Utils::startsWith($markdown_url, '#')) { + return $markdown_url; + } + + $target = null; + // see if page is relative to this or absolute + if (Utils::startsWith($markdown_url, '/')) { + $normalized_url = Utils::normalizePath($base_url . $markdown_url); + $normalized_path = Utils::normalizePath($pages_dir . $markdown_url); + } else { + $normalized_url = $base_url . Utils::normalizePath($page->route() . '/' . $markdown_url); + $normalized_path = Utils::normalizePath($page->path() . '/' . $markdown_url); + } + + // special check to see if path checking is required. + $just_path = Utils::replaceFirstOccurrence($normalized_url, '', $normalized_path); + if ($just_path === $page->path()) { + return $normalized_url; + } + + $url_bits = parse_url($normalized_path); + $full_path = $url_bits['path']; + + if (file_exists($full_path)) { + // do nothing + } elseif (file_exists(rawurldecode($full_path))) { + $full_path = rawurldecode($full_path); + } else { + return $normalized_url; + } + + $path_info = Utils::pathinfo($full_path); + $page_path = $path_info['dirname']; + $filename = ''; + + if ($markdown_url === '..') { + $page_path = $full_path; + } else { + // save the filename if a file is part of the path + if (is_file($full_path)) { + if ($path_info['extension'] !== 'md') { + $filename = '/' . $path_info['basename']; + } + } else { + $page_path = $full_path; + } + } + + // get page instances and try to find one that fits + $instances = $grav['pages']->instances(); + if (isset($instances[$page_path])) { + /** @var PageInterface $target */ + $target = $instances[$page_path]; + $url_bits['path'] = $base_url . rtrim($target->route(), '/') . $filename; + + return static::buildUrl($url_bits); + } + + return $normalized_url; + } + + /** + * Adds the nonce to a URL for a specific action + * + * @param string $url the url + * @param string $action the action + * @param string $nonceParamName the param name to use + * + * @return string the url with the nonce + */ + public static function addNonce($url, $action, $nonceParamName = 'nonce') + { + $fake = $url && strpos($url, '/') === 0; + + if ($fake) { + $url = 'http://domain.com' . $url; + } + $uri = new static($url); + $parts = $uri->toArray(); + $nonce = Utils::getNonce($action); + $parts['params'] = ($parts['params'] ?? []) + [$nonceParamName => $nonce]; + + if ($fake) { + unset($parts['scheme'], $parts['host']); + } + + return static::buildUrl($parts); + } + + /** + * Is the passed in URL a valid URL? + * + * @param string $url + * @return bool + */ + public static function isValidUrl($url) + { + $regex = '/^(?:(https?|ftp|telnet):)?\/\/((?:[a-z0-9@:.-]|%[0-9A-F]{2}){3,})(?::(\d+))?((?:\/(?:[a-z0-9-._~!$&\'\(\)\*\+\,\;\=\:\@]|%[0-9A-F]{2})*)*)(?:\?((?:[a-z0-9-._~!$&\'\(\)\*\+\,\;\=\:\/?@]|%[0-9A-F]{2})*))?(?:#((?:[a-z0-9-._~!$&\'\(\)\*\+\,\;\=\:\/?@]|%[0-9A-F]{2})*))?/'; + + return (bool)preg_match($regex, $url); + } + + /** + * Removes extra double slashes and fixes back-slashes + * + * @param string $path + * @return string + */ + public static function cleanPath($path) + { + $regex = '/(\/)\/+/'; + $path = str_replace(['\\', '/ /'], '/', $path); + $path = preg_replace($regex, '$1', $path); + + return $path; + } + + /** + * Filters the user info string. + * + * @param string|null $info The raw user or password. + * @return string The percent-encoded user or password string. + */ + public static function filterUserInfo($info) + { + return $info !== null ? UriPartsFilter::filterUserInfo($info) : ''; + } + + /** + * Filter Uri path. + * + * This method percent-encodes all reserved + * characters in the provided path string. This method + * will NOT double-encode characters that are already + * percent-encoded. + * + * @param string|null $path The raw uri path. + * @return string The RFC 3986 percent-encoded uri path. + * @link http://www.faqs.org/rfcs/rfc3986.html + */ + public static function filterPath($path) + { + return $path !== null ? UriPartsFilter::filterPath($path) : ''; + } + + /** + * Filters the query string or fragment of a URI. + * + * @param string|null $query The raw uri query string. + * @return string The percent-encoded query string. + */ + public static function filterQuery($query) + { + return $query !== null ? UriPartsFilter::filterQueryOrFragment($query) : ''; + } + + /** + * @param array $env + * @return void + */ + protected function createFromEnvironment(array $env) + { + // Build scheme. + if (isset($env['HTTP_X_FORWARDED_PROTO']) && Grav::instance()['config']->get('system.http_x_forwarded.protocol')) { + $this->scheme = $env['HTTP_X_FORWARDED_PROTO']; + } elseif (isset($env['X-FORWARDED-PROTO'])) { + $this->scheme = $env['X-FORWARDED-PROTO']; + } elseif (isset($env['HTTP_CLOUDFRONT_FORWARDED_PROTO'])) { + $this->scheme = $env['HTTP_CLOUDFRONT_FORWARDED_PROTO']; + } elseif (isset($env['REQUEST_SCHEME']) && empty($env['HTTPS'])) { + $this->scheme = $env['REQUEST_SCHEME']; + } else { + $https = $env['HTTPS'] ?? ''; + $this->scheme = (empty($https) || strtolower($https) === 'off') ? 'http' : 'https'; + } + + // Build user and password. + $this->user = $env['PHP_AUTH_USER'] ?? null; + $this->password = $env['PHP_AUTH_PW'] ?? null; + + // Build host. + if (isset($env['HTTP_X_FORWARDED_HOST']) && Grav::instance()['config']->get('system.http_x_forwarded.host')) { + $hostname = $env['HTTP_X_FORWARDED_HOST']; + } else if (isset($env['HTTP_HOST'])) { + $hostname = $env['HTTP_HOST']; + } elseif (isset($env['SERVER_NAME'])) { + $hostname = $env['SERVER_NAME']; + } else { + $hostname = 'localhost'; + } + // Remove port from HTTP_HOST generated $hostname + $hostname = Utils::substrToString($hostname, ':'); + // Validate the hostname + $this->host = $this->validateHostname($hostname) ? $hostname : 'unknown'; + + // Build port. + if (isset($env['HTTP_X_FORWARDED_PORT']) && Grav::instance()['config']->get('system.http_x_forwarded.port')) { + $this->port = (int)$env['HTTP_X_FORWARDED_PORT']; + } elseif (isset($env['X-FORWARDED-PORT'])) { + $this->port = (int)$env['X-FORWARDED-PORT']; + } elseif (isset($env['HTTP_CLOUDFRONT_FORWARDED_PROTO'])) { + // Since AWS Cloudfront does not provide a forwarded port header, + // we have to build the port using the scheme. + $this->port = $this->port(); + } elseif (isset($env['SERVER_PORT'])) { + $this->port = (int)$env['SERVER_PORT']; + } else { + $this->port = null; + } + + if ($this->port === 0 || $this->hasStandardPort()) { + $this->port = null; + } + + // Build path. + $request_uri = $env['REQUEST_URI'] ?? ''; + $this->path = rawurldecode(parse_url('http://example.com' . $request_uri, PHP_URL_PATH)); + + // Build query string. + $this->query = $env['QUERY_STRING'] ?? ''; + if ($this->query === '') { + $this->query = parse_url('http://example.com' . $request_uri, PHP_URL_QUERY) ?? ''; + } + + // Support ngnix routes. + if (strpos($this->query, '_url=') === 0) { + parse_str($this->query, $query); + unset($query['_url']); + $this->query = http_build_query($query); + } + + // Build fragment. + $this->fragment = null; + + // Filter userinfo, path and query string. + $this->user = $this->user !== null ? static::filterUserInfo($this->user) : null; + $this->password = $this->password !== null ? static::filterUserInfo($this->password) : null; + $this->path = empty($this->path) ? '/' : static::filterPath($this->path); + $this->query = static::filterQuery($this->query); + + $this->reset(); + } + + /** + * Does this Uri use a standard port? + * + * @return bool + */ + protected function hasStandardPort() + { + return (!$this->port || $this->port === 80 || $this->port === 443); + } + + /** + * @param string $url + */ + protected function createFromString($url) + { + // Set Uri parts. + $parts = parse_url($url); + if ($parts === false) { + throw new RuntimeException('Malformed URL: ' . $url); + } + $port = (int)($parts['port'] ?? 0); + + $this->scheme = $parts['scheme'] ?? null; + $this->user = $parts['user'] ?? null; + $this->password = $parts['pass'] ?? null; + $this->host = $parts['host'] ?? null; + $this->port = $port ?: null; + $this->path = $parts['path'] ?? ''; + $this->query = $parts['query'] ?? ''; + $this->fragment = $parts['fragment'] ?? null; + + // Validate the hostname + if ($this->host) { + $this->host = $this->validateHostname($this->host) ? $this->host : 'unknown'; + } + // Filter userinfo, path, query string and fragment. + $this->user = $this->user !== null ? static::filterUserInfo($this->user) : null; + $this->password = $this->password !== null ? static::filterUserInfo($this->password) : null; + $this->path = empty($this->path) ? '/' : static::filterPath($this->path); + $this->query = static::filterQuery($this->query); + $this->fragment = $this->fragment !== null ? static::filterQuery($this->fragment) : null; + + $this->reset(); + } + + /** + * @return void + */ + protected function reset() + { + // resets + parse_str($this->query, $this->queries); + $this->extension = null; + $this->basename = null; + $this->paths = []; + $this->params = []; + $this->env = $this->buildEnvironment(); + $this->uri = $this->path . (!empty($this->query) ? '?' . $this->query : ''); + + $this->base = $this->buildBaseUrl(); + $this->root_path = $this->buildRootPath(); + $this->root = $this->base . $this->root_path; + $this->url = $this->base . $this->uri; + } + + /** + * Get post from either $_POST or JSON response object + * By default returns all data, or can return a single item + * + * @param string|null $element + * @param string|null $filter_type + * @return array|null + */ + public function post($element = null, $filter_type = null) + { + if (!$this->post) { + $content_type = $this->getContentType(); + if ($content_type === 'application/json') { + $json = file_get_contents('php://input'); + $this->post = json_decode($json, true); + } elseif (!empty($_POST)) { + $this->post = (array)$_POST; + } + + $event = new Event(['post' => &$this->post]); + Grav::instance()->fireEvent('onHttpPostFilter', $event); + } + + if ($this->post && null !== $element) { + $item = Utils::getDotNotation($this->post, $element); + if ($filter_type) { + if ($filter_type === FILTER_SANITIZE_STRING || $filter_type === GRAV_SANITIZE_STRING) { + $item = htmlspecialchars(strip_tags($item), ENT_QUOTES, 'UTF-8'); + } else { + $item = filter_var($item, $filter_type); + } + } + return $item; + } + + return $this->post; + } + + /** + * Get content type from request + * + * @param bool $short + * @return null|string + */ + public function getContentType($short = true) + { + if (isset($_SERVER['CONTENT_TYPE'])) { + $content_type = $_SERVER['CONTENT_TYPE']; + if ($short) { + return Utils::substrToString($content_type, ';'); + } + return $content_type; + } + return null; + } + + /** + * Check if this is a valid Grav extension + * + * @param string|null $extension + * @return bool + */ + public function isValidExtension($extension): bool + { + $extension = (string)$extension; + + return $extension !== '' && in_array($extension, Utils::getSupportPageTypes(), true); + } + + /** + * Allow overriding of any element (be careful!) + * + * @param array $data + * @return Uri + */ + public function setUriProperties($data) + { + foreach (get_object_vars($this) as $property => $default) { + if (!array_key_exists($property, $data)) { + continue; + } + $this->{$property} = $data[$property]; // assign value to object + } + return $this; + } + + + /** + * Compatibility in case getallheaders() is not available on platform + */ + public static function getAllHeaders() + { + if (!function_exists('getallheaders')) { + $headers = []; + foreach ($_SERVER as $name => $value) { + if (substr($name, 0, 5) == 'HTTP_') { + $headers[str_replace(' ', '-', ucwords(strtolower(str_replace('_', ' ', substr($name, 5)))))] = $value; + } + } + return $headers; + } + return getallheaders(); + } + + /** + * Get the base URI with port if needed + * + * @return string + */ + private function buildBaseUrl() + { + return $this->scheme() . $this->host; + } + + /** + * Get the Grav Root Path + * + * @return string + */ + private function buildRootPath() + { + // In Windows script path uses backslash, convert it: + $scriptPath = str_replace('\\', '/', $_SERVER['PHP_SELF']); + $rootPath = str_replace(' ', '%20', rtrim(substr($scriptPath, 0, strpos($scriptPath, 'index.php')), '/')); + + return $rootPath; + } + + /** + * @return string + */ + private function buildEnvironment() + { + // check for localhost variations + if ($this->host === '127.0.0.1' || $this->host === '::1') { + return 'localhost'; + } + + return $this->host ?: 'unknown'; + } + + /** + * Process any params based in this URL, supports any valid delimiter + * + * @param string $uri + * @param string $delimiter + * @return string + */ + private function processParams(string $uri, string $delimiter = ':'): string + { + if (strpos($uri, $delimiter) !== false) { + preg_match_all(static::paramsRegex(), $uri, $matches, PREG_SET_ORDER); + + foreach ($matches as $match) { + $param = explode($delimiter, $match[1]); + if (count($param) === 2) { + $plain_var = htmlspecialchars(strip_tags($param[1]), ENT_QUOTES, 'UTF-8'); + $this->params[$param[0]] = $plain_var; + $uri = str_replace($match[0], '', $uri); + } + } + } + return $uri; + } +} diff --git a/system/src/Grav/Common/User/Access.php b/system/src/Grav/Common/User/Access.php new file mode 100644 index 0000000..5e24d3f --- /dev/null +++ b/system/src/Grav/Common/User/Access.php @@ -0,0 +1,52 @@ + ['admin.configuration_system'], + 'admin.configuration.site' => ['admin.configuration_site', 'admin.settings'], + 'admin.configuration.media' => ['admin.configuration_media'], + 'admin.configuration.info' => ['admin.configuration_info'], + ]; + + /** + * @param string $action + * @return bool|null + */ + public function get(string $action) + { + $result = parent::get($action); + if (is_bool($result)) { + return $result; + } + + // Get access value. + if (isset($this->aliases[$action])) { + $aliases = $this->aliases[$action]; + foreach ($aliases as $alias) { + $result = parent::get($alias); + if (is_bool($result)) { + return $result; + } + } + } + + return null; + } +} diff --git a/system/src/Grav/Common/User/Authentication.php b/system/src/Grav/Common/User/Authentication.php new file mode 100644 index 0000000..53cbf42 --- /dev/null +++ b/system/src/Grav/Common/User/Authentication.php @@ -0,0 +1,61 @@ +get('user/account'); + } + + parent::__construct($items, $blueprints); + } + + /** + * @param string $offset + * @return bool + */ + #[\ReturnTypeWillChange] + public function offsetExists($offset) + { + $value = parent::offsetExists($offset); + + // Handle special case where user was logged in before 'authorized' was added to the user object. + if (false === $value && $offset === 'authorized') { + $value = $this->offsetExists('authenticated'); + } + + return $value; + } + + /** + * @param string $offset + * @return mixed + */ + #[\ReturnTypeWillChange] + public function offsetGet($offset) + { + $value = parent::offsetGet($offset); + + // Handle special case where user was logged in before 'authorized' was added to the user object. + if (null === $value && $offset === 'authorized') { + $value = $this->offsetGet('authenticated'); + $this->offsetSet($offset, $value); + } + + return $value; + } + + /** + * @return bool + */ + public function isValid(): bool + { + return $this->items !== null; + } + + /** + * Update object with data + * + * @param array $data + * @param array $files + * @return $this + */ + public function update(array $data, array $files = []) + { + // Note: $this->merge() would cause infinite loop as it calls this method. + parent::merge($data); + + return $this; + } + + /** + * Save user + * + * @return void + */ + public function save() + { + /** @var CompiledYamlFile|null $file */ + $file = $this->file(); + if (!$file || !$file->filename()) { + user_error(__CLASS__ . ': calling \$user = new ' . __CLASS__ . "() is deprecated since Grav 1.6, use \$grav['accounts']->load(\$username) or \$grav['accounts']->load('') instead", E_USER_DEPRECATED); + } + + if ($file) { + $username = $this->filterUsername((string)$this->get('username')); + + if (!$file->filename()) { + $locator = Grav::instance()['locator']; + $file->filename($locator->findResource('account://' . $username . YAML_EXT, true, true)); + } + + // if plain text password, hash it and remove plain text + $password = $this->get('password') ?? $this->get('password1'); + if (null !== $password && '' !== $password) { + $password2 = $this->get('password2'); + if (!\is_string($password) || ($password2 && $password !== $password2)) { + throw new \RuntimeException('Passwords did not match.'); + } + + $this->set('hashed_password', Authentication::create($password)); + } + $this->undef('password'); + $this->undef('password1'); + $this->undef('password2'); + + $data = $this->items; + if ($username === $data['username']) { + unset($data['username']); + } + unset($data['authenticated'], $data['authorized']); + + $file->save($data); + + // We need to signal Flex Users about the change. + /** @var Flex|null $flex */ + $flex = Grav::instance()['flex'] ?? null; + $users = $flex ? $flex->getDirectory('user-accounts') : null; + if (null !== $users) { + $users->clearCache(); + } + } + } + + /** + * @return MediaCollectionInterface|Media + */ + public function getMedia() + { + if (null === $this->_media) { + // Media object should only contain avatar, nothing else. + $media = new Media($this->getMediaFolder() ?? '', $this->getMediaOrder(), false); + + $path = $this->getAvatarFile(); + if ($path && is_file($path)) { + $medium = MediumFactory::fromFile($path); + if ($medium) { + $media->add(Utils::basename($path), $medium); + } + } + + $this->_media = $media; + } + + return $this->_media; + } + + /** + * @return string + */ + public function getMediaFolder() + { + return $this->blueprints()->fields()['avatar']['destination'] ?? 'account://avatars'; + } + + /** + * @return array + */ + public function getMediaOrder() + { + return []; + } + + /** + * Serialize user. + * + * @return string[] + */ + public function __sleep() + { + return [ + 'items', + 'storage' + ]; + } + + /** + * Unserialize user. + */ + public function __wakeup() + { + $this->gettersVariable = 'items'; + $this->nestedSeparator = '.'; + + if (null === $this->items) { + $this->items = []; + } + + // Always set blueprints. + if (null === $this->blueprints) { + $this->blueprints = (new Blueprints)->get('user/account'); + } + } + + /** + * Merge two configurations together. + * + * @param array $data + * @return $this + * @deprecated 1.6 Use `->update($data)` instead (same but with data validation & filtering, file upload support). + */ + public function merge(array $data) + { + user_error(__CLASS__ . '::' . __FUNCTION__ . '() is deprecated since Grav 1.6, use ->update($data) method instead', E_USER_DEPRECATED); + + return $this->update($data); + } + + /** + * Return media object for the User's avatar. + * + * @return Medium|null + * @deprecated 1.6 Use ->getAvatarImage() method instead. + */ + public function getAvatarMedia() + { + user_error(__CLASS__ . '::' . __FUNCTION__ . '() is deprecated since Grav 1.6, use getAvatarImage() method instead', E_USER_DEPRECATED); + + return $this->getAvatarImage(); + } + + /** + * Return the User's avatar URL + * + * @return string + * @deprecated 1.6 Use ->getAvatarUrl() method instead. + */ + public function avatarUrl() + { + user_error(__CLASS__ . '::' . __FUNCTION__ . '() is deprecated since Grav 1.6, use getAvatarUrl() method instead', E_USER_DEPRECATED); + + return $this->getAvatarUrl(); + } + + /** + * Checks user authorization to the action. + * Ensures backwards compatibility + * + * @param string $action + * @return bool + * @deprecated 1.5 Use ->authorize() method instead. + */ + public function authorise($action) + { + user_error(__CLASS__ . '::' . __FUNCTION__ . '() is deprecated since Grav 1.5, use authorize() method instead', E_USER_DEPRECATED); + + return $this->authorize($action) ?? false; + } + + /** + * Implements Countable interface. + * + * @return int + * @deprecated 1.6 Method makes no sense for user account. + */ + #[\ReturnTypeWillChange] + public function count() + { + user_error(__CLASS__ . '::' . __FUNCTION__ . '() is deprecated since Grav 1.6', E_USER_DEPRECATED); + + return parent::count(); + } + + /** + * @param string $username + * @return string + */ + protected function filterUsername(string $username): string + { + return mb_strtolower($username); + } + + /** + * @return string|null + */ + protected function getAvatarFile(): ?string + { + $avatars = $this->get('avatar'); + if (is_array($avatars) && $avatars) { + $avatar = array_shift($avatars); + return $avatar['path'] ?? null; + } + + return null; + } +} diff --git a/system/src/Grav/Common/User/DataUser/UserCollection.php b/system/src/Grav/Common/User/DataUser/UserCollection.php new file mode 100644 index 0000000..3db16d3 --- /dev/null +++ b/system/src/Grav/Common/User/DataUser/UserCollection.php @@ -0,0 +1,163 @@ +className = $className; + } + + /** + * Load user account. + * + * Always creates user object. To check if user exists, use $this->exists(). + * + * @param string $username + * @return UserInterface + */ + public function load($username): UserInterface + { + $username = (string)$username; + + $grav = Grav::instance(); + /** @var UniformResourceLocator $locator */ + $locator = $grav['locator']; + + // Filter username. + $username = $this->filterUsername($username); + + $filename = 'account://' . $username . YAML_EXT; + $path = $locator->findResource($filename) ?: $locator->findResource($filename, true, true); + if (!is_string($path)) { + throw new RuntimeException('Internal Error'); + } + $file = CompiledYamlFile::instance($path); + $content = (array)$file->content() + ['username' => $username, 'state' => 'enabled']; + + $userClass = $this->className; + $callable = static function () { + $blueprints = new Blueprints; + + return $blueprints->get('user/account'); + }; + + /** @var UserInterface $user */ + $user = new $userClass($content, $callable); + $user->file($file); + + return $user; + } + + /** + * Find a user by username, email, etc + * + * @param string $query the query to search for + * @param array $fields the fields to search + * @return UserInterface + */ + public function find($query, $fields = ['username', 'email']): UserInterface + { + $fields = (array)$fields; + + $grav = Grav::instance(); + /** @var UniformResourceLocator $locator */ + $locator = $grav['locator']; + + $account_dir = $locator->findResource('account://'); + if (!is_string($account_dir)) { + return $this->load(''); + } + + $files = array_diff(scandir($account_dir) ?: [], ['.', '..']); + + // Try with username first, you never know! + if (in_array('username', $fields, true)) { + $user = $this->load($query); + unset($fields[array_search('username', $fields, true)]); + } else { + $user = $this->load(''); + } + + // If not found, try the fields + if (!$user->exists()) { + $query = mb_strtolower($query); + foreach ($files as $file) { + if (Utils::endsWith($file, YAML_EXT)) { + $find_user = $this->load(trim(Utils::pathinfo($file, PATHINFO_FILENAME))); + foreach ($fields as $field) { + if (isset($find_user[$field]) && mb_strtolower($find_user[$field]) === $query) { + return $find_user; + } + } + } + } + } + return $user; + } + + /** + * Remove user account. + * + * @param string $username + * @return bool True if the action was performed + */ + public function delete($username): bool + { + $file_path = Grav::instance()['locator']->findResource('account://' . $username . YAML_EXT); + + return $file_path && unlink($file_path); + } + + /** + * @return int + */ + public function count(): int + { + // check for existence of a user account + $account_dir = $file_path = Grav::instance()['locator']->findResource('account://'); + $accounts = glob($account_dir . '/*.yaml') ?: []; + + return count($accounts); + } + + /** + * @param string $username + * @return string + */ + protected function filterUsername(string $username): string + { + return mb_strtolower($username); + } +} diff --git a/system/src/Grav/Common/User/Group.php b/system/src/Grav/Common/User/Group.php new file mode 100644 index 0000000..7f8ab70 --- /dev/null +++ b/system/src/Grav/Common/User/Group.php @@ -0,0 +1,172 @@ +get('groups', []); + } + + /** + * Get the groups list + * + * @return array + * @deprecated 1.7, use $grav['user_groups'] Flex UserGroupCollection instead + */ + public static function groupNames() + { + user_error(__METHOD__ . '() is deprecated since Grav 1.7, use $grav[\'user_groups\'] Flex UserGroupCollection instead', E_USER_DEPRECATED); + + $groups = []; + + foreach (static::groups() as $groupname => $group) { + $groups[$groupname] = $group['readableName'] ?? $groupname; + } + + return $groups; + } + + /** + * Checks if a group exists + * + * @param string $groupname + * @return bool + * @deprecated 1.7, use $grav['user_groups'] Flex UserGroupCollection instead + */ + public static function groupExists($groupname) + { + user_error(__METHOD__ . '() is deprecated since Grav 1.7, use $grav[\'user_groups\'] Flex UserGroupCollection instead', E_USER_DEPRECATED); + + return isset(self::groups()[$groupname]); + } + + /** + * Get a group by name + * + * @param string $groupname + * @return object + * @deprecated 1.7, use $grav['user_groups'] Flex UserGroupCollection instead + */ + public static function load($groupname) + { + user_error(__METHOD__ . '() is deprecated since Grav 1.7, use $grav[\'user_groups\'] Flex UserGroupCollection instead', E_USER_DEPRECATED); + + $groups = self::groups(); + + $content = $groups[$groupname] ?? []; + $content += ['groupname' => $groupname]; + + $blueprints = new Blueprints(); + $blueprint = $blueprints->get('user/group'); + + return new Group($content, $blueprint); + } + + /** + * Save a group + * + * @return void + */ + public function save() + { + $grav = Grav::instance(); + + /** @var Config $config */ + $config = $grav['config']; + + $blueprints = new Blueprints(); + $blueprint = $blueprints->get('user/group'); + + $config->set("groups.{$this->get('groupname')}", []); + + $fields = $blueprint->fields(); + foreach ($fields as $field) { + if ($field['type'] === 'text') { + $value = $field['name']; + if (isset($this->items['data'][$value])) { + $config->set("groups.{$this->get('groupname')}.{$value}", $this->items['data'][$value]); + } + } + if ($field['type'] === 'array' || $field['type'] === 'permissions') { + $value = $field['name']; + $arrayValues = Utils::getDotNotation($this->items['data'], $field['name']); + + if ($arrayValues) { + foreach ($arrayValues as $arrayIndex => $arrayValue) { + $config->set("groups.{$this->get('groupname')}.{$value}.{$arrayIndex}", $arrayValue); + } + } + } + } + + $type = 'groups'; + $blueprints = $this->blueprints(); + + $filename = CompiledYamlFile::instance($grav['locator']->findResource("config://{$type}.yaml")); + + $obj = new Data($config->get($type), $blueprints); + $obj->file($filename); + $obj->save(); + } + + /** + * Remove a group + * + * @param string $groupname + * @return bool True if the action was performed + * @deprecated 1.7, use $grav['user_groups'] Flex UserGroupCollection instead + */ + public static function remove($groupname) + { + user_error(__METHOD__ . '() is deprecated since Grav 1.7, use $grav[\'user_groups\'] Flex UserGroupCollection instead', E_USER_DEPRECATED); + + $grav = Grav::instance(); + + /** @var Config $config */ + $config = $grav['config']; + + $blueprints = new Blueprints(); + $blueprint = $blueprints->get('user/group'); + + $type = 'groups'; + + $groups = $config->get($type); + unset($groups[$groupname]); + $config->set($type, $groups); + + $filename = CompiledYamlFile::instance($grav['locator']->findResource("config://{$type}.yaml")); + + $obj = new Data($groups, $blueprint); + $obj->file($filename); + $obj->save(); + + return true; + } +} diff --git a/system/src/Grav/Common/User/Interfaces/AuthorizeInterface.php b/system/src/Grav/Common/User/Interfaces/AuthorizeInterface.php new file mode 100644 index 0000000..1045522 --- /dev/null +++ b/system/src/Grav/Common/User/Interfaces/AuthorizeInterface.php @@ -0,0 +1,26 @@ +exists(). + * + * @param string $username + * @return UserInterface + */ + public function load($username): UserInterface; + + /** + * Find a user by username, email, etc + * + * @param string $query the query to search for + * @param array $fields the fields to search + * @return UserInterface + */ + public function find($query, $fields = ['username', 'email']): UserInterface; + + /** + * Delete user account. + * + * @param string $username + * @return bool True if user account was found and was deleted. + */ + public function delete($username): bool; +} diff --git a/system/src/Grav/Common/User/Interfaces/UserGroupInterface.php b/system/src/Grav/Common/User/Interfaces/UserGroupInterface.php new file mode 100644 index 0000000..63e103c --- /dev/null +++ b/system/src/Grav/Common/User/Interfaces/UserGroupInterface.php @@ -0,0 +1,18 @@ +get('this.is.my.nested.variable'); + * + * @param string $name Dot separated path to the requested value. + * @param mixed $default Default value (or null). + * @param string|null $separator Separator, defaults to '.' + * @return mixed Value. + */ + public function get($name, $default = null, $separator = null); + + /** + * Set value by using dot notation for nested arrays/objects. + * + * @example $data->set('this.is.my.nested.variable', $value); + * + * @param string $name Dot separated path to the requested value. + * @param mixed $value New value. + * @param string|null $separator Separator, defaults to '.' + * @return $this + */ + public function set($name, $value, $separator = null); + + /** + * Unset value by using dot notation for nested arrays/objects. + * + * @example $data->undef('this.is.my.nested.variable'); + * + * @param string $name Dot separated path to the requested value. + * @param string|null $separator Separator, defaults to '.' + * @return $this + */ + public function undef($name, $separator = null); + + /** + * Set default value by using dot notation for nested arrays/objects. + * + * @example $data->def('this.is.my.nested.variable', 'default'); + * + * @param string $name Dot separated path to the requested value. + * @param mixed $default Default value (or null). + * @param string|null $separator Separator, defaults to '.' + * @return $this + */ + public function def($name, $default = null, $separator = null); + + /** + * Join nested values together by using blueprints. + * + * @param string $name Dot separated path to the requested value. + * @param mixed $value Value to be joined. + * @param string $separator Separator, defaults to '.' + * @return $this + * @throws RuntimeException + */ + public function join($name, $value, $separator = '.'); + + /** + * Get nested structure containing default values defined in the blueprints. + * + * Fields without default value are ignored in the list. + + * @return array + */ + public function getDefaults(); + + /** + * Set default values by using blueprints. + * + * @param string $name Dot separated path to the requested value. + * @param mixed $value Value to be joined. + * @param string $separator Separator, defaults to '.' + * @return $this + */ + public function joinDefaults($name, $value, $separator = '.'); + + /** + * Get value from the configuration and join it with given data. + * + * @param string $name Dot separated path to the requested value. + * @param array|object $value Value to be joined. + * @param string $separator Separator, defaults to '.' + * @return array + * @throws RuntimeException + */ + public function getJoined($name, $value, $separator = '.'); + + /** + * Set default values to the configuration if variables were not set. + * + * @param array $data + * @return $this + */ + public function setDefaults(array $data); + + /** + * Update object with data + * + * @param array $data + * @param array $files + * @return $this + */ + public function update(array $data, array $files = []); + + /** + * Returns whether the data already exists in the storage. + * + * NOTE: This method does not check if the data is current. + * + * @return bool + */ + public function exists(); + + /** + * Return unmodified data as raw string. + * + * NOTE: This function only returns data which has been saved to the storage. + * + * @return string + */ + public function raw(); + + /** + * Authenticate user. + * + * If user password needs to be updated, new information will be saved. + * + * @param string $password Plaintext password. + * @return bool + */ + public function authenticate(string $password): bool; + + /** + * Return media object for the User's avatar. + * + * Note: if there's no local avatar image for the user, you should call getAvatarUrl() to get the external avatar URL. + * + * @return Medium|null + */ + public function getAvatarImage(): ?Medium; + + /** + * Return the User's avatar URL. + * + * @return string + */ + public function getAvatarUrl(): string; +} diff --git a/system/src/Grav/Common/User/Traits/UserTrait.php b/system/src/Grav/Common/User/Traits/UserTrait.php new file mode 100644 index 0000000..8afcac0 --- /dev/null +++ b/system/src/Grav/Common/User/Traits/UserTrait.php @@ -0,0 +1,233 @@ +get('hashed_password'); + + $isHashed = null !== $hash; + if (!$isHashed) { + // If there is no hashed password, fake verify with default hash. + $hash = Grav::instance()['config']->get('system.security.default_hash'); + } + + // Always execute verify() to protect us from timing attacks, but make the test to fail if hashed password wasn't set. + $result = Authentication::verify($password, $hash) && $isHashed; + + $plaintext_password = $this->get('password'); + if (null !== $plaintext_password) { + // Plain-text password is still stored, check if it matches. + if ($password !== $plaintext_password) { + return false; + } + + // Force hash update to get rid of plaintext password. + $result = 2; + } + + if ($result === 2) { + // Password needs to be updated, save the user. + $this->set('password', $password); + $this->undef('hashed_password'); + $this->save(); + } + + return (bool)$result; + } + + /** + * Checks user authorization to the action. + * + * @param string $action + * @param string|null $scope + * @return bool|null + */ + public function authorize(string $action, string $scope = null): ?bool + { + // User needs to be enabled. + if ($this->get('state', 'enabled') !== 'enabled') { + return false; + } + + // User needs to be logged in. + if (!$this->get('authenticated')) { + return false; + } + + // User needs to be authorized (2FA). + if (strpos($action, 'login') === false && !$this->get('authorized', true)) { + return false; + } + + if (null !== $scope) { + $action = $scope . '.' . $action; + } + + $config = Grav::instance()['config']; + $authorized = false; + + //Check group access level + $groups = (array)$this->get('groups'); + foreach ($groups as $group) { + $permission = $config->get("groups.{$group}.access.{$action}"); + $authorized = Utils::isPositive($permission); + if ($authorized === true) { + break; + } + } + + //Check user access level + $access = $this->get('access'); + if ($access && Utils::getDotNotation($access, $action) !== null) { + $permission = $this->get("access.{$action}"); + $authorized = Utils::isPositive($permission); + } + + return $authorized; + } + + /** + * Return media object for the User's avatar. + * + * Note: if there's no local avatar image for the user, you should call getAvatarUrl() to get the external avatar URL. + * + * @return ImageMedium|StaticImageMedium|null + */ + public function getAvatarImage(): ?Medium + { + $avatars = $this->get('avatar'); + if (is_array($avatars) && $avatars) { + $avatar = array_shift($avatars); + + $media = $this->getMedia(); + $name = $avatar['name'] ?? null; + + $image = $name ? $media[$name] : null; + if ($image instanceof ImageMedium || + $image instanceof StaticImageMedium) { + return $image; + } + } + + return null; + } + + /** + * Return the User's avatar URL + * + * @return string + */ + public function getAvatarUrl(): string + { + // Try to locate avatar image. + $avatar = $this->getAvatarImage(); + if ($avatar) { + return $avatar->url(); + } + + // Try if avatar is a sting (URL). + $avatar = $this->get('avatar'); + if (is_string($avatar)) { + return $avatar; + } + + // Try looking for provider. + $provider = $this->get('provider'); + $provider_options = $this->get($provider); + if (is_array($provider_options)) { + if (isset($provider_options['avatar_url']) && is_string($provider_options['avatar_url'])) { + return $provider_options['avatar_url']; + } + if (isset($provider_options['avatar']) && is_string($provider_options['avatar'])) { + return $provider_options['avatar']; + } + } + + $email = $this->get('email'); + $avatar_generator = Grav::instance()['config']->get('system.accounts.avatar', 'multiavatar'); + if ($avatar_generator === 'gravatar') { + if (!$email) { + return ''; + } + + $hash = md5(strtolower(trim($email))); + + return 'https://www.gravatar.com/avatar/' . $hash; + } + + $hash = $this->get('avatar_hash'); + if (!$hash) { + $username = $this->get('username'); + $hash = md5(strtolower(trim($email ?? $username))); + } + + return $this->generateMultiavatar($hash); + } + + /** + * @param string $hash + * @return string + */ + protected function generateMultiavatar(string $hash): string + { + /** @var UniformResourceLocator $locator */ + $locator = Grav::instance()['locator']; + + $storage = $locator->findResource('image://multiavatar', true, true); + $avatar_file = "{$storage}/{$hash}.svg"; + + if (!file_exists($storage)) { + Folder::create($storage); + } + + if (!file_exists($avatar_file)) { + $mavatar = new Multiavatar(); + + file_put_contents($avatar_file, $mavatar->generate($hash, null, null)); + } + + $avatar_url = $locator->findResource("image://multiavatar/{$hash}.svg", false, true); + + return Utils::url($avatar_url); + + } + + abstract public function get($name, $default = null, $separator = null); + abstract public function set($name, $value, $separator = null); + abstract public function undef($name, $separator = null); + abstract public function save(); +} diff --git a/system/src/Grav/Common/User/User.php b/system/src/Grav/Common/User/User.php new file mode 100644 index 0000000..e87302e --- /dev/null +++ b/system/src/Grav/Common/User/User.php @@ -0,0 +1,144 @@ +exists(). + * + * @param string $username + * @return UserInterface + * @deprecated 1.6 Use $grav['accounts']->load(...) instead. + */ + public static function load($username) + { + user_error(__CLASS__ . '::' . __FUNCTION__ . '() is deprecated since Grav 1.6, use $grav[\'accounts\']->' . __FUNCTION__ . '() instead', E_USER_DEPRECATED); + + return static::getCollection()->load($username); + } + + /** + * Find a user by username, email, etc + * + * Always creates user object. To check if user exists, use $this->exists(). + * + * @param string $query the query to search for + * @param array $fields the fields to search + * @return UserInterface + * @deprecated 1.6 Use $grav['accounts']->find(...) instead. + */ + public static function find($query, $fields = ['username', 'email']) + { + user_error(__CLASS__ . '::' . __FUNCTION__ . '() is deprecated since Grav 1.6, use $grav[\'accounts\']->' . __FUNCTION__ . '() instead', E_USER_DEPRECATED); + + return static::getCollection()->find($query, $fields); + } + + /** + * Remove user account. + * + * @param string $username + * @return bool True if the action was performed + * @deprecated 1.6 Use $grav['accounts']->delete(...) instead. + */ + public static function remove($username) + { + user_error(__CLASS__ . '::' . __FUNCTION__ . '() is deprecated since Grav 1.6, use $grav[\'accounts\']->delete() instead', E_USER_DEPRECATED); + + return static::getCollection()->delete($username); + } + + /** + * @return UserCollectionInterface + */ + protected static function getCollection() + { + return Grav::instance()['accounts']; + } + } +} else { + /** + * @deprecated 1.6 Use $grav['accounts'] instead of static calls. In type hints, use UserInterface. + */ + class User extends DataUser\User + { + /** + * Load user account. + * + * Always creates user object. To check if user exists, use $this->exists(). + * + * @param string $username + * @return UserInterface + * @deprecated 1.6 Use $grav['accounts']->load(...) instead. + */ + public static function load($username) + { + user_error(__CLASS__ . '::' . __FUNCTION__ . '() is deprecated since Grav 1.6, use $grav[\'accounts\']->' . __FUNCTION__ . '() instead', E_USER_DEPRECATED); + + return static::getCollection()->load($username); + } + + /** + * Find a user by username, email, etc + * + * Always creates user object. To check if user exists, use $this->exists(). + * + * @param string $query the query to search for + * @param array $fields the fields to search + * @return UserInterface + * @deprecated 1.6 Use $grav['accounts']->find(...) instead. + */ + public static function find($query, $fields = ['username', 'email']) + { + user_error(__CLASS__ . '::' . __FUNCTION__ . '() is deprecated since Grav 1.6, use $grav[\'accounts\']->' . __FUNCTION__ . '() instead', E_USER_DEPRECATED); + + return static::getCollection()->find($query, $fields); + } + + /** + * Remove user account. + * + * @param string $username + * @return bool True if the action was performed + * @deprecated 1.6 Use $grav['accounts']->delete(...) instead. + */ + public static function remove($username) + { + user_error(__CLASS__ . '::' . __FUNCTION__ . '() is deprecated since Grav 1.6, use $grav[\'accounts\']->delete() instead', E_USER_DEPRECATED); + + return static::getCollection()->delete($username); + } + + /** + * @return UserCollectionInterface + */ + protected static function getCollection() + { + return Grav::instance()['accounts']; + } + } +} diff --git a/system/src/Grav/Common/Utils.php b/system/src/Grav/Common/Utils.php new file mode 100644 index 0000000..a0fb949 --- /dev/null +++ b/system/src/Grav/Common/Utils.php @@ -0,0 +1,2213 @@ +schemeExists($scheme)) { + // If scheme does not exists as a stream, assume it's external. + return str_replace(' ', '%20', $input); + } + + // Attempt to find the resource (because of parse_url() we need to put host back to path). + $resource = $locator->findResource("{$scheme}://{$host}{$path}", false); + + if ($resource === false) { + if (!$fail_gracefully) { + return false; + } + + // Return location where the file would be if it was saved. + $resource = $locator->findResource("{$scheme}://{$host}{$path}", false, true); + } + } elseif ($host || $port) { + // If URL doesn't have scheme but has host or port, it is external. + return str_replace(' ', '%20', $input); + } + + if (!empty($resource)) { + // Add query string back. + if (isset($parts['query'])) { + $resource .= '?' . $parts['query']; + } + + // Add fragment back. + if (isset($parts['fragment'])) { + $resource .= '#' . $parts['fragment']; + } + } + } else { + // Not a valid URL (can still be a stream). + $resource = $locator->findResource($input, false); + } + } else { + // Just a path. + /** @var Pages $pages */ + $pages = $grav['pages']; + + // Is this a page? + $page = $pages->find($input, true); + if ($page && $page->routable()) { + return $page->url($domain); + } + + $root = preg_quote($uri->rootUrl(), '#'); + $pattern = '#(' . $root . '$|' . $root . '/)#'; + if (!empty($root) && preg_match($pattern, $input, $matches)) { + $input = static::replaceFirstOccurrence($matches[0], '', $input); + } + + $input = ltrim($input, '/'); + $resource = $input; + } + + if (!$fail_gracefully && $resource === false) { + return false; + } + + $domain = $domain ?: $grav['config']->get('system.absolute_urls', false); + + return rtrim($uri->rootUrl($domain), '/') . '/' . ($resource ?: ''); + } + + /** + * Helper method to find the full path to a file, be it a stream, a relative path, or + * already a full path + * + * @param string $path + * @return string + */ + public static function fullPath($path) + { + $locator = Grav::instance()['locator']; + + if ($locator->isStream($path)) { + $path = $locator->findResource($path, true); + } elseif (!static::startsWith($path, GRAV_ROOT)) { + $base_url = Grav::instance()['base_url']; + $path = GRAV_ROOT . '/' . ltrim(static::replaceFirstOccurrence($base_url, '', $path), '/'); + } + + return $path; + } + + + /** + * Check if the $haystack string starts with the substring $needle + * + * @param string $haystack + * @param string|string[] $needle + * @param bool $case_sensitive + * @return bool + */ + public static function startsWith($haystack, $needle, $case_sensitive = true) + { + $status = false; + + $compare_func = $case_sensitive ? 'mb_strpos' : 'mb_stripos'; + + foreach ((array)$needle as $each_needle) { + $status = $each_needle === '' || $compare_func((string) $haystack, $each_needle) === 0; + if ($status) { + break; + } + } + + return $status; + } + + /** + * Check if the $haystack string ends with the substring $needle + * + * @param string $haystack + * @param string|string[] $needle + * @param bool $case_sensitive + * @return bool + */ + public static function endsWith($haystack, $needle, $case_sensitive = true) + { + $status = false; + + $compare_func = $case_sensitive ? 'mb_strrpos' : 'mb_strripos'; + + foreach ((array)$needle as $each_needle) { + $expectedPosition = mb_strlen((string) $haystack) - mb_strlen($each_needle); + $status = $each_needle === '' || $compare_func((string) $haystack, $each_needle, 0) === $expectedPosition; + if ($status) { + break; + } + } + + return $status; + } + + /** + * Check if the $haystack string contains the substring $needle + * + * @param string $haystack + * @param string|string[] $needle + * @param bool $case_sensitive + * @return bool + */ + public static function contains($haystack, $needle, $case_sensitive = true) + { + $status = false; + + $compare_func = $case_sensitive ? 'mb_strpos' : 'mb_stripos'; + + foreach ((array)$needle as $each_needle) { + $status = $each_needle === '' || $compare_func((string) $haystack, $each_needle) !== false; + if ($status) { + break; + } + } + + return $status; + } + + /** + * Function that can match wildcards + * + * match_wildcard('foo*', $test), // TRUE + * match_wildcard('bar*', $test), // FALSE + * match_wildcard('*bar*', $test), // TRUE + * match_wildcard('**blob**', $test), // TRUE + * match_wildcard('*a?d*', $test), // TRUE + * match_wildcard('*etc**', $test) // TRUE + * + * @param string $wildcard_pattern + * @param string $haystack + * @return false|int + */ + public static function matchWildcard($wildcard_pattern, $haystack) + { + $regex = str_replace( + array("\*", "\?"), // wildcard chars + array('.*', '.'), // regexp chars + preg_quote($wildcard_pattern, '/') + ); + + return preg_match('/^' . $regex . '$/is', $haystack); + } + + /** + * Render simple template filling up the variables in it. If value is not defined, leave it as it was. + * + * @param string $template Template string + * @param array $variables Variables with values + * @param array $brackets Optional array of opening and closing brackets or symbols + * @return string Final string filled with values + */ + public static function simpleTemplate(string $template, array $variables, array $brackets = ['{', '}']): string + { + $opening = $brackets[0] ?? '{'; + $closing = $brackets[1] ?? '}'; + $expression = '/' . preg_quote($opening, '/') . '(.*?)' . preg_quote($closing, '/') . '/'; + $callback = static function ($match) use ($variables) { + return $variables[$match[1]] ?? $match[0]; + }; + + return preg_replace_callback($expression, $callback, $template); + } + + /** + * Returns the substring of a string up to a specified needle. if not found, return the whole haystack + * + * @param string $haystack + * @param string $needle + * @param bool $case_sensitive + * + * @return string + */ + public static function substrToString($haystack, $needle, $case_sensitive = true) + { + $compare_func = $case_sensitive ? 'mb_strpos' : 'mb_stripos'; + + if (static::contains($haystack, $needle, $case_sensitive)) { + return mb_substr($haystack, 0, $compare_func($haystack, $needle, $case_sensitive)); + } + + return $haystack; + } + + /** + * Utility method to replace only the first occurrence in a string + * + * @param string $search + * @param string $replace + * @param string $subject + * + * @return string + */ + public static function replaceFirstOccurrence($search, $replace, $subject) + { + if (!$search) { + return $subject; + } + + $pos = mb_strpos($subject, $search); + if ($pos !== false) { + $subject = static::mb_substr_replace($subject, $replace, $pos, mb_strlen($search)); + } + + + return $subject; + } + + /** + * Utility method to replace only the last occurrence in a string + * + * @param string $search + * @param string $replace + * @param string $subject + * @return string + */ + public static function replaceLastOccurrence($search, $replace, $subject) + { + $pos = strrpos($subject, $search); + + if ($pos !== false) { + $subject = static::mb_substr_replace($subject, $replace, $pos, mb_strlen($search)); + } + + return $subject; + } + + /** + * Multibyte compatible substr_replace + * + * @param string $original + * @param string $replacement + * @param int $position + * @param int $length + * @return string + */ + public static function mb_substr_replace($original, $replacement, $position, $length) + { + $startString = mb_substr($original, 0, $position, 'UTF-8'); + $endString = mb_substr($original, $position + $length, mb_strlen($original), 'UTF-8'); + + return $startString . $replacement . $endString; + } + + /** + * Merge two objects into one. + * + * @param object $obj1 + * @param object $obj2 + * + * @return object + */ + public static function mergeObjects($obj1, $obj2) + { + return (object)array_merge((array)$obj1, (array)$obj2); + } + + /** + * @param array $array + * @return bool + */ + public static function isAssoc(array $array) + { + return (array_values($array) !== $array); + } + + /** + * Lowercase an entire array. Useful when combined with `in_array()` + * + * @param array $a + * @return array|false + */ + public static function arrayLower(array $a) + { + return array_map('mb_strtolower', $a); + } + + /** + * Simple function to remove item/s in an array by value + * + * @param array $search + * @param string|array $value + * @return array + */ + public static function arrayRemoveValue(array $search, $value) + { + foreach ((array)$value as $val) { + $key = array_search($val, $search); + if ($key !== false) { + unset($search[$key]); + } + } + return $search; + } + + /** + * Recursive Merge with uniqueness + * + * @param array $array1 + * @param array $array2 + * @return array + */ + public static function arrayMergeRecursiveUnique($array1, $array2) + { + if (empty($array1)) { + // Optimize the base case + return $array2; + } + + foreach ($array2 as $key => $value) { + if (is_array($value) && isset($array1[$key]) && is_array($array1[$key])) { + $value = static::arrayMergeRecursiveUnique($array1[$key], $value); + } + $array1[$key] = $value; + } + + return $array1; + } + + /** + * Returns an array with the differences between $array1 and $array2 + * + * @param array $array1 + * @param array $array2 + * @return array + */ + public static function arrayDiffMultidimensional($array1, $array2) + { + $result = array(); + foreach ($array1 as $key => $value) { + if (!is_array($array2) || !array_key_exists($key, $array2)) { + $result[$key] = $value; + continue; + } + if (is_array($value)) { + $recursiveArrayDiff = static::ArrayDiffMultidimensional($value, $array2[$key]); + if (count($recursiveArrayDiff)) { + $result[$key] = $recursiveArrayDiff; + } + continue; + } + if ($value != $array2[$key]) { + $result[$key] = $value; + } + } + + return $result; + } + + /** + * Array combine but supports different array lengths + * + * @param array $arr1 + * @param array $arr2 + * @return array|false + */ + public static function arrayCombine($arr1, $arr2) + { + $count = min(count($arr1), count($arr2)); + + return array_combine(array_slice($arr1, 0, $count), array_slice($arr2, 0, $count)); + } + + /** + * Array is associative or not + * + * @param array $arr + * @return bool + */ + public static function arrayIsAssociative($arr) + { + if ([] === $arr) { + return false; + } + + return array_keys($arr) !== range(0, count($arr) - 1); + } + + /** + * Return the Grav date formats allowed + * + * @return array + */ + public static function dateFormats() + { + $now = new DateTime(); + + $date_formats = [ + 'd-m-Y H:i' => 'd-m-Y H:i (e.g. ' . $now->format('d-m-Y H:i') . ')', + 'Y-m-d H:i' => 'Y-m-d H:i (e.g. ' . $now->format('Y-m-d H:i') . ')', + 'm/d/Y h:i a' => 'm/d/Y h:i a (e.g. ' . $now->format('m/d/Y h:i a') . ')', + 'H:i d-m-Y' => 'H:i d-m-Y (e.g. ' . $now->format('H:i d-m-Y') . ')', + 'h:i a m/d/Y' => 'h:i a m/d/Y (e.g. ' . $now->format('h:i a m/d/Y') . ')', + ]; + $default_format = Grav::instance()['config']->get('system.pages.dateformat.default'); + if ($default_format) { + $date_formats = array_merge([$default_format => $default_format . ' (e.g. ' . $now->format($default_format) . ')'], $date_formats); + } + + return $date_formats; + } + + /** + * Get current date/time + * + * @param string|null $default_format + * @return string + * @throws Exception + */ + public static function dateNow($default_format = null) + { + $now = new DateTime(); + + if (null === $default_format) { + $default_format = Grav::instance()['config']->get('system.pages.dateformat.default'); + } + + return $now->format($default_format); + } + + /** + * Truncate text by number of characters but can cut off words. + * + * @param string $string + * @param int $limit Max number of characters. + * @param bool $up_to_break truncate up to breakpoint after char count + * @param string $break Break point. + * @param string $pad Appended padding to the end of the string. + * @return string + */ + public static function truncate($string, $limit = 150, $up_to_break = false, $break = ' ', $pad = '…') + { + // return with no change if string is shorter than $limit + if (mb_strlen($string) <= $limit) { + return $string; + } + + // is $break present between $limit and the end of the string? + if ($up_to_break && false !== ($breakpoint = mb_strpos($string, $break, $limit))) { + if ($breakpoint < mb_strlen($string) - 1) { + $string = mb_substr($string, 0, $breakpoint) . $pad; + } + } else { + $string = mb_substr($string, 0, $limit) . $pad; + } + + return $string; + } + + /** + * Truncate text by number of characters in a "word-safe" manor. + * + * @param string $string + * @param int $limit + * @return string + */ + public static function safeTruncate($string, $limit = 150) + { + return static::truncate($string, $limit, true); + } + + + /** + * Truncate HTML by number of characters. not "word-safe"! + * + * @param string $text + * @param int $length in characters + * @param string $ellipsis + * @return string + */ + public static function truncateHtml($text, $length = 100, $ellipsis = '...') + { + return Truncator::truncateLetters($text, $length, $ellipsis); + } + + /** + * Truncate HTML by number of characters in a "word-safe" manor. + * + * @param string $text + * @param int $length in words + * @param string $ellipsis + * @return string + */ + public static function safeTruncateHtml($text, $length = 25, $ellipsis = '...') + { + return Truncator::truncateWords($text, $length, $ellipsis); + } + + /** + * Generate a random string of a given length + * + * @param int $length + * @return string + */ + public static function generateRandomString($length = 5) + { + return substr(str_shuffle('0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ'), 0, $length); + } + + /** + * Generates a random string with configurable length, prefix and suffix. + * Unlike the built-in `uniqid()`, this string is non-conflicting and safe + * + * @param int $length + * @param array $options + * @return string + * @throws Exception + */ + public static function uniqueId(int $length = 13, array $options = []): string + { + $options = array_merge(['prefix' => '', 'suffix' => ''], $options); + $bytes = random_bytes(ceil($length / 2)); + + return $options['prefix'] . substr(bin2hex($bytes), 0, $length) . $options['suffix']; + } + + /** + * Provides the ability to download a file to the browser + * + * @param string $file the full path to the file to be downloaded + * @param bool $force_download as opposed to letting browser choose if to download or render + * @param int $sec Throttling, try 0.1 for some speed throttling of downloads + * @param int $bytes Size of chunks to send in bytes. Default is 1024 + * @param array $options Extra options: [mime, download_name, expires] + * @throws Exception + */ + public static function download($file, $force_download = true, $sec = 0, $bytes = 1024, array $options = []) + { + $grav = Grav::instance(); + + if (file_exists($file)) { + // fire download event + $grav->fireEvent('onBeforeDownload', new Event(['file' => $file, 'options' => &$options])); + + $file_parts = static::pathinfo($file); + $mimetype = $options['mime'] ?? static::getMimeByExtension($file_parts['extension']); + $size = filesize($file); // File size + + $grav->cleanOutputBuffers(); + + // required for IE, otherwise Content-Disposition may be ignored + if (ini_get('zlib.output_compression')) { + ini_set('zlib.output_compression', 'Off'); + } + + header('Content-Type: ' . $mimetype); + header('Accept-Ranges: bytes'); + + if ($force_download) { + // output the regular HTTP headers + header('Content-Disposition: attachment; filename="' . ($options['download_name'] ?? $file_parts['basename']) . '"'); + } + + // multipart-download and download resuming support + if (isset($_SERVER['HTTP_RANGE'])) { + [$a, $range] = explode('=', $_SERVER['HTTP_RANGE'], 2); + [$range] = explode(',', $range, 2); + [$range, $range_end] = explode('-', $range); + $range = (int)$range; + if (!$range_end) { + $range_end = $size - 1; + } else { + $range_end = (int)$range_end; + } + $new_length = $range_end - $range + 1; + header('HTTP/1.1 206 Partial Content'); + header("Content-Length: {$new_length}"); + header("Content-Range: bytes {$range}-{$range_end}/{$size}"); + } else { + $range = 0; + $new_length = $size; + header('Content-Length: ' . $size); + + if ($grav['config']->get('system.cache.enabled')) { + $expires = $options['expires'] ?? $grav['config']->get('system.pages.expires'); + if ($expires > 0) { + $expires_date = gmdate('D, d M Y H:i:s T', time() + $expires); + header('Cache-Control: max-age=' . $expires); + header('Expires: ' . $expires_date); + header('Pragma: cache'); + } + header('Last-Modified: ' . gmdate('D, d M Y H:i:s T', filemtime($file))); + + // Return 304 Not Modified if the file is already cached in the browser + if (isset($_SERVER['HTTP_IF_MODIFIED_SINCE']) && + strtotime($_SERVER['HTTP_IF_MODIFIED_SINCE']) >= filemtime($file)) { + header('HTTP/1.1 304 Not Modified'); + exit(); + } + } + } + + /* output the file itself */ + $chunksize = $bytes * 8; //you may want to change this + $bytes_send = 0; + + $fp = @fopen($file, 'rb'); + if ($fp) { + if ($range) { + fseek($fp, $range); + } + while (!feof($fp) && (!connection_aborted()) && ($bytes_send < $new_length)) { + $buffer = fread($fp, $chunksize); + echo($buffer); //echo($buffer); // is also possible + flush(); + usleep($sec * 1000000); + $bytes_send += strlen($buffer); + } + fclose($fp); + } else { + throw new RuntimeException('Error - can not open file.'); + } + + exit; + } + } + + /** + * Returns the output render format, usually the extension provided in the URL. (e.g. `html`, `json`, `xml`, etc). + * + * @return string + */ + public static function getPageFormat(): string + { + /** @var Uri $uri */ + $uri = Grav::instance()['uri']; + + // Set from uri extension + $uri_extension = $uri->extension(); + if (is_string($uri_extension) && $uri->isValidExtension($uri_extension)) { + return ($uri_extension); + } + + // Use content negotiation via the `accept:` header + $http_accept = $_SERVER['HTTP_ACCEPT'] ?? null; + if (is_string($http_accept)) { + $negotiator = new Negotiator(); + + $supported_types = static::getSupportPageTypes(['html', 'json']); + $priorities = static::getMimeTypes($supported_types); + + $media_type = $negotiator->getBest($http_accept, $priorities); + $mimetype = $media_type instanceof Accept ? $media_type->getValue() : ''; + + return static::getExtensionByMime($mimetype); + } + + return 'html'; + } + + /** + * Return the mimetype based on filename extension + * + * @param string $extension Extension of file (eg "txt") + * @param string $default + * @return string + */ + public static function getMimeByExtension($extension, $default = 'application/octet-stream') + { + $extension = strtolower($extension); + + // look for some standard types + switch ($extension) { + case null: + return $default; + case 'json': + return 'application/json'; + case 'html': + return 'text/html'; + case 'atom': + return 'application/atom+xml'; + case 'rss': + return 'application/rss+xml'; + case 'xml': + return 'application/xml'; + } + + $media_types = Grav::instance()['config']->get('media.types'); + + return $media_types[$extension]['mime'] ?? $default; + } + + /** + * Get all the mimetypes for an array of extensions + * + * @param array $extensions + * @return array + */ + public static function getMimeTypes(array $extensions) + { + $mimetypes = []; + foreach ($extensions as $extension) { + $mimetype = static::getMimeByExtension($extension, false); + if ($mimetype && !in_array($mimetype, $mimetypes)) { + $mimetypes[] = $mimetype; + } + } + return $mimetypes; + } + + /** + * Return all extensions for given mimetype. The first extension is the default one. + * + * @param string $mime Mime type (eg 'image/jpeg') + * @return string[] List of extensions eg. ['jpg', 'jpe', 'jpeg'] + */ + public static function getExtensionsByMime($mime) + { + $mime = strtolower($mime); + + $media_types = (array)Grav::instance()['config']->get('media.types'); + + $list = []; + foreach ($media_types as $extension => $type) { + if ($extension === '' || $extension === 'defaults') { + continue; + } + + if (isset($type['mime']) && $type['mime'] === $mime) { + $list[] = $extension; + } + } + + return $list; + } + + /** + * Return the mimetype based on filename extension + * + * @param string $mime mime type (eg "text/html") + * @param string $default default value + * @return string + */ + public static function getExtensionByMime($mime, $default = 'html') + { + $mime = strtolower($mime); + + // look for some standard mime types + switch ($mime) { + case '*/*': + case 'text/*': + case 'text/html': + return 'html'; + case 'application/json': + return 'json'; + case 'application/atom+xml': + return 'atom'; + case 'application/rss+xml': + return 'rss'; + case 'application/xml': + return 'xml'; + } + + $media_types = (array)Grav::instance()['config']->get('media.types'); + + foreach ($media_types as $extension => $type) { + if ($extension === 'defaults') { + continue; + } + if (isset($type['mime']) && $type['mime'] === $mime) { + return $extension; + } + } + + return $default; + } + + /** + * Get all the extensions for an array of mimetypes + * + * @param array $mimetypes + * @return array + */ + public static function getExtensions(array $mimetypes) + { + $extensions = []; + foreach ($mimetypes as $mimetype) { + $extension = static::getExtensionByMime($mimetype, false); + if ($extension && !in_array($extension, $extensions, true)) { + $extensions[] = $extension; + } + } + + return $extensions; + } + + /** + * Return the mimetype based on filename + * + * @param string $filename Filename or path to file + * @param string $default default value + * @return string + */ + public static function getMimeByFilename($filename, $default = 'application/octet-stream') + { + return static::getMimeByExtension(static::pathinfo($filename, PATHINFO_EXTENSION), $default); + } + + /** + * Return the mimetype based on existing local file + * + * @param string $filename Path to the file + * @param string $default + * @return string|bool + */ + public static function getMimeByLocalFile($filename, $default = 'application/octet-stream') + { + $type = false; + + // For local files we can detect type by the file content. + if (!stream_is_local($filename) || !file_exists($filename)) { + return false; + } + + // Prefer using finfo if it exists. + if (extension_loaded('fileinfo')) { + $finfo = finfo_open(FILEINFO_SYMLINK | FILEINFO_MIME_TYPE); + $type = finfo_file($finfo, $filename); + finfo_close($finfo); + } else { + // Fall back to use getimagesize() if it is available (not recommended, but better than nothing) + $info = @getimagesize($filename); + if ($info) { + $type = $info['mime']; + } + } + + return $type ?: static::getMimeByFilename($filename, $default); + } + + + /** + * Returns true if filename is considered safe. + * + * @param string $filename + * @return bool + */ + public static function checkFilename($filename): bool + { + $dangerous_extensions = Grav::instance()['config']->get('security.uploads_dangerous_extensions', []); + $extension = mb_strtolower(static::pathinfo($filename, PATHINFO_EXTENSION)); + + return !( + // Empty filenames are not allowed. + !$filename + // Filename should not contain horizontal/vertical tabs, newlines, nils or back/forward slashes. + || strtr($filename, "\t\v\n\r\0\\/", '_______') !== $filename + // Filename should not start or end with dot or space. + || trim($filename, '. ') !== $filename + // File extension should not be part of configured dangerous extensions + || in_array($extension, $dangerous_extensions) + ); + } + + /** + * Unicode-safe version of PHP’s pathinfo() function. + * + * @link https://www.php.net/manual/en/function.pathinfo.php + * + * @param string $path + * @param int|null $flags + * @return array|string + */ + public static function pathinfo($path, int $flags = null) + { + $path = str_replace(['%2F', '%5C'], ['/', '\\'], rawurlencode($path)); + + if (null === $flags) { + $info = pathinfo($path); + } else { + $info = pathinfo($path, $flags); + } + + if (is_array($info)) { + return array_map('rawurldecode', $info); + } + + return rawurldecode($info); + } + + /** + * Unicode-safe version of the PHP basename() function. + * + * @link https://www.php.net/manual/en/function.basename.php + * + * @param string $path + * @param string $suffix + * @return string + */ + public static function basename($path, string $suffix = ''): string + { + return rawurldecode(basename(str_replace(['%2F', '%5C'], '/', rawurlencode($path)), $suffix)); + } + + /** + * Normalize path by processing relative `.` and `..` syntax and merging path + * + * @param string $path + * @return string + */ + public static function normalizePath($path) + { + // Resolve any streams + /** @var UniformResourceLocator $locator */ + $locator = Grav::instance()['locator']; + if ($locator->isStream($path)) { + $path = $locator->findResource($path); + } + + // Set root properly for any URLs + $root = ''; + preg_match(self::ROOTURL_REGEX, $path, $matches); + if ($matches) { + $root = $matches[1]; + $path = $matches[2]; + } + + // Strip off leading / to ensure explode is accurate + if (static::startsWith($path, '/')) { + $root .= '/'; + $path = ltrim($path, '/'); + } + + // If there are any relative paths (..) handle those + if (static::contains($path, '..')) { + $segments = explode('/', trim($path, '/')); + $ret = []; + foreach ($segments as $segment) { + if (($segment === '.') || $segment === '') { + continue; + } + if ($segment === '..') { + array_pop($ret); + } else { + $ret[] = $segment; + } + } + $path = implode('/', $ret); + } + + // Stick everything back together + $normalized = $root . $path; + + return $normalized; + } + + /** + * Check whether a function exists. + * + * Disabled functions count as non-existing functions, just like in PHP 8+. + * + * @param string $function the name of the function to check + * @return bool + */ + public static function functionExists($function): bool + { + if (!function_exists($function)) { + return false; + } + + // In PHP 7 we need to also exclude disabled methods. + return !static::isFunctionDisabled($function); + } + + /** + * Check whether a function is disabled in the PHP settings + * + * @param string $function the name of the function to check + * @return bool + */ + public static function isFunctionDisabled($function): bool + { + static $list; + + if (null === $list) { + $str = trim(ini_get('disable_functions') . ',' . ini_get('suhosin.executor.func.blacklist'), ','); + $list = $str ? array_flip(preg_split('/\s*,\s*/', $str)) : []; + } + + return array_key_exists($function, $list); + } + + /** + * Get the formatted timezones list + * + * @return array + */ + public static function timezones() + { + $timezones = DateTimeZone::listIdentifiers(DateTimeZone::ALL); + $offsets = []; + $testDate = new DateTime(); + + foreach ($timezones as $zone) { + $tz = new DateTimeZone($zone); + $offsets[$zone] = $tz->getOffset($testDate); + } + + asort($offsets); + + $timezone_list = []; + foreach ($offsets as $timezone => $offset) { + $offset_prefix = $offset < 0 ? '-' : '+'; + $offset_formatted = gmdate('H:i', abs($offset)); + + $pretty_offset = "UTC{$offset_prefix}{$offset_formatted}"; + + $timezone_list[$timezone] = "({$pretty_offset}) " . str_replace('_', ' ', $timezone); + } + + return $timezone_list; + } + + /** + * Recursively filter an array, filtering values by processing them through the $fn function argument + * + * @param array $source the Array to filter + * @param callable $fn the function to pass through each array item + * @return array + */ + public static function arrayFilterRecursive(array $source, $fn) + { + $result = []; + foreach ($source as $key => $value) { + if (is_array($value)) { + $result[$key] = static::arrayFilterRecursive($value, $fn); + continue; + } + if ($fn($key, $value)) { + $result[$key] = $value; // KEEP + continue; + } + } + + return $result; + } + + /** + * Flatten a multi-dimensional associative array into query params. + * + * @param array $array + * @param string $prepend + * @return array + */ + public static function arrayToQueryParams($array, $prepend = '') + { + $results = []; + foreach ($array as $key => $value) { + $name = $prepend ? $prepend . '[' . $key . ']' : $key; + + if (is_array($value)) { + $results = array_merge($results, static::arrayToQueryParams($value, $name)); + } else { + $results[$name] = $value; + } + } + + return $results; + } + + /** + * Flatten an array + * + * @param array $array + * @return array + */ + public static function arrayFlatten($array) + { + $flatten = []; + foreach ($array as $key => $inner) { + if (is_array($inner)) { + foreach ($inner as $inner_key => $value) { + $flatten[$inner_key] = $value; + } + } else { + $flatten[$key] = $inner; + } + } + + return $flatten; + } + + /** + * Flatten a multi-dimensional associative array into dot notation + * + * @param array $array + * @param string $prepend + * @return array + */ + public static function arrayFlattenDotNotation($array, $prepend = '') + { + $results = array(); + foreach ($array as $key => $value) { + if (is_array($value)) { + $results = array_merge($results, static::arrayFlattenDotNotation($value, $prepend . $key . '.')); + } else { + $results[$prepend . $key] = $value; + } + } + + return $results; + } + + /** + * Opposite of flatten, convert flat dot notation array to multi dimensional array. + * + * If any of the parent has a scalar value, all children get ignored: + * + * admin.pages=true + * admin.pages.read=true + * + * becomes + * + * admin: + * pages: true + * + * @param array $array + * @param string $separator + * @return array + */ + public static function arrayUnflattenDotNotation($array, $separator = '.') + { + $newArray = []; + foreach ($array as $key => $value) { + $dots = explode($separator, $key); + if (count($dots) > 1) { + $last = &$newArray[$dots[0]]; + foreach ($dots as $k => $dot) { + if ($k === 0) { + continue; + } + + // Cannot use a scalar value as an array + if (null !== $last && !is_array($last)) { + continue 2; + } + + $last = &$last[$dot]; + } + + // Cannot use a scalar value as an array + if (null !== $last && !is_array($last)) { + continue; + } + + $last = $value; + } else { + $newArray[$key] = $value; + } + } + + return $newArray; + } + + /** + * Checks if the passed path contains the language code prefix + * + * @param string $string The path + * + * @return bool|string Either false or the language + * + */ + public static function pathPrefixedByLangCode($string) + { + $languages_enabled = Grav::instance()['config']->get('system.languages.supported', []); + $parts = explode('/', trim($string, '/')); + + if (count($parts) > 0 && in_array($parts[0], $languages_enabled)) { + return $parts[0]; + } + return false; + } + + /** + * Get the timestamp of a date + * + * @param string $date a String expressed in the system.pages.dateformat.default format, with fallback to a + * strtotime argument + * @param string|null $format a date format to use if possible + * @return int the timestamp + */ + public static function date2timestamp($date, $format = null) + { + $config = Grav::instance()['config']; + $dateformat = $format ?: $config->get('system.pages.dateformat.default'); + + // try to use DateTime and default format + if ($dateformat) { + $datetime = DateTime::createFromFormat($dateformat, $date); + } else { + $datetime = new DateTime($date); + } + + // fallback to strtotime() if DateTime approach failed + if ($datetime !== false) { + return $datetime->getTimestamp(); + } + + return strtotime($date); + } + + /** + * @param array $array + * @param string $path + * @param null $default + * @return mixed + * + * @deprecated 1.5 Use ->getDotNotation() method instead. + */ + public static function resolve(array $array, $path, $default = null) + { + user_error(__CLASS__ . '::' . __FUNCTION__ . '() is deprecated since Grav 1.5, use ->getDotNotation() method instead', E_USER_DEPRECATED); + + return static::getDotNotation($array, $path, $default); + } + + /** + * Checks if a value is positive (true) + * + * @param string $value + * @return bool + */ + public static function isPositive($value) + { + return in_array($value, [true, 1, '1', 'yes', 'on', 'true'], true); + } + + /** + * Checks if a value is negative (false) + * + * @param string $value + * @return bool + */ + public static function isNegative($value) + { + return in_array($value, [false, 0, '0', 'no', 'off', 'false'], true); + } + + /** + * Generates a nonce string to be hashed. Called by self::getNonce() + * We removed the IP portion in this version because it causes too many inconsistencies + * with reverse proxy setups. + * + * @param string $action + * @param bool $previousTick if true, generates the token for the previous tick (the previous 12 hours) + * @return string the nonce string + */ + private static function generateNonceString($action, $previousTick = false) + { + $grav = Grav::instance(); + + $username = isset($grav['user']) ? $grav['user']->username : ''; + $token = session_id(); + $i = self::nonceTick(); + + if ($previousTick) { + $i--; + } + + return ($i . '|' . $action . '|' . $username . '|' . $token . '|' . $grav['config']->get('security.salt')); + } + + /** + * Get the time-dependent variable for nonce creation. + * + * Now a tick lasts a day. Once the day is passed, the nonce is not valid any more. Find a better way + * to ensure nonces issued near the end of the day do not expire in that small amount of time + * + * @return int the time part of the nonce. Changes once every 24 hours + */ + private static function nonceTick() + { + $secondsInHalfADay = 60 * 60 * 12; + + return (int)ceil(time() / $secondsInHalfADay); + } + + /** + * Creates a hashed nonce tied to the passed action. Tied to the current user and time. The nonce for a given + * action is the same for 12 hours. + * + * @param string $action the action the nonce is tied to (e.g. save-user-admin or move-page-homepage) + * @param bool $previousTick if true, generates the token for the previous tick (the previous 12 hours) + * @return string the nonce + */ + public static function getNonce($action, $previousTick = false) + { + // Don't regenerate this again if not needed + if (isset(static::$nonces[$action][$previousTick])) { + return static::$nonces[$action][$previousTick]; + } + $nonce = md5(self::generateNonceString($action, $previousTick)); + static::$nonces[$action][$previousTick] = $nonce; + + return static::$nonces[$action][$previousTick]; + } + + /** + * Verify the passed nonce for the give action + * + * @param string|string[] $nonce the nonce to verify + * @param string $action the action to verify the nonce to + * @return boolean verified or not + */ + public static function verifyNonce($nonce, $action) + { + //Safety check for multiple nonces + if (is_array($nonce)) { + $nonce = array_shift($nonce); + } + + //Nonce generated 0-12 hours ago + if ($nonce === self::getNonce($action)) { + return true; + } + + //Nonce generated 12-24 hours ago + return $nonce === self::getNonce($action, true); + } + + /** + * Simple helper method to get whether or not the admin plugin is active + * + * @return bool + */ + public static function isAdminPlugin() + { + return isset(Grav::instance()['admin']); + } + + /** + * Get a portion of an array (passed by reference) with dot-notation key + * + * @param array $array + * @param string|int|null $key + * @param null $default + * @return mixed + */ + public static function getDotNotation($array, $key, $default = null) + { + if (null === $key) { + return $array; + } + + if (isset($array[$key])) { + return $array[$key]; + } + + foreach (explode('.', $key) as $segment) { + if (!is_array($array) || !array_key_exists($segment, $array)) { + return $default; + } + + $array = $array[$segment]; + } + + return $array; + } + + /** + * Set portion of array (passed by reference) for a dot-notation key + * and set the value + * + * @param array $array + * @param string|int|null $key + * @param mixed $value + * @param bool $merge + * + * @return mixed + */ + public static function setDotNotation(&$array, $key, $value, $merge = false) + { + if (null === $key) { + return $array = $value; + } + + $keys = explode('.', $key); + + while (count($keys) > 1) { + $key = array_shift($keys); + + if (!isset($array[$key]) || !is_array($array[$key])) { + $array[$key] = array(); + } + + $array =& $array[$key]; + } + + $key = array_shift($keys); + + if (!$merge || !isset($array[$key])) { + $array[$key] = $value; + } else { + $array[$key] = array_merge($array[$key], $value); + } + + return $array; + } + + /** + * Utility method to determine if the current OS is Windows + * + * @return bool + */ + public static function isWindows() + { + return strncasecmp(PHP_OS, 'WIN', 3) === 0; + } + + /** + * Utility to determine if the server running PHP is Apache + * + * @return bool + */ + public static function isApache() + { + return isset($_SERVER['SERVER_SOFTWARE']) && strpos($_SERVER['SERVER_SOFTWARE'], 'Apache') !== false; + } + + /** + * Sort a multidimensional array by another array of ordered keys + * + * @param array $array + * @param array $orderArray + * @return array + */ + public static function sortArrayByArray(array $array, array $orderArray) + { + $ordered = []; + foreach ($orderArray as $key) { + if (array_key_exists($key, $array)) { + $ordered[$key] = $array[$key]; + unset($array[$key]); + } + } + return $ordered + $array; + } + + /** + * Sort an array by a key value in the array + * + * @param mixed $array + * @param string|int $array_key + * @param int $direction + * @param int $sort_flags + * @return array + */ + public static function sortArrayByKey($array, $array_key, $direction = SORT_DESC, $sort_flags = SORT_REGULAR) + { + $output = []; + + if (!is_array($array) || !$array) { + return $output; + } + + foreach ($array as $key => $row) { + $output[$key] = $row[$array_key]; + } + + array_multisort($output, $direction, $sort_flags, $array); + + return $array; + } + + /** + * Get relative page path based on a token. + * + * @param string $path + * @param PageInterface|null $page + * @return string + * @throws RuntimeException + */ + public static function getPagePathFromToken($path, PageInterface $page = null) + { + return static::getPathFromToken($path, $page); + } + + /** + * Get relative path based on a token. + * + * Path supports following syntaxes: + * + * 'self@', 'self@/path' + * 'page@:/route', 'page@:/route/filename.ext' + * 'theme@:', 'theme@:/path' + * + * @param string $path + * @param FlexObjectInterface|PageInterface|null $object + * @return string + * @throws RuntimeException + */ + public static function getPathFromToken($path, $object = null) + { + $matches = static::resolveTokenPath($path); + if (null === $matches) { + return $path; + } + + $grav = Grav::instance(); + + switch ($matches[0]) { + case 'self': + if (!$object instanceof MediaInterface) { + throw new RuntimeException(sprintf('Page not available for self@ reference: %s', $path)); + } + + if ($matches[2] === '') { + if ($object->exists()) { + $route = '/' . $matches[1]; + + if ($object instanceof PageInterface) { + return trim($object->relativePagePath() . $route, '/'); + } + + $folder = $object->getMediaFolder(); + if ($folder) { + return trim($folder . $route, '/'); + } + } else { + return ''; + } + } + + break; + case 'page': + if ($matches[1] === '') { + $route = '/' . $matches[2]; + + // Exclude filename from the page lookup. + if (static::pathinfo($route, PATHINFO_EXTENSION)) { + $basename = '/' . static::basename($route); + $route = \dirname($route); + } else { + $basename = ''; + } + + $key = trim($route === '/' ? $grav['config']->get('system.home.alias') : $route, '/'); + if ($object instanceof PageObject) { + $object = $object->getFlexDirectory()->getObject($key); + } elseif (static::isAdminPlugin()) { + /** @var Flex|null $flex */ + $flex = $grav['flex'] ?? null; + $object = $flex ? $flex->getObject($key, 'pages') : null; + } else { + /** @var Pages $pages */ + $pages = $grav['pages']; + $object = $pages->find($route); + } + + if ($object instanceof PageInterface) { + return trim($object->relativePagePath() . $basename, '/'); + } + } + + break; + case 'theme': + if ($matches[1] === '') { + $route = '/' . $matches[2]; + $theme = $grav['locator']->findResource('theme://', false); + if (false !== $theme) { + return trim($theme . $route, '/'); + } + } + + break; + } + + throw new RuntimeException(sprintf('Token path not found: %s', $path)); + } + + /** + * Returns [token, route, path] from '@token/route:/path'. Route and path are optional. If pattern does not match, return null. + * + * @param string $path + * @return string[]|null + */ + protected static function resolveTokenPath(string $path): ?array + { + if (strpos($path, '@') !== false) { + $regex = '/^(@\w+|\w+@|@\w+@)([^:]*)(.*)$/u'; + if (preg_match($regex, $path, $matches)) { + return [ + trim($matches[1], '@'), + trim($matches[2], '/'), + trim($matches[3], ':/') + ]; + } + } + + return null; + } + + /** + * @return int + */ + public static function getUploadLimit() + { + static $max_size = -1; + + if ($max_size < 0) { + $post_max_size = static::parseSize(ini_get('post_max_size')); + if ($post_max_size > 0) { + $max_size = $post_max_size; + } else { + $max_size = 0; + } + + $upload_max = static::parseSize(ini_get('upload_max_filesize')); + if ($upload_max > 0 && $upload_max < $max_size) { + $max_size = $upload_max; + } + } + + return $max_size; + } + + /** + * Convert bytes to the unit specified by the $to parameter. + * + * @param int $bytes The filesize in Bytes. + * @param string $to The unit type to convert to. Accepts K, M, or G for Kilobytes, Megabytes, or Gigabytes, respectively. + * @param int $decimal_places The number of decimal places to return. + * @return int Returns only the number of units, not the type letter. Returns 0 if the $to unit type is out of scope. + * + */ + public static function convertSize($bytes, $to, $decimal_places = 1) + { + $formulas = array( + 'K' => number_format($bytes / 1024, $decimal_places), + 'M' => number_format($bytes / 1048576, $decimal_places), + 'G' => number_format($bytes / 1073741824, $decimal_places) + ); + return $formulas[$to] ?? 0; + } + + /** + * Return a pretty size based on bytes + * + * @param int $bytes + * @param int $precision + * @return string + */ + public static function prettySize($bytes, $precision = 2) + { + $units = array('B', 'KB', 'MB', 'GB', 'TB'); + + $bytes = max($bytes, 0); + $pow = floor(($bytes ? log($bytes) : 0) / log(1024)); + $pow = min($pow, count($units) - 1); + + // Uncomment one of the following alternatives + $bytes /= 1024 ** $pow; + // $bytes /= (1 << (10 * $pow)); + + return round($bytes, $precision) . ' ' . $units[$pow]; + } + + /** + * Parse a readable file size and return a value in bytes + * + * @param string|int|float $size + * @return int + */ + public static function parseSize($size) + { + $unit = preg_replace('/[^bkmgtpezy]/i', '', $size); + $size = (float)preg_replace('/[^0-9\.]/', '', $size); + + if ($unit) { + $size *= 1024 ** stripos('bkmgtpezy', $unit[0]); + } + + return (int)abs(round($size)); + } + + /** + * Multibyte-safe Parse URL function + * + * @param string $url + * @return array + * @throws InvalidArgumentException + */ + public static function multibyteParseUrl($url) + { + $enc_url = preg_replace_callback( + '%[^:/@?&=#]+%usD', + static function ($matches) { + return urlencode($matches[0]); + }, + $url + ); + + $parts = parse_url($enc_url); + + if ($parts === false) { + $parts = []; + } + + foreach ($parts as $name => $value) { + $parts[$name] = urldecode($value); + } + + return $parts; + } + + /** + * Process a string as markdown + * + * @param string $string + * @param bool $block Block or Line processing + * @param PageInterface|null $page + * @return string + * @throws Exception + */ + public static function processMarkdown($string, $block = true, $page = null) + { + $grav = Grav::instance(); + $page = $page ?? $grav['page'] ?? null; + $defaults = [ + 'markdown' => $grav['config']->get('system.pages.markdown', []), + 'images' => $grav['config']->get('system.images', []) + ]; + $extra = $defaults['markdown']['extra'] ?? false; + + $excerpts = new Excerpts($page, $defaults); + + // Initialize the preferred variant of Parsedown + if ($extra) { + $parsedown = new ParsedownExtra($excerpts); + } else { + $parsedown = new Parsedown($excerpts); + } + + if ($block) { + $string = $parsedown->text((string) $string); + } else { + $string = $parsedown->line((string) $string); + } + + return $string; + } + + /** + * Find the subnet of an ip with CIDR prefix size + * + * @param string $ip + * @param int $prefix + * @return string + */ + public static function getSubnet($ip, $prefix = 64) + { + if (!filter_var($ip, FILTER_VALIDATE_IP)) { + return $ip; + } + + // Packed representation of IP + $ip = (string)inet_pton($ip); + + // Maximum netmask length = same as packed address + $len = 8 * strlen($ip); + if ($prefix > $len) { + $prefix = $len; + } + + $mask = str_repeat('f', $prefix >> 2); + + switch ($prefix & 3) { + case 3: + $mask .= 'e'; + break; + case 2: + $mask .= 'c'; + break; + case 1: + $mask .= '8'; + break; + } + $mask = str_pad($mask, $len >> 2, '0'); + + // Packed representation of netmask + $mask = pack('H*', $mask); + // Bitwise - Take all bits that are both 1 to generate subnet + $subnet = inet_ntop($ip & $mask); + + return $subnet; + } + + /** + * Wrapper to ensure html, htm in the front of the supported page types + * + * @param array|null $defaults + * @return array + */ + public static function getSupportPageTypes(array $defaults = null) + { + $types = Grav::instance()['config']->get('system.pages.types', $defaults); + if (!is_array($types)) { + return []; + } + + // remove html/htm + $types = static::arrayRemoveValue($types, ['html', 'htm']); + + // put them back at the front + $types = array_merge(['html', 'htm'], $types); + + return $types; + } + + /** + * @param string|array|Closure $name + * @return bool + */ + public static function isDangerousFunction($name): bool + { + static $commandExecutionFunctions = [ + 'exec', + 'passthru', + 'system', + 'shell_exec', + 'popen', + 'proc_open', + 'pcntl_exec', + ]; + + static $codeExecutionFunctions = [ + 'assert', + 'preg_replace', + 'create_function', + 'include', + 'include_once', + 'require', + 'require_once' + ]; + + static $callbackFunctions = [ + 'ob_start' => 0, + 'array_diff_uassoc' => -1, + 'array_diff_ukey' => -1, + 'array_filter' => 1, + 'array_intersect_uassoc' => -1, + 'array_intersect_ukey' => -1, + 'array_map' => 0, + 'array_reduce' => 1, + 'array_udiff_assoc' => -1, + 'array_udiff_uassoc' => [-1, -2], + 'array_udiff' => -1, + 'array_uintersect_assoc' => -1, + 'array_uintersect_uassoc' => [-1, -2], + 'array_uintersect' => -1, + 'array_walk_recursive' => 1, + 'array_walk' => 1, + 'assert_options' => 1, + 'uasort' => 1, + 'uksort' => 1, + 'usort' => 1, + 'preg_replace_callback' => 1, + 'spl_autoload_register' => 0, + 'iterator_apply' => 1, + 'call_user_func' => 0, + 'call_user_func_array' => 0, + 'register_shutdown_function' => 0, + 'register_tick_function' => 0, + 'set_error_handler' => 0, + 'set_exception_handler' => 0, + 'session_set_save_handler' => [0, 1, 2, 3, 4, 5], + 'sqlite_create_aggregate' => [2, 3], + 'sqlite_create_function' => 2, + ]; + + static $informationDiscosureFunctions = [ + 'phpinfo', + 'posix_mkfifo', + 'posix_getlogin', + 'posix_ttyname', + 'getenv', + 'get_current_user', + 'proc_get_status', + 'get_cfg_var', + 'disk_free_space', + 'disk_total_space', + 'diskfreespace', + 'getcwd', + 'getlastmo', + 'getmygid', + 'getmyinode', + 'getmypid', + 'getmyuid' + ]; + + static $otherFunctions = [ + 'extract', + 'parse_str', + 'putenv', + 'ini_set', + 'mail', + 'header', + 'proc_nice', + 'proc_terminate', + 'proc_close', + 'pfsockopen', + 'fsockopen', + 'apache_child_terminate', + 'posix_kill', + 'posix_mkfifo', + 'posix_setpgid', + 'posix_setsid', + 'posix_setuid', + 'unserialize', + 'ini_alter', + 'simplexml_load_file', + 'simplexml_load_string', + 'forward_static_call', + 'forward_static_call_array', + ]; + + if (is_string($name)) { + $name = strtolower($name); + } + + if ($name instanceof \Closure) { + return false; + } + + if (is_array($name) || strpos($name, ":") !== false) { + return true; + } + + if (strpos($name, "\\") !== false) { + return true; + } + + if (in_array($name, $commandExecutionFunctions)) { + return true; + } + + if (in_array($name, $codeExecutionFunctions)) { + return true; + } + + if (isset($callbackFunctions[$name])) { + return true; + } + + if (in_array($name, $informationDiscosureFunctions)) { + return true; + } + + if (in_array($name, $otherFunctions)) { + return true; + } + + return static::isFilesystemFunction($name); + } + + /** + * @param string $name + * @return bool + */ + public static function isFilesystemFunction(string $name): bool + { + static $fileWriteFunctions = [ + 'fopen', + 'tmpfile', + 'bzopen', + 'gzopen', + // write to filesystem (partially in combination with reading) + 'chgrp', + 'chmod', + 'chown', + 'copy', + 'file_put_contents', + 'lchgrp', + 'lchown', + 'link', + 'mkdir', + 'move_uploaded_file', + 'rename', + 'rmdir', + 'symlink', + 'tempnam', + 'touch', + 'unlink', + 'imagepng', + 'imagewbmp', + 'image2wbmp', + 'imagejpeg', + 'imagexbm', + 'imagegif', + 'imagegd', + 'imagegd2', + 'iptcembed', + 'ftp_get', + 'ftp_nb_get', + ]; + + static $fileContentFunctions = [ + 'file_get_contents', + 'file', + 'filegroup', + 'fileinode', + 'fileowner', + 'fileperms', + 'glob', + 'is_executable', + 'is_uploaded_file', + 'parse_ini_file', + 'readfile', + 'readlink', + 'realpath', + 'gzfile', + 'readgzfile', + 'stat', + 'imagecreatefromgif', + 'imagecreatefromjpeg', + 'imagecreatefrompng', + 'imagecreatefromwbmp', + 'imagecreatefromxbm', + 'imagecreatefromxpm', + 'ftp_put', + 'ftp_nb_put', + 'hash_update_file', + 'highlight_file', + 'show_source', + 'php_strip_whitespace', + ]; + + static $filesystemFunctions = [ + // read from filesystem + 'file_exists', + 'fileatime', + 'filectime', + 'filemtime', + 'filesize', + 'filetype', + 'is_dir', + 'is_file', + 'is_link', + 'is_readable', + 'is_writable', + 'is_writeable', + 'linkinfo', + 'lstat', + //'pathinfo', + 'getimagesize', + 'exif_read_data', + 'read_exif_data', + 'exif_thumbnail', + 'exif_imagetype', + 'hash_file', + 'hash_hmac_file', + 'md5_file', + 'sha1_file', + 'get_meta_tags', + ]; + + if (in_array($name, $fileWriteFunctions)) { + return true; + } + + if (in_array($name, $fileContentFunctions)) { + return true; + } + + if (in_array($name, $filesystemFunctions)) { + return true; + } + + return false; + } +} diff --git a/system/src/Grav/Common/Yaml.php b/system/src/Grav/Common/Yaml.php new file mode 100644 index 0000000..a4b3d73 --- /dev/null +++ b/system/src/Grav/Common/Yaml.php @@ -0,0 +1,65 @@ +decode($data); + } + + /** + * @param array $data + * @param int|null $inline + * @param int|null $indent + * @return string + */ + public static function dump($data, $inline = null, $indent = null) + { + if (null === static::$yaml) { + static::init(); + } + + return static::$yaml->encode($data, $inline, $indent); + } + + /** + * @return void + */ + protected static function init() + { + $config = [ + 'inline' => 5, + 'indent' => 2, + 'native' => true, + 'compat' => true + ]; + + static::$yaml = new YamlFormatter($config); + } +} diff --git a/system/src/Grav/Console/Application/Application.php b/system/src/Grav/Console/Application/Application.php new file mode 100644 index 0000000..d2fa0cd --- /dev/null +++ b/system/src/Grav/Console/Application/Application.php @@ -0,0 +1,138 @@ +addListener(ConsoleEvents::COMMAND, [$this, 'prepareEnvironment']); + + $this->setDispatcher($dispatcher); + } + + /** + * @param InputInterface $input + * @return string|null + */ + public function getCommandName(InputInterface $input): ?string + { + if ($input->hasParameterOption('--env', true)) { + $this->environment = $input->getParameterOption('--env'); + } + if ($input->hasParameterOption('--lang', true)) { + $this->language = $input->getParameterOption('--lang'); + } + + $this->init(); + + return parent::getCommandName($input); + } + + /** + * @param ConsoleCommandEvent $event + * @return void + */ + public function prepareEnvironment(ConsoleCommandEvent $event): void + { + } + + /** + * @return void + */ + protected function init(): void + { + if ($this->initialized) { + return; + } + + $this->initialized = true; + + $grav = Grav::instance(); + $grav->setup($this->environment); + } + + /** + * Add global --env and --lang options. + * + * @return InputDefinition + */ + protected function getDefaultInputDefinition(): InputDefinition + { + $inputDefinition = parent::getDefaultInputDefinition(); + $inputDefinition->addOption( + new InputOption( + '--env', + '', + InputOption::VALUE_OPTIONAL, + 'Use environment configuration (defaults to localhost)' + ) + ); + $inputDefinition->addOption( + new InputOption( + '--lang', + '', + InputOption::VALUE_OPTIONAL, + 'Language to be used (defaults to en)' + ) + ); + + return $inputDefinition; + } + + /** + * @param InputInterface $input + * @param OutputInterface $output + * @return void + */ + protected function configureIO(InputInterface $input, OutputInterface $output) + { + $formatter = $output->getFormatter(); + $formatter->setStyle('normal', new OutputFormatterStyle('white')); + $formatter->setStyle('yellow', new OutputFormatterStyle('yellow', null, ['bold'])); + $formatter->setStyle('red', new OutputFormatterStyle('red', null, ['bold'])); + $formatter->setStyle('cyan', new OutputFormatterStyle('cyan', null, ['bold'])); + $formatter->setStyle('green', new OutputFormatterStyle('green', null, ['bold'])); + $formatter->setStyle('magenta', new OutputFormatterStyle('magenta', null, ['bold'])); + $formatter->setStyle('white', new OutputFormatterStyle('white', null, ['bold'])); + + parent::configureIO($input, $output); + } +} diff --git a/system/src/Grav/Console/Application/CommandLoader/PluginCommandLoader.php b/system/src/Grav/Console/Application/CommandLoader/PluginCommandLoader.php new file mode 100644 index 0000000..f550c51 --- /dev/null +++ b/system/src/Grav/Console/Application/CommandLoader/PluginCommandLoader.php @@ -0,0 +1,95 @@ +commands = []; + + try { + $path = "plugins://{$name}/cli"; + $pattern = '([A-Z]\w+Command\.php)'; + + $commands = is_dir($path) ? Folder::all($path, ['compare' => 'Filename', 'pattern' => '/' . $pattern . '$/usm', 'levels' => 1]) : []; + } catch (RuntimeException $e) { + throw new RuntimeException("Failed to load console commands for plugin {$name}"); + } + + $grav = Grav::instance(); + + /** @var UniformResourceLocator $locator */ + $locator = $grav['locator']; + foreach ($commands as $command_path) { + $full_path = $locator->findResource("plugins://{$name}/cli/{$command_path}"); + require_once $full_path; + + $command_class = 'Grav\Plugin\Console\\' . preg_replace('/.php$/', '', $command_path); + if (class_exists($command_class)) { + $command = new $command_class(); + if ($command instanceof Command) { + $this->commands[$command->getName()] = $command; + } + } + } + } + + /** + * @param string $name + * @return Command + */ + public function get($name): Command + { + $command = $this->commands[$name] ?? null; + if (null === $command) { + throw new CommandNotFoundException(sprintf('The command "%s" does not exist.', $name)); + } + + return $command; + } + + /** + * @param string $name + * @return bool + */ + public function has($name): bool + { + return isset($this->commands[$name]); + } + + /** + * @return string[] + */ + public function getNames(): array + { + return array_keys($this->commands); + } +} diff --git a/system/src/Grav/Console/Application/GpmApplication.php b/system/src/Grav/Console/Application/GpmApplication.php new file mode 100644 index 0000000..cddf473 --- /dev/null +++ b/system/src/Grav/Console/Application/GpmApplication.php @@ -0,0 +1,42 @@ +addCommands([ + new IndexCommand(), + new VersionCommand(), + new InfoCommand(), + new InstallCommand(), + new UninstallCommand(), + new UpdateCommand(), + new SelfupgradeCommand(), + new DirectInstallCommand(), + ]); + } +} diff --git a/system/src/Grav/Console/Application/GravApplication.php b/system/src/Grav/Console/Application/GravApplication.php new file mode 100644 index 0000000..7b43b2b --- /dev/null +++ b/system/src/Grav/Console/Application/GravApplication.php @@ -0,0 +1,52 @@ +addCommands([ + new InstallCommand(), + new ComposerCommand(), + new SandboxCommand(), + new CleanCommand(), + new ClearCacheCommand(), + new BackupCommand(), + new NewProjectCommand(), + new SchedulerCommand(), + new SecurityCommand(), + new LogViewerCommand(), + new YamlLinterCommand(), + new ServerCommand(), + new PageSystemValidatorCommand(), + ]); + } +} diff --git a/system/src/Grav/Console/Application/PluginApplication.php b/system/src/Grav/Console/Application/PluginApplication.php new file mode 100644 index 0000000..e748018 --- /dev/null +++ b/system/src/Grav/Console/Application/PluginApplication.php @@ -0,0 +1,116 @@ +addCommands([ + new PluginListCommand(), + ]); + } + + /** + * @param string $pluginName + * @return void + */ + public function setPluginName(string $pluginName): void + { + $this->pluginName = $pluginName; + } + + /** + * @return string + */ + public function getPluginName(): string + { + return $this->pluginName; + } + + /** + * @param InputInterface|null $input + * @param OutputInterface|null $output + * @return int + * @throws Throwable + */ + public function run(InputInterface $input = null, OutputInterface $output = null): int + { + if (null === $input) { + $argv = $_SERVER['argv'] ?? []; + + $bin = array_shift($argv); + $this->pluginName = array_shift($argv); + $argv = array_merge([$bin], $argv); + + $input = new ArgvInput($argv); + } + + return parent::run($input, $output); + } + + /** + * @return void + */ + protected function init(): void + { + if ($this->initialized) { + return; + } + + parent::init(); + + if (null === $this->pluginName) { + $this->setDefaultCommand('plugins:list'); + + return; + } + + $grav = Grav::instance(); + $grav->initializeCli(); + + /** @var Plugins $plugins */ + $plugins = $grav['plugins']; + + $plugin = $this->pluginName ? $plugins::get($this->pluginName) : null; + if (null === $plugin) { + throw new NamespaceNotFoundException("Plugin \"{$this->pluginName}\" is not installed."); + } + if (!$plugin->enabled) { + throw new NamespaceNotFoundException("Plugin \"{$this->pluginName}\" is not enabled."); + } + + $this->setCommandLoader(new PluginCommandLoader($this->pluginName)); + } +} diff --git a/system/src/Grav/Console/Cli/BackupCommand.php b/system/src/Grav/Console/Cli/BackupCommand.php new file mode 100644 index 0000000..d95e7cf --- /dev/null +++ b/system/src/Grav/Console/Cli/BackupCommand.php @@ -0,0 +1,138 @@ +setName('backup') + ->addArgument( + 'id', + InputArgument::OPTIONAL, + 'The ID of the backup profile to perform without prompting' + ) + ->setDescription('Creates a backup of the Grav instance') + ->setHelp('The backup creates a zipped backup.'); + + $this->source = getcwd(); + } + + /** + * @return int + */ + protected function serve(): int + { + $this->initializeGrav(); + + $input = $this->getInput(); + $io = $this->getIO(); + + $io->title('Grav Backup'); + + if (!class_exists(ZipArchive::class)) { + $io->error('php-zip extension needs to be enabled!'); + return 1; + } + + ProgressBar::setFormatDefinition('zip', 'Archiving %current% files [%bar%] %percent:3s%% %elapsed:6s% %message%'); + + $this->progress = new ProgressBar($this->output, 100); + $this->progress->setFormat('zip'); + + + /** @var Backups $backups */ + $backups = Grav::instance()['backups']; + $backups_list = $backups::getBackupProfiles(); + $backups_names = $backups->getBackupNames(); + + $id = null; + + $inline_id = $input->getArgument('id'); + if (null !== $inline_id && is_numeric($inline_id)) { + $id = $inline_id; + } + + if (null === $id) { + if (count($backups_list) > 1) { + $question = new ChoiceQuestion( + 'Choose a backup?', + $backups_names, + 0 + ); + $question->setErrorMessage('Option %s is invalid.'); + $backup_name = $io->askQuestion($question); + $id = array_search($backup_name, $backups_names, true); + + $io->newLine(); + $io->note('Selected backup: ' . $backup_name); + } else { + $id = 0; + } + } + + $backup = $backups::backup($id, function($args) { $this->outputProgress($args); }); + + $io->newline(2); + $io->success('Backup Successfully Created: ' . $backup); + + return 0; + } + + /** + * @param array $args + * @return void + */ + public function outputProgress(array $args): void + { + switch ($args['type']) { + case 'count': + $steps = $args['steps']; + $freq = (int)($steps > 100 ? round($steps / 100) : $steps); + $this->progress->setMaxSteps($steps); + $this->progress->setRedrawFrequency($freq); + $this->progress->setMessage('Adding files...'); + break; + case 'message': + $this->progress->setMessage($args['message']); + $this->progress->display(); + break; + case 'progress': + if (isset($args['complete']) && $args['complete']) { + $this->progress->finish(); + } else { + $this->progress->advance(); + } + break; + } + } +} diff --git a/system/src/Grav/Console/Cli/CleanCommand.php b/system/src/Grav/Console/Cli/CleanCommand.php new file mode 100644 index 0000000..34fc522 --- /dev/null +++ b/system/src/Grav/Console/Cli/CleanCommand.php @@ -0,0 +1,411 @@ +setName('clean') + ->setDescription('Handles cleaning chores for Grav distribution') + ->setHelp('The clean clean extraneous folders and data'); + } + + /** + * @param InputInterface $input + * @param OutputInterface $output + * @return int + */ + protected function execute(InputInterface $input, OutputInterface $output): int + { + $this->setupConsole($input, $output); + + return $this->cleanPaths() ? 0 : 1; + } + + /** + * @return bool + */ + private function cleanPaths(): bool + { + $success = true; + + $this->io->writeln(''); + $this->io->writeln('DELETING'); + $anything = false; + foreach ($this->paths_to_remove as $path) { + $path = GRAV_ROOT . DS . $path; + try { + if (is_dir($path) && Folder::delete($path)) { + $anything = true; + $this->io->writeln('dir: ' . $path); + } elseif (is_file($path) && @unlink($path)) { + $anything = true; + $this->io->writeln('file: ' . $path); + } + } catch (\Exception $e) { + $success = false; + $this->io->error(sprintf('Failed to delete %s: %s', $path, $e->getMessage())); + } + } + if (!$anything) { + $this->io->writeln(''); + $this->io->writeln('Nothing to clean...'); + } + + return $success; + } + + /** + * Set colors style definition for the formatter. + * + * @param InputInterface $input + * @param OutputInterface $output + * @return void + */ + public function setupConsole(InputInterface $input, OutputInterface $output): void + { + $this->input = $input; + $this->io = new SymfonyStyle($input, $output); + + $this->io->getFormatter()->setStyle('normal', new OutputFormatterStyle('white')); + $this->io->getFormatter()->setStyle('yellow', new OutputFormatterStyle('yellow', null, ['bold'])); + $this->io->getFormatter()->setStyle('red', new OutputFormatterStyle('red', null, ['bold'])); + $this->io->getFormatter()->setStyle('cyan', new OutputFormatterStyle('cyan', null, ['bold'])); + $this->io->getFormatter()->setStyle('green', new OutputFormatterStyle('green', null, ['bold'])); + $this->io->getFormatter()->setStyle('magenta', new OutputFormatterStyle('magenta', null, ['bold'])); + $this->io->getFormatter()->setStyle('white', new OutputFormatterStyle('white', null, ['bold'])); + } +} diff --git a/system/src/Grav/Console/Cli/ClearCacheCommand.php b/system/src/Grav/Console/Cli/ClearCacheCommand.php new file mode 100644 index 0000000..14795ef --- /dev/null +++ b/system/src/Grav/Console/Cli/ClearCacheCommand.php @@ -0,0 +1,104 @@ +setName('cache') + ->setAliases(['clearcache', 'cache-clear']) + ->setDescription('Clears Grav cache') + ->addOption('invalidate', null, InputOption::VALUE_NONE, 'Invalidate cache, but do not remove any files') + ->addOption('purge', null, InputOption::VALUE_NONE, 'If set purge old caches') + ->addOption('all', null, InputOption::VALUE_NONE, 'If set will remove all including compiled, twig, doctrine caches') + ->addOption('assets-only', null, InputOption::VALUE_NONE, 'If set will remove only assets/*') + ->addOption('images-only', null, InputOption::VALUE_NONE, 'If set will remove only images/*') + ->addOption('cache-only', null, InputOption::VALUE_NONE, 'If set will remove only cache/*') + ->addOption('tmp-only', null, InputOption::VALUE_NONE, 'If set will remove only tmp/*') + + ->setHelp('The cache command allows you to interact with Grav cache'); + } + + /** + * @return int + */ + protected function serve(): int + { + // Old versions of Grav called this command after grav upgrade. + // We need make this command to work with older GravCommand instance: + if (!method_exists($this, 'initializePlugins')) { + Cache::clearCache('all'); + + return 0; + } + + $this->initializePlugins(); + $this->cleanPaths(); + + return 0; + } + + /** + * loops over the array of paths and deletes the files/folders + * + * @return void + */ + private function cleanPaths(): void + { + $input = $this->getInput(); + $io = $this->getIO(); + + $io->newLine(); + + if ($input->getOption('purge')) { + $io->writeln('Purging old cache'); + $io->newLine(); + + $msg = Cache::purgeJob(); + $io->writeln($msg); + } else { + $io->writeln('Clearing cache'); + $io->newLine(); + + if ($input->getOption('all')) { + $remove = 'all'; + } elseif ($input->getOption('assets-only')) { + $remove = 'assets-only'; + } elseif ($input->getOption('images-only')) { + $remove = 'images-only'; + } elseif ($input->getOption('cache-only')) { + $remove = 'cache-only'; + } elseif ($input->getOption('tmp-only')) { + $remove = 'tmp-only'; + } elseif ($input->getOption('invalidate')) { + $remove = 'invalidate'; + } else { + $remove = 'standard'; + } + + foreach (Cache::clearCache($remove) as $result) { + $io->writeln($result); + } + } + } +} diff --git a/system/src/Grav/Console/Cli/ComposerCommand.php b/system/src/Grav/Console/Cli/ComposerCommand.php new file mode 100644 index 0000000..05c784a --- /dev/null +++ b/system/src/Grav/Console/Cli/ComposerCommand.php @@ -0,0 +1,64 @@ +setName('composer') + ->addOption( + 'install', + 'i', + InputOption::VALUE_NONE, + 'install the dependencies' + ) + ->addOption( + 'update', + 'u', + InputOption::VALUE_NONE, + 'update the dependencies' + ) + ->setDescription('Updates the composer vendor dependencies needed by Grav.') + ->setHelp('The composer command updates the composer vendor dependencies needed by Grav'); + } + + /** + * @return int + */ + protected function serve(): int + { + $input = $this->getInput(); + $io = $this->getIO(); + + $action = $input->getOption('install') ? 'install' : ($input->getOption('update') ? 'update' : 'install'); + + if ($input->getOption('install')) { + $action = 'install'; + } + + // Updates composer first + $io->writeln("\nInstalling vendor dependencies"); + $io->writeln($this->composerUpdate(GRAV_ROOT, $action)); + + return 0; + } +} diff --git a/system/src/Grav/Console/Cli/InstallCommand.php b/system/src/Grav/Console/Cli/InstallCommand.php new file mode 100644 index 0000000..51fd16c --- /dev/null +++ b/system/src/Grav/Console/Cli/InstallCommand.php @@ -0,0 +1,302 @@ +setName('install') + ->addOption( + 'symlink', + 's', + InputOption::VALUE_NONE, + 'Symlink the required bits' + ) + ->addOption( + 'plugin', + 'p', + InputOption::VALUE_REQUIRED, + 'Install plugin (symlink)' + ) + ->addOption( + 'theme', + 't', + InputOption::VALUE_REQUIRED, + 'Install theme (symlink)' + ) + ->addArgument( + 'destination', + InputArgument::OPTIONAL, + 'Where to install the required bits (default to current project)' + ) + ->setDescription('Installs the dependencies needed by Grav. Optionally can create symbolic links') + ->setHelp('The install command installs the dependencies needed by Grav. Optionally can create symbolic links'); + } + + /** + * @return int + */ + protected function serve(): int + { + $input = $this->getInput(); + $io = $this->getIO(); + + $dependencies_file = '.dependencies'; + $this->destination = $input->getArgument('destination') ?: GRAV_WEBROOT; + + // fix trailing slash + $this->destination = rtrim($this->destination, DS) . DS; + $this->user_path = $this->destination . GRAV_USER_PATH . DS; + if ($local_config_file = $this->loadLocalConfig()) { + $io->writeln('Read local config from ' . $local_config_file . ''); + } + + // Look for dependencies file in ROOT and USER dir + if (file_exists($this->user_path . $dependencies_file)) { + $file = YamlFile::instance($this->user_path . $dependencies_file); + } elseif (file_exists($this->destination . $dependencies_file)) { + $file = YamlFile::instance($this->destination . $dependencies_file); + } else { + $io->writeln('ERROR Missing .dependencies file in user/ folder'); + if ($input->getArgument('destination')) { + $io->writeln('HINT Are you trying to install a plugin or a theme? Make sure you use bin/gpm install , not bin/grav install. This command is only used to install Grav skeletons.'); + } else { + $io->writeln('HINT Are you trying to install Grav? Grav is already installed. You need to run this command only if you download a skeleton from GitHub directly.'); + } + + return 1; + } + + $this->config = $file->content(); + $file->free(); + + // If no config, fail. + if (!$this->config) { + $io->writeln('ERROR invalid YAML in ' . $dependencies_file); + + return 1; + } + + $plugin = $input->getOption('plugin'); + $theme = $input->getOption('theme'); + $name = $plugin ?? $theme; + $symlink = $name || $input->getOption('symlink'); + + if (!$symlink) { + // Updates composer first + $io->writeln("\nInstalling vendor dependencies"); + $io->writeln($this->composerUpdate(GRAV_ROOT, 'install')); + + $error = $this->gitclone(); + } else { + $type = $name ? ($plugin ? 'plugin' : 'theme') : null; + + $error = $this->symlink($name, $type); + } + + return $error; + } + + /** + * Clones from Git + * + * @return int + */ + private function gitclone(): int + { + $io = $this->getIO(); + + $io->newLine(); + $io->writeln('Cloning Bits'); + $io->writeln('============'); + $io->newLine(); + + $error = 0; + $this->destination = rtrim($this->destination, DS); + foreach ($this->config['git'] as $repo => $data) { + $path = $this->destination . DS . $data['path']; + if (!file_exists($path)) { + exec('cd ' . escapeshellarg($this->destination) . ' && git clone -b ' . $data['branch'] . ' --depth 1 ' . $data['url'] . ' ' . $data['path'], $output, $return); + + if (!$return) { + $io->writeln('SUCCESS cloned ' . $data['url'] . ' -> ' . $path . ''); + } else { + $io->writeln('ERROR cloning ' . $data['url']); + $error = 1; + } + + $io->newLine(); + } else { + $io->writeln('' . $path . ' already exists, skipping...'); + $io->newLine(); + } + } + + return $error; + } + + /** + * Symlinks + * + * @param string|null $name + * @param string|null $type + * @return int + */ + private function symlink(string $name = null, string $type = null): int + { + $io = $this->getIO(); + + $io->newLine(); + $io->writeln('Symlinking Bits'); + $io->writeln('==============='); + $io->newLine(); + + if (!$this->local_config) { + $io->writeln('No local configuration available, aborting...'); + $io->newLine(); + + return 1; + } + + $error = 0; + $this->destination = rtrim($this->destination, DS); + + if ($name) { + $src = "grav-{$type}-{$name}"; + $links = [ + $name => [ + 'scm' => 'github', // TODO: make configurable + 'src' => $src, + 'path' => "user/{$type}s/{$name}" + ] + ]; + } else { + $links = $this->config['links']; + } + + foreach ($links as $name => $data) { + $scm = $data['scm'] ?? null; + $src = $data['src'] ?? null; + $path = $data['path'] ?? null; + if (!isset($scm, $src, $path)) { + $io->writeln("Dependency '$name' has broken configuration, skipping..."); + $io->newLine(); + $error = 1; + + continue; + } + + $locations = (array) $this->local_config["{$scm}_repos"]; + $to = $this->destination . DS . $path; + + $from = null; + foreach ($locations as $location) { + $test = rtrim($location, '\\/') . DS . $src; + if (file_exists($test)) { + $from = $test; + continue; + } + } + + if (is_link($to) && !realpath($to)) { + $io->writeln('Removed broken symlink '. $path .''); + unlink($to); + } + if (null === $from) { + $io->writeln('source for ' . $src . ' does not exists, skipping...'); + $io->newLine(); + $error = 1; + } elseif (!file_exists($to)) { + $error = $this->addSymlinks($from, $to, ['name' => $name, 'src' => $src, 'path' => $path]); + $io->newLine(); + } else { + $io->writeln('destination: ' . $path . ' already exists, skipping...'); + $io->newLine(); + } + } + + return $error; + } + + private function addSymlinks(string $from, string $to, array $options): int + { + $io = $this->getIO(); + + $hebe = $this->readHebe($from); + if (null === $hebe) { + symlink($from, $to); + + $io->writeln('SUCCESS symlinked ' . $options['src'] . ' -> ' . $options['path'] . ''); + } else { + $to = GRAV_ROOT; + $name = $options['name']; + $io->writeln("Processing {$name}"); + foreach ($hebe as $section => $symlinks) { + foreach ($symlinks as $symlink) { + $src = trim($symlink['source'], '/'); + $dst = trim($symlink['destination'], '/'); + $s = "{$from}/{$src}"; + $d = "{$to}/{$dst}"; + + if (is_link($d) && !realpath($d)) { + unlink($d); + $io->writeln(' Removed broken symlink '. $dst .''); + } + if (!file_exists($d)) { + symlink($s, $d); + $io->writeln(' symlinked ' . $src . ' -> ' . $dst . ''); + } + } + } + $io->writeln('SUCCESS'); + } + + return 0; + } + + private function readHebe(string $folder): ?array + { + $filename = "{$folder}/hebe.json"; + if (!is_file($filename)) { + return null; + } + + $formatter = new JsonFormatter(); + $file = new JsonFile($filename, $formatter); + $hebe = $file->load(); + $paths = $hebe['platforms']['grav']['nodes'] ?? null; + + return is_array($paths) ? $paths : null; + } +} diff --git a/system/src/Grav/Console/Cli/LogViewerCommand.php b/system/src/Grav/Console/Cli/LogViewerCommand.php new file mode 100644 index 0000000..fe19a40 --- /dev/null +++ b/system/src/Grav/Console/Cli/LogViewerCommand.php @@ -0,0 +1,96 @@ +setName('logviewer') + ->addOption( + 'file', + 'f', + InputOption::VALUE_OPTIONAL, + 'custom log file location (default = grav.log)' + ) + ->addOption( + 'lines', + 'l', + InputOption::VALUE_OPTIONAL, + 'number of lines (default = 10)' + ) + ->setDescription('Display the last few entries of Grav log') + ->setHelp('Display the last few entries of Grav log'); + } + + /** + * @return int + */ + protected function serve(): int + { + $input = $this->getInput(); + $io = $this->getIO(); + + $file = $input->getOption('file') ?? 'grav.log'; + $lines = $input->getOption('lines') ?? 20; + $verbose = $input->getOption('verbose') ?? false; + + $io->title('Log Viewer'); + + $io->writeln(sprintf('viewing last %s entries in %s', $lines, $file)); + $io->newLine(); + + $viewer = new LogViewer(); + + $grav = Grav::instance(); + + $logfile = $grav['locator']->findResource('log://' . $file); + if (!$logfile) { + $io->error('cannot find the log file: logs/' . $file); + + return 1; + } + + $rows = $viewer->objectTail($logfile, $lines, true); + foreach ($rows as $log) { + $date = $log['date']; + $level_color = LogViewer::levelColor($log['level']); + + if ($date instanceof DateTime) { + $output = "{$log['date']->format('Y-m-d h:i:s')} [<{$level_color}>{$log['level']}]"; + if ($log['trace'] && $verbose) { + $output .= " {$log['message']}\n"; + foreach ((array) $log['trace'] as $index => $tracerow) { + $output .= "{$index}{$tracerow}\n"; + } + } else { + $output .= " {$log['message']}"; + } + $io->writeln($output); + } + } + + return 0; + } +} diff --git a/system/src/Grav/Console/Cli/NewProjectCommand.php b/system/src/Grav/Console/Cli/NewProjectCommand.php new file mode 100644 index 0000000..9450139 --- /dev/null +++ b/system/src/Grav/Console/Cli/NewProjectCommand.php @@ -0,0 +1,75 @@ +setName('new-project') + ->setAliases(['newproject']) + ->addArgument( + 'destination', + InputArgument::REQUIRED, + 'The destination directory of your new Grav project' + ) + ->addOption( + 'symlink', + 's', + InputOption::VALUE_NONE, + 'Symlink the required bits' + ) + ->setDescription('Creates a new Grav project with all the dependencies installed') + ->setHelp("The new-project command is a combination of the `setup` and `install` commands.\nCreates a new Grav instance and performs the installation of all the required dependencies."); + } + + /** + * @return int + */ + protected function serve(): int + { + $io = $this->getIO(); + + $sandboxCommand = $this->getApplication()->find('sandbox'); + $installCommand = $this->getApplication()->find('install'); + + $sandboxArguments = new ArrayInput([ + 'command' => 'sandbox', + 'destination' => $this->input->getArgument('destination'), + '-s' => $this->input->getOption('symlink') + ]); + + $installArguments = new ArrayInput([ + 'command' => 'install', + 'destination' => $this->input->getArgument('destination'), + '-s' => $this->input->getOption('symlink') + ]); + + $error = $sandboxCommand->run($sandboxArguments, $io); + if ($error === 0) { + $error = $installCommand->run($installArguments, $io); + } + + return $error; + } +} diff --git a/system/src/Grav/Console/Cli/PageSystemValidatorCommand.php b/system/src/Grav/Console/Cli/PageSystemValidatorCommand.php new file mode 100644 index 0000000..1e8302d --- /dev/null +++ b/system/src/Grav/Console/Cli/PageSystemValidatorCommand.php @@ -0,0 +1,299 @@ + [[]], + 'summary' => [[], [200], [200, true]], + 'content' => [[]], + 'getRawContent' => [[]], + 'rawMarkdown' => [[]], + 'value' => [['content'], ['route'], ['order'], ['ordering'], ['folder'], ['slug'], ['name'], /*['frontmatter'],*/ ['header.menu'], ['header.slug']], + 'title' => [[]], + 'menu' => [[]], + 'visible' => [[]], + 'published' => [[]], + 'publishDate' => [[]], + 'unpublishDate' => [[]], + 'process' => [[]], + 'slug' => [[]], + 'order' => [[]], + //'id' => [[]], + 'modified' => [[]], + 'lastModified' => [[]], + 'folder' => [[]], + 'date' => [[]], + 'dateformat' => [[]], + 'taxonomy' => [[]], + 'shouldProcess' => [['twig'], ['markdown']], + 'isPage' => [[]], + 'isDir' => [[]], + 'exists' => [[]], + + // Forms + 'forms' => [[]], + + // Routing + 'urlExtension' => [[]], + 'routable' => [[]], + 'link' => [[], [false], [true]], + 'permalink' => [[]], + 'canonical' => [[], [false], [true]], + 'url' => [[], [true], [true, true], [true, true, false], [false, false, true, false]], + 'route' => [[]], + 'rawRoute' => [[]], + 'routeAliases' => [[]], + 'routeCanonical' => [[]], + 'redirect' => [[]], + 'relativePagePath' => [[]], + 'path' => [[]], + //'folder' => [[]], + 'parent' => [[]], + 'topParent' => [[]], + 'currentPosition' => [[]], + 'active' => [[]], + 'activeChild' => [[]], + 'home' => [[]], + 'root' => [[]], + + // Translations + 'translatedLanguages' => [[], [false], [true]], + 'untranslatedLanguages' => [[], [false], [true]], + 'language' => [[]], + + // Legacy + 'raw' => [[]], + 'frontmatter' => [[]], + 'httpResponseCode' => [[]], + 'httpHeaders' => [[]], + 'blueprintName' => [[]], + 'name' => [[]], + 'childType' => [[]], + 'template' => [[]], + 'templateFormat' => [[]], + 'extension' => [[]], + 'expires' => [[]], + 'cacheControl' => [[]], + 'ssl' => [[]], + 'metadata' => [[]], + 'eTag' => [[]], + 'filePath' => [[]], + 'filePathClean' => [[]], + 'orderDir' => [[]], + 'orderBy' => [[]], + 'orderManual' => [[]], + 'maxCount' => [[]], + 'modular' => [[]], + 'modularTwig' => [[]], + //'children' => [[]], + 'isFirst' => [[]], + 'isLast' => [[]], + 'prevSibling' => [[]], + 'nextSibling' => [[]], + 'adjacentSibling' => [[]], + 'ancestor' => [[]], + //'inherited' => [[]], + //'inheritedField' => [[]], + 'find' => [['/']], + //'collection' => [[]], + //'evaluate' => [[]], + 'folderExists' => [[]], + //'getOriginal' => [[]], + //'getAction' => [[]], + ]; + + /** @var Grav */ + protected $grav; + + /** + * @return void + */ + protected function configure(): void + { + $this + ->setName('page-system-validator') + ->setDescription('Page validator can be used to compare site before/after update and when migrating to Flex Pages.') + ->addOption('record', 'r', InputOption::VALUE_NONE, 'Record results') + ->addOption('check', 'c', InputOption::VALUE_NONE, 'Compare site against previously recorded results') + ->setHelp('The page-system-validator command can be used to test the pages before and after upgrade'); + } + + /** + * @return int + */ + protected function serve(): int + { + $input = $this->getInput(); + $io = $this->getIO(); + + $this->setLanguage('en'); + $this->initializePages(); + + $io->newLine(); + + $this->grav = $grav = Grav::instance(); + + $grav->fireEvent('onPageInitialized', new Event(['page' => $grav['page']])); + + /** @var Config $config */ + $config = $grav['config']; + + if ($input->getOption('record')) { + $io->writeln('Pages: ' . $config->get('system.pages.type', 'page')); + + $io->writeln('Record tests'); + $io->newLine(); + + $results = $this->record(); + $file = $this->getFile('pages-old'); + $file->save($results); + + $io->writeln('Recorded tests to ' . $file->filename()); + } elseif ($input->getOption('check')) { + $io->writeln('Pages: ' . $config->get('system.pages.type', 'page')); + + $io->writeln('Run tests'); + $io->newLine(); + + $new = $this->record(); + $file = $this->getFile('pages-new'); + $file->save($new); + $io->writeln('Recorded tests to ' . $file->filename()); + + $file = $this->getFile('pages-old'); + $old = $file->content(); + + $results = $this->check($old, $new); + $file = $this->getFile('diff'); + $file->save($results); + $io->writeln('Recorded results to ' . $file->filename()); + } else { + $io->writeln('page-system-validator [-r|--record] [-c|--check]'); + } + $io->newLine(); + + return 0; + } + + /** + * @return array + */ + private function record(): array + { + $io = $this->getIO(); + + /** @var Pages $pages */ + $pages = $this->grav['pages']; + $all = $pages->all(); + + $results = []; + $results[''] = $this->recordRow($pages->root()); + foreach ($all as $path => $page) { + if (null === $page) { + $io->writeln('Error on page ' . $path . ''); + continue; + } + + $results[$page->rawRoute()] = $this->recordRow($page); + } + + return json_decode(json_encode($results), true); + } + + /** + * @param PageInterface $page + * @return array + */ + private function recordRow(PageInterface $page): array + { + $results = []; + + foreach ($this->tests as $method => $params) { + $params = $params ?: [[]]; + foreach ($params as $p) { + $result = $page->$method(...$p); + if (in_array($method, ['summary', 'content', 'getRawContent'], true)) { + $result = preg_replace('/name="(form-nonce|__unique_form_id__)" value="[^"]+"/', + 'name="\\1" value="DYNAMIC"', $result); + $result = preg_replace('`src=("|\'|")/images/./././././[^"]+\\1`', + 'src="\\1images/GENERATED\\1', $result); + $result = preg_replace('/\?\d{10}/', '?1234567890', $result); + } elseif ($method === 'httpHeaders' && isset($result['Expires'])) { + $result['Expires'] = 'Thu, 19 Sep 2019 13:10:24 GMT (REPLACED AS DYNAMIC)'; + } elseif ($result instanceof PageInterface) { + $result = $result->rawRoute(); + } elseif (is_object($result)) { + $result = json_decode(json_encode($result), true); + } + + $ps = []; + foreach ($p as $val) { + $ps[] = (string)var_export($val, true); + } + $pstr = implode(', ', $ps); + $call = "->{$method}({$pstr})"; + $results[$call] = $result; + } + } + + return $results; + } + + /** + * @param array $old + * @param array $new + * @return array + */ + private function check(array $old, array $new): array + { + $errors = []; + foreach ($old as $path => $page) { + if (!isset($new[$path])) { + $errors[$path] = 'PAGE REMOVED'; + continue; + } + foreach ($page as $method => $test) { + if (($new[$path][$method] ?? null) !== $test) { + $errors[$path][$method] = ['old' => $test, 'new' => $new[$path][$method]]; + } + } + } + + return $errors; + } + + /** + * @param string $name + * @return CompiledYamlFile + */ + private function getFile(string $name): CompiledYamlFile + { + return CompiledYamlFile::instance('cache://tests/' . $name . '.yaml'); + } +} diff --git a/system/src/Grav/Console/Cli/SandboxCommand.php b/system/src/Grav/Console/Cli/SandboxCommand.php new file mode 100644 index 0000000..4e2cadd --- /dev/null +++ b/system/src/Grav/Console/Cli/SandboxCommand.php @@ -0,0 +1,347 @@ + '/.gitignore', + '/.editorconfig' => '/.editorconfig', + '/CHANGELOG.md' => '/CHANGELOG.md', + '/LICENSE.txt' => '/LICENSE.txt', + '/README.md' => '/README.md', + '/CONTRIBUTING.md' => '/CONTRIBUTING.md', + '/index.php' => '/index.php', + '/composer.json' => '/composer.json', + '/bin' => '/bin', + '/system' => '/system', + '/vendor' => '/vendor', + '/webserver-configs' => '/webserver-configs', + ]; + + /** @var string */ + protected $source; + /** @var string */ + protected $destination; + + /** + * @return void + */ + protected function configure(): void + { + $this + ->setName('sandbox') + ->setDescription('Setup of a base Grav system in your webroot, good for development, playing around or starting fresh') + ->addArgument( + 'destination', + InputArgument::REQUIRED, + 'The destination directory to symlink into' + ) + ->addOption( + 'symlink', + 's', + InputOption::VALUE_NONE, + 'Symlink the base grav system' + ) + ->setHelp("The sandbox command help create a development environment that can optionally use symbolic links to link the core of grav to the git cloned repository.\nGood for development, playing around or starting fresh"); + + $source = getcwd(); + if ($source === false) { + throw new RuntimeException('Internal Error'); + } + $this->source = $source; + } + + /** + * @return int + */ + protected function serve(): int + { + $input = $this->getInput(); + + $this->destination = $input->getArgument('destination'); + + // Create Some core stuff if it doesn't exist + $error = $this->createDirectories(); + if ($error) { + return $error; + } + + // Copy files or create symlinks + $error = $input->getOption('symlink') ? $this->symlink() : $this->copy(); + if ($error) { + return $error; + } + + $error = $this->pages(); + if ($error) { + return $error; + } + + $error = $this->initFiles(); + if ($error) { + return $error; + } + + $error = $this->perms(); + if ($error) { + return $error; + } + + return 0; + } + + /** + * @return int + */ + private function createDirectories(): int + { + $io = $this->getIO(); + + $io->newLine(); + $io->writeln('Creating Directories'); + $dirs_created = false; + + if (!file_exists($this->destination)) { + Folder::create($this->destination); + } + + foreach ($this->directories as $dir) { + if (!file_exists($this->destination . $dir)) { + $dirs_created = true; + $io->writeln(' ' . $dir . ''); + Folder::create($this->destination . $dir); + } + } + + if (!$dirs_created) { + $io->writeln(' Directories already exist'); + } + + return 0; + } + + /** + * @return int + */ + private function copy(): int + { + $io = $this->getIO(); + + $io->newLine(); + $io->writeln('Copying Files'); + + + foreach ($this->mappings as $source => $target) { + if ((string)(int)$source === (string)$source) { + $source = $target; + } + + $from = $this->source . $source; + $to = $this->destination . $target; + + $io->writeln(' ' . $source . ' -> ' . $to); + @Folder::rcopy($from, $to); + } + + return 0; + } + + /** + * @return int + */ + private function symlink(): int + { + $io = $this->getIO(); + + $io->newLine(); + $io->writeln('Resetting Symbolic Links'); + + // Symlink also tests if using git. + if (is_dir($this->source . '/tests')) { + $this->mappings['/tests'] = '/tests'; + } + + foreach ($this->mappings as $source => $target) { + if ((string)(int)$source === (string)$source) { + $source = $target; + } + + $from = $this->source . $source; + $to = $this->destination . $target; + + $io->writeln(' ' . $source . ' -> ' . $to); + + if (is_dir($to)) { + @Folder::delete($to); + } else { + @unlink($to); + } + symlink($from, $to); + } + + return 0; + } + + /** + * @return int + */ + private function pages(): int + { + $io = $this->getIO(); + + $io->newLine(); + $io->writeln('Pages Initializing'); + + // get pages files and initialize if no pages exist + $pages_dir = $this->destination . '/user/pages'; + $pages_files = array_diff(scandir($pages_dir), ['..', '.']); + + if (count($pages_files) === 0) { + $destination = $this->source . '/user/pages'; + Folder::rcopy($destination, $pages_dir); + $io->writeln(' ' . $destination . ' -> Created'); + } + + return 0; + } + + /** + * @return int + */ + private function initFiles(): int + { + if (!$this->check()) { + return 1; + } + + $io = $this->getIO(); + $io->newLine(); + $io->writeln('File Initializing'); + $files_init = false; + + // Copy files if they do not exist + foreach ($this->files as $source => $target) { + if ((string)(int)$source === (string)$source) { + $source = $target; + } + + $from = $this->source . $source; + $to = $this->destination . $target; + + if (!file_exists($to)) { + $files_init = true; + copy($from, $to); + $io->writeln(' ' . $target . ' -> Created'); + } + } + + if (!$files_init) { + $io->writeln(' Files already exist'); + } + + return 0; + } + + /** + * @return int + */ + private function perms(): int + { + $io = $this->getIO(); + $io->newLine(); + $io->writeln('Permissions Initializing'); + + $dir_perms = 0755; + + $binaries = glob($this->destination . DS . 'bin' . DS . '*'); + + foreach ($binaries as $bin) { + chmod($bin, $dir_perms); + $io->writeln(' bin/' . Utils::basename($bin) . ' permissions reset to ' . decoct($dir_perms)); + } + + $io->newLine(); + + return 0; + } + + /** + * @return bool + */ + private function check(): bool + { + $success = true; + $io = $this->getIO(); + + if (!file_exists($this->destination)) { + $io->writeln(' file: ' . $this->destination . ' does not exist!'); + $success = false; + } + + foreach ($this->directories as $dir) { + if (!file_exists($this->destination . $dir)) { + $io->writeln(' directory: ' . $dir . ' does not exist!'); + $success = false; + } + } + + foreach ($this->mappings as $target => $link) { + if (!file_exists($this->destination . $target)) { + $io->writeln(' mappings: ' . $target . ' does not exist!'); + $success = false; + } + } + + if (!$success) { + $io->newLine(); + $io->writeln('install should be run with --symlink|--s to symlink first'); + } + + return $success; + } +} diff --git a/system/src/Grav/Console/Cli/SchedulerCommand.php b/system/src/Grav/Console/Cli/SchedulerCommand.php new file mode 100644 index 0000000..fb30244 --- /dev/null +++ b/system/src/Grav/Console/Cli/SchedulerCommand.php @@ -0,0 +1,223 @@ +setName('scheduler') + ->addOption( + 'install', + 'i', + InputOption::VALUE_NONE, + 'Show Install Command' + ) + ->addOption( + 'jobs', + 'j', + InputOption::VALUE_NONE, + 'Show Jobs Summary' + ) + ->addOption( + 'details', + 'd', + InputOption::VALUE_NONE, + 'Show Job Details' + ) + ->addOption( + 'run', + 'r', + InputOption::VALUE_OPTIONAL, + 'Force run all jobs or a specific job if you specify a specific Job ID', + false + ) + ->setDescription('Run the Grav Scheduler. Best when integrated with system cron') + ->setHelp("Running without any options will force the Scheduler to run through it's jobs and process them"); + } + + /** + * @return int + */ + protected function serve(): int + { + $this->initializePlugins(); + + $grav = Grav::instance(); + $grav['backups']->init(); + $this->initializePages(); + $this->initializeThemes(); + + /** @var Scheduler $scheduler */ + $scheduler = $grav['scheduler']; + $grav->fireEvent('onSchedulerInitialized', new Event(['scheduler' => $scheduler])); + + $input = $this->getInput(); + $io = $this->getIO(); + $error = 0; + + $run = $input->getOption('run'); + + if ($input->getOption('jobs')) { + // Show jobs list + + $jobs = $scheduler->getAllJobs(); + $job_states = (array)$scheduler->getJobStates()->content(); + $rows = []; + + $table = new Table($io); + $table->setStyle('box'); + $headers = ['Job ID', 'Command', 'Run At', 'Status', 'Last Run', 'State']; + + $io->title('Scheduler Jobs Listing'); + + foreach ($jobs as $job) { + $job_status = ucfirst($job_states[$job->getId()]['state'] ?? 'ready'); + $last_run = $job_states[$job->getId()]['last-run'] ?? 0; + $status = $job_status === 'Failure' ? "{$job_status}" : "{$job_status}"; + $state = $job->getEnabled() ? 'Enabled' : 'Disabled'; + $row = [ + $job->getId(), + "{$job->getCommand()}", + "{$job->getAt()}", + $status, + '' . ($last_run === 0 ? 'Never' : date('Y-m-d H:i', $last_run)) . '', + $state, + + ]; + $rows[] = $row; + } + + if (!empty($rows)) { + $table->setHeaders($headers); + $table->setRows($rows); + $table->render(); + } else { + $io->text('no jobs found...'); + } + + $io->newLine(); + $io->note('For error details run "bin/grav scheduler -d"'); + $io->newLine(); + } elseif ($input->getOption('details')) { + $jobs = $scheduler->getAllJobs(); + $job_states = (array)$scheduler->getJobStates()->content(); + + $io->title('Job Details'); + + $table = new Table($io); + $table->setStyle('box'); + $table->setHeaders(['Job ID', 'Last Run', 'Next Run', 'Errors']); + $rows = []; + + foreach ($jobs as $job) { + $job_state = $job_states[$job->getId()]; + $error = isset($job_state['error']) ? trim($job_state['error']) : false; + + /** @var CronExpression $expression */ + $expression = $job->getCronExpression(); + $next_run = $expression->getNextRunDate(); + + $row = []; + $row[] = $job->getId(); + if (!is_null($job_state['last-run'])) { + $row[] = '' . date('Y-m-d H:i', $job_state['last-run']) . ''; + } else { + $row[] = 'Never'; + } + $row[] = '' . $next_run->format('Y-m-d H:i') . ''; + + if ($error) { + $row[] = "{$error}"; + } else { + $row[] = 'None'; + } + $rows[] = $row; + } + + $table->setRows($rows); + $table->render(); + } elseif ($run !== false && $run !== null) { + $io->title('Force Run Job: ' . $run); + + $job = $scheduler->getJob($run); + + if ($job) { + $job->inForeground()->run(); + + if ($job->isSuccessful()) { + $io->success('Job ran successfully...'); + } else { + $error = 1; + $io->error('Job failed to run successfully...'); + } + + $output = $job->getOutput(); + + if ($output) { + $io->write($output); + } + } else { + $error = 1; + $io->error('Could not find a job with id: ' . $run); + } + } elseif ($input->getOption('install')) { + $io->title('Install Scheduler'); + + $verb = 'install'; + + if ($scheduler->isCrontabSetup()) { + $io->success('All Ready! You have already set up Grav\'s Scheduler in your crontab. You can validate this by running "crontab -l" to list your current crontab entries.'); + $verb = 'reinstall'; + } else { + $user = $scheduler->whoami(); + $error = 1; + $io->error('Can\'t find a crontab for ' . $user . '. You need to set up Grav\'s Scheduler in your crontab'); + } + if (!Utils::isWindows()) { + $io->note("To $verb, run the following command from your terminal:"); + $io->newLine(); + $io->text(trim($scheduler->getCronCommand())); + } else { + $io->note("To $verb, create a scheduled task in Windows."); + $io->text('Learn more at https://learn.getgrav.org/advanced/scheduler'); + } + } else { + // Run scheduler + $force = $run === null; + $scheduler->run(null, $force); + + if ($input->getOption('verbose')) { + $io->title('Running Scheduled Jobs'); + $io->text($scheduler->getVerboseOutput()); + } + } + + return $error; + } +} diff --git a/system/src/Grav/Console/Cli/SecurityCommand.php b/system/src/Grav/Console/Cli/SecurityCommand.php new file mode 100644 index 0000000..d75a4a6 --- /dev/null +++ b/system/src/Grav/Console/Cli/SecurityCommand.php @@ -0,0 +1,102 @@ +setName('security') + ->setDescription('Capable of running various Security checks') + ->setHelp('The security runs various security checks on your Grav site'); + } + + /** + * @return int + */ + protected function serve(): int + { + $this->initializePages(); + + $io = $this->getIO(); + + /** @var Grav $grav */ + $grav = Grav::instance(); + $this->progress = new ProgressBar($this->output, count($grav['pages']->routes()) - 1); + $this->progress->setFormat('Scanning %current% pages [%bar%] %percent:3s%% %elapsed:6s%'); + $this->progress->setBarWidth(100); + + $io->title('Grav Security Check'); + $io->newline(2); + + $output = Security::detectXssFromPages($grav['pages'], false, [$this, 'outputProgress']); + + $error = 0; + if (!empty($output)) { + $counter = 1; + foreach ($output as $route => $results) { + $results_parts = array_map(static function ($value, $key) { + return $key.': \''.$value . '\''; + }, array_values($results), array_keys($results)); + + $io->writeln($counter++ .' - ' . $route . ' → ' . implode(', ', $results_parts) . ''); + } + + $error = 1; + $io->error('Security Scan complete: ' . count($output) . ' potential XSS issues found...'); + } else { + $io->success('Security Scan complete: No issues found...'); + } + + $io->newline(1); + + return $error; + } + + /** + * @param array $args + * @return void + */ + public function outputProgress(array $args): void + { + switch ($args['type']) { + case 'count': + $steps = $args['steps']; + $freq = (int)($steps > 100 ? round($steps / 100) : $steps); + $this->progress->setMaxSteps($steps); + $this->progress->setRedrawFrequency($freq); + break; + case 'progress': + if (isset($args['complete']) && $args['complete']) { + $this->progress->finish(); + } else { + $this->progress->advance(); + } + break; + } + } +} diff --git a/system/src/Grav/Console/Cli/ServerCommand.php b/system/src/Grav/Console/Cli/ServerCommand.php new file mode 100644 index 0000000..7b50082 --- /dev/null +++ b/system/src/Grav/Console/Cli/ServerCommand.php @@ -0,0 +1,154 @@ +setName('server') + ->addOption('port', 'p', InputOption::VALUE_OPTIONAL, 'Preferred HTTP port rather than auto-find (default is 8000-9000') + ->addOption('symfony', null, InputOption::VALUE_NONE, 'Force using Symfony server') + ->addOption('php', null, InputOption::VALUE_NONE, 'Force using built-in PHP server') + ->setDescription("Runs built-in web-server, Symfony first, then tries PHP's") + ->setHelp("Runs built-in web-server, Symfony first, then tries PHP's"); + } + + /** + * @return int + */ + protected function serve(): int + { + $input = $this->getInput(); + $io = $this->getIO(); + + $io->title('Grav Web Server'); + + // Ensure CLI colors are on + ini_set('cli_server.color', 'on'); + + // Options + $force_symfony = $input->getOption('symfony'); + $force_php = $input->getOption('php'); + + // Find PHP + $executableFinder = new PhpExecutableFinder(); + $php = $executableFinder->find(false); + + $this->ip = '127.0.0.1'; + $this->port = (int)($input->getOption('port') ?? 8000); + + // Get an open port + while (!$this->portAvailable($this->ip, $this->port)) { + $this->port++; + } + + // Setup the commands + $symfony_cmd = ['symfony', 'server:start', '--ansi', '--port=' . $this->port]; + $php_cmd = [$php, '-S', $this->ip.':'.$this->port, 'system/router.php']; + + $commands = [ + self::SYMFONY_SERVER => $symfony_cmd, + self::PHP_SERVER => $php_cmd + ]; + + if ($force_symfony) { + unset($commands[self::PHP_SERVER]); + } elseif ($force_php) { + unset($commands[self::SYMFONY_SERVER]); + } + + $error = 0; + foreach ($commands as $name => $command) { + $process = $this->runProcess($name, $command); + if (!$process) { + $io->note('Starting ' . $name . '...'); + } + + // Should only get here if there's an error running + if (!$process->isRunning() && (($name === self::SYMFONY_SERVER && $force_symfony) || ($name === self::PHP_SERVER))) { + $error = 1; + $io->error('Could not start ' . $name); + } + } + + return $error; + } + + /** + * @param string $name + * @param array $cmd + * @return Process + */ + protected function runProcess(string $name, array $cmd): Process + { + $io = $this->getIO(); + + $process = new Process($cmd); + $process->setTimeout(0); + $process->start(); + + if ($name === self::SYMFONY_SERVER && Utils::contains($process->getErrorOutput(), 'symfony: not found')) { + $io->error('The symfony binary could not be found, please install the CLI tools: https://symfony.com/download'); + $io->warning('Falling back to PHP web server...'); + } + + if ($name === self::PHP_SERVER) { + $io->success('Built-in PHP web server listening on http://' . $this->ip . ':' . $this->port . ' (PHP v' . PHP_VERSION . ')'); + } + + $process->wait(function ($type, $buffer) { + $this->getIO()->write($buffer); + }); + + return $process; + } + + /** + * Simple function test the port + * + * @param string $ip + * @param int $port + * @return bool + */ + protected function portAvailable(string $ip, int $port): bool + { + $fp = @fsockopen($ip, $port, $errno, $errstr, 0.1); + if (!$fp) { + return true; + } + + fclose($fp); + + return false; + } +} diff --git a/system/src/Grav/Console/Cli/YamlLinterCommand.php b/system/src/Grav/Console/Cli/YamlLinterCommand.php new file mode 100644 index 0000000..76a5a75 --- /dev/null +++ b/system/src/Grav/Console/Cli/YamlLinterCommand.php @@ -0,0 +1,124 @@ +setName('yamllinter') + ->addOption( + 'all', + 'a', + InputOption::VALUE_NONE, + 'Go through the whole Grav installation' + ) + ->addOption( + 'folder', + 'f', + InputOption::VALUE_OPTIONAL, + 'Go through specific folder' + ) + ->setDescription('Checks various files for YAML errors') + ->setHelp('Checks various files for YAML errors'); + } + + /** + * @return int + */ + protected function serve(): int + { + $input = $this->getInput(); + $io = $this->getIO(); + + $io->title('Yaml Linter'); + + $error = 0; + if ($input->getOption('all')) { + $io->section('All'); + $errors = YamlLinter::lint(''); + + if (empty($errors)) { + $io->success('No YAML Linting issues found'); + } else { + $error = 1; + $this->displayErrors($errors, $io); + } + } elseif ($folder = $input->getOption('folder')) { + $io->section($folder); + $errors = YamlLinter::lint($folder); + + if (empty($errors)) { + $io->success('No YAML Linting issues found'); + } else { + $error = 1; + $this->displayErrors($errors, $io); + } + } else { + $io->section('User Configuration'); + $errors = YamlLinter::lintConfig(); + + if (empty($errors)) { + $io->success('No YAML Linting issues with configuration'); + } else { + $error = 1; + $this->displayErrors($errors, $io); + } + + $io->section('Pages Frontmatter'); + $errors = YamlLinter::lintPages(); + + if (empty($errors)) { + $io->success('No YAML Linting issues with pages'); + } else { + $error = 1; + $this->displayErrors($errors, $io); + } + + $io->section('Page Blueprints'); + $errors = YamlLinter::lintBlueprints(); + + if (empty($errors)) { + $io->success('No YAML Linting issues with blueprints'); + } else { + $error = 1; + $this->displayErrors($errors, $io); + } + } + + return $error; + } + + /** + * @param array $errors + * @param SymfonyStyle $io + * @return void + */ + protected function displayErrors(array $errors, SymfonyStyle $io): void + { + $io->error('YAML Linting issues found...'); + foreach ($errors as $path => $error) { + $io->writeln("{$path} - {$error}"); + } + } +} diff --git a/system/src/Grav/Console/ConsoleCommand.php b/system/src/Grav/Console/ConsoleCommand.php new file mode 100644 index 0000000..d7cff9f --- /dev/null +++ b/system/src/Grav/Console/ConsoleCommand.php @@ -0,0 +1,46 @@ +setupConsole($input, $output); + + return $this->serve(); + } + + /** + * Override with your implementation. + * + * @return int + */ + protected function serve() + { + // Return error. + return 1; + } +} diff --git a/system/src/Grav/Console/ConsoleTrait.php b/system/src/Grav/Console/ConsoleTrait.php new file mode 100644 index 0000000..2f8848f --- /dev/null +++ b/system/src/Grav/Console/ConsoleTrait.php @@ -0,0 +1,338 @@ +argv = $_SERVER['argv'][0]; + $this->input = $input; + $this->output = new SymfonyStyle($input, $output); + + $this->setupGrav(); + } + + public function getInput(): InputInterface + { + return $this->input; + } + + /** + * @return SymfonyStyle + */ + public function getIO(): SymfonyStyle + { + return $this->output; + } + + /** + * Adds an option. + * + * @param string $name The option name + * @param string|array|null $shortcut The shortcuts, can be null, a string of shortcuts delimited by | or an array of shortcuts + * @param int|null $mode The option mode: One of the InputOption::VALUE_* constants + * @param string $description A description text + * @param string|string[]|int|bool|null $default The default value (must be null for InputOption::VALUE_NONE) + * @return $this + * @throws InvalidArgumentException If option mode is invalid or incompatible + */ + public function addOption($name, $shortcut = null, $mode = null, $description = '', $default = null) + { + if ($name !== 'env' && $name !== 'lang') { + parent::addOption($name, $shortcut, $mode, $description, $default); + } + + return $this; + } + + /** + * @return void + */ + final protected function setupGrav(): void + { + try { + $language = $this->input->getOption('lang'); + if ($language) { + // Set used language. + $this->setLanguage($language); + } + } catch (InvalidArgumentException $e) {} + + // Initialize cache with CLI compatibility + $grav = Grav::instance(); + $grav['config']->set('system.cache.cli_compatibility', true); + } + + /** + * Initialize Grav. + * + * - Load configuration + * - Initialize logger + * - Disable debugger + * - Set timezone, locale + * - Load plugins (call PluginsLoadedEvent) + * - Set Pages and Users type to be used in the site + * + * Safe to be called multiple times. + * + * @return $this + */ + final protected function initializeGrav() + { + InitializeProcessor::initializeCli(Grav::instance()); + + return $this; + } + + /** + * Set language to be used in CLI. + * + * @param string|null $code + * @return $this + */ + final protected function setLanguage(string $code = null) + { + $this->initializeGrav(); + + $grav = Grav::instance(); + /** @var Language $language */ + $language = $grav['language']; + if ($language->enabled()) { + if ($code && $language->validate($code)) { + $language->setActive($code); + } else { + $language->setActive($language->getDefault()); + } + } + + return $this; + } + + /** + * Properly initialize plugins. + * + * - call $this->initializeGrav() + * - call onPluginsInitialized event + * + * Safe to be called multiple times. + * + * @return $this + */ + final protected function initializePlugins() + { + if (!$this->plugins_initialized) { + $this->plugins_initialized = true; + + $this->initializeGrav(); + + // Initialize plugins. + $grav = Grav::instance(); + $grav['plugins']->init(); + $grav->fireEvent('onPluginsInitialized'); + } + + return $this; + } + + /** + * Properly initialize themes. + * + * - call $this->initializePlugins() + * - initialize theme (call onThemeInitialized event) + * + * Safe to be called multiple times. + * + * @return $this + */ + final protected function initializeThemes() + { + if (!$this->themes_initialized) { + $this->themes_initialized = true; + + $this->initializePlugins(); + + // Initialize themes. + $grav = Grav::instance(); + $grav['themes']->init(); + } + + return $this; + } + + /** + * Properly initialize pages. + * + * - call $this->initializeThemes() + * - initialize assets (call onAssetsInitialized event) + * - initialize twig (calls the twig events) + * - initialize pages (calls onPagesInitialized event) + * + * Safe to be called multiple times. + * + * @return $this + */ + final protected function initializePages() + { + if (!$this->pages_initialized) { + $this->pages_initialized = true; + + $this->initializeThemes(); + + $grav = Grav::instance(); + + // Initialize assets. + $grav['assets']->init(); + $grav->fireEvent('onAssetsInitialized'); + + // Initialize twig. + $grav['twig']->init(); + + // Initialize pages. + $pages = $grav['pages']; + $pages->init(); + $grav->fireEvent('onPagesInitialized', new Event(['pages' => $pages])); + } + + return $this; + } + + /** + * @param string $path + * @return void + */ + public function isGravInstance($path) + { + $io = $this->getIO(); + + if (!file_exists($path)) { + $io->writeln(''); + $io->writeln("ERROR: Destination doesn't exist:"); + $io->writeln(" $path"); + $io->writeln(''); + exit; + } + + if (!is_dir($path)) { + $io->writeln(''); + $io->writeln("ERROR: Destination chosen to install is not a directory:"); + $io->writeln(" $path"); + $io->writeln(''); + exit; + } + + if (!file_exists($path . DS . 'index.php') || !file_exists($path . DS . '.dependencies') || !file_exists($path . DS . 'system' . DS . 'config' . DS . 'system.yaml')) { + $io->writeln(''); + $io->writeln('ERROR: Destination chosen to install does not appear to be a Grav instance:'); + $io->writeln(" $path"); + $io->writeln(''); + exit; + } + } + + /** + * @param string $path + * @param string $action + * @return string|false + */ + public function composerUpdate($path, $action = 'install') + { + $composer = Composer::getComposerExecutor(); + + return system($composer . ' --working-dir=' . escapeshellarg($path) . ' --no-interaction --no-dev --prefer-dist -o '. $action); + } + + /** + * @param array $all + * @return int + * @throws Exception + */ + public function clearCache($all = []) + { + if ($all) { + $all = ['--all' => true]; + } + + $command = new ClearCacheCommand(); + $input = new ArrayInput($all); + return $command->run($input, $this->output); + } + + /** + * @return void + */ + public function invalidateCache() + { + Cache::invalidateCache(); + } + + /** + * Load the local config file + * + * @return string|false The local config file name. false if local config does not exist + */ + public function loadLocalConfig() + { + $home_folder = getenv('HOME') ?: getenv('HOMEDRIVE') . getenv('HOMEPATH'); + $local_config_file = $home_folder . '/.grav/config'; + + if (file_exists($local_config_file)) { + $file = YamlFile::instance($local_config_file); + $this->local_config = $file->content(); + $file->free(); + + return $local_config_file; + } + + return false; + } +} diff --git a/system/src/Grav/Console/Gpm/DirectInstallCommand.php b/system/src/Grav/Console/Gpm/DirectInstallCommand.php new file mode 100644 index 0000000..272b5f5 --- /dev/null +++ b/system/src/Grav/Console/Gpm/DirectInstallCommand.php @@ -0,0 +1,321 @@ +setName('direct-install') + ->setAliases(['directinstall']) + ->addArgument( + 'package-file', + InputArgument::REQUIRED, + 'Installable package local or remote . Can install specific version' + ) + ->addOption( + 'all-yes', + 'y', + InputOption::VALUE_NONE, + 'Assumes yes (or best approach) instead of prompting' + ) + ->addOption( + 'destination', + 'd', + InputOption::VALUE_OPTIONAL, + 'The destination where the package should be installed at. By default this would be where the grav instance has been launched from', + GRAV_ROOT + ) + ->setDescription('Installs Grav, plugin, or theme directly from a file or a URL') + ->setHelp('The direct-install command installs Grav, plugin, or theme directly from a file or a URL'); + } + + /** + * @return int + */ + protected function serve(): int + { + $input = $this->getInput(); + $io = $this->getIO(); + + if (!class_exists(ZipArchive::class)) { + $io->title('Direct Install'); + $io->error('php-zip extension needs to be enabled!'); + + return 1; + } + + // Making sure the destination is usable + $this->destination = realpath($input->getOption('destination')); + + if (!Installer::isGravInstance($this->destination) || + !Installer::isValidDestination($this->destination, [Installer::EXISTS, Installer::IS_LINK]) + ) { + $io->writeln('ERROR: ' . Installer::lastErrorMsg()); + + return 1; + } + + $this->all_yes = $input->getOption('all-yes'); + + $package_file = $input->getArgument('package-file'); + + $question = new ConfirmationQuestion("Are you sure you want to direct-install {$package_file} [y|N] ", false); + + $answer = $this->all_yes ? true : $io->askQuestion($question); + + if (!$answer) { + $io->writeln('exiting...'); + $io->newLine(); + + return 1; + } + + $tmp_dir = Grav::instance()['locator']->findResource('tmp://', true, true); + $tmp_zip = $tmp_dir . uniqid('/Grav-', false); + + $io->newLine(); + $io->writeln("Preparing to install {$package_file}"); + + $zip = null; + if (Response::isRemote($package_file)) { + $io->write(' |- Downloading package... 0%'); + try { + $zip = GPM::downloadPackage($package_file, $tmp_zip); + } catch (RuntimeException $e) { + $io->newLine(); + $io->writeln(" `- ERROR: {$e->getMessage()}"); + $io->newLine(); + + return 1; + } + + if ($zip) { + $io->write("\x0D"); + $io->write(' |- Downloading package... 100%'); + $io->newLine(); + } + } elseif (is_file($package_file)) { + $io->write(' |- Copying package... 0%'); + $zip = GPM::copyPackage($package_file, $tmp_zip); + if ($zip) { + $io->write("\x0D"); + $io->write(' |- Copying package... 100%'); + $io->newLine(); + } + } + + if ($zip && file_exists($zip)) { + $tmp_source = $tmp_dir . uniqid('/Grav-', false); + + $io->write(' |- Extracting package... '); + $extracted = Installer::unZip($zip, $tmp_source); + + if (!$extracted) { + $io->write("\x0D"); + $io->writeln(' |- Extracting package... failed'); + Folder::delete($tmp_source); + Folder::delete($tmp_zip); + + return 1; + } + + $io->write("\x0D"); + $io->writeln(' |- Extracting package... ok'); + + + $type = GPM::getPackageType($extracted); + + if (!$type) { + $io->writeln(" '- ERROR: Not a valid Grav package"); + $io->newLine(); + Folder::delete($tmp_source); + Folder::delete($tmp_zip); + + return 1; + } + + $blueprint = GPM::getBlueprints($extracted); + if ($blueprint) { + if (isset($blueprint['dependencies'])) { + $dependencies = []; + foreach ($blueprint['dependencies'] as $dependency) { + if (is_array($dependency)) { + if (isset($dependency['name'])) { + $dependencies[] = $dependency['name']; + } + if (isset($dependency['github'])) { + $dependencies[] = $dependency['github']; + } + } else { + $dependencies[] = $dependency; + } + } + $io->writeln(' |- Dependencies found... [' . implode(',', $dependencies) . ']'); + + $question = new ConfirmationQuestion(" | '- Dependencies will not be satisfied. Continue ? [y|N] ", false); + $answer = $this->all_yes ? true : $io->askQuestion($question); + + if (!$answer) { + $io->writeln('exiting...'); + $io->newLine(); + Folder::delete($tmp_source); + Folder::delete($tmp_zip); + + return 1; + } + } + } + + if ($type === 'grav') { + $io->write(' |- Checking destination... '); + Installer::isValidDestination(GRAV_ROOT . '/system'); + if (Installer::IS_LINK === Installer::lastErrorCode()) { + $io->write("\x0D"); + $io->writeln(' |- Checking destination... symbolic link'); + $io->writeln(" '- ERROR: symlinks found... " . GRAV_ROOT . ''); + $io->newLine(); + Folder::delete($tmp_source); + Folder::delete($tmp_zip); + + return 1; + } + + $io->write("\x0D"); + $io->writeln(' |- Checking destination... ok'); + + $io->write(' |- Installing package... '); + + $this->upgradeGrav($zip, $extracted); + } else { + $name = GPM::getPackageName($extracted); + + if (!$name) { + $io->writeln('ERROR: Name could not be determined. Please specify with --name|-n'); + $io->newLine(); + Folder::delete($tmp_source); + Folder::delete($tmp_zip); + + return 1; + } + + $install_path = GPM::getInstallPath($type, $name); + $is_update = file_exists($install_path); + + $io->write(' |- Checking destination... '); + + Installer::isValidDestination(GRAV_ROOT . DS . $install_path); + if (Installer::lastErrorCode() === Installer::IS_LINK) { + $io->write("\x0D"); + $io->writeln(' |- Checking destination... symbolic link'); + $io->writeln(" '- ERROR: symlink found... " . GRAV_ROOT . DS . $install_path . ''); + $io->newLine(); + Folder::delete($tmp_source); + Folder::delete($tmp_zip); + + return 1; + } + + $io->write("\x0D"); + $io->writeln(' |- Checking destination... ok'); + + $io->write(' |- Installing package... '); + + Installer::install( + $zip, + $this->destination, + $options = [ + 'install_path' => $install_path, + 'theme' => (($type === 'theme')), + 'is_update' => $is_update + ], + $extracted + ); + + // clear cache after successful upgrade + $this->clearCache(); + } + + Folder::delete($tmp_source); + + $io->write("\x0D"); + + if (Installer::lastErrorCode()) { + $io->writeln(" '- " . Installer::lastErrorMsg() . ''); + $io->newLine(); + } else { + $io->writeln(' |- Installing package... ok'); + $io->writeln(" '- Success! "); + $io->newLine(); + } + } else { + $io->writeln(" '- ERROR: ZIP package could not be found"); + Folder::delete($tmp_zip); + + return 1; + } + + Folder::delete($tmp_zip); + + return 0; + } + + /** + * @param string $zip + * @param string $folder + * @return void + */ + private function upgradeGrav(string $zip, string $folder): void + { + if (!is_dir($folder)) { + Installer::setError('Invalid source folder'); + } + + try { + $script = $folder . '/system/install.php'; + /** Install $installer */ + if ((file_exists($script) && $install = include $script) && is_callable($install)) { + $install($zip); + } else { + throw new RuntimeException('Uploaded archive file is not a valid Grav update package'); + } + } catch (Exception $e) { + Installer::setError($e->getMessage()); + } + } +} diff --git a/system/src/Grav/Console/Gpm/IndexCommand.php b/system/src/Grav/Console/Gpm/IndexCommand.php new file mode 100644 index 0000000..d9b5448 --- /dev/null +++ b/system/src/Grav/Console/Gpm/IndexCommand.php @@ -0,0 +1,335 @@ +setName('index') + ->addOption( + 'force', + 'f', + InputOption::VALUE_NONE, + 'Force re-fetching the data from remote' + ) + ->addOption( + 'filter', + 'F', + InputOption::VALUE_REQUIRED | InputOption::VALUE_IS_ARRAY, + 'Allows to limit the results based on one or multiple filters input. This can be either portion of a name/slug or a regex' + ) + ->addOption( + 'themes-only', + 'T', + InputOption::VALUE_NONE, + 'Filters the results to only Themes' + ) + ->addOption( + 'plugins-only', + 'P', + InputOption::VALUE_NONE, + 'Filters the results to only Plugins' + ) + ->addOption( + 'updates-only', + 'U', + InputOption::VALUE_NONE, + 'Filters the results to Updatable Themes and Plugins only' + ) + ->addOption( + 'installed-only', + 'I', + InputOption::VALUE_NONE, + 'Filters the results to only the Themes and Plugins you have installed' + ) + ->addOption( + 'sort', + 's', + InputOption::VALUE_REQUIRED, + 'Allows to sort (ASC) the results. SORT can be either "name", "slug", "author", "date"', + 'date' + ) + ->addOption( + 'desc', + 'D', + InputOption::VALUE_NONE, + 'Reverses the order of the output.' + ) + ->addOption( + 'enabled', + 'e', + InputOption::VALUE_NONE, + 'Filters the results to only enabled Themes and Plugins.' + ) + ->addOption( + 'disabled', + 'd', + InputOption::VALUE_NONE, + 'Filters the results to only disabled Themes and Plugins.' + ) + ->setDescription('Lists the plugins and themes available for installation') + ->setHelp('The index command lists the plugins and themes available for installation') + ; + } + + /** + * @return int + */ + protected function serve(): int + { + $input = $this->getInput(); + $this->options = $input->getOptions(); + $this->gpm = new GPM($this->options['force']); + $this->displayGPMRelease(); + $this->data = $this->gpm->getRepository(); + + $data = $this->filter($this->data); + + $io = $this->getIO(); + + if (count($data) === 0) { + $io->writeln('No data was found in the GPM repository stored locally.'); + $io->writeln('Please try clearing cache and running the bin/gpm index -f command again'); + $io->writeln('If this doesn\'t work try tweaking your GPM system settings.'); + $io->newLine(); + $io->writeln('For more help go to:'); + $io->writeln(' -> https://learn.getgrav.org/troubleshooting/common-problems#cannot-connect-to-the-gpm'); + + return 1; + } + + foreach ($data as $type => $packages) { + $io->writeln('' . strtoupper($type) . ' [ ' . count($packages) . ' ]'); + + $packages = $this->sort($packages); + + if (!empty($packages)) { + $io->section('Packages table'); + $table = new Table($io); + $table->setHeaders(['Count', 'Name', 'Slug', 'Version', 'Installed', 'Enabled']); + + $index = 0; + foreach ($packages as $slug => $package) { + $row = [ + 'Count' => $index++ + 1, + 'Name' => '' . Utils::truncate($package->name, 20, false, ' ', '...') . ' ', + 'Slug' => $slug, + 'Version'=> $this->version($package), + 'Installed' => $this->installed($package), + 'Enabled' => $this->enabled($package), + ]; + + $table->addRow($row); + } + + $table->render(); + } + + $io->newLine(); + } + + $io->writeln('You can either get more informations about a package by typing:'); + $io->writeln(" {$this->argv} info "); + $io->newLine(); + $io->writeln('Or you can install a package by typing:'); + $io->writeln(" {$this->argv} install "); + $io->newLine(); + + return 0; + } + + /** + * @param Package $package + * @return string + */ + private function version(Package $package): string + { + $list = $this->gpm->{'getUpdatable' . ucfirst($package->package_type)}(); + $package = $list[$package->slug] ?? $package; + $type = ucfirst(preg_replace('/s$/', '', $package->package_type)); + $updatable = $this->gpm->{'is' . $type . 'Updatable'}($package->slug); + $installed = $this->gpm->{'is' . $type . 'Installed'}($package->slug); + $local = $this->gpm->{'getInstalled' . $type}($package->slug); + + if (!$installed || !$updatable) { + $version = $installed ? $local->version : $package->version; + return "v{$version}"; + } + + return "v{$package->version} -> v{$package->available}"; + } + + /** + * @param Package $package + * @return string + */ + private function installed(Package $package): string + { + $type = ucfirst(preg_replace('/s$/', '', $package->package_type)); + $method = 'is' . $type . 'Installed'; + $installed = $this->gpm->{$method}($package->slug); + + return !$installed ? 'not installed' : 'installed'; + } + + /** + * @param Package $package + * @return string + */ + private function enabled(Package $package): string + { + $type = ucfirst(preg_replace('/s$/', '', $package->package_type)); + $method = 'is' . $type . 'Installed'; + $installed = $this->gpm->{$method}($package->slug); + + $result = ''; + if ($installed) { + $method = 'is' . $type . 'Enabled'; + $enabled = $this->gpm->{$method}($package->slug); + if ($enabled === true) { + $result = 'enabled'; + } elseif ($enabled === false) { + $result = 'disabled'; + } + } + + return $result; + } + + /** + * @param Packages $data + * @return Packages + */ + public function filter(Packages $data): Packages + { + // filtering and sorting + if ($this->options['plugins-only']) { + unset($data['themes']); + } + if ($this->options['themes-only']) { + unset($data['plugins']); + } + + $filter = [ + $this->options['desc'], + $this->options['disabled'], + $this->options['enabled'], + $this->options['filter'], + $this->options['installed-only'], + $this->options['updates-only'], + ]; + + if (count(array_filter($filter))) { + foreach ($data as $type => $packages) { + foreach ($packages as $slug => $package) { + $filter = true; + + // Filtering by string + if ($this->options['filter']) { + $filter = preg_grep('/(' . implode('|', $this->options['filter']) . ')/i', [$slug, $package->name]); + } + + // Filtering updatables only + if ($filter && ($this->options['installed-only'] || $this->options['enabled'] || $this->options['disabled'])) { + $method = ucfirst(preg_replace('/s$/', '', $package->package_type)); + $function = 'is' . $method . 'Installed'; + $filter = $this->gpm->{$function}($package->slug); + } + + // Filtering updatables only + if ($filter && $this->options['updates-only']) { + $method = ucfirst(preg_replace('/s$/', '', $package->package_type)); + $function = 'is' . $method . 'Updatable'; + $filter = $this->gpm->{$function}($package->slug); + } + + // Filtering enabled only + if ($filter && $this->options['enabled']) { + $method = ucfirst(preg_replace('/s$/', '', $package->package_type)); + + // Check if packaged is enabled. + $function = 'is' . $method . 'Enabled'; + $filter = $this->gpm->{$function}($package->slug); + } + + // Filtering disabled only + if ($filter && $this->options['disabled']) { + $method = ucfirst(preg_replace('/s$/', '', $package->package_type)); + + // Check if package is disabled. + $function = 'is' . $method . 'Enabled'; + $enabled_filter = $this->gpm->{$function}($package->slug); + + // Apply filtering results. + if (!( $enabled_filter === false)) { + $filter = false; + } + } + + if (!$filter) { + unset($data[$type][$slug]); + } + } + } + } + + return $data; + } + + /** + * @param AbstractPackageCollection|Plugins|Themes $packages + * @return array + */ + public function sort(AbstractPackageCollection $packages): array + { + $key = $this->options['sort']; + + // Sorting only works once. + return $packages->sort( + function ($a, $b) use ($key) { + switch ($key) { + case 'author': + return strcmp($a->{$key}['name'], $b->{$key}['name']); + default: + return strcmp($a->$key, $b->$key); + } + }, + $this->options['desc'] ? true : false + ); + } +} diff --git a/system/src/Grav/Console/Gpm/InfoCommand.php b/system/src/Grav/Console/Gpm/InfoCommand.php new file mode 100644 index 0000000..d343cfd --- /dev/null +++ b/system/src/Grav/Console/Gpm/InfoCommand.php @@ -0,0 +1,191 @@ +setName('info') + ->addOption( + 'force', + 'f', + InputOption::VALUE_NONE, + 'Force fetching the new data remotely' + ) + ->addOption( + 'all-yes', + 'y', + InputOption::VALUE_NONE, + 'Assumes yes (or best approach) instead of prompting' + ) + ->addArgument( + 'package', + InputArgument::REQUIRED, + 'The package of which more informations are desired. Use the "index" command for a list of packages' + ) + ->setDescription('Shows more informations about a package') + ->setHelp('The info shows more information about a package'); + } + + /** + * @return int + */ + protected function serve(): int + { + $input = $this->getInput(); + $io = $this->getIO(); + + $this->gpm = new GPM($input->getOption('force')); + + $this->all_yes = $input->getOption('all-yes'); + + $this->displayGPMRelease(); + + $foundPackage = $this->gpm->findPackage($input->getArgument('package')); + + if (!$foundPackage) { + $io->writeln("The package '{$input->getArgument('package')}' was not found in the Grav repository."); + $io->newLine(); + $io->writeln('You can list all the available packages by typing:'); + $io->writeln(" {$this->argv} index"); + $io->newLine(); + + return 1; + } + + $io->writeln("Found package '{$input->getArgument('package')}' under the '" . ucfirst($foundPackage->package_type) . "' section"); + $io->newLine(); + $io->writeln("{$foundPackage->name} [{$foundPackage->slug}]"); + $io->writeln(str_repeat('-', strlen($foundPackage->name) + strlen($foundPackage->slug) + 3)); + $io->writeln('' . strip_tags($foundPackage->description_plain) . ''); + $io->newLine(); + + $packageURL = ''; + if (isset($foundPackage->author['url'])) { + $packageURL = '<' . $foundPackage->author['url'] . '>'; + } + + $io->writeln('' . str_pad( + 'Author', + 12 + ) . ': ' . $foundPackage->author['name'] . ' <' . $foundPackage->author['email'] . '> ' . $packageURL); + + foreach ([ + 'version', + 'keywords', + 'date', + 'homepage', + 'demo', + 'docs', + 'guide', + 'repository', + 'bugs', + 'zipball_url', + 'license' + ] as $info) { + if (isset($foundPackage->{$info})) { + $name = ucfirst($info); + $data = $foundPackage->{$info}; + + if ($info === 'zipball_url') { + $name = 'Download'; + } + + if ($info === 'date') { + $name = 'Last Update'; + $data = date('D, j M Y, H:i:s, P ', strtotime($data)); + } + + $name = str_pad($name, 12); + $io->writeln("{$name}: {$data}"); + } + } + + $type = rtrim($foundPackage->package_type, 's'); + $updatable = $this->gpm->{'is' . $type . 'Updatable'}($foundPackage->slug); + $installed = $this->gpm->{'is' . $type . 'Installed'}($foundPackage->slug); + + // display current version if installed and different + if ($installed && $updatable) { + $local = $this->gpm->{'getInstalled'. $type}($foundPackage->slug); + $io->newLine(); + $io->writeln("Currently installed version: {$local->version}"); + $io->newLine(); + } + + // display changelog information + $question = new ConfirmationQuestion( + 'Would you like to read the changelog? [y|N] ', + false + ); + $answer = $this->all_yes ? true : $io->askQuestion($question); + + if ($answer) { + $changelog = $foundPackage->changelog; + + $io->newLine(); + foreach ($changelog as $version => $log) { + $title = $version . ' [' . $log['date'] . ']'; + $content = preg_replace_callback('/\d\.\s\[\]\(#(.*)\)/', static function ($match) { + return "\n" . ucfirst($match[1]) . ':'; + }, $log['content']); + + $io->writeln("{$title}"); + $io->writeln(str_repeat('-', strlen($title))); + $io->writeln($content); + $io->newLine(); + + $question = new ConfirmationQuestion('Press [ENTER] to continue or [q] to quit ', true); + $answer = $this->all_yes ? false : $io->askQuestion($question); + if (!$answer) { + break; + } + $io->newLine(); + } + } + + $io->newLine(); + + if ($installed && $updatable) { + $io->writeln('You can update this package by typing:'); + $io->writeln(" {$this->argv} update {$foundPackage->slug}"); + } else { + $io->writeln('You can install this package by typing:'); + $io->writeln(" {$this->argv} install {$foundPackage->slug}"); + } + + $io->newLine(); + + return 0; + } +} diff --git a/system/src/Grav/Console/Gpm/InstallCommand.php b/system/src/Grav/Console/Gpm/InstallCommand.php new file mode 100644 index 0000000..e3bb901 --- /dev/null +++ b/system/src/Grav/Console/Gpm/InstallCommand.php @@ -0,0 +1,726 @@ +setName('install') + ->addOption( + 'force', + 'f', + InputOption::VALUE_NONE, + 'Force re-fetching the data from remote' + ) + ->addOption( + 'all-yes', + 'y', + InputOption::VALUE_NONE, + 'Assumes yes (or best approach) instead of prompting' + ) + ->addOption( + 'destination', + 'd', + InputOption::VALUE_OPTIONAL, + 'The destination where the package should be installed at. By default this would be where the grav instance has been launched from', + GRAV_ROOT + ) + ->addArgument( + 'package', + InputArgument::IS_ARRAY | InputArgument::REQUIRED, + 'Package(s) to install. Use "bin/gpm index" to list packages. Use "bin/gpm direct-install" to install a specific version' + ) + ->setDescription('Performs the installation of plugins and themes') + ->setHelp('The install command allows to install plugins and themes'); + } + + /** + * Allows to set the GPM object, used for testing the class + * + * @param GPM $gpm + */ + public function setGpm(GPM $gpm): void + { + $this->gpm = $gpm; + } + + /** + * @return int + */ + protected function serve(): int + { + $input = $this->getInput(); + $io = $this->getIO(); + + if (!class_exists(ZipArchive::class)) { + $io->title('GPM Install'); + $io->error('php-zip extension needs to be enabled!'); + + return 1; + } + + $this->gpm = new GPM($input->getOption('force')); + + $this->all_yes = $input->getOption('all-yes'); + + $this->displayGPMRelease(); + + $this->destination = realpath($input->getOption('destination')); + + $packages = array_map('strtolower', $input->getArgument('package')); + $this->data = $this->gpm->findPackages($packages); + $this->loadLocalConfig(); + + if (!Installer::isGravInstance($this->destination) || + !Installer::isValidDestination($this->destination, [Installer::EXISTS, Installer::IS_LINK]) + ) { + $io->writeln('ERROR: ' . Installer::lastErrorMsg()); + + return 1; + } + + $io->newLine(); + + if (!$this->data['total']) { + $io->writeln('Nothing to install.'); + $io->newLine(); + + return 0; + } + + if (count($this->data['not_found'])) { + $io->writeln('These packages were not found on Grav: ' . implode( + ', ', + array_keys($this->data['not_found']) + ) . ''); + } + + unset($this->data['not_found'], $this->data['total']); + + if (null !== $this->local_config) { + // Symlinks available, ask if Grav should use them + $this->use_symlinks = false; + $question = new ConfirmationQuestion('Should Grav use the symlinks if available? [y|N] ', false); + + $answer = $this->all_yes ? false : $io->askQuestion($question); + + if ($answer) { + $this->use_symlinks = true; + } + } + + $io->newLine(); + + try { + $dependencies = $this->gpm->getDependencies($packages); + } catch (Exception $e) { + //Error out if there are incompatible packages requirements and tell which ones, and what to do + //Error out if there is any error in parsing the dependencies and their versions, and tell which one is broken + $io->writeln("{$e->getMessage()}"); + + return 1; + } + + if ($dependencies) { + try { + $this->installDependencies($dependencies, 'install', 'The following dependencies need to be installed...'); + $this->installDependencies($dependencies, 'update', 'The following dependencies need to be updated...'); + $this->installDependencies($dependencies, 'ignore', "The following dependencies can be updated as there is a newer version, but it's not mandatory...", false); + } catch (Exception $e) { + $io->writeln('Installation aborted'); + + return 1; + } + + $io->writeln('Dependencies are OK'); + $io->newLine(); + } + + + //We're done installing dependencies. Install the actual packages + foreach ($this->data as $data) { + foreach ($data as $package_name => $package) { + if (array_key_exists($package_name, $dependencies)) { + $io->writeln("Package {$package_name} already installed as dependency"); + } else { + $is_valid_destination = Installer::isValidDestination($this->destination . DS . $package->install_path); + if ($is_valid_destination || Installer::lastErrorCode() == Installer::NOT_FOUND) { + $this->processPackage($package, false); + } else { + if (Installer::lastErrorCode() == Installer::EXISTS) { + try { + $this->askConfirmationIfMajorVersionUpdated($package); + $this->gpm->checkNoOtherPackageNeedsThisDependencyInALowerVersion($package->slug, $package->available, array_keys($data)); + } catch (Exception $e) { + $io->writeln("{$e->getMessage()}"); + + return 1; + } + + $question = new ConfirmationQuestion("The package {$package_name} is already installed, overwrite? [y|N] ", false); + $answer = $this->all_yes ? true : $io->askQuestion($question); + + if ($answer) { + $is_update = true; + $this->processPackage($package, $is_update); + } else { + $io->writeln("Package {$package_name} not overwritten"); + } + } else { + if (Installer::lastErrorCode() == Installer::IS_LINK) { + $io->writeln("Cannot overwrite existing symlink for {$package_name}"); + $io->newLine(); + } + } + } + } + } + } + + if (count($this->demo_processing) > 0) { + foreach ($this->demo_processing as $package) { + $this->installDemoContent($package); + } + } + + // clear cache after successful upgrade + $this->clearCache(); + + return 0; + } + + /** + * If the package is updated from an older major release, show warning and ask confirmation + * + * @param Package $package + * @return void + */ + public function askConfirmationIfMajorVersionUpdated(Package $package): void + { + $io = $this->getIO(); + $package_name = $package->name; + $new_version = $package->available ?: $this->gpm->getLatestVersionOfPackage($package->slug); + $old_version = $package->version; + + $major_version_changed = explode('.', $new_version)[0] !== explode('.', $old_version)[0]; + + if ($major_version_changed) { + if ($this->all_yes) { + $io->writeln("The package {$package_name} will be updated to a new major version {$new_version}, from {$old_version}"); + return; + } + + $question = new ConfirmationQuestion("The package {$package_name} will be updated to a new major version {$new_version}, from {$old_version}. Be sure to read what changed with the new major release. Continue? [y|N] ", false); + + if (!$io->askQuestion($question)) { + $io->writeln("Package {$package_name} not updated"); + exit; + } + } + } + + /** + * Given a $dependencies list, filters their type according to $type and + * shows $message prior to listing them to the user. Then asks the user a confirmation prior + * to installing them. + * + * @param array $dependencies The dependencies array + * @param string $type The type of dependency to show: install, update, ignore + * @param string $message A message to be shown prior to listing the dependencies + * @param bool $required A flag that determines if the installation is required or optional + * @return void + * @throws Exception + */ + public function installDependencies(array $dependencies, string $type, string $message, bool $required = true): void + { + $io = $this->getIO(); + $packages = array_filter($dependencies, static function ($action) use ($type) { + return $action === $type; + }); + if (count($packages) > 0) { + $io->writeln($message); + + foreach ($packages as $dependencyName => $dependencyVersion) { + $io->writeln(" |- Package {$dependencyName}"); + } + + $io->newLine(); + + if ($type === 'install') { + $questionAction = 'Install'; + } else { + $questionAction = 'Update'; + } + + if (count($packages) === 1) { + $questionArticle = 'this'; + } else { + $questionArticle = 'these'; + } + + if (count($packages) === 1) { + $questionNoun = 'package'; + } else { + $questionNoun = 'packages'; + } + + $question = new ConfirmationQuestion("{$questionAction} {$questionArticle} {$questionNoun}? [Y|n] ", true); + $answer = $this->all_yes ? true : $io->askQuestion($question); + + if ($answer) { + foreach ($packages as $dependencyName => $dependencyVersion) { + $package = $this->gpm->findPackage($dependencyName); + $this->processPackage($package, $type === 'update'); + } + $io->newLine(); + } elseif ($required) { + throw new Exception(); + } + } + } + + /** + * @param Package|null $package + * @param bool $is_update True if the package is an update + * @return void + */ + private function processPackage(?Package $package, bool $is_update = false): void + { + $io = $this->getIO(); + + if (!$package) { + $io->writeln('Package not found on the GPM!'); + $io->newLine(); + return; + } + + $symlink = false; + if ($this->use_symlinks) { + if (!isset($package->version) || $this->getSymlinkSource($package)) { + $symlink = true; + } + } + + $symlink ? $this->processSymlink($package) : $this->processGpm($package, $is_update); + + $this->processDemo($package); + } + + /** + * Add package to the queue to process the demo content, if demo content exists + * + * @param Package $package + * @return void + */ + private function processDemo(Package $package): void + { + $demo_dir = $this->destination . DS . $package->install_path . DS . '_demo'; + if (file_exists($demo_dir)) { + $this->demo_processing[] = $package; + } + } + + /** + * Prompt to install the demo content of a package + * + * @param Package $package + * @return void + */ + private function installDemoContent(Package $package): void + { + $io = $this->getIO(); + $demo_dir = $this->destination . DS . $package->install_path . DS . '_demo'; + + if (file_exists($demo_dir)) { + $dest_dir = $this->destination . DS . 'user'; + $pages_dir = $dest_dir . DS . 'pages'; + + // Demo content exists, prompt to install it. + $io->writeln("Attention: {$package->name} contains demo content"); + + $question = new ConfirmationQuestion('Do you wish to install this demo content? [y|N] ', false); + + $answer = $io->askQuestion($question); + + if (!$answer) { + $io->writeln(" '- Skipped! "); + $io->newLine(); + + return; + } + + // if pages folder exists in demo + if (file_exists($demo_dir . DS . 'pages')) { + $pages_backup = 'pages.' . date('m-d-Y-H-i-s'); + $question = new ConfirmationQuestion('This will backup your current `user/pages` folder to `user/' . $pages_backup . '`, continue? [y|N]', false); + $answer = $this->all_yes ? true : $io->askQuestion($question); + + if (!$answer) { + $io->writeln(" '- Skipped! "); + $io->newLine(); + + return; + } + + // backup current pages folder + if (file_exists($dest_dir)) { + if (rename($pages_dir, $dest_dir . DS . $pages_backup)) { + $io->writeln(' |- Backing up pages... ok'); + } else { + $io->writeln(' |- Backing up pages... failed'); + } + } + } + + // Confirmation received, copy over the data + $io->writeln(' |- Installing demo content... ok '); + Folder::rcopy($demo_dir, $dest_dir); + $io->writeln(" '- Success! "); + $io->newLine(); + } + } + + /** + * @param Package $package + * @return array|false + */ + private function getGitRegexMatches(Package $package) + { + if (isset($package->repository)) { + $repository = $package->repository; + } else { + return false; + } + + preg_match(GIT_REGEX, $repository, $matches); + + return $matches; + } + + /** + * @param Package $package + * @return string|false + */ + private function getSymlinkSource(Package $package) + { + $matches = $this->getGitRegexMatches($package); + + foreach ($this->local_config as $paths) { + if (Utils::endsWith($matches[2], '.git')) { + $repo_dir = preg_replace('/\.git$/', '', $matches[2]); + } else { + $repo_dir = $matches[2]; + } + + $paths = (array) $paths; + foreach ($paths as $repo) { + $path = rtrim($repo, '/') . '/' . $repo_dir; + if (file_exists($path)) { + return $path; + } + } + } + + return false; + } + + /** + * @param Package $package + * @return void + */ + private function processSymlink(Package $package): void + { + $io = $this->getIO(); + + exec('cd ' . escapeshellarg($this->destination)); + + $to = $this->destination . DS . $package->install_path; + $from = $this->getSymlinkSource($package); + + $io->writeln("Preparing to Symlink {$package->name}"); + $io->write(' |- Checking source... '); + + if (file_exists($from)) { + $io->writeln('ok'); + + $io->write(' |- Checking destination... '); + $checks = $this->checkDestination($package); + + if (!$checks) { + $io->writeln(" '- Installation failed or aborted."); + $io->newLine(); + } elseif (file_exists($to)) { + $io->writeln(" '- Symlink cannot overwrite an existing package, please remove first"); + $io->newLine(); + } else { + symlink($from, $to); + + // extra white spaces to clear out the buffer properly + $io->writeln(' |- Symlinking package... ok '); + $io->writeln(" '- Success! "); + $io->newLine(); + } + + return; + } + + $io->writeln('not found!'); + $io->writeln(" '- Installation failed or aborted."); + } + + /** + * @param Package $package + * @param bool $is_update + * @return bool + */ + private function processGpm(Package $package, bool $is_update = false) + { + $io = $this->getIO(); + + $version = $package->available ?? $package->version; + $license = Licenses::get($package->slug); + + $io->writeln("Preparing to install {$package->name} [v{$version}]"); + + $io->write(' |- Downloading package... 0%'); + $this->file = $this->downloadPackage($package, $license); + + if (!$this->file) { + $io->writeln(" '- Installation failed or aborted."); + $io->newLine(); + + return false; + } + + $io->write(' |- Checking destination... '); + $checks = $this->checkDestination($package); + + if (!$checks) { + $io->writeln(" '- Installation failed or aborted."); + $io->newLine(); + } else { + $io->write(' |- Installing package... '); + $installation = $this->installPackage($package, $is_update); + if (!$installation) { + $io->writeln(" '- Installation failed or aborted."); + $io->newLine(); + } else { + $io->writeln(" '- Success! "); + $io->newLine(); + + return true; + } + } + + return false; + } + + /** + * @param Package $package + * @param string|null $license + * @return string|null + */ + private function downloadPackage(Package $package, string $license = null) + { + $io = $this->getIO(); + + $tmp_dir = Grav::instance()['locator']->findResource('tmp://', true, true); + $this->tmp = $tmp_dir . '/Grav-' . uniqid(); + $filename = $package->slug . Utils::basename($package->zipball_url); + $filename = preg_replace('/[\\\\\/:"*?&<>|]+/m', '-', $filename); + $query = ''; + + if (!empty($package->premium)) { + $query = json_encode(array_merge( + $package->premium, + [ + 'slug' => $package->slug, + 'filename' => $package->premium['filename'], + 'license_key' => $license, + 'sid' => md5(GRAV_ROOT) + ] + )); + + $query = '?d=' . base64_encode($query); + } + + try { + $output = Response::get($package->zipball_url . $query, [], [$this, 'progress']); + } catch (Exception $e) { + if (!empty($package->premium) && $e->getCode() === 401) { + $message = 'Unauthorized Premium License Key'; + } else { + $message = $e->getMessage(); + } + + $error = str_replace("\n", "\n | '- ", $message); + $io->write("\x0D"); + // extra white spaces to clear out the buffer properly + $io->writeln(' |- Downloading package... error '); + $io->writeln(" | '- " . $error); + + return null; + } + + Folder::create($this->tmp); + + $io->write("\x0D"); + $io->write(' |- Downloading package... 100%'); + $io->newLine(); + + file_put_contents($this->tmp . DS . $filename, $output); + + return $this->tmp . DS . $filename; + } + + /** + * @param Package $package + * @return bool + */ + private function checkDestination(Package $package): bool + { + $io = $this->getIO(); + + Installer::isValidDestination($this->destination . DS . $package->install_path); + + if (Installer::lastErrorCode() === Installer::IS_LINK) { + $io->write("\x0D"); + $io->writeln(' |- Checking destination... symbolic link'); + + if ($this->all_yes) { + $io->writeln(" | '- Skipped automatically."); + + return false; + } + + $question = new ConfirmationQuestion( + " | '- Destination has been detected as symlink, delete symbolic link first? [y|N] ", + false + ); + $answer = $io->askQuestion($question); + + if (!$answer) { + $io->writeln(" | '- You decided to not delete the symlink automatically."); + + return false; + } + + unlink($this->destination . DS . $package->install_path); + } + + $io->write("\x0D"); + $io->writeln(' |- Checking destination... ok'); + + return true; + } + + /** + * Install a package + * + * @param Package $package + * @param bool $is_update True if it's an update. False if it's an install + * @return bool + */ + private function installPackage(Package $package, bool $is_update = false): bool + { + $io = $this->getIO(); + + $type = $package->package_type; + + Installer::install($this->file, $this->destination, ['install_path' => $package->install_path, 'theme' => $type === 'themes', 'is_update' => $is_update]); + $error_code = Installer::lastErrorCode(); + Folder::delete($this->tmp); + + if ($error_code) { + $io->write("\x0D"); + // extra white spaces to clear out the buffer properly + $io->writeln(' |- Installing package... error '); + $io->writeln(" | '- " . Installer::lastErrorMsg()); + + return false; + } + + $message = Installer::getMessage(); + if ($message) { + $io->write("\x0D"); + // extra white spaces to clear out the buffer properly + $io->writeln(" |- {$message}"); + } + + $io->write("\x0D"); + // extra white spaces to clear out the buffer properly + $io->writeln(' |- Installing package... ok '); + + return true; + } + + /** + * @param array $progress + * @return void + */ + public function progress(array $progress): void + { + $io = $this->getIO(); + + $io->write("\x0D"); + $io->write(' |- Downloading package... ' . str_pad( + $progress['percent'], + 5, + ' ', + STR_PAD_LEFT + ) . '%'); + } +} diff --git a/system/src/Grav/Console/Gpm/SelfupgradeCommand.php b/system/src/Grav/Console/Gpm/SelfupgradeCommand.php new file mode 100644 index 0000000..2b164d0 --- /dev/null +++ b/system/src/Grav/Console/Gpm/SelfupgradeCommand.php @@ -0,0 +1,344 @@ +setName('self-upgrade') + ->setAliases(['selfupgrade', 'selfupdate']) + ->addOption( + 'force', + 'f', + InputOption::VALUE_NONE, + 'Force re-fetching the data from remote' + ) + ->addOption( + 'all-yes', + 'y', + InputOption::VALUE_NONE, + 'Assumes yes (or best approach) instead of prompting' + ) + ->addOption( + 'overwrite', + 'o', + InputOption::VALUE_NONE, + 'Option to overwrite packages if they already exist' + ) + ->addOption( + 'timeout', + 't', + InputOption::VALUE_OPTIONAL, + 'Option to set the timeout in seconds when downloading the update (0 for no timeout)', + 30 + ) + ->setDescription('Detects and performs an update of Grav itself when available') + ->setHelp('The update command updates Grav itself when a new version is available'); + } + + /** + * @return int + */ + protected function serve(): int + { + $input = $this->getInput(); + $io = $this->getIO(); + + if (!class_exists(ZipArchive::class)) { + $io->title('GPM Self Upgrade'); + $io->error('php-zip extension needs to be enabled!'); + + return 1; + } + + $this->upgrader = new Upgrader($input->getOption('force')); + $this->all_yes = $input->getOption('all-yes'); + $this->overwrite = $input->getOption('overwrite'); + $this->timeout = (int) $input->getOption('timeout'); + + $this->displayGPMRelease(); + + $update = $this->upgrader->getAssets()['grav-update']; + + $local = $this->upgrader->getLocalVersion(); + $remote = $this->upgrader->getRemoteVersion(); + $release = strftime('%c', strtotime($this->upgrader->getReleaseDate())); + + if (!$this->upgrader->meetsRequirements()) { + $io->writeln('ATTENTION:'); + $io->writeln(' Grav has increased the minimum PHP requirement.'); + $io->writeln(' You are currently running PHP ' . phpversion() . ', but PHP ' . $this->upgrader->minPHPVersion() . ' is required.'); + $io->writeln(' Additional information: http://getgrav.org/blog/changing-php-requirements'); + $io->newLine(); + $io->writeln('Selfupgrade aborted.'); + $io->newLine(); + + return 1; + } + + if (!$this->overwrite && !$this->upgrader->isUpgradable()) { + $io->writeln("You are already running the latest version of Grav v{$local}"); + $io->writeln("which was released on {$release}"); + + $config = Grav::instance()['config']; + $schema = $config->get('versions.core.grav.schema'); + if ($schema !== GRAV_SCHEMA && version_compare($schema, GRAV_SCHEMA, '<')) { + $io->newLine(); + $io->writeln('However post-install scripts have not been run.'); + if (!$this->all_yes) { + $question = new ConfirmationQuestion( + 'Would you like to run the scripts? [Y|n] ', + true + ); + $answer = $io->askQuestion($question); + } else { + $answer = true; + } + + if ($answer) { + // Finalize installation. + Install::instance()->finalize(); + + $io->write(' |- Running post-install scripts... '); + $io->writeln(" '- Success! "); + $io->newLine(); + } + } + + return 0; + } + + Installer::isValidDestination(GRAV_ROOT . '/system'); + if (Installer::IS_LINK === Installer::lastErrorCode()) { + $io->writeln('ATTENTION: Grav is symlinked, cannot upgrade, aborting...'); + $io->newLine(); + $io->writeln("You are currently running a symbolically linked Grav v{$local}. Latest available is v{$remote}."); + + return 1; + } + + // not used but preloaded just in case! + new ArrayInput([]); + + $io->writeln("Grav v{$remote} is now available [release date: {$release}]."); + $io->writeln('You are currently using v' . GRAV_VERSION . '.'); + + if (!$this->all_yes) { + $question = new ConfirmationQuestion( + 'Would you like to read the changelog before proceeding? [y|N] ', + false + ); + $answer = $io->askQuestion($question); + + if ($answer) { + $changelog = $this->upgrader->getChangelog(GRAV_VERSION); + + $io->newLine(); + foreach ($changelog as $version => $log) { + $title = $version . ' [' . $log['date'] . ']'; + $content = preg_replace_callback('/\d\.\s\[\]\(#(.*)\)/', static function ($match) { + return "\n" . ucfirst($match[1]) . ':'; + }, $log['content']); + + $io->writeln($title); + $io->writeln(str_repeat('-', strlen($title))); + $io->writeln($content); + $io->newLine(); + } + + $question = new ConfirmationQuestion('Press [ENTER] to continue.', true); + $io->askQuestion($question); + } + + $question = new ConfirmationQuestion('Would you like to upgrade now? [y|N] ', false); + $answer = $io->askQuestion($question); + + if (!$answer) { + $io->writeln('Aborting...'); + + return 1; + } + } + + $io->newLine(); + $io->writeln("Preparing to upgrade to v{$remote}.."); + + $io->write(" |- Downloading upgrade [{$this->formatBytes($update['size'])}]... 0%"); + $this->file = $this->download($update); + + $io->write(' |- Installing upgrade... '); + $installation = $this->upgrade(); + + $error = 0; + if (!$installation) { + $io->writeln(" '- Installation failed or aborted."); + $io->newLine(); + $error = 1; + } else { + $io->writeln(" '- Success! "); + $io->newLine(); + } + + if ($this->tmp && is_dir($this->tmp)) { + Folder::delete($this->tmp); + } + + return $error; + } + + /** + * @param array $package + * @return string + */ + private function download(array $package): string + { + $io = $this->getIO(); + + $tmp_dir = Grav::instance()['locator']->findResource('tmp://', true, true); + $this->tmp = $tmp_dir . '/grav-update-' . uniqid('', false); + $options = [ + 'timeout' => $this->timeout, + ]; + + $output = Response::get($package['download'], $options, [$this, 'progress']); + + Folder::create($this->tmp); + + $io->write("\x0D"); + $io->write(" |- Downloading upgrade [{$this->formatBytes($package['size'])}]... 100%"); + $io->newLine(); + + file_put_contents($this->tmp . DS . $package['name'], $output); + + return $this->tmp . DS . $package['name']; + } + + /** + * @return bool + */ + private function upgrade(): bool + { + $io = $this->getIO(); + + $this->upgradeGrav($this->file); + + $errorCode = Installer::lastErrorCode(); + if ($errorCode) { + $io->write("\x0D"); + // extra white spaces to clear out the buffer properly + $io->writeln(' |- Installing upgrade... error '); + $io->writeln(" | '- " . Installer::lastErrorMsg()); + + return false; + } + + $io->write("\x0D"); + // extra white spaces to clear out the buffer properly + $io->writeln(' |- Installing upgrade... ok '); + + return true; + } + + /** + * @param array $progress + * @return void + */ + public function progress(array $progress): void + { + $io = $this->getIO(); + + $io->write("\x0D"); + $io->write(" |- Downloading upgrade [{$this->formatBytes($progress['filesize']) }]... " . str_pad( + $progress['percent'], + 5, + ' ', + STR_PAD_LEFT + ) . '%'); + } + + /** + * @param int|float $size + * @param int $precision + * @return string + */ + public function formatBytes($size, int $precision = 2): string + { + $base = log($size) / log(1024); + $suffixes = array('', 'k', 'M', 'G', 'T'); + + return round(1024 ** ($base - floor($base)), $precision) . $suffixes[(int)floor($base)]; + } + + /** + * @param string $zip + * @return void + */ + private function upgradeGrav(string $zip): void + { + try { + $folder = Installer::unZip($zip, $this->tmp . '/zip'); + if ($folder === false) { + throw new RuntimeException(Installer::lastErrorMsg()); + } + + $script = $folder . '/system/install.php'; + if ((file_exists($script) && $install = include $script) && is_callable($install)) { + $install($zip); + } else { + throw new RuntimeException('Uploaded archive file is not a valid Grav update package'); + } + } catch (Exception $e) { + Installer::setError($e->getMessage()); + } + } +} diff --git a/system/src/Grav/Console/Gpm/UninstallCommand.php b/system/src/Grav/Console/Gpm/UninstallCommand.php new file mode 100644 index 0000000..60d85aa --- /dev/null +++ b/system/src/Grav/Console/Gpm/UninstallCommand.php @@ -0,0 +1,312 @@ +setName('uninstall') + ->addOption( + 'all-yes', + 'y', + InputOption::VALUE_NONE, + 'Assumes yes (or best approach) instead of prompting' + ) + ->addArgument( + 'package', + InputArgument::IS_ARRAY | InputArgument::REQUIRED, + 'The package(s) that are desired to be removed. Use the "index" command for a list of packages' + ) + ->setDescription('Performs the uninstallation of plugins and themes') + ->setHelp('The uninstall command allows to uninstall plugins and themes'); + } + + /** + * @return int + */ + protected function serve(): int + { + $input = $this->getInput(); + $io = $this->getIO(); + + $this->gpm = new GPM(); + + $this->all_yes = $input->getOption('all-yes'); + + $packages = array_map('strtolower', $input->getArgument('package')); + $this->data = ['total' => 0, 'not_found' => []]; + + $total = 0; + foreach ($packages as $package) { + $plugin = $this->gpm->getInstalledPlugin($package); + $theme = $this->gpm->getInstalledTheme($package); + if ($plugin || $theme) { + $this->data[strtolower($package)] = $plugin ?: $theme; + $total++; + } else { + $this->data['not_found'][] = $package; + } + } + $this->data['total'] = $total; + + $io->newLine(); + + if (!$this->data['total']) { + $io->writeln('Nothing to uninstall.'); + $io->newLine(); + + return 0; + } + + if (count($this->data['not_found'])) { + $io->writeln('These packages were not found installed: ' . implode( + ', ', + $this->data['not_found'] + ) . ''); + } + + unset($this->data['not_found'], $this->data['total']); + + // Plugins need to be initialized in order to make clearcache to work. + try { + $this->initializePlugins(); + } catch (Throwable $e) { + $io->writeln("Some plugins failed to initialize: {$e->getMessage()}"); + } + + $error = 0; + foreach ($this->data as $slug => $package) { + $io->writeln("Preparing to uninstall {$package->name} [v{$package->version}]"); + + $io->write(' |- Checking destination... '); + $checks = $this->checkDestination($slug, $package); + + if (!$checks) { + $io->writeln(" '- Installation failed or aborted."); + $io->newLine(); + $error = 1; + } else { + $uninstall = $this->uninstallPackage($slug, $package); + + if (!$uninstall) { + $io->writeln(" '- Uninstallation failed or aborted."); + $error = 1; + } else { + $io->writeln(" '- Success! "); + } + } + } + + // clear cache after successful upgrade + $this->clearCache(); + + return $error; + } + + /** + * @param string $slug + * @param Local\Package|Remote\Package $package + * @param bool $is_dependency + * @return bool + */ + private function uninstallPackage($slug, $package, $is_dependency = false): bool + { + $io = $this->getIO(); + + if (!$slug) { + return false; + } + + //check if there are packages that have this as a dependency. Abort and show list + $dependent_packages = $this->gpm->getPackagesThatDependOnPackage($slug); + if (count($dependent_packages) > ($is_dependency ? 1 : 0)) { + $io->newLine(2); + $io->writeln('Uninstallation failed.'); + $io->newLine(); + if (count($dependent_packages) > ($is_dependency ? 2 : 1)) { + $io->writeln('The installed packages ' . implode(', ', $dependent_packages) . ' depends on this package. Please remove those first.'); + } else { + $io->writeln('The installed package ' . implode(', ', $dependent_packages) . ' depends on this package. Please remove it first.'); + } + + $io->newLine(); + return false; + } + + if (isset($package->dependencies)) { + $dependencies = $package->dependencies; + + if ($is_dependency) { + foreach ($dependencies as $key => $dependency) { + if (in_array($dependency['name'], $this->dependencies, true)) { + unset($dependencies[$key]); + } + } + } elseif (count($dependencies) > 0) { + $io->writeln(' `- Dependencies found...'); + $io->newLine(); + } + + foreach ($dependencies as $dependency) { + $this->dependencies[] = $dependency['name']; + + if (is_array($dependency)) { + $dependency = $dependency['name']; + } + if ($dependency === 'grav' || $dependency === 'php') { + continue; + } + + $dependencyPackage = $this->gpm->findPackage($dependency); + + $dependency_exists = $this->packageExists($dependency, $dependencyPackage); + + if ($dependency_exists == Installer::EXISTS) { + $io->writeln("A dependency on {$dependencyPackage->name} [v{$dependencyPackage->version}] was found"); + + $question = new ConfirmationQuestion(" |- Uninstall {$dependencyPackage->name}? [y|N] ", false); + $answer = $this->all_yes ? true : $io->askQuestion($question); + + if ($answer) { + $uninstall = $this->uninstallPackage($dependency, $dependencyPackage, true); + + if (!$uninstall) { + $io->writeln(" '- Uninstallation failed or aborted."); + } else { + $io->writeln(" '- Success! "); + } + $io->newLine(); + } else { + $io->writeln(" '- You decided not to uninstall {$dependencyPackage->name}."); + $io->newLine(); + } + } + } + } + + + $locator = Grav::instance()['locator']; + $path = $locator->findResource($package->package_type . '://' . $slug); + Installer::uninstall($path); + $errorCode = Installer::lastErrorCode(); + + if ($errorCode && $errorCode !== Installer::IS_LINK && $errorCode !== Installer::EXISTS) { + $io->writeln(" |- Uninstalling {$package->name} package... error "); + $io->writeln(" | '- " . Installer::lastErrorMsg() . ''); + + return false; + } + + $message = Installer::getMessage(); + if ($message) { + $io->writeln(" |- {$message}"); + } + + if (!$is_dependency && $this->dependencies) { + $io->writeln("Finishing up uninstalling {$package->name}"); + } + $io->writeln(" |- Uninstalling {$package->name} package... ok "); + + return true; + } + + /** + * @param string $slug + * @param Local\Package|Remote\Package $package + * @return bool + */ + private function checkDestination(string $slug, $package): bool + { + $io = $this->getIO(); + + $exists = $this->packageExists($slug, $package); + + if ($exists === Installer::IS_LINK) { + $io->write("\x0D"); + $io->writeln(' |- Checking destination... symbolic link'); + + if ($this->all_yes) { + $io->writeln(" | '- Skipped automatically."); + + return false; + } + + $question = new ConfirmationQuestion( + " | '- Destination has been detected as symlink, delete symbolic link first? [y|N] ", + false + ); + + $answer = $io->askQuestion($question); + if (!$answer) { + $io->writeln(" | '- You decided not to delete the symlink automatically."); + + return false; + } + } + + $io->write("\x0D"); + $io->writeln(' |- Checking destination... ok'); + + return true; + } + + /** + * Check if package exists + * + * @param string $slug + * @param Local\Package|Remote\Package $package + * @return int + */ + private function packageExists(string $slug, $package): int + { + $path = Grav::instance()['locator']->findResource($package->package_type . '://' . $slug); + Installer::isValidDestination($path); + + return Installer::lastErrorCode(); + } +} diff --git a/system/src/Grav/Console/Gpm/UpdateCommand.php b/system/src/Grav/Console/Gpm/UpdateCommand.php new file mode 100644 index 0000000..d39b77d --- /dev/null +++ b/system/src/Grav/Console/Gpm/UpdateCommand.php @@ -0,0 +1,289 @@ +setName('update') + ->addOption( + 'force', + 'f', + InputOption::VALUE_NONE, + 'Force re-fetching the data from remote' + ) + ->addOption( + 'destination', + 'd', + InputOption::VALUE_OPTIONAL, + 'The grav instance location where the updates should be applied to. By default this would be where the grav cli has been launched from', + GRAV_ROOT + ) + ->addOption( + 'all-yes', + 'y', + InputOption::VALUE_NONE, + 'Assumes yes (or best approach) instead of prompting' + ) + ->addOption( + 'overwrite', + 'o', + InputOption::VALUE_NONE, + 'Option to overwrite packages if they already exist' + ) + ->addOption( + 'plugins', + 'p', + InputOption::VALUE_NONE, + 'Update only plugins' + ) + ->addOption( + 'themes', + 't', + InputOption::VALUE_NONE, + 'Update only themes' + ) + ->addArgument( + 'package', + InputArgument::IS_ARRAY | InputArgument::OPTIONAL, + 'The package or packages that is desired to update. By default all available updates will be applied.' + ) + ->setDescription('Detects and performs an update of plugins and themes when available') + ->setHelp('The update command updates plugins and themes when a new version is available'); + } + + /** + * @return int + */ + protected function serve(): int + { + $input = $this->getInput(); + $io = $this->getIO(); + + if (!class_exists(ZipArchive::class)) { + $io->title('GPM Update'); + $io->error('php-zip extension needs to be enabled!'); + + return 1; + } + + $this->upgrader = new Upgrader($input->getOption('force')); + $local = $this->upgrader->getLocalVersion(); + $remote = $this->upgrader->getRemoteVersion(); + if ($local !== $remote) { + $io->writeln('WARNING: A new version of Grav is available. You should update Grav before updating plugins and themes. If you continue without updating Grav, some plugins or themes may stop working.'); + $io->newLine(); + $question = new ConfirmationQuestion('Continue with the update process? [Y|n] ', true); + $answer = $io->askQuestion($question); + + if (!$answer) { + $io->writeln('Update aborted. Exiting...'); + + return 1; + } + } + + $this->gpm = new GPM($input->getOption('force')); + + $this->all_yes = $input->getOption('all-yes'); + $this->overwrite = $input->getOption('overwrite'); + + $this->displayGPMRelease(); + + $this->destination = realpath($input->getOption('destination')); + + if (!Installer::isGravInstance($this->destination)) { + $io->writeln('ERROR: ' . Installer::lastErrorMsg()); + exit; + } + if ($input->getOption('plugins') === false && $input->getOption('themes') === false) { + $list_type = ['plugins' => true, 'themes' => true]; + } else { + $list_type['plugins'] = $input->getOption('plugins'); + $list_type['themes'] = $input->getOption('themes'); + } + + if ($this->overwrite) { + $this->data = $this->gpm->getInstallable($list_type); + $description = ' can be overwritten'; + } else { + $this->data = $this->gpm->getUpdatable($list_type); + $description = ' need updating'; + } + + $only_packages = array_map('strtolower', $input->getArgument('package')); + + if (!$this->overwrite && !$this->data['total']) { + $io->writeln('Nothing to update.'); + + return 0; + } + + $io->write("Found {$this->gpm->countInstalled()} packages installed of which {$this->data['total']}{$description}"); + + $limit_to = $this->userInputPackages($only_packages); + + $io->newLine(); + + unset($this->data['total'], $limit_to['total']); + + + // updates review + $slugs = []; + + $index = 1; + foreach ($this->data as $packages) { + foreach ($packages as $slug => $package) { + if (!array_key_exists($slug, $limit_to) && count($only_packages)) { + continue; + } + + if (!$package->available) { + $package->available = $package->version; + } + + $io->writeln( + // index + str_pad((string)$index++, 2, '0', STR_PAD_LEFT) . '. ' . + // name + '' . str_pad($package->name, 15) . ' ' . + // version + "[v{$package->version} -> v{$package->available}]" + ); + $slugs[] = $slug; + } + } + + if (!$this->all_yes) { + // prompt to continue + $io->newLine(); + $question = new ConfirmationQuestion('Continue with the update process? [Y|n] ', true); + $answer = $io->askQuestion($question); + + if (!$answer) { + $io->writeln('Update aborted. Exiting...'); + + return 1; + } + } + + // finally update + $install_command = $this->getApplication()->find('install'); + + $args = new ArrayInput([ + 'command' => 'install', + 'package' => $slugs, + '-f' => $input->getOption('force'), + '-d' => $this->destination, + '-y' => true + ]); + $command_exec = $install_command->run($args, $io); + + if ($command_exec != 0) { + $io->writeln('Error: An error occurred while trying to install the packages'); + + return 1; + } + + return 0; + } + + /** + * @param array $only_packages + * @return array + */ + private function userInputPackages(array $only_packages): array + { + $io = $this->getIO(); + + $found = ['total' => 0]; + $ignore = []; + + if (!count($only_packages)) { + $io->newLine(); + } else { + foreach ($only_packages as $only_package) { + $find = $this->gpm->findPackage($only_package); + + if (!$find || (!$this->overwrite && !$this->gpm->isUpdatable($find->slug))) { + $name = $find->slug ?? $only_package; + $ignore[$name] = $name; + } else { + $found[$find->slug] = $find; + $found['total']++; + } + } + + if ($found['total']) { + $list = $found; + unset($list['total']); + $list = array_keys($list); + + if ($found['total'] !== $this->data['total']) { + $io->write(", only {$found['total']} will be updated"); + } + + $io->newLine(); + $io->writeln('Limiting updates for only ' . implode( + ', ', + $list + ) . ''); + } + + if (count($ignore)) { + $io->newLine(); + $io->writeln('Packages not found or not requiring updates: ' . implode( + ', ', + $ignore + ) . ''); + } + } + + return $found; + } +} diff --git a/system/src/Grav/Console/Gpm/VersionCommand.php b/system/src/Grav/Console/Gpm/VersionCommand.php new file mode 100644 index 0000000..3e16adb --- /dev/null +++ b/system/src/Grav/Console/Gpm/VersionCommand.php @@ -0,0 +1,125 @@ +setName('version') + ->addOption( + 'force', + 'f', + InputOption::VALUE_NONE, + 'Force re-fetching the data from remote' + ) + ->addArgument( + 'package', + InputArgument::IS_ARRAY | InputArgument::OPTIONAL, + 'The package or packages that is desired to know the version of. By default and if not specified this would be grav' + ) + ->setDescription('Shows the version of an installed package. If available also shows pending updates.') + ->setHelp('The version command displays the current version of a package installed and, if available, the available version of pending updates'); + } + + /** + * @return int + */ + protected function serve(): int + { + $input = $this->getInput(); + $io = $this->getIO(); + + $this->gpm = new GPM($input->getOption('force')); + $packages = $input->getArgument('package'); + + $installed = false; + + if (!count($packages)) { + $packages = ['grav']; + } + + foreach ($packages as $package) { + $package = strtolower($package); + $name = null; + $version = null; + $updatable = false; + + if ($package === 'grav') { + $name = 'Grav'; + $version = GRAV_VERSION; + $upgrader = new Upgrader(); + + if ($upgrader->isUpgradable()) { + $updatable = " [upgradable: v{$upgrader->getRemoteVersion()}]"; + } + } else { + // get currently installed version + $locator = Grav::instance()['locator']; + $blueprints_path = $locator->findResource('plugins://' . $package . DS . 'blueprints.yaml'); + if (!file_exists($blueprints_path)) { // theme? + $blueprints_path = $locator->findResource('themes://' . $package . DS . 'blueprints.yaml'); + if (!file_exists($blueprints_path)) { + continue; + } + } + + $file = YamlFile::instance($blueprints_path); + $package_yaml = $file->content(); + $file->free(); + + $version = $package_yaml['version']; + + if (!$version) { + continue; + } + + $installed = $this->gpm->findPackage($package); + if ($installed) { + $name = $installed->name; + + if ($this->gpm->isUpdatable($package)) { + $updatable = " [updatable: v{$installed->available}]"; + } + } + } + + $updatable = $updatable ?: ''; + + if ($installed || $package === 'grav') { + $io->writeln("You are running {$name} v{$version}{$updatable}"); + } else { + $io->writeln("Package {$package} not found"); + } + } + + return 0; + } +} diff --git a/system/src/Grav/Console/GpmCommand.php b/system/src/Grav/Console/GpmCommand.php new file mode 100644 index 0000000..f89d565 --- /dev/null +++ b/system/src/Grav/Console/GpmCommand.php @@ -0,0 +1,68 @@ +setupConsole($input, $output); + + $grav = Grav::instance(); + $grav['config']->init(); + $grav['uri']->init(); + // @phpstan-ignore-next-line + $grav['accounts']; + + return $this->serve(); + } + + /** + * Override with your implementation. + * + * @return int + */ + protected function serve() + { + // Return error. + return 1; + } + + /** + * @return void + */ + protected function displayGPMRelease() + { + /** @var Config $config */ + $config = Grav::instance()['config']; + + $io = $this->getIO(); + $io->newLine(); + $io->writeln('GPM Releases Configuration: ' . ucfirst($config->get('system.gpm.releases')) . ''); + $io->newLine(); + } +} diff --git a/system/src/Grav/Console/GravCommand.php b/system/src/Grav/Console/GravCommand.php new file mode 100644 index 0000000..a62dbc3 --- /dev/null +++ b/system/src/Grav/Console/GravCommand.php @@ -0,0 +1,52 @@ +setupConsole($input, $output); + + // Old versions of Grav called this command after grav upgrade. + // We need make this command to work with older ConsoleTrait: + if (method_exists($this, 'initializeGrav')) { + $this->initializeGrav(); + } + + return $this->serve(); + } + + /** + * Override with your implementation. + * + * @return int + */ + protected function serve() + { + // Return error. + return 1; + } +} diff --git a/system/src/Grav/Console/Plugin/PluginListCommand.php b/system/src/Grav/Console/Plugin/PluginListCommand.php new file mode 100644 index 0000000..24be2f5 --- /dev/null +++ b/system/src/Grav/Console/Plugin/PluginListCommand.php @@ -0,0 +1,69 @@ +setHidden(true); + } + + /** + * @return int + */ + protected function serve(): int + { + $bin = $this->argv; + $pattern = '([A-Z]\w+Command\.php)'; + + $io = $this->getIO(); + $io->newLine(); + $io->writeln('Usage:'); + $io->writeln(" {$bin} [slug] [command] [arguments]"); + $io->newLine(); + $io->writeln('Example:'); + $io->writeln(" {$bin} error log -l 1 --trace"); + $io->newLine(); + $io->writeln('Plugins with CLI available:'); + + $plugins = Plugins::all(); + $index = 0; + foreach ($plugins as $name => $plugin) { + if (!$plugin->enabled) { + continue; + } + + $list = Folder::all("plugins://{$name}", ['compare' => 'Pathname', 'pattern' => '/\/cli\/' . $pattern . '$/usm', 'levels' => 1]); + if (!$list) { + continue; + } + + $index++; + $num = str_pad((string)$index, 2, '0', STR_PAD_LEFT); + $io->writeln(' ' . $num . '. ' . str_pad($name, 15) . " {$bin} {$name} list"); + } + + return 0; + } +} diff --git a/system/src/Grav/Console/TerminalObjects/Table.php b/system/src/Grav/Console/TerminalObjects/Table.php new file mode 100644 index 0000000..754f2dc --- /dev/null +++ b/system/src/Grav/Console/TerminalObjects/Table.php @@ -0,0 +1,38 @@ +column_widths = $this->getColumnWidths(); + $this->table_width = $this->getWidth(); + $this->border = $this->getBorder(); + + $this->buildHeaderRow(); + + foreach ($this->data as $key => $columns) { + $this->rows[] = $this->buildRow($columns); + } + + $this->rows[] = $this->border; + + return $this->rows; + } +} diff --git a/system/src/Grav/Events/BeforeSessionStartEvent.php b/system/src/Grav/Events/BeforeSessionStartEvent.php new file mode 100644 index 0000000..de15051 --- /dev/null +++ b/system/src/Grav/Events/BeforeSessionStartEvent.php @@ -0,0 +1,36 @@ +start() right before session_start() call. + * + * @property SessionInterface $session Session instance. + */ +class BeforeSessionStartEvent extends Event +{ + /** @var SessionInterface */ + public $session; + + public function __construct(SessionInterface $session) + { + $this->session = $session; + } + + public function __debugInfo(): array + { + return (array)$this; + } +} diff --git a/system/src/Grav/Events/FlexRegisterEvent.php b/system/src/Grav/Events/FlexRegisterEvent.php new file mode 100644 index 0000000..40c8529 --- /dev/null +++ b/system/src/Grav/Events/FlexRegisterEvent.php @@ -0,0 +1,45 @@ +flex = $flex; + } + + /** + * @return array + */ + public function __debugInfo(): array + { + return (array)$this; + } +} diff --git a/system/src/Grav/Events/PageEvent.php b/system/src/Grav/Events/PageEvent.php new file mode 100644 index 0000000..a451f9f --- /dev/null +++ b/system/src/Grav/Events/PageEvent.php @@ -0,0 +1,18 @@ +permissions = $permissions; + } + + /** + * @return array + */ + public function __debugInfo(): array + { + return (array)$this; + } +} diff --git a/system/src/Grav/Events/PluginsLoadedEvent.php b/system/src/Grav/Events/PluginsLoadedEvent.php new file mode 100644 index 0000000..24e1ff7 --- /dev/null +++ b/system/src/Grav/Events/PluginsLoadedEvent.php @@ -0,0 +1,53 @@ +grav = $grav; + $this->plugins = $plugins; + } + + /** + * @return array + */ + public function __debugInfo(): array + { + return [ + 'plugins' => $this->plugins + ]; + } +} diff --git a/system/src/Grav/Events/SessionStartEvent.php b/system/src/Grav/Events/SessionStartEvent.php new file mode 100644 index 0000000..283e9a1 --- /dev/null +++ b/system/src/Grav/Events/SessionStartEvent.php @@ -0,0 +1,36 @@ +start() right after successful session_start() call. + * + * @property SessionInterface $session Session instance. + */ +class SessionStartEvent extends Event +{ + /** @var SessionInterface */ + public $session; + + public function __construct(SessionInterface $session) + { + $this->session = $session; + } + + public function __debugInfo(): array + { + return (array)$this; + } +} diff --git a/system/src/Grav/Events/TypesEvent.php b/system/src/Grav/Events/TypesEvent.php new file mode 100644 index 0000000..6a746a8 --- /dev/null +++ b/system/src/Grav/Events/TypesEvent.php @@ -0,0 +1,18 @@ + + */ +class Access implements JsonSerializable, IteratorAggregate, Countable +{ + /** @var string */ + private $name; + /** @var array */ + private $rules; + /** @var array */ + private $ops; + /** @var array */ + private $acl = []; + /** @var array */ + private $inherited = []; + + /** + * Access constructor. + * @param string|array|null $acl + * @param array|null $rules + * @param string $name + */ + public function __construct($acl = null, array $rules = null, string $name = '') + { + $this->name = $name; + $this->rules = $rules ?? []; + $this->ops = ['+' => true, '-' => false]; + if (is_string($acl)) { + $this->acl = $this->resolvePermissions($acl); + } elseif (is_array($acl)) { + $this->acl = $this->normalizeAcl($acl); + } + } + + /** + * @return string + */ + public function getName(): string + { + return $this->name; + } + + /** + * @param Access $parent + * @param string|null $name + * @return void + */ + public function inherit(Access $parent, string $name = null) + { + // Remove cached null actions from acl. + $acl = $this->getAllActions(); + // Get only inherited actions. + $inherited = array_diff_key($parent->getAllActions(), $acl); + + $this->inherited += $parent->inherited + array_fill_keys(array_keys($inherited), $name ?? $parent->getName()); + $this->acl = array_replace($acl, $inherited); + } + + /** + * Checks user authorization to the action. + * + * @param string $action + * @param string|null $scope + * @return bool|null + */ + public function authorize(string $action, string $scope = null): ?bool + { + if (null !== $scope) { + $action = $scope !== 'test' ? "{$scope}.{$action}" : $action; + } + + return $this->get($action); + } + + /** + * @return array + */ + public function toArray(): array + { + return Utils::arrayUnflattenDotNotation($this->acl); + } + + /** + * @return array + */ + public function getAllActions(): array + { + return array_filter($this->acl, static function($val) { return $val !== null; }); + } + + /** + * @return array + */ + public function jsonSerialize(): array + { + return $this->toArray(); + } + + /** + * @param string $action + * @return bool|null + */ + public function get(string $action) + { + // Get access value. + if (isset($this->acl[$action])) { + return $this->acl[$action]; + } + + // If no value is defined, check the parent access (all true|false). + $pos = strrpos($action, '.'); + $value = $pos ? $this->get(substr($action, 0, $pos)) : null; + + // Cache result for faster lookup. + $this->acl[$action] = $value; + + return $value; + } + + /** + * @param string $action + * @return bool + */ + public function isInherited(string $action): bool + { + return isset($this->inherited[$action]); + } + + /** + * @param string $action + * @return string|null + */ + public function getInherited(string $action): ?string + { + return $this->inherited[$action] ?? null; + } + + /** + * @return Traversable + */ + public function getIterator(): Traversable + { + return new ArrayIterator($this->acl); + } + + /** + * @return int + */ + public function count(): int + { + return count($this->acl); + } + + /** + * @param array $acl + * @return array + */ + protected function normalizeAcl(array $acl): array + { + if (empty($acl)) { + return []; + } + + // Normalize access control list. + $list = []; + foreach (Utils::arrayFlattenDotNotation($acl) as $key => $value) { + if (is_bool($value)) { + $list[$key] = $value; + } elseif ($value === 0 || $value === 1) { + $list[$key] = (bool)$value; + } elseif($value === null) { + continue; + } elseif ($this->rules && is_string($value)) { + $list[$key] = $this->resolvePermissions($value); + } elseif (Utils::isPositive($value)) { + $list[$key] = true; + } elseif (Utils::isNegative($value)) { + $list[$key] = false; + } + } + + return $list; + } + + /** + * @param string $access + * @return array + */ + protected function resolvePermissions(string $access): array + { + $len = strlen($access); + $op = true; + $list = []; + for($count = 0; $count < $len; $count++) { + $letter = $access[$count]; + if (isset($this->rules[$letter])) { + $list[$this->rules[$letter]] = $op; + $op = true; + } elseif (isset($this->ops[$letter])) { + $op = $this->ops[$letter]; + } + } + + return $list; + } +} diff --git a/system/src/Grav/Framework/Acl/Action.php b/system/src/Grav/Framework/Acl/Action.php new file mode 100644 index 0000000..a5cfa1a --- /dev/null +++ b/system/src/Grav/Framework/Acl/Action.php @@ -0,0 +1,204 @@ + + */ +class Action implements IteratorAggregate, Countable +{ + /** @var string */ + public $name; + /** @var string */ + public $type; + /** @var bool */ + public $visible; + /** @var string|null */ + public $label; + /** @var array */ + public $params; + + /** @var Action|null */ + protected $parent; + /** @var array */ + protected $children = []; + + /** + * @param string $name + * @param array $action + */ + public function __construct(string $name, array $action = []) + { + $label = $action['label'] ?? null; + if (!$label) { + if ($pos = mb_strrpos($name, '.')) { + $label = mb_substr($name, $pos + 1); + } else { + $label = $name; + } + $label = Inflector::humanize($label, 'all'); + } + + $this->name = $name; + $this->type = $action['type'] ?? 'action'; + $this->visible = (bool)($action['visible'] ?? true); + $this->label = $label; + unset($action['type'], $action['label']); + $this->params = $action; + + // Include compact rules. + if (isset($action['letters'])) { + foreach ($action['letters'] as $letter => $data) { + $data['letter'] = $letter; + $childName = $this->name . '.' . $data['action']; + unset($data['action']); + $child = new Action($childName, $data); + $this->addChild($child); + } + } + } + + /** + * @return array + */ + public function getParams(): array + { + return $this->params; + } + + /** + * @param string $name + * @return mixed|null + */ + public function getParam(string $name) + { + return $this->params[$name] ?? null; + } + + /** + * @return Action|null + */ + public function getParent(): ?Action + { + return $this->parent; + } + + /** + * @param Action|null $parent + * @return void + */ + public function setParent(?Action $parent): void + { + $this->parent = $parent; + } + + /** + * @return string + */ + public function getScope(): string + { + $pos = mb_strpos($this->name, '.'); + if ($pos) { + return mb_substr($this->name, 0, $pos); + } + + return $this->name; + } + + /** + * @return int + */ + public function getLevels(): int + { + return mb_substr_count($this->name, '.'); + } + + /** + * @return bool + */ + public function hasChildren(): bool + { + return !empty($this->children); + } + + /** + * @return Action[] + */ + public function getChildren(): array + { + return $this->children; + } + + /** + * @param string $name + * @return Action|null + */ + public function getChild(string $name): ?Action + { + return $this->children[$name] ?? null; + } + + /** + * @param Action $child + * @return void + */ + public function addChild(Action $child): void + { + if (mb_strpos($child->name, "{$this->name}.") !== 0) { + throw new RuntimeException('Bad child'); + } + + $child->setParent($this); + $name = mb_substr($child->name, mb_strlen($this->name) + 1); + + $this->children[$name] = $child; + } + + /** + * @return Traversable + */ + public function getIterator(): Traversable + { + return new ArrayIterator($this->children); + } + + /** + * @return int + */ + public function count(): int + { + return count($this->children); + } + + /** + * @return array + */ + #[\ReturnTypeWillChange] + public function __debugInfo() + { + return [ + 'name' => $this->name, + 'type' => $this->type, + 'label' => $this->label, + 'params' => $this->params, + 'actions' => $this->children + ]; + } +} diff --git a/system/src/Grav/Framework/Acl/Permissions.php b/system/src/Grav/Framework/Acl/Permissions.php new file mode 100644 index 0000000..a07f7eb --- /dev/null +++ b/system/src/Grav/Framework/Acl/Permissions.php @@ -0,0 +1,249 @@ + + * @implements IteratorAggregate + */ +class Permissions implements ArrayAccess, Countable, IteratorAggregate +{ + /** @var array */ + protected $instances = []; + /** @var array */ + protected $actions = []; + /** @var array */ + protected $nested = []; + /** @var array */ + protected $types = []; + + /** + * @return array + */ + public function getInstances(): array + { + $iterator = new RecursiveActionIterator($this->actions); + $recursive = new RecursiveIteratorIterator($iterator, RecursiveIteratorIterator::SELF_FIRST); + + return iterator_to_array($recursive); + } + + /** + * @param string $name + * @return bool + */ + public function hasAction(string $name): bool + { + return isset($this->instances[$name]); + } + + /** + * @param string $name + * @return Action|null + */ + public function getAction(string $name): ?Action + { + return $this->instances[$name] ?? null; + } + + /** + * @param Action $action + * @return void + */ + public function addAction(Action $action): void + { + $name = $action->name; + $parent = $this->getParent($name); + if ($parent) { + $parent->addChild($action); + } else { + $this->actions[$name] = $action; + } + + $this->instances[$name] = $action; + + // If Action has children, add those, too. + foreach ($action->getChildren() as $child) { + $this->instances[$child->name] = $child; + } + } + + /** + * @return array + */ + public function getActions(): array + { + return $this->actions; + } + + /** + * @param Action[] $actions + * @return void + */ + public function addActions(array $actions): void + { + foreach ($actions as $action) { + $this->addAction($action); + } + } + + /** + * @param string $name + * @return bool + */ + public function hasType(string $name): bool + { + return isset($this->types[$name]); + } + + /** + * @param string $name + * @return Action|null + */ + public function getType(string $name): ?Action + { + return $this->types[$name] ?? null; + } + + /** + * @param string $name + * @param array $type + * @return void + */ + public function addType(string $name, array $type): void + { + $this->types[$name] = $type; + } + + /** + * @return array + */ + public function getTypes(): array + { + return $this->types; + } + + /** + * @param array $types + * @return void + */ + public function addTypes(array $types): void + { + $types = array_replace($this->types, $types); + + $this->types = $types; + } + + /** + * @param array|null $access + * @return Access + */ + public function getAccess(array $access = null): Access + { + return new Access($access ?? []); + } + + /** + * @param int|string $offset + * @return bool + */ + public function offsetExists($offset): bool + { + return isset($this->nested[$offset]); + } + + /** + * @param int|string $offset + * @return Action|null + */ + public function offsetGet($offset): ?Action + { + return $this->nested[$offset] ?? null; + } + + /** + * @param int|string $offset + * @param mixed $value + * @return void + */ + public function offsetSet($offset, $value): void + { + throw new RuntimeException(__METHOD__ . '(): Not Supported'); + } + + /** + * @param int|string $offset + * @return void + */ + public function offsetUnset($offset): void + { + throw new RuntimeException(__METHOD__ . '(): Not Supported'); + } + + /** + * @return int + */ + public function count(): int + { + return count($this->actions); + } + + /** + * @return ArrayIterator|Traversable + */ + #[\ReturnTypeWillChange] + public function getIterator() + { + return new ArrayIterator($this->actions); + } + + /** + * @return array + */ + #[\ReturnTypeWillChange] + public function __debugInfo() + { + return [ + 'actions' => $this->actions + ]; + } + + /** + * @param string $name + * @return Action|null + */ + protected function getParent(string $name): ?Action + { + if ($pos = strrpos($name, '.')) { + $parentName = substr($name, 0, $pos); + + $parent = $this->getAction($parentName); + if (!$parent) { + $parent = new Action($parentName); + $this->addAction($parent); + } + + return $parent; + } + + return null; + } +} diff --git a/system/src/Grav/Framework/Acl/PermissionsReader.php b/system/src/Grav/Framework/Acl/PermissionsReader.php new file mode 100644 index 0000000..0560361 --- /dev/null +++ b/system/src/Grav/Framework/Acl/PermissionsReader.php @@ -0,0 +1,186 @@ +content(); + $actions = $content['actions'] ?? []; + $types = $content['types'] ?? []; + + return static::fromArray($actions, $types); + } + + /** + * @param array $actions + * @param array $types + * @return Action[] + */ + public static function fromArray(array $actions, array $types): array + { + static::initTypes($types); + + $list = []; + foreach (static::read($actions) as $type => $data) { + $list[$type] = new Action($type, $data); + } + + return $list; + } + + /** + * @param array $actions + * @param string $prefix + * @return array + */ + public static function read(array $actions, string $prefix = ''): array + { + $list = []; + foreach ($actions as $name => $action) { + $prefixName = $prefix . $name; + $list[$prefixName] = null; + + // Support nested sets of actions. + if (isset($action['actions']) && is_array($action['actions'])) { + $innerList = static::read($action['actions'], "{$prefixName}."); + + $list += $innerList; + } + + unset($action['actions']); + + // Add defaults if they exist. + $action = static::addDefaults($action); + + // Build flat list of actions. + $list[$prefixName] = $action; + } + + return $list; + } + + /** + * @param array $types + * @return void + */ + protected static function initTypes(array $types) + { + static::$types = []; + + $dependencies = []; + foreach ($types as $type => $defaults) { + $current = array_fill_keys((array)($defaults['use'] ?? null), null); + $defType = $defaults['type'] ?? $type; + if ($type !== $defType) { + $current[$defaults['type']] = null; + } + + $dependencies[$type] = (object)$current; + } + + // Build dependency tree. + foreach ($dependencies as $type => $dep) { + foreach (get_object_vars($dep) as $k => &$val) { + if (null === $val) { + $val = $dependencies[$k] ?? new stdClass(); + } + } + unset($val); + } + + $encoded = json_encode($dependencies); + if ($encoded === false) { + throw new RuntimeException('json_encode(): failed to encode dependencies'); + } + $dependencies = json_decode($encoded, true); + + foreach (static::getDependencies($dependencies) as $type) { + $defaults = $types[$type] ?? null; + if ($defaults) { + static::$types[$type] = static::addDefaults($defaults); + } + } + } + + /** + * @param array $dependencies + * @return array + */ + protected static function getDependencies(array $dependencies): array + { + $list = [[]]; + foreach ($dependencies as $name => $deps) { + $current = $deps ? static::getDependencies($deps) : []; + $current[] = $name; + + $list[] = $current; + } + + return array_unique(array_merge(...$list)); + } + + /** + * @param array $action + * @return array + */ + protected static function addDefaults(array $action): array + { + $scopes = []; + + // Add used properties. + $use = (array)($action['use'] ?? null); + foreach ($use as $type) { + if (isset(static::$types[$type])) { + $used = static::$types[$type]; + unset($used['type']); + $scopes[] = $used; + } + } + unset($action['use']); + + // Add type defaults. + $type = $action['type'] ?? 'default'; + $defaults = static::$types[$type] ?? null; + if (is_array($defaults)) { + $scopes[] = $defaults; + } + + if ($scopes) { + $scopes[] = $action; + + $action = array_replace_recursive(...$scopes); + + $newType = $defaults['type'] ?? null; + if ($newType && $newType !== $type) { + $action['type'] = $newType; + } + } + + return $action; + } +} diff --git a/system/src/Grav/Framework/Acl/RecursiveActionIterator.php b/system/src/Grav/Framework/Acl/RecursiveActionIterator.php new file mode 100644 index 0000000..3c38612 --- /dev/null +++ b/system/src/Grav/Framework/Acl/RecursiveActionIterator.php @@ -0,0 +1,64 @@ + + */ +class RecursiveActionIterator implements RecursiveIterator, \Countable +{ + use Constructor, Iterator, Countable; + + public $items; + + /** + * @see \Iterator::key() + * @return string + */ + #[\ReturnTypeWillChange] + public function key() + { + /** @var Action $current */ + $current = $this->current(); + + return $current->name; + } + + /** + * @see \RecursiveIterator::hasChildren() + * @return bool + */ + public function hasChildren(): bool + { + /** @var Action $current */ + $current = $this->current(); + + return $current->hasChildren(); + } + + /** + * @see \RecursiveIterator::getChildren() + * @return RecursiveActionIterator + */ + public function getChildren(): self + { + /** @var Action $current */ + $current = $this->current(); + + return new static($current->getChildren()); + } +} diff --git a/system/src/Grav/Framework/Cache/AbstractCache.php b/system/src/Grav/Framework/Cache/AbstractCache.php new file mode 100644 index 0000000..1a3fadc --- /dev/null +++ b/system/src/Grav/Framework/Cache/AbstractCache.php @@ -0,0 +1,32 @@ +init($namespace, $defaultLifetime); + } +} diff --git a/system/src/Grav/Framework/Cache/Adapter/ChainCache.php b/system/src/Grav/Framework/Cache/Adapter/ChainCache.php new file mode 100644 index 0000000..2957841 --- /dev/null +++ b/system/src/Grav/Framework/Cache/Adapter/ChainCache.php @@ -0,0 +1,210 @@ +getMessage(), $e->getCode(), $e); + } + + if (!$caches) { + throw new InvalidArgumentException('At least one cache must be specified'); + } + + foreach ($caches as $cache) { + if (!$cache instanceof CacheInterface) { + throw new InvalidArgumentException( + sprintf( + "The class '%s' does not implement the '%s' interface", + get_class($cache), + CacheInterface::class + ) + ); + } + } + + $this->caches = array_values($caches); + $this->count = count($caches); + } + + /** + * @inheritdoc + */ + public function doGet($key, $miss) + { + foreach ($this->caches as $i => $cache) { + $value = $cache->doGet($key, $miss); + if ($value !== $miss) { + while (--$i >= 0) { + // Update all the previous caches with missing value. + $this->caches[$i]->doSet($key, $value, $this->getDefaultLifetime()); + } + + return $value; + } + } + + return $miss; + } + + /** + * @inheritdoc + */ + public function doSet($key, $value, $ttl) + { + $success = true; + $i = $this->count; + + while ($i--) { + $success = $this->caches[$i]->doSet($key, $value, $ttl) && $success; + } + + return $success; + } + + /** + * @inheritdoc + */ + public function doDelete($key) + { + $success = true; + $i = $this->count; + + while ($i--) { + $success = $this->caches[$i]->doDelete($key) && $success; + } + + return $success; + } + + /** + * @inheritdoc + */ + public function doClear() + { + $success = true; + $i = $this->count; + + while ($i--) { + $success = $this->caches[$i]->doClear() && $success; + } + + return $success; + } + + /** + * @inheritdoc + */ + public function doGetMultiple($keys, $miss) + { + $list = []; + /** + * @var int $i + * @var CacheInterface $cache + */ + foreach ($this->caches as $i => $cache) { + $list[$i] = $cache->doGetMultiple($keys, $miss); + + $keys = array_diff_key($keys, $list[$i]); + + if (!$keys) { + break; + } + } + + // Update all the previous caches with missing values. + $values = []; + /** + * @var int $i + * @var CacheInterface $items + */ + foreach (array_reverse($list) as $i => $items) { + $values += $items; + if ($i && $values) { + $this->caches[$i-1]->doSetMultiple($values, $this->getDefaultLifetime()); + } + } + + return $values; + } + + /** + * @inheritdoc + */ + public function doSetMultiple($values, $ttl) + { + $success = true; + $i = $this->count; + + while ($i--) { + $success = $this->caches[$i]->doSetMultiple($values, $ttl) && $success; + } + + return $success; + } + + /** + * @inheritdoc + */ + public function doDeleteMultiple($keys) + { + $success = true; + $i = $this->count; + + while ($i--) { + $success = $this->caches[$i]->doDeleteMultiple($keys) && $success; + } + + return $success; + } + + /** + * @inheritdoc + */ + public function doHas($key) + { + foreach ($this->caches as $cache) { + if ($cache->doHas($key)) { + return true; + } + } + + return false; + } +} diff --git a/system/src/Grav/Framework/Cache/Adapter/DoctrineCache.php b/system/src/Grav/Framework/Cache/Adapter/DoctrineCache.php new file mode 100644 index 0000000..14117de --- /dev/null +++ b/system/src/Grav/Framework/Cache/Adapter/DoctrineCache.php @@ -0,0 +1,118 @@ +getMessage(), $e->getCode(), $e); + } + + // Set namespace to Doctrine Cache provider if it was given. + $namespace = $this->getNamespace(); + if ($namespace) { + $doctrineCache->setNamespace($namespace); + } + + $this->driver = $doctrineCache; + } + + /** + * @inheritdoc + */ + public function doGet($key, $miss) + { + $value = $this->driver->fetch($key); + + // Doctrine cache does not differentiate between no result and cached 'false'. Make sure that we do. + return $value !== false || $this->driver->contains($key) ? $value : $miss; + } + + /** + * @inheritdoc + */ + public function doSet($key, $value, $ttl) + { + return $this->driver->save($key, $value, (int) $ttl); + } + + /** + * @inheritdoc + */ + public function doDelete($key) + { + return $this->driver->delete($key); + } + + /** + * @inheritdoc + */ + public function doClear() + { + return $this->driver->deleteAll(); + } + + /** + * @inheritdoc + */ + public function doGetMultiple($keys, $miss) + { + return $this->driver->fetchMultiple($keys); + } + + /** + * @inheritdoc + */ + public function doSetMultiple($values, $ttl) + { + return $this->driver->saveMultiple($values, (int) $ttl); + } + + /** + * @inheritdoc + */ + public function doDeleteMultiple($keys) + { + return $this->driver->deleteMultiple($keys); + } + + /** + * @inheritdoc + */ + public function doHas($key) + { + return $this->driver->contains($key); + } +} diff --git a/system/src/Grav/Framework/Cache/Adapter/FileCache.php b/system/src/Grav/Framework/Cache/Adapter/FileCache.php new file mode 100644 index 0000000..d2058d5 --- /dev/null +++ b/system/src/Grav/Framework/Cache/Adapter/FileCache.php @@ -0,0 +1,266 @@ +initFileCache($namespace, $folder ?? ''); + } catch (\Psr\SimpleCache\InvalidArgumentException $e) { + throw new InvalidArgumentException($e->getMessage(), $e->getCode(), $e); + } + } + + /** + * @inheritdoc + */ + public function doGet($key, $miss) + { + $now = time(); + $file = $this->getFile($key); + + if (!file_exists($file) || !$h = @fopen($file, 'rb')) { + return $miss; + } + + if ($now >= (int) $expiresAt = fgets($h)) { + fclose($h); + @unlink($file); + } else { + $i = rawurldecode(rtrim((string)fgets($h))); + $value = stream_get_contents($h) ?: ''; + fclose($h); + + if ($i === $key) { + return unserialize($value, ['allowed_classes' => true]); + } + } + + return $miss; + } + + /** + * @inheritdoc + * @throws CacheException + */ + public function doSet($key, $value, $ttl) + { + $expiresAt = time() + (int)$ttl; + + $result = $this->write( + $this->getFile($key, true), + $expiresAt . "\n" . rawurlencode($key) . "\n" . serialize($value), + $expiresAt + ); + + if (!$result && !is_writable($this->directory)) { + throw new CacheException(sprintf('Cache directory is not writable (%s)', $this->directory)); + } + + return $result; + } + + /** + * @inheritdoc + */ + public function doDelete($key) + { + $file = $this->getFile($key); + + $result = false; + if (file_exists($file)) { + $result = @unlink($file); + $result &= !file_exists($file); + } + + return $result; + } + + /** + * @inheritdoc + */ + public function doClear() + { + $result = true; + $iterator = new RecursiveIteratorIterator(new RecursiveDirectoryIterator($this->directory, FilesystemIterator::SKIP_DOTS)); + + foreach ($iterator as $file) { + $result = ($file->isDir() || @unlink($file) || !file_exists($file)) && $result; + } + + return $result; + } + + /** + * @inheritdoc + */ + public function doHas($key) + { + $file = $this->getFile($key); + + return file_exists($file) && (@filemtime($file) > time() || $this->doGet($key, null)); + } + + /** + * @param string $key + * @param bool $mkdir + * @return string + */ + protected function getFile($key, $mkdir = false) + { + $hash = str_replace('/', '-', base64_encode(hash('sha256', static::class . $key, true))); + $dir = $this->directory . $hash[0] . DIRECTORY_SEPARATOR . $hash[1] . DIRECTORY_SEPARATOR; + + if ($mkdir) { + $this->mkdir($dir); + } + + return $dir . substr($hash, 2, 20); + } + + /** + * @param string $namespace + * @param string $directory + * @return void + * @throws InvalidArgumentException + */ + protected function initFileCache($namespace, $directory) + { + if ($directory === '') { + $directory = sys_get_temp_dir() . '/grav-cache'; + } else { + $directory = realpath($directory) ?: $directory; + } + + if (isset($namespace[0])) { + if (preg_match('#[^-+_.A-Za-z0-9]#', $namespace, $match)) { + throw new InvalidArgumentException(sprintf('Namespace contains "%s" but only characters in [-+_.A-Za-z0-9] are allowed.', $match[0])); + } + $directory .= DIRECTORY_SEPARATOR . $namespace; + } + + $this->mkdir($directory); + + $directory .= DIRECTORY_SEPARATOR; + // On Windows the whole path is limited to 258 chars + if ('\\' === DIRECTORY_SEPARATOR && strlen($directory) > 234) { + throw new InvalidArgumentException(sprintf('Cache folder is too long (%s)', $directory)); + } + $this->directory = $directory; + } + + /** + * @param string $file + * @param string $data + * @param int|null $expiresAt + * @return bool + */ + private function write($file, $data, $expiresAt = null) + { + set_error_handler(__CLASS__.'::throwError'); + + try { + if ($this->tmp === null) { + $this->tmp = $this->directory . uniqid('', true); + } + + file_put_contents($this->tmp, $data); + + if ($expiresAt !== null) { + touch($this->tmp, $expiresAt); + } + + return rename($this->tmp, $file); + } finally { + restore_error_handler(); + } + } + + /** + * @param string $dir + * @return void + * @throws RuntimeException + */ + private function mkdir($dir) + { + // Silence error for open_basedir; should fail in mkdir instead. + if (@is_dir($dir)) { + return; + } + + $success = @mkdir($dir, 0777, true); + + if (!$success) { + // Take yet another look, make sure that the folder doesn't exist. + clearstatcache(true, $dir); + if (!@is_dir($dir)) { + throw new RuntimeException(sprintf('Unable to create directory: %s', $dir)); + } + } + } + + /** + * @param int $type + * @param string $message + * @param string $file + * @param int $line + * @return bool + * @internal + * @throws ErrorException + */ + public static function throwError($type, $message, $file, $line) + { + throw new ErrorException($message, 0, $type, $file, $line); + } + + /** + * @return void + */ + #[\ReturnTypeWillChange] + public function __destruct() + { + if ($this->tmp !== null && file_exists($this->tmp)) { + unlink($this->tmp); + } + } +} diff --git a/system/src/Grav/Framework/Cache/Adapter/MemoryCache.php b/system/src/Grav/Framework/Cache/Adapter/MemoryCache.php new file mode 100644 index 0000000..6196368 --- /dev/null +++ b/system/src/Grav/Framework/Cache/Adapter/MemoryCache.php @@ -0,0 +1,83 @@ +cache)) { + return $miss; + } + + return $this->cache[$key]; + } + + /** + * @param string $key + * @param mixed $value + * @param int $ttl + * @return bool + */ + public function doSet($key, $value, $ttl) + { + $this->cache[$key] = $value; + + return true; + } + + /** + * @param string $key + * @return bool + */ + public function doDelete($key) + { + unset($this->cache[$key]); + + return true; + } + + /** + * @return bool + */ + public function doClear() + { + $this->cache = []; + + return true; + } + + /** + * @param string $key + * @return bool + */ + public function doHas($key) + { + return array_key_exists($key, $this->cache); + } +} diff --git a/system/src/Grav/Framework/Cache/Adapter/SessionCache.php b/system/src/Grav/Framework/Cache/Adapter/SessionCache.php new file mode 100644 index 0000000..7159685 --- /dev/null +++ b/system/src/Grav/Framework/Cache/Adapter/SessionCache.php @@ -0,0 +1,107 @@ +doGetStored($key); + + return $stored ? $stored[self::VALUE] : $miss; + } + + /** + * @param string $key + * @param mixed $value + * @param int $ttl + * @return bool + */ + public function doSet($key, $value, $ttl) + { + $stored = [self::VALUE => $value]; + if (null !== $ttl) { + $stored[self::LIFETIME] = time() + $ttl; + } + + $_SESSION[$this->getNamespace()][$key] = $stored; + + return true; + } + + /** + * @param string $key + * @return bool + */ + public function doDelete($key) + { + unset($_SESSION[$this->getNamespace()][$key]); + + return true; + } + + /** + * @return bool + */ + public function doClear() + { + unset($_SESSION[$this->getNamespace()]); + + return true; + } + + /** + * @param string $key + * @return bool + */ + public function doHas($key) + { + return $this->doGetStored($key) !== null; + } + + /** + * @return string + */ + public function getNamespace() + { + return 'cache-' . parent::getNamespace(); + } + + /** + * @param string $key + * @return mixed|null + */ + protected function doGetStored($key) + { + $stored = $_SESSION[$this->getNamespace()][$key] ?? null; + + if (isset($stored[self::LIFETIME]) && $stored[self::LIFETIME] < time()) { + unset($_SESSION[$this->getNamespace()][$key]); + $stored = null; + } + + return $stored ?: null; + } +} diff --git a/system/src/Grav/Framework/Cache/CacheInterface.php b/system/src/Grav/Framework/Cache/CacheInterface.php new file mode 100644 index 0000000..c095f3d --- /dev/null +++ b/system/src/Grav/Framework/Cache/CacheInterface.php @@ -0,0 +1,71 @@ + $values + * @param int|null $ttl + * @return mixed + */ + public function doSetMultiple($values, $ttl); + + /** + * @param string[] $keys + * @return mixed + */ + public function doDeleteMultiple($keys); + + /** + * @param string $key + * @return mixed + */ + public function doHas($key); +} diff --git a/system/src/Grav/Framework/Cache/CacheTrait.php b/system/src/Grav/Framework/Cache/CacheTrait.php new file mode 100644 index 0000000..f7eeb04 --- /dev/null +++ b/system/src/Grav/Framework/Cache/CacheTrait.php @@ -0,0 +1,373 @@ +namespace = (string) $namespace; + $this->defaultLifetime = $this->convertTtl($defaultLifetime); + $this->miss = new stdClass; + } + + /** + * @param bool $validation + * @return void + */ + public function setValidation($validation) + { + $this->validation = (bool) $validation; + } + + /** + * @return string + */ + protected function getNamespace() + { + return $this->namespace; + } + + /** + * @return int|null + */ + protected function getDefaultLifetime() + { + return $this->defaultLifetime; + } + + /** + * @param string $key + * @param mixed|null $default + * @return mixed|null + * @throws InvalidArgumentException + */ + public function get($key, $default = null) + { + $this->validateKey($key); + + $value = $this->doGet($key, $this->miss); + + return $value !== $this->miss ? $value : $default; + } + + /** + * @param string $key + * @param mixed $value + * @param null|int|DateInterval $ttl + * @return bool + * @throws InvalidArgumentException + */ + public function set($key, $value, $ttl = null) + { + $this->validateKey($key); + + $ttl = $this->convertTtl($ttl); + + // If a negative or zero TTL is provided, the item MUST be deleted from the cache. + return null !== $ttl && $ttl <= 0 ? $this->doDelete($key) : $this->doSet($key, $value, $ttl); + } + + /** + * @param string $key + * @return bool + * @throws InvalidArgumentException + */ + public function delete($key) + { + $this->validateKey($key); + + return $this->doDelete($key); + } + + /** + * @return bool + */ + public function clear() + { + return $this->doClear(); + } + + /** + * @param iterable $keys + * @param mixed|null $default + * @return iterable + * @throws InvalidArgumentException + */ + public function getMultiple($keys, $default = null) + { + if ($keys instanceof Traversable) { + $keys = iterator_to_array($keys, false); + } elseif (!is_array($keys)) { + $isObject = is_object($keys); + throw new InvalidArgumentException( + sprintf( + 'Cache keys must be array or Traversable, "%s" given', + $isObject ? get_class($keys) : gettype($keys) + ) + ); + } + + if (empty($keys)) { + return []; + } + + $this->validateKeys($keys); + $keys = array_unique($keys); + $keys = array_combine($keys, $keys); + + $list = $this->doGetMultiple($keys, $this->miss); + + // Make sure that values are returned in the same order as the keys were given. + $values = []; + foreach ($keys as $key) { + if (!array_key_exists($key, $list) || $list[$key] === $this->miss) { + $values[$key] = $default; + } else { + $values[$key] = $list[$key]; + } + } + + return $values; + } + + /** + * @param iterable $values + * @param null|int|DateInterval $ttl + * @return bool + * @throws InvalidArgumentException + */ + public function setMultiple($values, $ttl = null) + { + if ($values instanceof Traversable) { + $values = iterator_to_array($values, true); + } elseif (!is_array($values)) { + $isObject = is_object($values); + throw new InvalidArgumentException( + sprintf( + 'Cache values must be array or Traversable, "%s" given', + $isObject ? get_class($values) : gettype($values) + ) + ); + } + + $keys = array_keys($values); + + if (empty($keys)) { + return true; + } + + $this->validateKeys($keys); + + $ttl = $this->convertTtl($ttl); + + // If a negative or zero TTL is provided, the item MUST be deleted from the cache. + return null !== $ttl && $ttl <= 0 ? $this->doDeleteMultiple($keys) : $this->doSetMultiple($values, $ttl); + } + + /** + * @param iterable $keys + * @return bool + * @throws InvalidArgumentException + */ + public function deleteMultiple($keys) + { + if ($keys instanceof Traversable) { + $keys = iterator_to_array($keys, false); + } elseif (!is_array($keys)) { + $isObject = is_object($keys); + throw new InvalidArgumentException( + sprintf( + 'Cache keys must be array or Traversable, "%s" given', + $isObject ? get_class($keys) : gettype($keys) + ) + ); + } + + if (empty($keys)) { + return true; + } + + $this->validateKeys($keys); + + return $this->doDeleteMultiple($keys); + } + + /** + * @param string $key + * @return bool + * @throws InvalidArgumentException + */ + public function has($key) + { + $this->validateKey($key); + + return $this->doHas($key); + } + + /** + * @param array $keys + * @param mixed $miss + * @return array + */ + public function doGetMultiple($keys, $miss) + { + $results = []; + + foreach ($keys as $key) { + $value = $this->doGet($key, $miss); + if ($value !== $miss) { + $results[$key] = $value; + } + } + + return $results; + } + + /** + * @param array $values + * @param int|null $ttl + * @return bool + */ + public function doSetMultiple($values, $ttl) + { + $success = true; + + foreach ($values as $key => $value) { + $success = $this->doSet($key, $value, $ttl) && $success; + } + + return $success; + } + + /** + * @param array $keys + * @return bool + */ + public function doDeleteMultiple($keys) + { + $success = true; + + foreach ($keys as $key) { + $success = $this->doDelete($key) && $success; + } + + return $success; + } + + /** + * @param string|mixed $key + * @return void + * @throws InvalidArgumentException + */ + protected function validateKey($key) + { + if (!is_string($key)) { + throw new InvalidArgumentException( + sprintf( + 'Cache key must be string, "%s" given', + is_object($key) ? get_class($key) : gettype($key) + ) + ); + } + if (!isset($key[0])) { + throw new InvalidArgumentException('Cache key length must be greater than zero'); + } + if (strlen($key) > 64) { + throw new InvalidArgumentException( + sprintf('Cache key length must be less than 65 characters, key had %d characters', strlen($key)) + ); + } + if (strpbrk($key, '{}()/\@:') !== false) { + throw new InvalidArgumentException( + sprintf('Cache key "%s" contains reserved characters {}()/\@:', $key) + ); + } + } + + /** + * @param array $keys + * @return void + * @throws InvalidArgumentException + */ + protected function validateKeys($keys) + { + if (!$this->validation) { + return; + } + + foreach ($keys as $key) { + $this->validateKey($key); + } + } + + /** + * @param null|int|DateInterval $ttl + * @return int|null + * @throws InvalidArgumentException + */ + protected function convertTtl($ttl) + { + if ($ttl === null) { + return $this->getDefaultLifetime(); + } + + if (is_int($ttl)) { + return $ttl; + } + + if ($ttl instanceof DateInterval) { + $date = DateTime::createFromFormat('U', '0'); + $ttl = $date ? (int)$date->add($ttl)->format('U') : 0; + } + + throw new InvalidArgumentException( + sprintf( + 'Expiration date must be an integer, a DateInterval or null, "%s" given', + is_object($ttl) ? get_class($ttl) : gettype($ttl) + ) + ); + } +} diff --git a/system/src/Grav/Framework/Cache/Exception/CacheException.php b/system/src/Grav/Framework/Cache/Exception/CacheException.php new file mode 100644 index 0000000..4c4b8b9 --- /dev/null +++ b/system/src/Grav/Framework/Cache/Exception/CacheException.php @@ -0,0 +1,21 @@ + + * @implements FileCollectionInterface + */ +class AbstractFileCollection extends AbstractLazyCollection implements FileCollectionInterface +{ + /** @var string */ + protected $path; + /** @var RecursiveDirectoryIterator|RecursiveUniformResourceIterator */ + protected $iterator; + /** @var callable */ + protected $createObjectFunction; + /** @var callable|null */ + protected $filterFunction; + /** @var int */ + protected $flags; + /** @var int */ + protected $nestingLimit; + + /** + * @param string $path + */ + protected function __construct($path) + { + $this->path = $path; + $this->flags = self::INCLUDE_FILES | self::INCLUDE_FOLDERS; + $this->nestingLimit = 0; + $this->createObjectFunction = [$this, 'createObject']; + + $this->setIterator(); + } + + /** + * @return string + */ + public function getPath() + { + return $this->path; + } + + /** + * @param Criteria $criteria + * @return ArrayCollection + * @phpstan-return ArrayCollection + * @todo Implement lazy matching + */ + public function matching(Criteria $criteria) + { + $expr = $criteria->getWhereExpression(); + + $oldFilter = $this->filterFunction; + if ($expr) { + $visitor = new ClosureExpressionVisitor(); + $filter = $visitor->dispatch($expr); + $this->addFilter($filter); + } + + $filtered = $this->doInitializeByIterator($this->iterator, $this->nestingLimit); + $this->filterFunction = $oldFilter; + + if ($orderings = $criteria->getOrderings()) { + $next = null; + /** + * @var string $field + * @var string $ordering + */ + foreach (array_reverse($orderings) as $field => $ordering) { + $next = ClosureExpressionVisitor::sortByField($field, $ordering === Criteria::DESC ? -1 : 1, $next); + } + /** @phpstan-ignore-next-line */ + if (null === $next) { + throw new RuntimeException('Criteria is missing orderings'); + } + + uasort($filtered, $next); + } else { + ksort($filtered); + } + + $offset = $criteria->getFirstResult(); + $length = $criteria->getMaxResults(); + + if ($offset || $length) { + $filtered = array_slice($filtered, (int)$offset, $length); + } + + return new ArrayCollection($filtered); + } + + /** + * @return void + */ + protected function setIterator() + { + $iteratorFlags = RecursiveDirectoryIterator::SKIP_DOTS + FilesystemIterator::UNIX_PATHS + + FilesystemIterator::CURRENT_AS_SELF + FilesystemIterator::FOLLOW_SYMLINKS; + + if (strpos($this->path, '://')) { + /** @var UniformResourceLocator $locator */ + $locator = Grav::instance()['locator']; + $this->iterator = $locator->getRecursiveIterator($this->path, $iteratorFlags); + } else { + $this->iterator = new RecursiveDirectoryIterator($this->path, $iteratorFlags); + } + } + + /** + * @param callable $filterFunction + * @return $this + */ + protected function addFilter(callable $filterFunction) + { + if ($this->filterFunction) { + $oldFilterFunction = $this->filterFunction; + $this->filterFunction = function ($expr) use ($oldFilterFunction, $filterFunction) { + return $oldFilterFunction($expr) && $filterFunction($expr); + }; + } else { + $this->filterFunction = $filterFunction; + } + + return $this; + } + + /** + * {@inheritDoc} + */ + protected function doInitialize() + { + $filtered = $this->doInitializeByIterator($this->iterator, $this->nestingLimit); + ksort($filtered); + + $this->collection = new ArrayCollection($filtered); + } + + /** + * @param SeekableIterator $iterator + * @param int $nestingLimit + * @return array + * @phpstan-param SeekableIterator $iterator + */ + protected function doInitializeByIterator(SeekableIterator $iterator, $nestingLimit) + { + $children = []; + $objects = []; + $filter = $this->filterFunction; + $objectFunction = $this->createObjectFunction; + + /** @var RecursiveDirectoryIterator $file */ + foreach ($iterator as $file) { + // Skip files if they shouldn't be included. + if (!($this->flags & static::INCLUDE_FILES) && $file->isFile()) { + continue; + } + + // Apply main filter. + if ($filter && !$filter($file)) { + continue; + } + + // Include children if the recursive flag is set. + if (($this->flags & static::RECURSIVE) && $nestingLimit > 0 && $file->hasChildren()) { + $children[] = $file->getChildren(); + } + + // Skip folders if they shouldn't be included. + if (!($this->flags & static::INCLUDE_FOLDERS) && $file->isDir()) { + continue; + } + + $object = $objectFunction($file); + $objects[$object->key] = $object; + } + + if ($children) { + $objects += $this->doInitializeChildren($children, $nestingLimit - 1); + } + + return $objects; + } + + /** + * @param array $children + * @param int $nestingLimit + * @return array + */ + protected function doInitializeChildren(array $children, $nestingLimit) + { + $objects = []; + foreach ($children as $iterator) { + $objects += $this->doInitializeByIterator($iterator, $nestingLimit); + } + + return $objects; + } + + /** + * @param RecursiveDirectoryIterator $file + * @return object + */ + protected function createObject($file) + { + return (object) [ + 'key' => $file->getSubPathname(), + 'type' => $file->isDir() ? 'folder' : 'file:' . $file->getExtension(), + 'url' => method_exists($file, 'getUrl') ? $file->getUrl() : null, + 'pathname' => $file->getPathname(), + 'mtime' => $file->getMTime() + ]; + } +} diff --git a/system/src/Grav/Framework/Collection/AbstractIndexCollection.php b/system/src/Grav/Framework/Collection/AbstractIndexCollection.php new file mode 100644 index 0000000..1c2da8c --- /dev/null +++ b/system/src/Grav/Framework/Collection/AbstractIndexCollection.php @@ -0,0 +1,574 @@ + + */ +abstract class AbstractIndexCollection implements CollectionInterface +{ + use Serializable; + + /** + * @var array + * @phpstan-var array + */ + private $entries; + + /** + * Initializes a new IndexCollection. + * + * @param array $entries + * @phpstan-param array $entries + */ + public function __construct(array $entries = []) + { + $this->entries = $entries; + } + + /** + * {@inheritDoc} + */ + public function toArray() + { + return $this->loadElements($this->entries); + } + + /** + * {@inheritDoc} + */ + public function first() + { + $value = reset($this->entries); + $key = (string)key($this->entries); + + return $this->loadElement($key, $value); + } + + /** + * {@inheritDoc} + */ + public function last() + { + $value = end($this->entries); + $key = (string)key($this->entries); + + return $this->loadElement($key, $value); + } + + /** + * {@inheritDoc} + */ + #[\ReturnTypeWillChange] + public function key() + { + /** @phpstan-var TKey */ + return (string)key($this->entries); + } + + /** + * {@inheritDoc} + */ + #[\ReturnTypeWillChange] + public function next() + { + $value = next($this->entries); + $key = (string)key($this->entries); + + return $this->loadElement($key, $value); + } + + /** + * {@inheritDoc} + */ + #[\ReturnTypeWillChange] + public function current() + { + $value = current($this->entries); + $key = (string)key($this->entries); + + return $this->loadElement($key, $value); + } + + /** + * {@inheritDoc} + */ + public function remove($key) + { + if (!array_key_exists($key, $this->entries)) { + return null; + } + + $value = $this->entries[$key]; + unset($this->entries[$key]); + + return $this->loadElement((string)$key, $value); + } + + /** + * {@inheritDoc} + */ + public function removeElement($element) + { + $key = $this->isAllowedElement($element) ? $this->getCurrentKey($element) : null; + + if (null !== $key || !isset($this->entries[$key])) { + return false; + } + + unset($this->entries[$key]); + + return true; + } + + /** + * Required by interface ArrayAccess. + * + * @param string|int|null $offset + * @return bool + * @phpstan-param TKey|null $offset + */ + #[\ReturnTypeWillChange] + public function offsetExists($offset) + { + /** @phpstan-ignore-next-line phpstan bug? */ + return $offset !== null ? $this->containsKey($offset) : false; + } + + /** + * Required by interface ArrayAccess. + * + * @param string|int|null $offset + * @return mixed + * @phpstan-param TKey|null $offset + */ + #[\ReturnTypeWillChange] + public function offsetGet($offset) + { + /** @phpstan-ignore-next-line phpstan bug? */ + return $offset !== null ? $this->get($offset) : null; + } + + /** + * Required by interface ArrayAccess. + * + * @param string|int|null $offset + * @param mixed $value + * @return void + * @phpstan-param TKey|null $offset + */ + #[\ReturnTypeWillChange] + public function offsetSet($offset, $value) + { + if (null === $offset) { + $this->add($value); + } else { + /** @phpstan-ignore-next-line phpstan bug? */ + $this->set($offset, $value); + } + } + + /** + * Required by interface ArrayAccess. + * + * @param string|int|null $offset + * @return void + * @phpstan-param TKey|null $offset + */ + #[\ReturnTypeWillChange] + public function offsetUnset($offset) + { + if ($offset !== null) { + /** @phpstan-ignore-next-line phpstan bug? */ + $this->remove($offset); + } + } + + /** + * {@inheritDoc} + */ + public function containsKey($key) + { + return isset($this->entries[$key]) || array_key_exists($key, $this->entries); + } + + /** + * {@inheritDoc} + */ + public function contains($element) + { + $key = $this->isAllowedElement($element) ? $this->getCurrentKey($element) : null; + + return $key && isset($this->entries[$key]); + } + + /** + * {@inheritDoc} + */ + public function exists(Closure $p) + { + return $this->loadCollection($this->entries)->exists($p); + } + + /** + * {@inheritDoc} + */ + public function indexOf($element) + { + $key = $this->isAllowedElement($element) ? $this->getCurrentKey($element) : null; + + return $key && isset($this->entries[$key]) ? $key : false; + } + + /** + * {@inheritDoc} + */ + public function get($key) + { + if (!isset($this->entries[$key])) { + return null; + } + + return $this->loadElement((string)$key, $this->entries[$key]); + } + + /** + * {@inheritDoc} + */ + public function getKeys() + { + return array_keys($this->entries); + } + + /** + * {@inheritDoc} + */ + public function getValues() + { + return array_values($this->loadElements($this->entries)); + } + + /** + * {@inheritDoc} + */ + #[\ReturnTypeWillChange] + public function count() + { + return count($this->entries); + } + + /** + * {@inheritDoc} + */ + public function set($key, $value) + { + if (!$this->isAllowedElement($value)) { + throw new InvalidArgumentException('Invalid argument $value'); + } + + $this->entries[$key] = $this->getElementMeta($value); + } + + /** + * {@inheritDoc} + */ + public function add($element) + { + if (!$this->isAllowedElement($element)) { + throw new InvalidArgumentException('Invalid argument $element'); + } + + $this->entries[$this->getCurrentKey($element)] = $this->getElementMeta($element); + + return true; + } + + /** + * {@inheritDoc} + */ + public function isEmpty() + { + return empty($this->entries); + } + + /** + * Required by interface IteratorAggregate. + * + * {@inheritDoc} + * @phpstan-return Iterator + */ + #[\ReturnTypeWillChange] + public function getIterator() + { + return new ArrayIterator($this->loadElements()); + } + + /** + * {@inheritDoc} + */ + public function map(Closure $func) + { + return $this->loadCollection($this->entries)->map($func); + } + + /** + * {@inheritDoc} + */ + public function filter(Closure $p) + { + return $this->loadCollection($this->entries)->filter($p); + } + + /** + * {@inheritDoc} + */ + public function forAll(Closure $p) + { + return $this->loadCollection($this->entries)->forAll($p); + } + + /** + * {@inheritDoc} + */ + public function partition(Closure $p) + { + return $this->loadCollection($this->entries)->partition($p); + } + + /** + * Returns a string representation of this object. + * + * @return string + */ + #[\ReturnTypeWillChange] + public function __toString() + { + return __CLASS__ . '@' . spl_object_hash($this); + } + + /** + * {@inheritDoc} + */ + public function clear() + { + $this->entries = []; + } + + /** + * {@inheritDoc} + */ + public function slice($offset, $length = null) + { + return $this->loadElements(array_slice($this->entries, $offset, $length, true)); + } + + /** + * @param int $start + * @param int|null $limit + * @return static + * @phpstan-return static + */ + public function limit($start, $limit = null) + { + return $this->createFrom(array_slice($this->entries, $start, $limit, true)); + } + + /** + * Reverse the order of the items. + * + * @return static + * @phpstan-return static + */ + public function reverse() + { + return $this->createFrom(array_reverse($this->entries)); + } + + /** + * Shuffle items. + * + * @return static + * @phpstan-return static + */ + public function shuffle() + { + $keys = $this->getKeys(); + shuffle($keys); + + return $this->createFrom(array_replace(array_flip($keys), $this->entries)); + } + + /** + * Select items from collection. + * + * Collection is returned in the order of $keys given to the function. + * + * @param array $keys + * @return static + * @phpstan-return static + */ + public function select(array $keys) + { + $list = []; + foreach ($keys as $key) { + if (isset($this->entries[$key])) { + $list[$key] = $this->entries[$key]; + } + } + + return $this->createFrom($list); + } + + /** + * Un-select items from collection. + * + * @param array $keys + * @return static + * @phpstan-return static + */ + public function unselect(array $keys) + { + return $this->select(array_diff($this->getKeys(), $keys)); + } + + /** + * Split collection into chunks. + * + * @param int $size Size of each chunk. + * @return array + * @phpstan-return array> + */ + public function chunk($size) + { + /** @phpstan-var array> */ + return $this->loadCollection($this->entries)->chunk($size); + } + + /** + * @return array + */ + public function __serialize(): array + { + return [ + 'entries' => $this->entries + ]; + } + + /** + * @param array $data + * @return void + */ + public function __unserialize(array $data): void + { + $this->entries = $data['entries']; + } + + /** + * Implements JsonSerializable interface. + * + * @return array + */ + #[\ReturnTypeWillChange] + public function jsonSerialize() + { + return $this->loadCollection()->jsonSerialize(); + } + + /** + * Creates a new instance from the specified elements. + * + * This method is provided for derived classes to specify how a new + * instance should be created when constructor semantics have changed. + * + * @param array $entries Elements. + * @return static + * @phpstan-return static + */ + protected function createFrom(array $entries) + { + return new static($entries); + } + + /** + * @return array + */ + protected function getEntries(): array + { + return $this->entries; + } + + /** + * @param array $entries + * @return void + * @phpstan-param array $entries + */ + protected function setEntries(array $entries): void + { + $this->entries = $entries; + } + + /** + * @param FlexObjectInterface $element + * @return string + * @phpstan-param T $element + * @phpstan-return TKey + */ + protected function getCurrentKey($element) + { + return $element->getKey(); + } + + /** + * @param string $key + * @param mixed $value + * @return mixed|null + */ + abstract protected function loadElement($key, $value); + + /** + * @param array|null $entries + * @return array + * @phpstan-return array + */ + abstract protected function loadElements(array $entries = null): array; + + /** + * @param array|null $entries + * @return CollectionInterface + * @phpstan-return C + */ + abstract protected function loadCollection(array $entries = null): CollectionInterface; + + /** + * @param mixed $value + * @return bool + */ + abstract protected function isAllowedElement($value): bool; + + /** + * @param mixed $element + * @return mixed + */ + abstract protected function getElementMeta($element); +} diff --git a/system/src/Grav/Framework/Collection/AbstractLazyCollection.php b/system/src/Grav/Framework/Collection/AbstractLazyCollection.php new file mode 100644 index 0000000..806939c --- /dev/null +++ b/system/src/Grav/Framework/Collection/AbstractLazyCollection.php @@ -0,0 +1,97 @@ + + * @implements CollectionInterface + */ +abstract class AbstractLazyCollection extends BaseAbstractLazyCollection implements CollectionInterface +{ + /** + * @par ArrayCollection + * @phpstan-var ArrayCollection + */ + protected $collection; + + /** + * {@inheritDoc} + * @phpstan-return ArrayCollection + */ + public function reverse() + { + $this->initialize(); + + return $this->collection->reverse(); + } + + /** + * {@inheritDoc} + * @phpstan-return ArrayCollection + */ + public function shuffle() + { + $this->initialize(); + + return $this->collection->shuffle(); + } + + /** + * {@inheritDoc} + */ + public function chunk($size) + { + $this->initialize(); + + return $this->collection->chunk($size); + } + + /** + * {@inheritDoc} + * @phpstan-param array $keys + * @phpstan-return ArrayCollection + */ + public function select(array $keys) + { + $this->initialize(); + + return $this->collection->select($keys); + } + + /** + * {@inheritDoc} + * @phpstan-param array $keys + * @phpstan-return ArrayCollection + */ + public function unselect(array $keys) + { + $this->initialize(); + + return $this->collection->unselect($keys); + } + + /** + * @return array + */ + #[\ReturnTypeWillChange] + public function jsonSerialize() + { + $this->initialize(); + + return $this->collection->jsonSerialize(); + } +} diff --git a/system/src/Grav/Framework/Collection/ArrayCollection.php b/system/src/Grav/Framework/Collection/ArrayCollection.php new file mode 100644 index 0000000..7d8c7ac --- /dev/null +++ b/system/src/Grav/Framework/Collection/ArrayCollection.php @@ -0,0 +1,117 @@ + + * @implements CollectionInterface + */ +class ArrayCollection extends BaseArrayCollection implements CollectionInterface +{ + /** + * Reverse the order of the items. + * + * @return static + * @phpstan-return static + */ + public function reverse() + { + $keys = array_reverse($this->toArray()); + + /** @phpstan-var static */ + return $this->createFrom($keys); + } + + /** + * Shuffle items. + * + * @return static + * @phpstan-return static + */ + public function shuffle() + { + $keys = $this->getKeys(); + shuffle($keys); + $keys = array_replace(array_flip($keys), $this->toArray()); + + /** @phpstan-var static */ + return $this->createFrom($keys); + } + + /** + * Split collection into chunks. + * + * @param int $size Size of each chunk. + * @return array + * @phpstan-return array> + */ + public function chunk($size) + { + /** @phpstan-var array> */ + return array_chunk($this->toArray(), $size, true); + } + + /** + * Select items from collection. + * + * Collection is returned in the order of $keys given to the function. + * + * @param array $keys + * @return static + * @phpstan-param TKey[] $keys + * @phpstan-return static + */ + public function select(array $keys) + { + $list = []; + foreach ($keys as $key) { + if ($this->containsKey($key)) { + $list[$key] = $this->get($key); + } + } + + /** @phpstan-var static */ + return $this->createFrom($list); + } + + /** + * Un-select items from collection. + * + * @param array $keys + * @return static + * @phpstan-param TKey[] $keys + * @phpstan-return static + */ + public function unselect(array $keys) + { + $list = array_diff($this->getKeys(), $keys); + + /** @phpstan-var static */ + return $this->select($list); + } + + /** + * Implements JsonSerializable interface. + * + * @return array + */ + #[\ReturnTypeWillChange] + public function jsonSerialize() + { + return $this->toArray(); + } +} diff --git a/system/src/Grav/Framework/Collection/CollectionInterface.php b/system/src/Grav/Framework/Collection/CollectionInterface.php new file mode 100644 index 0000000..d112057 --- /dev/null +++ b/system/src/Grav/Framework/Collection/CollectionInterface.php @@ -0,0 +1,69 @@ + + */ +interface CollectionInterface extends Collection, JsonSerializable +{ + /** + * Reverse the order of the items. + * + * @return CollectionInterface + * @phpstan-return static + */ + public function reverse(); + + /** + * Shuffle items. + * + * @return CollectionInterface + * @phpstan-return static + */ + public function shuffle(); + + /** + * Split collection into chunks. + * + * @param int $size Size of each chunk. + * @return array + * @phpstan-return array> + */ + public function chunk($size); + + /** + * Select items from collection. + * + * Collection is returned in the order of $keys given to the function. + * + * @param array $keys + * @return CollectionInterface + * @phpstan-return static + */ + public function select(array $keys); + + /** + * Un-select items from collection. + * + * @param array $keys + * @return CollectionInterface + * @phpstan-return static + */ + public function unselect(array $keys); +} diff --git a/system/src/Grav/Framework/Collection/FileCollection.php b/system/src/Grav/Framework/Collection/FileCollection.php new file mode 100644 index 0000000..8fe254d --- /dev/null +++ b/system/src/Grav/Framework/Collection/FileCollection.php @@ -0,0 +1,97 @@ + + */ +class FileCollection extends AbstractFileCollection +{ + /** + * @param string $path + * @param int $flags + */ + public function __construct($path, $flags = null) + { + parent::__construct($path); + + $this->flags = (int)($flags ?: self::INCLUDE_FILES | self::INCLUDE_FOLDERS | self::RECURSIVE); + + $this->setIterator(); + $this->setFilter(); + $this->setObjectBuilder(); + $this->setNestingLimit(); + } + + /** + * @return int + */ + public function getFlags() + { + return $this->flags; + } + + /** + * @return int + */ + public function getNestingLimit() + { + return $this->nestingLimit; + } + + /** + * @param int $limit + * @return $this + */ + public function setNestingLimit($limit = 99) + { + $this->nestingLimit = (int) $limit; + + return $this; + } + + /** + * @param callable|null $filterFunction + * @return $this + */ + public function setFilter(callable $filterFunction = null) + { + $this->filterFunction = $filterFunction; + + return $this; + } + + /** + * @param callable $filterFunction + * @return $this + */ + public function addFilter(callable $filterFunction) + { + parent::addFilter($filterFunction); + + return $this; + } + + /** + * @param callable|null $objectFunction + * @return $this + */ + public function setObjectBuilder(callable $objectFunction = null) + { + $this->createObjectFunction = $objectFunction ?: [$this, 'createObject']; + + return $this; + } +} diff --git a/system/src/Grav/Framework/Collection/FileCollectionInterface.php b/system/src/Grav/Framework/Collection/FileCollectionInterface.php new file mode 100644 index 0000000..92ac164 --- /dev/null +++ b/system/src/Grav/Framework/Collection/FileCollectionInterface.php @@ -0,0 +1,33 @@ + + * @extends Selectable + */ +interface FileCollectionInterface extends CollectionInterface, Selectable +{ + public const INCLUDE_FILES = 1; + public const INCLUDE_FOLDERS = 2; + public const RECURSIVE = 4; + + /** + * @return string + */ + public function getPath(); +} diff --git a/system/src/Grav/Framework/Compat/Serializable.php b/system/src/Grav/Framework/Compat/Serializable.php new file mode 100644 index 0000000..a060fef --- /dev/null +++ b/system/src/Grav/Framework/Compat/Serializable.php @@ -0,0 +1,47 @@ +__serialize()); + } + + /** + * @param string $serialized + * @return void + */ + final public function unserialize($serialized): void + { + $this->__unserialize(unserialize($serialized, ['allowed_classes' => $this->getUnserializeAllowedClasses()])); + } + + /** + * @return array|bool + */ + protected function getUnserializeAllowedClasses() + { + return false; + } +} diff --git a/system/src/Grav/Framework/ContentBlock/ContentBlock.php b/system/src/Grav/Framework/ContentBlock/ContentBlock.php new file mode 100644 index 0000000..3ba8abe --- /dev/null +++ b/system/src/Grav/Framework/ContentBlock/ContentBlock.php @@ -0,0 +1,303 @@ +setContent('my inner content'); + * $outerBlock = ContentBlock::create(); + * $outerBlock->setContent(sprintf('Inside my outer block I have %s.', $innerBlock->getToken())); + * $outerBlock->addBlock($innerBlock); + * echo $outerBlock; + * + * @package Grav\Framework\ContentBlock + */ +class ContentBlock implements ContentBlockInterface +{ + use Serializable; + + /** @var int */ + protected $version = 1; + /** @var string */ + protected $id; + /** @var string */ + protected $tokenTemplate = '@@BLOCK-%s@@'; + /** @var string */ + protected $content = ''; + /** @var array */ + protected $blocks = []; + /** @var string */ + protected $checksum; + /** @var bool */ + protected $cached = true; + + /** + * @param string|null $id + * @return static + */ + public static function create($id = null) + { + return new static($id); + } + + /** + * @param array $serialized + * @return ContentBlockInterface + * @throws InvalidArgumentException + */ + public static function fromArray(array $serialized) + { + try { + $type = $serialized['_type'] ?? null; + $id = $serialized['id'] ?? null; + + if (!$type || !$id || !is_a($type, ContentBlockInterface::class, true)) { + throw new InvalidArgumentException('Bad data'); + } + + /** @var ContentBlockInterface $instance */ + $instance = new $type($id); + $instance->build($serialized); + } catch (Exception $e) { + throw new InvalidArgumentException(sprintf('Cannot unserialize Block: %s', $e->getMessage()), $e->getCode(), $e); + } + + return $instance; + } + + /** + * Block constructor. + * + * @param string|null $id + */ + public function __construct($id = null) + { + $this->id = $id ? (string) $id : $this->generateId(); + } + + /** + * @return string + */ + public function getId() + { + return $this->id; + } + + /** + * @return string + */ + public function getToken() + { + return sprintf($this->tokenTemplate, $this->getId()); + } + + /** + * @return array + */ + public function toArray() + { + $blocks = []; + /** @var ContentBlockInterface $block */ + foreach ($this->blocks as $block) { + $blocks[$block->getId()] = $block->toArray(); + } + + $array = [ + '_type' => get_class($this), + '_version' => $this->version, + 'id' => $this->id, + 'cached' => $this->cached + ]; + + if ($this->checksum) { + $array['checksum'] = $this->checksum; + } + + if ($this->content) { + $array['content'] = $this->content; + } + + if ($blocks) { + $array['blocks'] = $blocks; + } + + return $array; + } + + /** + * @return string + */ + public function toString() + { + if (!$this->blocks) { + return (string) $this->content; + } + + $tokens = []; + $replacements = []; + foreach ($this->blocks as $block) { + $tokens[] = $block->getToken(); + $replacements[] = $block->toString(); + } + + return str_replace($tokens, $replacements, (string) $this->content); + } + + /** + * @return string + */ + #[\ReturnTypeWillChange] + public function __toString() + { + try { + return $this->toString(); + } catch (Exception $e) { + return sprintf('Error while rendering block: %s', $e->getMessage()); + } + } + + /** + * @param array $serialized + * @return void + * @throws RuntimeException + */ + public function build(array $serialized) + { + $this->checkVersion($serialized); + + $this->id = $serialized['id'] ?? $this->generateId(); + $this->checksum = $serialized['checksum'] ?? null; + $this->cached = $serialized['cached'] ?? null; + + if (isset($serialized['content'])) { + $this->setContent($serialized['content']); + } + + $blocks = isset($serialized['blocks']) ? (array) $serialized['blocks'] : []; + foreach ($blocks as $block) { + $this->addBlock(self::fromArray($block)); + } + } + + /** + * @return bool + */ + public function isCached() + { + if (!$this->cached) { + return false; + } + + foreach ($this->blocks as $block) { + if (!$block->isCached()) { + return false; + } + } + + return true; + } + + /** + * @return $this + */ + public function disableCache() + { + $this->cached = false; + + return $this; + } + + /** + * @param string $checksum + * @return $this + */ + public function setChecksum($checksum) + { + $this->checksum = $checksum; + + return $this; + } + + /** + * @return string + */ + public function getChecksum() + { + return $this->checksum; + } + + /** + * @param string $content + * @return $this + */ + public function setContent($content) + { + $this->content = $content; + + return $this; + } + + /** + * @param ContentBlockInterface $block + * @return $this + */ + public function addBlock(ContentBlockInterface $block) + { + $this->blocks[$block->getId()] = $block; + + return $this; + } + + /** + * @return array + */ + final public function __serialize(): array + { + return $this->toArray(); + } + + /** + * @param array $data + * @return void + */ + final public function __unserialize(array $data): void + { + $this->build($data); + } + + /** + * @return string + */ + protected function generateId() + { + return uniqid('', true); + } + + /** + * @param array $serialized + * @return void + * @throws RuntimeException + */ + protected function checkVersion(array $serialized) + { + $version = isset($serialized['_version']) ? (int) $serialized['_version'] : 1; + if ($version !== $this->version) { + throw new RuntimeException(sprintf('Unsupported version %s', $version)); + } + } +} diff --git a/system/src/Grav/Framework/ContentBlock/ContentBlockInterface.php b/system/src/Grav/Framework/ContentBlock/ContentBlockInterface.php new file mode 100644 index 0000000..0a18cd0 --- /dev/null +++ b/system/src/Grav/Framework/ContentBlock/ContentBlockInterface.php @@ -0,0 +1,90 @@ +getAssetsFast(); + + $this->sortAssets($assets['styles']); + $this->sortAssets($assets['scripts']); + $this->sortAssets($assets['links']); + $this->sortAssets($assets['html']); + + return $assets; + } + + /** + * @return array + */ + public function getFrameworks() + { + $assets = $this->getAssetsFast(); + + return array_keys($assets['frameworks']); + } + + /** + * @param string $location + * @return array + */ + public function getStyles($location = 'head') + { + return $this->getAssetsInLocation('styles', $location); + } + + /** + * @param string $location + * @return array + */ + public function getScripts($location = 'head') + { + return $this->getAssetsInLocation('scripts', $location); + } + + /** + * @param string $location + * @return array + */ + public function getLinks($location = 'head') + { + return $this->getAssetsInLocation('links', $location); + } + + /** + * @param string $location + * @return array + */ + public function getHtml($location = 'bottom') + { + return $this->getAssetsInLocation('html', $location); + } + + /** + * @return array + */ + public function toArray() + { + $array = parent::toArray(); + + if ($this->frameworks) { + $array['frameworks'] = $this->frameworks; + } + if ($this->styles) { + $array['styles'] = $this->styles; + } + if ($this->scripts) { + $array['scripts'] = $this->scripts; + } + if ($this->links) { + $array['links'] = $this->links; + } + if ($this->html) { + $array['html'] = $this->html; + } + + return $array; + } + + /** + * @param array $serialized + * @return void + * @throws RuntimeException + */ + public function build(array $serialized) + { + parent::build($serialized); + + $this->frameworks = isset($serialized['frameworks']) ? (array) $serialized['frameworks'] : []; + $this->styles = isset($serialized['styles']) ? (array) $serialized['styles'] : []; + $this->scripts = isset($serialized['scripts']) ? (array) $serialized['scripts'] : []; + $this->links = isset($serialized['links']) ? (array) $serialized['links'] : []; + $this->html = isset($serialized['html']) ? (array) $serialized['html'] : []; + } + + /** + * @param string $framework + * @return $this + */ + public function addFramework($framework) + { + $this->frameworks[$framework] = 1; + + return $this; + } + + /** + * @param string|array $element + * @param int $priority + * @param string $location + * @return bool + * + * @example $block->addStyle('assets/js/my.js'); + * @example $block->addStyle(['href' => 'assets/js/my.js', 'media' => 'screen']); + */ + public function addStyle($element, $priority = 0, $location = 'head') + { + if (!is_array($element)) { + $element = ['href' => (string) $element]; + } + if (empty($element['href'])) { + return false; + } + if (!isset($this->styles[$location])) { + $this->styles[$location] = []; + } + + $id = !empty($element['id']) ? ['id' => (string) $element['id']] : []; + $href = $element['href']; + $type = !empty($element['type']) ? (string) $element['type'] : 'text/css'; + $media = !empty($element['media']) ? (string) $element['media'] : null; + unset( + $element['tag'], + $element['id'], + $element['rel'], + $element['content'], + $element['href'], + $element['type'], + $element['media'] + ); + + $this->styles[$location][md5($href) . sha1($href)] = [ + ':type' => 'file', + ':priority' => (int) $priority, + 'href' => $href, + 'type' => $type, + 'media' => $media, + 'element' => $element + ] + $id; + + return true; + } + + /** + * @param string|array $element + * @param int $priority + * @param string $location + * @return bool + */ + public function addInlineStyle($element, $priority = 0, $location = 'head') + { + if (!is_array($element)) { + $element = ['content' => (string) $element]; + } + if (empty($element['content'])) { + return false; + } + if (!isset($this->styles[$location])) { + $this->styles[$location] = []; + } + + $content = (string) $element['content']; + $type = !empty($element['type']) ? (string) $element['type'] : 'text/css'; + + unset($element['content'], $element['type']); + + $this->styles[$location][md5($content) . sha1($content)] = [ + ':type' => 'inline', + ':priority' => (int) $priority, + 'content' => $content, + 'type' => $type, + 'element' => $element + ]; + + return true; + } + + /** + * @param string|array $element + * @param int $priority + * @param string $location + * @return bool + */ + public function addScript($element, $priority = 0, $location = 'head') + { + if (!is_array($element)) { + $element = ['src' => (string) $element]; + } + if (empty($element['src'])) { + return false; + } + if (!isset($this->scripts[$location])) { + $this->scripts[$location] = []; + } + + $src = $element['src']; + $type = !empty($element['type']) ? (string) $element['type'] : 'text/javascript'; + $loading = !empty($element['loading']) ? (string) $element['loading'] : null; + $defer = !empty($element['defer']); + $async = !empty($element['async']); + $handle = !empty($element['handle']) ? (string) $element['handle'] : ''; + + unset($element['src'], $element['type'], $element['loading'], $element['defer'], $element['async'], $element['handle']); + + $this->scripts[$location][md5($src) . sha1($src)] = [ + ':type' => 'file', + ':priority' => (int) $priority, + 'src' => $src, + 'type' => $type, + 'loading' => $loading, + 'defer' => $defer, + 'async' => $async, + 'handle' => $handle, + 'element' => $element + ]; + + return true; + } + + /** + * @param string|array $element + * @param int $priority + * @param string $location + * @return bool + */ + public function addInlineScript($element, $priority = 0, $location = 'head') + { + if (!is_array($element)) { + $element = ['content' => (string) $element]; + } + if (empty($element['content'])) { + return false; + } + if (!isset($this->scripts[$location])) { + $this->scripts[$location] = []; + } + + $content = (string) $element['content']; + $type = !empty($element['type']) ? (string) $element['type'] : 'text/javascript'; + $loading = !empty($element['loading']) ? (string) $element['loading'] : null; + + unset($element['content'], $element['type'], $element['loading']); + + $this->scripts[$location][md5($content) . sha1($content)] = [ + ':type' => 'inline', + ':priority' => (int) $priority, + 'content' => $content, + 'type' => $type, + 'loading' => $loading, + 'element' => $element + ]; + + return true; + } + + /** + * @param string|array $element + * @param int $priority + * @param string $location + * @return bool + */ + public function addModule($element, $priority = 0, $location = 'head') + { + if (!is_array($element)) { + $element = ['src' => (string) $element]; + } + + $element['type'] = 'module'; + + return $this->addScript($element, $priority, $location); + } + + /** + * @param string|array $element + * @param int $priority + * @param string $location + * @return bool + */ + public function addInlineModule($element, $priority = 0, $location = 'head') + { + if (!is_array($element)) { + $element = ['content' => (string) $element]; + } + + $element['type'] = 'module'; + + return $this->addInlineScript($element, $priority, $location); + } + + /** + * @param array $element + * @param int $priority + * @param string $location + * @return bool + */ + public function addLink($element, $priority = 0, $location = 'head') + { + if (!is_array($element) || empty($element['rel']) || empty($element['href'])) { + return false; + } + + if (!isset($this->links[$location])) { + $this->links[$location] = []; + } + + $rel = (string) $element['rel']; + $href = (string) $element['href']; + + unset($element['rel'], $element['href']); + + $this->links[$location][md5($href) . sha1($href)] = [ + ':type' => 'file', + ':priority' => (int) $priority, + 'href' => $href, + 'rel' => $rel, + 'element' => $element, + ]; + + return true; + } + + /** + * @param string $html + * @param int $priority + * @param string $location + * @return bool + */ + public function addHtml($html, $priority = 0, $location = 'bottom') + { + if (empty($html) || !is_string($html)) { + return false; + } + if (!isset($this->html[$location])) { + $this->html[$location] = []; + } + + $this->html[$location][md5($html) . sha1($html)] = [ + ':priority' => (int) $priority, + 'html' => $html + ]; + + return true; + } + + /** + * @return array + */ + protected function getAssetsFast() + { + $assets = [ + 'frameworks' => $this->frameworks, + 'styles' => $this->styles, + 'scripts' => $this->scripts, + 'links' => $this->links, + 'html' => $this->html + ]; + + foreach ($this->blocks as $block) { + if ($block instanceof self) { + $blockAssets = $block->getAssetsFast(); + $assets['frameworks'] += $blockAssets['frameworks']; + + foreach ($blockAssets['styles'] as $location => $styles) { + if (!isset($assets['styles'][$location])) { + $assets['styles'][$location] = $styles; + } elseif ($styles) { + $assets['styles'][$location] += $styles; + } + } + + foreach ($blockAssets['scripts'] as $location => $scripts) { + if (!isset($assets['scripts'][$location])) { + $assets['scripts'][$location] = $scripts; + } elseif ($scripts) { + $assets['scripts'][$location] += $scripts; + } + } + + foreach ($blockAssets['links'] as $location => $links) { + if (!isset($assets['links'][$location])) { + $assets['links'][$location] = $links; + } elseif ($links) { + $assets['links'][$location] += $links; + } + } + + foreach ($blockAssets['html'] as $location => $htmls) { + if (!isset($assets['html'][$location])) { + $assets['html'][$location] = $htmls; + } elseif ($htmls) { + $assets['html'][$location] += $htmls; + } + } + } + } + + return $assets; + } + + /** + * @param string $type + * @param string $location + * @return array + */ + protected function getAssetsInLocation($type, $location) + { + $assets = $this->getAssetsFast(); + + if (empty($assets[$type][$location])) { + return []; + } + + $styles = $assets[$type][$location]; + $this->sortAssetsInLocation($styles); + + return $styles; + } + + /** + * @param array $items + * @return void + */ + protected function sortAssetsInLocation(array &$items) + { + $count = 0; + foreach ($items as &$item) { + $item[':order'] = ++$count; + } + unset($item); + + uasort( + $items, + static function ($a, $b) { + return $a[':priority'] <=> $b[':priority'] ?: $a[':order'] <=> $b[':order']; + } + ); + } + + /** + * @param array $array + * @return void + */ + protected function sortAssets(array &$array) + { + foreach ($array as &$items) { + $this->sortAssetsInLocation($items); + } + } +} diff --git a/system/src/Grav/Framework/ContentBlock/HtmlBlockInterface.php b/system/src/Grav/Framework/ContentBlock/HtmlBlockInterface.php new file mode 100644 index 0000000..f619607 --- /dev/null +++ b/system/src/Grav/Framework/ContentBlock/HtmlBlockInterface.php @@ -0,0 +1,130 @@ +addStyle('assets/js/my.js'); + * @example $block->addStyle(['href' => 'assets/js/my.js', 'media' => 'screen']); + */ + public function addStyle($element, $priority = 0, $location = 'head'); + + /** + * @param string|array $element + * @param int $priority + * @param string $location + * @return bool + */ + public function addInlineStyle($element, $priority = 0, $location = 'head'); + + /** + * @param string|array $element + * @param int $priority + * @param string $location + * @return bool + */ + public function addScript($element, $priority = 0, $location = 'head'); + + /** + * @param string|array $element + * @param int $priority + * @param string $location + * @return bool + */ + public function addInlineScript($element, $priority = 0, $location = 'head'); + + + /** + * Shortcut for writing addScript(['type' => 'module', 'src' => ...]). + * + * @param string|array $element + * @param int $priority + * @param string $location + * @return bool + */ + public function addModule($element, $priority = 0, $location = 'head'); + + /** + * Shortcut for writing addInlineScript(['type' => 'module', 'content' => ...]). + * + * @param string|array $element + * @param int $priority + * @param string $location + * @return bool + */ + public function addInlineModule($element, $priority = 0, $location = 'head'); + + /** + * @param array $element + * @param int $priority + * @param string $location + * @return bool + */ + public function addLink($element, $priority = 0, $location = 'head'); + + /** + * @param string $html + * @param int $priority + * @param string $location + * @return bool + */ + public function addHtml($html, $priority = 0, $location = 'bottom'); +} diff --git a/system/src/Grav/Framework/Contracts/Media/MediaObjectInterface.php b/system/src/Grav/Framework/Contracts/Media/MediaObjectInterface.php new file mode 100644 index 0000000..75b80f0 --- /dev/null +++ b/system/src/Grav/Framework/Contracts/Media/MediaObjectInterface.php @@ -0,0 +1,52 @@ +|ArrayAccess + * @phpstan-pure + */ + public function getIdentifierMeta(); +} diff --git a/system/src/Grav/Framework/Contracts/Relationships/RelationshipInterface.php b/system/src/Grav/Framework/Contracts/Relationships/RelationshipInterface.php new file mode 100644 index 0000000..c0a7edf --- /dev/null +++ b/system/src/Grav/Framework/Contracts/Relationships/RelationshipInterface.php @@ -0,0 +1,81 @@ + + */ +interface RelationshipInterface extends Countable, IteratorAggregate, JsonSerializable, Serializable +{ + /** + * @return string + * @phpstan-pure + */ + public function getName(): string; + + /** + * @return string + * @phpstan-pure + */ + public function getType(): string; + + /** + * @return bool + * @phpstan-pure + */ + public function isModified(): bool; + + /** + * @return string + * @phpstan-pure + */ + public function getCardinality(): string; + + /** + * @return P + * @phpstan-pure + */ + public function getParent(): IdentifierInterface; + + /** + * @param string $id + * @param string|null $type + * @return bool + * @phpstan-pure + */ + public function has(string $id, string $type = null): bool; + + /** + * @param T $identifier + * @return bool + * @phpstan-pure + */ + public function hasIdentifier(IdentifierInterface $identifier): bool; + + /** + * @param T $identifier + * @return bool + */ + public function addIdentifier(IdentifierInterface $identifier): bool; + + /** + * @param T|null $identifier + * @return bool + */ + public function removeIdentifier(IdentifierInterface $identifier = null): bool; + + /** + * @return iterable + */ + public function getIterator(): iterable; +} diff --git a/system/src/Grav/Framework/Contracts/Relationships/RelationshipsInterface.php b/system/src/Grav/Framework/Contracts/Relationships/RelationshipsInterface.php new file mode 100644 index 0000000..4bd90a3 --- /dev/null +++ b/system/src/Grav/Framework/Contracts/Relationships/RelationshipsInterface.php @@ -0,0 +1,53 @@ +> + * @extends Iterator> + */ +interface RelationshipsInterface extends Countable, ArrayAccess, Iterator, JsonSerializable +{ + /** + * @return bool + * @phpstan-pure + */ + public function isModified(): bool; + + /** + * @return array + */ + public function getModified(): array; + + /** + * @return int + * @phpstan-pure + */ + public function count(): int; + + /** + * @param string $offset + * @return RelationshipInterface|null + */ + public function offsetGet($offset): ?RelationshipInterface; + + /** + * @return RelationshipInterface|null + */ + public function current(): ?RelationshipInterface; + + /** + * @return string + * @phpstan-pure + */ + public function key(): string; +} diff --git a/system/src/Grav/Framework/Contracts/Relationships/ToManyRelationshipInterface.php b/system/src/Grav/Framework/Contracts/Relationships/ToManyRelationshipInterface.php new file mode 100644 index 0000000..723bef6 --- /dev/null +++ b/system/src/Grav/Framework/Contracts/Relationships/ToManyRelationshipInterface.php @@ -0,0 +1,55 @@ + + */ +interface ToManyRelationshipInterface extends RelationshipInterface +{ + /** + * @param positive-int $pos + * @return IdentifierInterface|null + */ + public function getNthIdentifier(int $pos): ?IdentifierInterface; + + /** + * @param string $id + * @param string|null $type + * @return T|null + * @phpstan-pure + */ + public function getIdentifier(string $id, string $type = null): ?IdentifierInterface; + + /** + * @param string $id + * @param string|null $type + * @return T|null + * @phpstan-pure + */ + public function getObject(string $id, string $type = null): ?object; + + /** + * @param iterable $identifiers + * @return bool + */ + public function addIdentifiers(iterable $identifiers): bool; + + /** + * @param iterable $identifiers + * @return bool + */ + public function replaceIdentifiers(iterable $identifiers): bool; + + /** + * @param iterable $identifiers + * @return bool + */ + public function removeIdentifiers(iterable $identifiers): bool; +} diff --git a/system/src/Grav/Framework/Contracts/Relationships/ToOneRelationshipInterface.php b/system/src/Grav/Framework/Contracts/Relationships/ToOneRelationshipInterface.php new file mode 100644 index 0000000..0e6aeb9 --- /dev/null +++ b/system/src/Grav/Framework/Contracts/Relationships/ToOneRelationshipInterface.php @@ -0,0 +1,37 @@ + + */ +interface ToOneRelationshipInterface extends RelationshipInterface +{ + /** + * @param string|null $id + * @param string|null $type + * @return T|null + * @phpstan-pure + */ + public function getIdentifier(string $id = null, string $type = null): ?IdentifierInterface; + + /** + * @param string|null $id + * @param string|null $type + * @return T|null + * @phpstan-pure + */ + public function getObject(string $id = null, string $type = null): ?object; + + /** + * @param T|null $identifier + * @return bool + */ + public function replaceIdentifier(IdentifierInterface $identifier = null): bool; +} diff --git a/system/src/Grav/Framework/Controller/Traits/ControllerResponseTrait.php b/system/src/Grav/Framework/Controller/Traits/ControllerResponseTrait.php new file mode 100644 index 0000000..0840283 --- /dev/null +++ b/system/src/Grav/Framework/Controller/Traits/ControllerResponseTrait.php @@ -0,0 +1,307 @@ + 599) { + $code = 500; + } + $headers = $headers ?? []; + + return new Response($code, $headers, $content); + } + + /** + * @param array $content + * @param int|null $code + * @param array|null $headers + * @return Response + */ + protected function createJsonResponse(array $content, int $code = null, array $headers = null): ResponseInterface + { + $code = $code ?? $content['code'] ?? 200; + if (null === $code || $code < 100 || $code > 599) { + $code = 200; + } + $headers = ($headers ?? []) + [ + 'Content-Type' => 'application/json', + 'Cache-Control' => 'no-store, max-age=0' + ]; + + return new Response($code, $headers, json_encode($content)); + } + + /** + * @param string $filename + * @param string|resource|StreamInterface $resource + * @param array|null $headers + * @param array|null $options + * @return ResponseInterface + */ + protected function createDownloadResponse(string $filename, $resource, array $headers = null, array $options = null): ResponseInterface + { + // Required for IE, otherwise Content-Disposition may be ignored + if (ini_get('zlib.output_compression')) { + @ini_set('zlib.output_compression', 'Off'); + } + + $headers = $headers ?? []; + $options = $options ?? ['force_download' => true]; + + $file_parts = Utils::pathinfo($filename); + + if (!isset($headers['Content-Type'])) { + $mimetype = Utils::getMimeByExtension($file_parts['extension']); + + $headers['Content-Type'] = $mimetype; + } + + // TODO: add multipart download support. + //$headers['Accept-Ranges'] = 'bytes'; + + if (!empty($options['force_download'])) { + $headers['Content-Disposition'] = 'attachment; filename="' . $file_parts['basename'] . '"'; + } + + if (!isset($headers['Content-Length'])) { + $realpath = realpath($filename); + if ($realpath) { + $headers['Content-Length'] = filesize($realpath); + } + } + + $headers += [ + 'Expires' => 'Mon, 26 Jul 1997 05:00:00 GMT', + 'Last-Modified' => gmdate('D, d M Y H:i:s') . ' GMT', + 'Cache-Control' => 'no-store, no-cache, must-revalidate', + 'Pragma' => 'no-cache' + ]; + + return new Response(200, $headers, $resource); + } + + /** + * @param string $url + * @param int|null $code + * @return Response + */ + protected function createRedirectResponse(string $url, int $code = null): ResponseInterface + { + if (null === $code || $code < 301 || $code > 307) { + $code = (int)$this->getConfig()->get('system.pages.redirect_default_code', 302); + } + + $ext = Utils::pathinfo($url, PATHINFO_EXTENSION); + $accept = $this->getAccept(['application/json', 'text/html']); + if ($ext === 'json' || $accept === 'application/json') { + return $this->createJsonResponse(['code' => $code, 'status' => 'redirect', 'redirect' => $url]); + } + + return new Response($code, ['Location' => $url]); + } + + /** + * @param Throwable $e + * @return ResponseInterface + */ + protected function createErrorResponse(Throwable $e): ResponseInterface + { + $response = $this->getErrorJson($e); + $message = $response['message']; + $code = $response['code']; + $reason = $e instanceof RequestException ? $e->getHttpReason() : null; + $accept = $this->getAccept(['application/json', 'text/html']); + + $request = $this->getRequest(); + $context = $request->getAttributes(); + + /** @var Route $route */ + $route = $context['route'] ?? null; + + $ext = $route ? $route->getExtension() : null; + if ($ext !== 'json' && $accept === 'text/html') { + $method = $request->getMethod(); + + // On POST etc, redirect back to the previous page. + if ($method !== 'GET' && $method !== 'HEAD') { + $this->setMessage($message, 'error'); + $referer = $request->getHeaderLine('Referer'); + + return $this->createRedirectResponse($referer, 303); + } + + // TODO: improve error page + return $this->createHtmlResponse($response['message'], $code); + } + + return new Response($code, ['Content-Type' => 'application/json'], json_encode($response), '1.1', $reason); + } + + /** + * @param Throwable $e + * @return ResponseInterface + */ + protected function createJsonErrorResponse(Throwable $e): ResponseInterface + { + $response = $this->getErrorJson($e); + $reason = $e instanceof RequestException ? $e->getHttpReason() : null; + + return new Response($response['code'], ['Content-Type' => 'application/json'], json_encode($response), '1.1', $reason); + } + + /** + * @param Throwable $e + * @return array + */ + protected function getErrorJson(Throwable $e): array + { + $code = $this->getErrorCode($e instanceof RequestException ? $e->getHttpCode() : $e->getCode()); + if ($e instanceof ValidationException) { + $message = $e->getMessage(); + } else { + $message = htmlspecialchars($e->getMessage(), ENT_QUOTES | ENT_HTML5, 'UTF-8'); + } + + $extra = $e instanceof JsonSerializable ? $e->jsonSerialize() : []; + + $response = [ + 'code' => $code, + 'status' => 'error', + 'message' => $message, + 'redirect' => null, + 'error' => [ + 'code' => $code, + 'message' => $message + ] + $extra + ]; + + /** @var Debugger $debugger */ + $debugger = Grav::instance()['debugger']; + if ($debugger->enabled()) { + $response['error'] += [ + 'type' => get_class($e), + 'file' => $e->getFile(), + 'line' => $e->getLine(), + 'trace' => explode("\n", $e->getTraceAsString()) + ]; + } + + return $response; + } + + /** + * @param int $code + * @return int + */ + protected function getErrorCode(int $code): int + { + static $errorCodes = [ + 400, 401, 402, 403, 404, 405, 406, 407, 408, 409, 410, 411, 412, 413, 414, 415, 416, 417, 418, + 422, 423, 424, 425, 426, 428, 429, 431, 451, 500, 501, 502, 503, 504, 505, 506, 507, 508, 511 + ]; + + if (!in_array($code, $errorCodes, true)) { + $code = 500; + } + + return $code; + } + + /** + * @param array $compare + * @return mixed + */ + protected function getAccept(array $compare) + { + $accepted = []; + foreach ($this->getRequest()->getHeader('Accept') as $accept) { + foreach (explode(',', $accept) as $item) { + if (!$item) { + continue; + } + + $split = explode(';q=', $item); + $mime = array_shift($split); + $priority = array_shift($split) ?? 1.0; + + $accepted[$mime] = $priority; + } + } + + arsort($accepted); + + // TODO: add support for image/* etc + $list = array_intersect($compare, array_keys($accepted)); + if (!$list && (isset($accepted['*/*']) || isset($accepted['*']))) { + return reset($compare); + } + + return reset($list); + } + + /** + * @return ServerRequestInterface + */ + abstract protected function getRequest(): ServerRequestInterface; + + /** + * @param string $message + * @param string $type + * @return $this + */ + abstract protected function setMessage(string $message, string $type = 'info'); + + /** + * @return Config + */ + abstract protected function getConfig(): Config; +} diff --git a/system/src/Grav/Framework/DI/Container.php b/system/src/Grav/Framework/DI/Container.php new file mode 100644 index 0000000..45d0384 --- /dev/null +++ b/system/src/Grav/Framework/DI/Container.php @@ -0,0 +1,35 @@ +offsetGet($id); + } + + /** + * @param string $id + * @return bool + */ + public function has($id): bool + { + return $this->offsetExists($id); + } +} diff --git a/system/src/Grav/Framework/File/AbstractFile.php b/system/src/Grav/Framework/File/AbstractFile.php new file mode 100644 index 0000000..e81c419 --- /dev/null +++ b/system/src/Grav/Framework/File/AbstractFile.php @@ -0,0 +1,444 @@ +filesystem = $filesystem ?? Filesystem::getInstance(); + $this->setFilepath($filepath); + } + + /** + * Unlock file when the object gets destroyed. + */ + #[\ReturnTypeWillChange] + public function __destruct() + { + if ($this->isLocked()) { + $this->unlock(); + } + } + + /** + * @return void + */ + #[\ReturnTypeWillChange] + public function __clone() + { + $this->handle = null; + $this->locked = false; + } + + /** + * @return array + */ + final public function __serialize(): array + { + return ['filesystem_normalize' => $this->filesystem->getNormalization()] + $this->doSerialize(); + } + + /** + * @param array $data + * @return void + */ + final public function __unserialize(array $data): void + { + $this->filesystem = Filesystem::getInstance($data['filesystem_normalize'] ?? null); + + $this->doUnserialize($data); + } + + /** + * {@inheritdoc} + * @see FileInterface::getFilePath() + */ + public function getFilePath(): string + { + return $this->filepath; + } + + /** + * {@inheritdoc} + * @see FileInterface::getPath() + */ + public function getPath(): string + { + if (null === $this->path) { + $this->setPathInfo(); + } + + return $this->path ?? ''; + } + + /** + * {@inheritdoc} + * @see FileInterface::getFilename() + */ + public function getFilename(): string + { + if (null === $this->filename) { + $this->setPathInfo(); + } + + return $this->filename ?? ''; + } + + /** + * {@inheritdoc} + * @see FileInterface::getBasename() + */ + public function getBasename(): string + { + if (null === $this->basename) { + $this->setPathInfo(); + } + + return $this->basename ?? ''; + } + + /** + * {@inheritdoc} + * @see FileInterface::getExtension() + */ + public function getExtension(bool $withDot = false): string + { + if (null === $this->extension) { + $this->setPathInfo(); + } + + return ($withDot ? '.' : '') . $this->extension; + } + + /** + * {@inheritdoc} + * @see FileInterface::exists() + */ + public function exists(): bool + { + return is_file($this->filepath); + } + + /** + * {@inheritdoc} + * @see FileInterface::getCreationTime() + */ + public function getCreationTime(): int + { + return is_file($this->filepath) ? (int)filectime($this->filepath) : time(); + } + + /** + * {@inheritdoc} + * @see FileInterface::getModificationTime() + */ + public function getModificationTime(): int + { + return is_file($this->filepath) ? (int)filemtime($this->filepath) : time(); + } + + /** + * {@inheritdoc} + * @see FileInterface::lock() + */ + public function lock(bool $block = true): bool + { + if (!$this->handle) { + if (!$this->mkdir($this->getPath())) { + throw new RuntimeException('Creating directory failed for ' . $this->filepath); + } + $this->handle = @fopen($this->filepath, 'cb+') ?: null; + if (!$this->handle) { + $error = error_get_last(); + $message = $error['message'] ?? 'Unknown error'; + + throw new RuntimeException("Opening file for writing failed on error {$message}"); + } + } + + $lock = $block ? LOCK_EX : LOCK_EX | LOCK_NB; + + // Some filesystems do not support file locks, only fail if another process holds the lock. + $this->locked = flock($this->handle, $lock, $wouldBlock) || !$wouldBlock; + + return $this->locked; + } + + /** + * {@inheritdoc} + * @see FileInterface::unlock() + */ + public function unlock(): bool + { + if (!$this->handle) { + return false; + } + + if ($this->locked) { + flock($this->handle, LOCK_UN | LOCK_NB); + $this->locked = false; + } + + fclose($this->handle); + $this->handle = null; + + return true; + } + + /** + * {@inheritdoc} + * @see FileInterface::isLocked() + */ + public function isLocked(): bool + { + return $this->locked; + } + + /** + * {@inheritdoc} + * @see FileInterface::isReadable() + */ + public function isReadable(): bool + { + return is_readable($this->filepath) && is_file($this->filepath); + } + + /** + * {@inheritdoc} + * @see FileInterface::isWritable() + */ + public function isWritable(): bool + { + if (!file_exists($this->filepath)) { + return $this->isWritablePath($this->getPath()); + } + + return is_writable($this->filepath) && is_file($this->filepath); + } + + /** + * {@inheritdoc} + * @see FileInterface::load() + */ + public function load() + { + return file_get_contents($this->filepath); + } + + /** + * {@inheritdoc} + * @see FileInterface::save() + */ + public function save($data): void + { + $filepath = $this->filepath; + $dir = $this->getPath(); + + if (!$this->mkdir($dir)) { + throw new RuntimeException('Creating directory failed for ' . $filepath); + } + + try { + if ($this->handle) { + $tmp = true; + // As we are using non-truncating locking, make sure that the file is empty before writing. + if (@ftruncate($this->handle, 0) === false || @fwrite($this->handle, $data) === false) { + // Writing file failed, throw an error. + $tmp = false; + } + } else { + // Support for symlinks. + $realpath = is_link($filepath) ? realpath($filepath) : $filepath; + if ($realpath === false) { + throw new RuntimeException('Failed to save file ' . $filepath); + } + + // Create file with a temporary name and rename it to make the save action atomic. + $tmp = $this->tempname($realpath); + if (@file_put_contents($tmp, $data) === false) { + $tmp = false; + } elseif (@rename($tmp, $realpath) === false) { + @unlink($tmp); + $tmp = false; + } + } + } catch (Exception $e) { + $tmp = false; + } + + if ($tmp === false) { + throw new RuntimeException('Failed to save file ' . $filepath); + } + + // Touch the directory as well, thus marking it modified. + @touch($dir); + } + + /** + * {@inheritdoc} + * @see FileInterface::rename() + */ + public function rename(string $path): bool + { + if ($this->exists() && !@rename($this->filepath, $path)) { + return false; + } + + $this->setFilepath($path); + + return true; + } + + /** + * {@inheritdoc} + * @see FileInterface::delete() + */ + public function delete(): bool + { + return @unlink($this->filepath); + } + + /** + * @param string $dir + * @return bool + * @throws RuntimeException + * @internal + */ + protected function mkdir(string $dir): bool + { + // Silence error for open_basedir; should fail in mkdir instead. + if (@is_dir($dir)) { + return true; + } + + $success = @mkdir($dir, 0777, true); + + if (!$success) { + // Take yet another look, make sure that the folder doesn't exist. + clearstatcache(true, $dir); + if (!@is_dir($dir)) { + return false; + } + } + + return true; + } + + /** + * @return array + */ + protected function doSerialize(): array + { + return [ + 'filepath' => $this->filepath + ]; + } + + /** + * @param array $serialized + * @return void + */ + protected function doUnserialize(array $serialized): void + { + $this->setFilepath($serialized['filepath']); + } + + /** + * @param string $filepath + */ + protected function setFilepath(string $filepath): void + { + $this->filepath = $filepath; + $this->filename = null; + $this->basename = null; + $this->path = null; + $this->extension = null; + } + + protected function setPathInfo(): void + { + /** @var array $pathInfo */ + $pathInfo = $this->filesystem->pathinfo($this->filepath); + + $this->filename = $pathInfo['filename'] ?? null; + $this->basename = $pathInfo['basename'] ?? null; + $this->path = $pathInfo['dirname'] ?? null; + $this->extension = $pathInfo['extension'] ?? null; + } + + /** + * @param string $dir + * @return bool + * @internal + */ + protected function isWritablePath(string $dir): bool + { + if ($dir === '') { + return false; + } + + if (!file_exists($dir)) { + // Recursively look up in the directory tree. + return $this->isWritablePath($this->filesystem->parent($dir)); + } + + return is_dir($dir) && is_writable($dir); + } + + /** + * @param string $filename + * @param int $length + * @return string + */ + protected function tempname(string $filename, int $length = 5) + { + do { + $test = $filename . substr(str_shuffle('0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ'), 0, $length); + } while (file_exists($test)); + + return $test; + } +} diff --git a/system/src/Grav/Framework/File/CsvFile.php b/system/src/Grav/Framework/File/CsvFile.php new file mode 100644 index 0000000..543a792 --- /dev/null +++ b/system/src/Grav/Framework/File/CsvFile.php @@ -0,0 +1,40 @@ +formatter = $formatter; + } + + /** + * {@inheritdoc} + * @see FileInterface::load() + */ + public function load() + { + $raw = parent::load(); + + try { + if (!is_string($raw)) { + throw new RuntimeException('Bad Data'); + } + + return $this->formatter->decode($raw); + } catch (RuntimeException $e) { + throw new RuntimeException(sprintf("Failed to load file '%s': %s", $this->getFilePath(), $e->getMessage()), $e->getCode(), $e); + } + } + + /** + * {@inheritdoc} + * @see FileInterface::save() + */ + public function save($data): void + { + if (is_string($data)) { + // Make sure that the string is valid data. + try { + $this->formatter->decode($data); + } catch (RuntimeException $e) { + throw new RuntimeException(sprintf("Failed to save file '%s': %s", $this->getFilePath(), $e->getMessage()), $e->getCode(), $e); + } + $encoded = $data; + } else { + $encoded = $this->formatter->encode($data); + } + + parent::save($encoded); + } +} diff --git a/system/src/Grav/Framework/File/File.php b/system/src/Grav/Framework/File/File.php new file mode 100644 index 0000000..578b28e --- /dev/null +++ b/system/src/Grav/Framework/File/File.php @@ -0,0 +1,35 @@ +config = $config; + } + + /** + * @return string + */ + public function getMimeType(): string + { + $mime = $this->getConfig('mime'); + + return is_string($mime) ? $mime : 'application/octet-stream'; + } + + /** + * {@inheritdoc} + * @see FileFormatterInterface::getDefaultFileExtension() + */ + public function getDefaultFileExtension(): string + { + $extensions = $this->getSupportedFileExtensions(); + + // Call fails on bad configuration. + return reset($extensions) ?: ''; + } + + /** + * {@inheritdoc} + * @see FileFormatterInterface::getSupportedFileExtensions() + */ + public function getSupportedFileExtensions(): array + { + $extensions = $this->getConfig('file_extension'); + + // Call fails on bad configuration. + return is_string($extensions) ? [$extensions] : $extensions; + } + + /** + * {@inheritdoc} + * @see FileFormatterInterface::encode() + */ + abstract public function encode($data): string; + + /** + * {@inheritdoc} + * @see FileFormatterInterface::decode() + */ + abstract public function decode($data); + + + /** + * @return array + */ + public function __serialize(): array + { + return ['config' => $this->config]; + } + + /** + * @param array $data + * @return void + */ + public function __unserialize(array $data): void + { + $this->config = $data['config']; + } + + /** + * Get either full configuration or a single option. + * + * @param string|null $name Configuration option (optional) + * @return mixed + */ + protected function getConfig(string $name = null) + { + if (null !== $name) { + return $this->config[$name] ?? null; + } + + return $this->config; + } +} diff --git a/system/src/Grav/Framework/File/Formatter/CsvFormatter.php b/system/src/Grav/Framework/File/Formatter/CsvFormatter.php new file mode 100644 index 0000000..9bdd662 --- /dev/null +++ b/system/src/Grav/Framework/File/Formatter/CsvFormatter.php @@ -0,0 +1,170 @@ + ['.csv', '.tsv'], + 'delimiter' => ',', + 'mime' => 'text/x-csv' + ]; + + parent::__construct($config); + } + + /** + * Returns delimiter used to both encode and decode CSV. + * + * @return string + */ + public function getDelimiter(): string + { + // Call fails on bad configuration. + return $this->getConfig('delimiter'); + } + + /** + * @param array $data + * @param string|null $delimiter + * @return string + * @see FileFormatterInterface::encode() + */ + public function encode($data, $delimiter = null): string + { + if (count($data) === 0) { + return ''; + } + $delimiter = $delimiter ?? $this->getDelimiter(); + $header = array_keys(reset($data)); + + // Encode the field names + $string = $this->encodeLine($header, $delimiter); + + // Encode the data + foreach ($data as $row) { + $string .= $this->encodeLine($row, $delimiter); + } + + return $string; + } + + /** + * @param string $data + * @param string|null $delimiter + * @return array + * @see FileFormatterInterface::decode() + */ + public function decode($data, $delimiter = null): array + { + $delimiter = $delimiter ?? $this->getDelimiter(); + $lines = preg_split('/\r\n|\r|\n/', $data); + if ($lines === false) { + throw new RuntimeException('Decoding CSV failed'); + } + + // Get the field names + $headerStr = array_shift($lines); + if (!$headerStr) { + throw new RuntimeException('CSV header missing'); + } + + $header = str_getcsv($headerStr, $delimiter); + + // Allow for replacing a null string with null/empty value + $null_replace = $this->getConfig('null'); + + // Get the data + $list = []; + $line = null; + try { + foreach ($lines as $line) { + if (!empty($line)) { + $csv_line = str_getcsv($line, $delimiter); + + if ($null_replace) { + array_walk($csv_line, static function (&$el) use ($null_replace) { + $el = str_replace($null_replace, "\0", $el); + }); + } + + $list[] = array_combine($header, $csv_line); + } + } + } catch (Exception $e) { + throw new RuntimeException('Badly formatted CSV line: ' . $line); + } + + return $list; + } + + /** + * @param array $line + * @param string $delimiter + * @return string + */ + protected function encodeLine(array $line, string $delimiter): string + { + foreach ($line as $key => &$value) { + // Oops, we need to convert the line to a string. + if (!is_scalar($value)) { + if (is_array($value) || $value instanceof JsonSerializable || $value instanceof stdClass) { + $value = json_encode($value); + } elseif (is_object($value)) { + if (method_exists($value, 'toJson')) { + $value = $value->toJson(); + } elseif (method_exists($value, 'toArray')) { + $value = json_encode($value->toArray()); + } + } + } + + $value = $this->escape((string)$value); + } + unset($value); + + return implode($delimiter, $line). "\n"; + } + + /** + * @param string $value + * @return string + */ + protected function escape(string $value) + { + if (preg_match('/[,"\r\n]/u', $value)) { + $value = '"' . preg_replace('/"/', '""', $value) . '"'; + } + + return $value; + } +} diff --git a/system/src/Grav/Framework/File/Formatter/FormatterInterface.php b/system/src/Grav/Framework/File/Formatter/FormatterInterface.php new file mode 100644 index 0000000..757e229 --- /dev/null +++ b/system/src/Grav/Framework/File/Formatter/FormatterInterface.php @@ -0,0 +1,12 @@ + '.ini' + ]; + + parent::__construct($config); + } + + /** + * {@inheritdoc} + * @see FileFormatterInterface::encode() + */ + public function encode($data): string + { + $string = ''; + foreach ($data as $key => $value) { + $string .= $key . '="' . preg_replace( + ['/"/', '/\\\/', "/\t/", "/\n/", "/\r/"], + ['\"', '\\\\', '\t', '\n', '\r'], + $value + ) . "\"\n"; + } + + return $string; + } + + /** + * {@inheritdoc} + * @see FileFormatterInterface::decode() + */ + public function decode($data): array + { + $decoded = @parse_ini_string($data); + + if ($decoded === false) { + throw new RuntimeException('Decoding INI failed'); + } + + return $decoded; + } +} diff --git a/system/src/Grav/Framework/File/Formatter/JsonFormatter.php b/system/src/Grav/Framework/File/Formatter/JsonFormatter.php new file mode 100644 index 0000000..972958a --- /dev/null +++ b/system/src/Grav/Framework/File/Formatter/JsonFormatter.php @@ -0,0 +1,170 @@ + JSON_FORCE_OBJECT, + 'JSON_HEX_QUOT' => JSON_HEX_QUOT, + 'JSON_HEX_TAG' => JSON_HEX_TAG, + 'JSON_HEX_AMP' => JSON_HEX_AMP, + 'JSON_HEX_APOS' => JSON_HEX_APOS, + 'JSON_INVALID_UTF8_IGNORE' => JSON_INVALID_UTF8_IGNORE, + 'JSON_INVALID_UTF8_SUBSTITUTE' => JSON_INVALID_UTF8_SUBSTITUTE, + 'JSON_NUMERIC_CHECK' => JSON_NUMERIC_CHECK, + 'JSON_PARTIAL_OUTPUT_ON_ERROR' => JSON_PARTIAL_OUTPUT_ON_ERROR, + 'JSON_PRESERVE_ZERO_FRACTION' => JSON_PRESERVE_ZERO_FRACTION, + 'JSON_PRETTY_PRINT' => JSON_PRETTY_PRINT, + 'JSON_UNESCAPED_LINE_TERMINATORS' => JSON_UNESCAPED_LINE_TERMINATORS, + 'JSON_UNESCAPED_SLASHES' => JSON_UNESCAPED_SLASHES, + 'JSON_UNESCAPED_UNICODE' => JSON_UNESCAPED_UNICODE, + //'JSON_THROW_ON_ERROR' => JSON_THROW_ON_ERROR // PHP 7.3 + ]; + + /** @var array */ + protected $decodeOptions = [ + 'JSON_BIGINT_AS_STRING' => JSON_BIGINT_AS_STRING, + 'JSON_INVALID_UTF8_IGNORE' => JSON_INVALID_UTF8_IGNORE, + 'JSON_INVALID_UTF8_SUBSTITUTE' => JSON_INVALID_UTF8_SUBSTITUTE, + 'JSON_OBJECT_AS_ARRAY' => JSON_OBJECT_AS_ARRAY, + //'JSON_THROW_ON_ERROR' => JSON_THROW_ON_ERROR // PHP 7.3 + ]; + + public function __construct(array $config = []) + { + $config += [ + 'file_extension' => '.json', + 'encode_options' => 0, + 'decode_assoc' => true, + 'decode_depth' => 512, + 'decode_options' => 0 + ]; + + parent::__construct($config); + } + + /** + * Returns options used in encode() function. + * + * @return int + */ + public function getEncodeOptions(): int + { + $options = $this->getConfig('encode_options'); + if (!is_int($options)) { + if (is_string($options)) { + $list = preg_split('/[\s,|]+/', $options); + $options = 0; + if ($list) { + foreach ($list as $option) { + if (isset($this->encodeOptions[$option])) { + $options += $this->encodeOptions[$option]; + } + } + } + } else { + $options = 0; + } + } + + return $options; + } + + /** + * Returns options used in decode() function. + * + * @return int + */ + public function getDecodeOptions(): int + { + $options = $this->getConfig('decode_options'); + if (!is_int($options)) { + if (is_string($options)) { + $list = preg_split('/[\s,|]+/', $options); + $options = 0; + if ($list) { + foreach ($list as $option) { + if (isset($this->decodeOptions[$option])) { + $options += $this->decodeOptions[$option]; + } + } + } + } else { + $options = 0; + } + } + + return $options; + } + + /** + * Returns recursion depth used in decode() function. + * + * @return int + * @phpstan-return positive-int + */ + public function getDecodeDepth(): int + { + return $this->getConfig('decode_depth'); + } + + /** + * Returns true if JSON objects will be converted into associative arrays. + * + * @return bool + */ + public function getDecodeAssoc(): bool + { + return $this->getConfig('decode_assoc'); + } + + /** + * {@inheritdoc} + * @see FileFormatterInterface::encode() + */ + public function encode($data): string + { + $encoded = @json_encode($data, $this->getEncodeOptions()); + + if ($encoded === false && json_last_error() !== JSON_ERROR_NONE) { + throw new RuntimeException('Encoding JSON failed: ' . json_last_error_msg()); + } + + return $encoded ?: ''; + } + + /** + * {@inheritdoc} + * @see FileFormatterInterface::decode() + */ + public function decode($data) + { + $decoded = @json_decode($data, $this->getDecodeAssoc(), $this->getDecodeDepth(), $this->getDecodeOptions()); + + if (null === $decoded && json_last_error() !== JSON_ERROR_NONE) { + throw new RuntimeException('Decoding JSON failed: ' . json_last_error_msg()); + } + + return $decoded; + } +} diff --git a/system/src/Grav/Framework/File/Formatter/MarkdownFormatter.php b/system/src/Grav/Framework/File/Formatter/MarkdownFormatter.php new file mode 100644 index 0000000..cf16cf7 --- /dev/null +++ b/system/src/Grav/Framework/File/Formatter/MarkdownFormatter.php @@ -0,0 +1,161 @@ + '.md', + 'header' => 'header', + 'body' => 'markdown', + 'raw' => 'frontmatter', + 'yaml' => ['inline' => 20] + ]; + + parent::__construct($config); + + $this->headerFormatter = $headerFormatter ?? new YamlFormatter($config['yaml']); + } + + /** + * Returns header field used in both encode() and decode(). + * + * @return string + */ + public function getHeaderField(): string + { + return $this->getConfig('header'); + } + + /** + * Returns body field used in both encode() and decode(). + * + * @return string + */ + public function getBodyField(): string + { + return $this->getConfig('body'); + } + + /** + * Returns raw field used in both encode() and decode(). + * + * @return string + */ + public function getRawField(): string + { + return $this->getConfig('raw'); + } + + /** + * Returns header formatter object used in both encode() and decode(). + * + * @return FileFormatterInterface + */ + public function getHeaderFormatter(): FileFormatterInterface + { + return $this->headerFormatter; + } + + /** + * {@inheritdoc} + * @see FileFormatterInterface::encode() + */ + public function encode($data): string + { + $headerVar = $this->getHeaderField(); + $bodyVar = $this->getBodyField(); + + $header = isset($data[$headerVar]) ? (array) $data[$headerVar] : []; + $body = isset($data[$bodyVar]) ? (string) $data[$bodyVar] : ''; + + // Create Markdown file with YAML header. + $encoded = ''; + if ($header) { + $encoded = "---\n" . trim($this->getHeaderFormatter()->encode($data['header'])) . "\n---\n\n"; + } + $encoded .= $body; + + // Normalize line endings to Unix style. + $encoded = preg_replace("/(\r\n|\r)/u", "\n", $encoded); + if (null === $encoded) { + throw new RuntimeException('Encoding markdown failed'); + } + + return $encoded; + } + + /** + * {@inheritdoc} + * @see FileFormatterInterface::decode() + */ + public function decode($data): array + { + $headerVar = $this->getHeaderField(); + $bodyVar = $this->getBodyField(); + $rawVar = $this->getRawField(); + + // Define empty content + $content = [ + $headerVar => [], + $bodyVar => '' + ]; + + $headerRegex = "/^---\n(.+?)\n---\n{0,}(.*)$/uis"; + + // Normalize line endings to Unix style. + $data = preg_replace("/(\r\n|\r)/u", "\n", $data); + if (null === $data) { + throw new RuntimeException('Decoding markdown failed'); + } + + // Parse header. + preg_match($headerRegex, ltrim($data), $matches); + if (empty($matches)) { + $content[$bodyVar] = $data; + } else { + // Normalize frontmatter. + $frontmatter = preg_replace("/\n\t/", "\n ", $matches[1]); + if ($rawVar) { + $content[$rawVar] = $frontmatter; + } + $content[$headerVar] = $this->getHeaderFormatter()->decode($frontmatter); + $content[$bodyVar] = $matches[2]; + } + + return $content; + } + + public function __serialize(): array + { + return parent::__serialize() + ['headerFormatter' => $this->headerFormatter]; + } + + public function __unserialize(array $data): void + { + parent::__unserialize($data); + + $this->headerFormatter = $data['headerFormatter'] ?? new YamlFormatter(['inline' => 20]); + } +} diff --git a/system/src/Grav/Framework/File/Formatter/SerializeFormatter.php b/system/src/Grav/Framework/File/Formatter/SerializeFormatter.php new file mode 100644 index 0000000..2ed8b93 --- /dev/null +++ b/system/src/Grav/Framework/File/Formatter/SerializeFormatter.php @@ -0,0 +1,98 @@ + '.ser', + 'decode_options' => ['allowed_classes' => [stdClass::class]] + ]; + + parent::__construct($config); + } + + /** + * Returns options used in decode(). + * + * By default only allow stdClass class. + * + * @return array + */ + public function getOptions() + { + return $this->getConfig('decode_options'); + } + + /** + * {@inheritdoc} + * @see FileFormatterInterface::encode() + */ + public function encode($data): string + { + return serialize($this->preserveLines($data, ["\n", "\r"], ['\\n', '\\r'])); + } + + /** + * {@inheritdoc} + * @see FileFormatterInterface::decode() + */ + public function decode($data) + { + $classes = $this->getOptions()['allowed_classes'] ?? false; + $decoded = @unserialize($data, ['allowed_classes' => $classes]); + + if ($decoded === false && $data !== serialize(false)) { + throw new RuntimeException('Decoding serialized data failed'); + } + + return $this->preserveLines($decoded, ['\\n', '\\r'], ["\n", "\r"]); + } + + /** + * Preserve new lines, recursive function. + * + * @param mixed $data + * @param array $search + * @param array $replace + * @return mixed + */ + protected function preserveLines($data, array $search, array $replace) + { + if (is_string($data)) { + $data = str_replace($search, $replace, $data); + } elseif (is_array($data)) { + foreach ($data as &$value) { + $value = $this->preserveLines($value, $search, $replace); + } + unset($value); + } + + return $data; + } +} diff --git a/system/src/Grav/Framework/File/Formatter/YamlFormatter.php b/system/src/Grav/Framework/File/Formatter/YamlFormatter.php new file mode 100644 index 0000000..9a0e2be --- /dev/null +++ b/system/src/Grav/Framework/File/Formatter/YamlFormatter.php @@ -0,0 +1,129 @@ + '.yaml', + 'inline' => 5, + 'indent' => 2, + 'native' => true, + 'compat' => true + ]; + + parent::__construct($config); + } + + /** + * @return int + */ + public function getInlineOption(): int + { + return $this->getConfig('inline'); + } + + /** + * @return int + */ + public function getIndentOption(): int + { + return $this->getConfig('indent'); + } + + /** + * @return bool + */ + public function useNativeDecoder(): bool + { + return $this->getConfig('native'); + } + + /** + * @return bool + */ + public function useCompatibleDecoder(): bool + { + return $this->getConfig('compat'); + } + + /** + * @param array $data + * @param int|null $inline + * @param int|null $indent + * @return string + * @see FileFormatterInterface::encode() + */ + public function encode($data, $inline = null, $indent = null): string + { + try { + return YamlParser::dump( + $data, + $inline ? (int) $inline : $this->getInlineOption(), + $indent ? (int) $indent : $this->getIndentOption(), + YamlParser::DUMP_EXCEPTION_ON_INVALID_TYPE + ); + } catch (DumpException $e) { + throw new RuntimeException('Encoding YAML failed: ' . $e->getMessage(), 0, $e); + } + } + + /** + * {@inheritdoc} + * @see FileFormatterInterface::decode() + */ + public function decode($data): array + { + // Try native PECL YAML PHP extension first if available. + if (function_exists('yaml_parse') && $this->useNativeDecoder()) { + // Safely decode YAML. + $saved = @ini_get('yaml.decode_php'); + @ini_set('yaml.decode_php', '0'); + $decoded = @yaml_parse($data); + if ($saved !== false) { + @ini_set('yaml.decode_php', $saved); + } + + if ($decoded !== false) { + return (array) $decoded; + } + } + + try { + return (array) YamlParser::parse($data); + } catch (ParseException $e) { + if ($this->useCompatibleDecoder()) { + return (array) FallbackYamlParser::parse($data); + } + + throw new RuntimeException('Decoding YAML failed: ' . $e->getMessage(), 0, $e); + } + } +} diff --git a/system/src/Grav/Framework/File/IniFile.php b/system/src/Grav/Framework/File/IniFile.php new file mode 100644 index 0000000..3039623 --- /dev/null +++ b/system/src/Grav/Framework/File/IniFile.php @@ -0,0 +1,40 @@ +setNormalization() + * @return Filesystem + */ + public static function getInstance(bool $normalize = null): Filesystem + { + if ($normalize === true) { + $instance = &static::$safe; + } elseif ($normalize === false) { + $instance = &static::$unsafe; + } else { + $instance = &static::$default; + } + + if (null === $instance) { + $instance = new static($normalize); + } + + return $instance; + } + + /** + * Always use Filesystem::getInstance() instead. + * + * @param bool|null $normalize + * @internal + */ + protected function __construct(bool $normalize = null) + { + $this->normalize = $normalize; + } + + /** + * Set path normalization. + * + * Default option enables normalization for the streams only, but you can force the normalization to be either + * on or off for every path. Disabling path normalization speeds up the calls, but may cause issues if paths were + * not normalized. + * + * @param bool|null $normalize + * @return Filesystem + */ + public function setNormalization(bool $normalize = null): self + { + return static::getInstance($normalize); + } + + /** + * @return bool|null + */ + public function getNormalization(): ?bool + { + return $this->normalize; + } + + /** + * Force all paths to be normalized. + * + * @return self + */ + public function unsafe(): self + { + return static::getInstance(true); + } + + /** + * Force all paths not to be normalized (speeds up the calls if given paths are known to be normalized). + * + * @return self + */ + public function safe(): self + { + return static::getInstance(false); + } + + /** + * {@inheritdoc} + * @see FilesystemInterface::parent() + */ + public function parent(string $path, int $levels = 1): string + { + [$scheme, $path] = $this->getSchemeAndHierarchy($path); + + if ($this->normalize !== false) { + $path = $this->normalizePathPart($path); + } + + if ($path === '' || $path === '.') { + return ''; + } + + [$scheme, $parent] = $this->dirnameInternal($scheme, $path, $levels); + + return $parent !== $path ? $this->toString($scheme, $parent) : ''; + } + + /** + * {@inheritdoc} + * @see FilesystemInterface::normalize() + */ + public function normalize(string $path): string + { + [$scheme, $path] = $this->getSchemeAndHierarchy($path); + + $path = $this->normalizePathPart($path); + + return $this->toString($scheme, $path); + } + + /** + * {@inheritdoc} + * @see FilesystemInterface::basename() + */ + public function basename(string $path, ?string $suffix = null): string + { + // Escape path. + $path = str_replace(['%2F', '%5C'], '/', rawurlencode($path)); + + return rawurldecode($suffix ? basename($path, $suffix) : basename($path)); + } + + /** + * {@inheritdoc} + * @see FilesystemInterface::dirname() + */ + public function dirname(string $path, int $levels = 1): string + { + [$scheme, $path] = $this->getSchemeAndHierarchy($path); + + if ($this->normalize || ($scheme && null === $this->normalize)) { + $path = $this->normalizePathPart($path); + } + + [$scheme, $path] = $this->dirnameInternal($scheme, $path, $levels); + + return $this->toString($scheme, $path); + } + + /** + * Gets full path with trailing slash. + * + * @param string $path + * @param int $levels + * @return string + * @phpstan-param positive-int $levels + */ + public function pathname(string $path, int $levels = 1): string + { + $path = $this->dirname($path, $levels); + + return $path !== '.' ? $path . '/' : ''; + } + + /** + * {@inheritdoc} + * @see FilesystemInterface::pathinfo() + */ + public function pathinfo(string $path, ?int $options = null) + { + [$scheme, $path] = $this->getSchemeAndHierarchy($path); + + if ($this->normalize || ($scheme && null === $this->normalize)) { + $path = $this->normalizePathPart($path); + } + + return $this->pathinfoInternal($scheme, $path, $options); + } + + /** + * @param string|null $scheme + * @param string $path + * @param int $levels + * @return array + * @phpstan-param positive-int $levels + */ + protected function dirnameInternal(?string $scheme, string $path, int $levels = 1): array + { + $path = dirname($path, $levels); + + if (null !== $scheme && $path === '.') { + return [$scheme, '']; + } + + // In Windows dirname() may return backslashes, fix that. + if (DIRECTORY_SEPARATOR !== '/') { + $path = str_replace('\\', '/', $path); + } + + return [$scheme, $path]; + } + + /** + * @param string|null $scheme + * @param string $path + * @param int|null $options + * @return array|string + */ + protected function pathinfoInternal(?string $scheme, string $path, ?int $options = null) + { + $path = str_replace(['%2F', '%5C'], ['/', '\\'], rawurlencode($path)); + + if (null === $options) { + $info = pathinfo($path); + } else { + $info = pathinfo($path, $options); + } + + if (!is_array($info)) { + return rawurldecode($info); + } + + $info = array_map('rawurldecode', $info); + + if (null !== $scheme) { + $info['scheme'] = $scheme; + + /** @phpstan-ignore-next-line because pathinfo('') doesn't have dirname */ + $dirname = $info['dirname'] ?? '.'; + + if ('' !== $dirname && '.' !== $dirname) { + // In Windows dirname may be using backslashes, fix that. + if (DIRECTORY_SEPARATOR !== '/') { + $dirname = str_replace(DIRECTORY_SEPARATOR, '/', $dirname); + } + + $info['dirname'] = $scheme . '://' . $dirname; + } else { + $info = ['dirname' => $scheme . '://'] + $info; + } + } + + return $info; + } + + /** + * Gets a 2-tuple of scheme (may be null) and hierarchical part of a filename (e.g. file:///tmp -> array(file, tmp)). + * + * @param string $filename + * @return array + */ + protected function getSchemeAndHierarchy(string $filename): array + { + $components = explode('://', $filename, 2); + + return 2 === count($components) ? $components : [null, $components[0]]; + } + + /** + * @param string|null $scheme + * @param string $path + * @return string + */ + protected function toString(?string $scheme, string $path): string + { + if ($scheme) { + return $scheme . '://' . $path; + } + + return $path; + } + + /** + * @param string $path + * @return string + * @throws RuntimeException + */ + protected function normalizePathPart(string $path): string + { + // Quick check for empty path. + if ($path === '' || $path === '.') { + return ''; + } + + // Quick check for root. + if ($path === '/') { + return '/'; + } + + // If the last character is not '/' or any of '\', './', '//' and '..' are not found, path is clean and we're done. + if ($path[-1] !== '/' && !preg_match('`(\\\\|\./|//|\.\.)`', $path)) { + return $path; + } + + // Convert backslashes + $path = strtr($path, ['\\' => '/']); + + $parts = explode('/', $path); + + // Keep absolute paths. + $root = ''; + if ($parts[0] === '') { + $root = '/'; + array_shift($parts); + } + + $list = []; + foreach ($parts as $i => $part) { + // Remove empty parts: // and /./ + if ($part === '' || $part === '.') { + continue; + } + + // Resolve /../ by removing path part. + if ($part === '..') { + $test = array_pop($list); + if ($test === null) { + // Oops, user tried to access something outside of our root folder. + throw new RuntimeException("Bad path {$path}"); + } + } else { + $list[] = $part; + } + } + + // Build path back together. + return $root . implode('/', $list); + } +} diff --git a/system/src/Grav/Framework/Filesystem/Interfaces/FilesystemInterface.php b/system/src/Grav/Framework/Filesystem/Interfaces/FilesystemInterface.php new file mode 100644 index 0000000..f5135bd --- /dev/null +++ b/system/src/Grav/Framework/Filesystem/Interfaces/FilesystemInterface.php @@ -0,0 +1,84 @@ += 1). + * @return string Returns parent path. + * @throws RuntimeException + * @phpstan-param positive-int $levels + * @api + */ + public function parent(string $path, int $levels = 1): string; + + /** + * Normalize path by cleaning up `\`, `/./`, `//` and `/../`. + * + * @param string $path A filename or path, does not need to exist as a file. + * @return string Returns normalized path. + * @throws RuntimeException + * @api + */ + public function normalize(string $path): string; + + /** + * Unicode-safe and stream-safe `\basename()` replacement. + * + * @param string $path A filename or path, does not need to exist as a file. + * @param string|null $suffix If the filename ends in suffix this will also be cut off. + * @return string + * @api + */ + public function basename(string $path, ?string $suffix = null): string; + + /** + * Unicode-safe and stream-safe `\dirname()` replacement. + * + * @see http://php.net/manual/en/function.dirname.php + * + * @param string $path A filename or path, does not need to exist as a file. + * @param int $levels The number of parent directories to go up (>= 1). + * @return string Returns path to the directory. + * @throws RuntimeException + * @phpstan-param positive-int $levels + * @api + */ + public function dirname(string $path, int $levels = 1): string; + + /** + * Unicode-safe and stream-safe `\pathinfo()` replacement. + * + * @see http://php.net/manual/en/function.pathinfo.php + * + * @param string $path A filename or path, does not need to exist as a file. + * @param int|null $options A PATHINFO_* constant. + * @return array|string + * @api + */ + public function pathinfo(string $path, ?int $options = null); +} diff --git a/system/src/Grav/Framework/Flex/Flex.php b/system/src/Grav/Framework/Flex/Flex.php new file mode 100644 index 0000000..c78a42c --- /dev/null +++ b/system/src/Grav/Framework/Flex/Flex.php @@ -0,0 +1,334 @@ + blueprint file, ...] + * @param array $config + */ + public function __construct(array $types, array $config) + { + $this->config = $config; + $this->types = []; + + foreach ($types as $type => $blueprint) { + if (!file_exists($blueprint)) { + /** @var Debugger $debugger */ + $debugger = Grav::instance()['debugger']; + $debugger->addMessage(sprintf('Flex: blueprint for flex type %s is missing', $type), 'error'); + + continue; + } + $this->addDirectoryType($type, $blueprint); + } + } + + /** + * @param string $type + * @param string $blueprint + * @param array $config + * @return $this + */ + public function addDirectoryType(string $type, string $blueprint, array $config = []) + { + $config = array_replace_recursive(['enabled' => true], $this->config, $config); + + $this->types[$type] = new FlexDirectory($type, $blueprint, $config); + + return $this; + } + + /** + * @param FlexDirectory $directory + * @return $this + */ + public function addDirectory(FlexDirectory $directory) + { + $this->types[$directory->getFlexType()] = $directory; + + return $this; + } + + /** + * @param string $type + * @return bool + */ + public function hasDirectory(string $type): bool + { + return isset($this->types[$type]); + } + + /** + * @param array|string[]|null $types + * @param bool $keepMissing + * @return array + */ + public function getDirectories(array $types = null, bool $keepMissing = false): array + { + if ($types === null) { + return $this->types; + } + + // Return the directories in the given order. + $directories = []; + foreach ($types as $type) { + $directories[$type] = $this->types[$type] ?? null; + } + + return $keepMissing ? $directories : array_filter($directories); + } + + /** + * @param string $type + * @return FlexDirectory|null + */ + public function getDirectory(string $type): ?FlexDirectory + { + return $this->types[$type] ?? null; + } + + /** + * @param string $type + * @param array|null $keys + * @param string|null $keyField + * @return FlexCollectionInterface|null + * @phpstan-return FlexCollectionInterface|null + */ + public function getCollection(string $type, array $keys = null, string $keyField = null): ?FlexCollectionInterface + { + $directory = $type ? $this->getDirectory($type) : null; + + return $directory ? $directory->getCollection($keys, $keyField) : null; + } + + /** + * @param array $keys + * @param array $options In addition to the options in getObjects(), following options can be passed: + * collection_class: Class to be used to create the collection. Defaults to ObjectCollection. + * @return FlexCollectionInterface + * @throws RuntimeException + * @phpstan-return FlexCollectionInterface + */ + public function getMixedCollection(array $keys, array $options = []): FlexCollectionInterface + { + $collectionClass = $options['collection_class'] ?? ObjectCollection::class; + if (!is_a($collectionClass, FlexCollectionInterface::class, true)) { + throw new RuntimeException(sprintf('Cannot create collection: Class %s does not exist', $collectionClass)); + } + + $objects = $this->getObjects($keys, $options); + + return new $collectionClass($objects); + } + + /** + * @param array $keys + * @param array $options Following optional options can be passed: + * types: List of allowed types. + * type: Allowed type if types isn't defined, otherwise acts as default_type. + * default_type: Set default type for objects given without type (only used if key_field isn't set). + * keep_missing: Set to true if you want to return missing objects as null. + * key_field: Key field which is used to match the objects. + * @return array + */ + public function getObjects(array $keys, array $options = []): array + { + $type = $options['type'] ?? null; + $defaultType = $options['default_type'] ?? $type ?? null; + $keyField = $options['key_field'] ?? 'flex_key'; + + // Prepare empty result lists for all requested Flex types. + $types = $options['types'] ?? (array)$type ?: null; + if ($types) { + $types = array_fill_keys($types, []); + } + $strict = isset($types); + + $guessed = []; + if ($keyField === 'flex_key') { + // We need to split Flex key lookups into individual directories. + $undefined = []; + $keyFieldFind = 'storage_key'; + + foreach ($keys as $flexKey) { + if (!$flexKey) { + continue; + } + + $flexKey = (string)$flexKey; + // Normalize key and type using fallback to default type if it was set. + [$key, $type, $guess] = $this->resolveKeyAndType($flexKey, $defaultType); + + if ($type === '' && $types) { + // Add keys which are not associated to any Flex type. They will be included to every Flex type. + foreach ($types as $type => &$array) { + $array[] = $key; + $guessed[$key][] = "{$type}.obj:{$key}"; + } + unset($array); + } elseif (!$strict || isset($types[$type])) { + // Collect keys by their Flex type. If allowed types are defined, only include values from those types. + $types[$type][] = $key; + if ($guess) { + $guessed[$key][] = "{$type}.obj:{$key}"; + } + } + } + } else { + // We are using a specific key field, make every key undefined. + $undefined = $keys; + $keyFieldFind = $keyField; + } + + if (!$types) { + return []; + } + + $list = [[]]; + foreach ($types as $type => $typeKeys) { + // Also remember to look up keys from undefined Flex types. + $lookupKeys = $undefined ? array_merge($typeKeys, $undefined) : $typeKeys; + + $collection = $this->getCollection($type, $lookupKeys, $keyFieldFind); + if ($collection && $keyFieldFind !== $keyField) { + $collection = $collection->withKeyField($keyField); + } + + $list[] = $collection ? $collection->toArray() : []; + } + + // Merge objects from individual types back together. + $list = array_merge(...$list); + + // Use the original key ordering. + if (!$guessed) { + $list = array_replace(array_fill_keys($keys, null), $list); + } else { + // We have mixed keys, we need to map flex keys back to storage keys. + $results = []; + foreach ($keys as $key) { + $flexKey = $guessed[$key] ?? $key; + if (is_array($flexKey)) { + $result = null; + foreach ($flexKey as $tryKey) { + if ($result = $list[$tryKey] ?? null) { + // Use the first matching object (conflicting objects will be ignored for now). + break; + } + } + } else { + $result = $list[$flexKey] ?? null; + } + + $results[$key] = $result; + } + + $list = $results; + } + + // Remove missing objects if not asked to keep them. + if (empty($options['keep_missing'])) { + $list = array_filter($list); + } + + return $list; + } + + /** + * @param string $key + * @param string|null $type + * @param string|null $keyField + * @return FlexObjectInterface|null + */ + public function getObject(string $key, string $type = null, string $keyField = null): ?FlexObjectInterface + { + if (null === $type && null === $keyField) { + // Special handling for quick Flex key lookups. + $keyField = 'storage_key'; + [$key, $type] = $this->resolveKeyAndType($key, $type); + } else { + $type = $this->resolveType($type); + } + + if ($type === '' || $key === '') { + return null; + } + + $directory = $this->getDirectory($type); + + return $directory ? $directory->getObject($key, $keyField) : null; + } + + /** + * @return int + */ + public function count(): int + { + return count($this->types); + } + + /** + * @param string $flexKey + * @param string|null $type + * @return array + */ + protected function resolveKeyAndType(string $flexKey, string $type = null): array + { + $guess = false; + if (strpos($flexKey, ':') !== false) { + [$type, $key] = explode(':', $flexKey, 2); + + $type = $this->resolveType($type); + } else { + $key = $flexKey; + $type = (string)$type; + $guess = true; + } + + return [$key, $type, $guess]; + } + + /** + * @param string|null $type + * @return string + */ + protected function resolveType(string $type = null): string + { + if (null !== $type && strpos($type, '.') !== false) { + return preg_replace('|\.obj$|', '', $type) ?? $type; + } + + return $type ?? ''; + } +} diff --git a/system/src/Grav/Framework/Flex/FlexCollection.php b/system/src/Grav/Framework/Flex/FlexCollection.php new file mode 100644 index 0000000..9d9fc47 --- /dev/null +++ b/system/src/Grav/Framework/Flex/FlexCollection.php @@ -0,0 +1,732 @@ + + * @implements FlexCollectionInterface + */ +class FlexCollection extends ObjectCollection implements FlexCollectionInterface +{ + /** @var FlexDirectory */ + private $_flexDirectory; + + /** @var string */ + private $_keyField = 'storage_key'; + + /** + * Get list of cached methods. + * + * @return array Returns a list of methods with their caching information. + */ + public static function getCachedMethods(): array + { + return [ + 'getTypePrefix' => true, + 'getType' => true, + 'getFlexDirectory' => true, + 'hasFlexFeature' => true, + 'getFlexFeatures' => true, + 'getCacheKey' => true, + 'getCacheChecksum' => false, + 'getTimestamp' => true, + 'hasProperty' => true, + 'getProperty' => true, + 'hasNestedProperty' => true, + 'getNestedProperty' => true, + 'orderBy' => true, + + 'render' => false, + 'isAuthorized' => 'session', + 'search' => true, + 'sort' => true, + 'getDistinctValues' => true + ]; + } + + /** + * {@inheritdoc} + * @see FlexCollectionInterface::createFromArray() + */ + public static function createFromArray(array $entries, FlexDirectory $directory, string $keyField = null) + { + $instance = new static($entries, $directory); + $instance->setKeyField($keyField); + + return $instance; + } + + /** + * {@inheritdoc} + * @see FlexCollectionInterface::__construct() + */ + public function __construct(array $entries = [], FlexDirectory $directory = null) + { + // @phpstan-ignore-next-line + if (get_class($this) === __CLASS__) { + user_error('Using ' . __CLASS__ . ' directly is deprecated since Grav 1.7, use \Grav\Common\Flex\Types\Generic\GenericCollection or your own class instead', E_USER_DEPRECATED); + } + + parent::__construct($entries); + + if ($directory) { + $this->setFlexDirectory($directory)->setKey($directory->getFlexType()); + } + } + + /** + * {@inheritdoc} + * @see FlexCommonInterface::hasFlexFeature() + */ + public function hasFlexFeature(string $name): bool + { + return in_array($name, $this->getFlexFeatures(), true); + } + + /** + * {@inheritdoc} + * @see FlexCommonInterface::hasFlexFeature() + */ + public function getFlexFeatures(): array + { + /** @var array $implements */ + $implements = class_implements($this); + + $list = []; + foreach ($implements as $interface) { + if ($pos = strrpos($interface, '\\')) { + $interface = substr($interface, $pos+1); + } + + $list[] = Inflector::hyphenize(str_replace('Interface', '', $interface)); + } + + return $list; + + } + + /** + * {@inheritdoc} + * @see FlexCollectionInterface::search() + */ + public function search(string $search, $properties = null, array $options = null) + { + $directory = $this->getFlexDirectory(); + $properties = $directory->getSearchProperties($properties); + $options = $directory->getSearchOptions($options); + + $matching = $this->call('search', [$search, $properties, $options]); + $matching = array_filter($matching); + + if ($matching) { + arsort($matching, SORT_NUMERIC); + } + + /** @var string[] $array */ + $array = array_keys($matching); + + /** @phpstan-var static */ + return $this->select($array); + } + + /** + * {@inheritdoc} + * @see FlexCollectionInterface::sort() + */ + public function sort(array $order) + { + $criteria = Criteria::create()->orderBy($order); + + /** @phpstan-var FlexCollectionInterface $matching */ + $matching = $this->matching($criteria); + + return $matching; + } + + /** + * @param array $filters + * @return static + * @phpstan-return static + */ + public function filterBy(array $filters) + { + $expr = Criteria::expr(); + $criteria = Criteria::create(); + + foreach ($filters as $key => $value) { + $criteria->andWhere($expr->eq($key, $value)); + } + + /** @phpstan-var static */ + return $this->matching($criteria); + } + + /** + * {@inheritdoc} + * @see FlexCollectionInterface::getFlexType() + */ + public function getFlexType(): string + { + return $this->_flexDirectory->getFlexType(); + } + + /** + * {@inheritdoc} + * @see FlexCollectionInterface::getFlexDirectory() + */ + public function getFlexDirectory(): FlexDirectory + { + return $this->_flexDirectory; + } + + /** + * {@inheritdoc} + * @see FlexCollectionInterface::getTimestamp() + */ + public function getTimestamp(): int + { + $timestamps = $this->getTimestamps(); + + return $timestamps ? max($timestamps) : time(); + } + + /** + * {@inheritdoc} + * @see FlexCollectionInterface::getFlexDirectory() + */ + public function getCacheKey(): string + { + return $this->getTypePrefix() . $this->getFlexType() . '.' . sha1((string)json_encode($this->call('getKey'))); + } + + /** + * {@inheritdoc} + * @see FlexCollectionInterface::getFlexDirectory() + */ + public function getCacheChecksum(): string + { + $list = []; + /** + * @var string $key + * @var FlexObjectInterface $object + */ + foreach ($this as $key => $object) { + $list[$key] = $object->getCacheChecksum(); + } + + return sha1((string)json_encode($list)); + } + + /** + * {@inheritdoc} + * @see FlexCollectionInterface::getFlexDirectory() + */ + public function getTimestamps(): array + { + /** @var int[] $timestamps */ + $timestamps = $this->call('getTimestamp'); + + return $timestamps; + } + + /** + * {@inheritdoc} + * @see FlexCollectionInterface::getFlexDirectory() + */ + public function getStorageKeys(): array + { + /** @var string[] $keys */ + $keys = $this->call('getStorageKey'); + + return $keys; + } + + /** + * {@inheritdoc} + * @see FlexCollectionInterface::getFlexDirectory() + */ + public function getFlexKeys(): array + { + /** @var string[] $keys */ + $keys = $this->call('getFlexKey'); + + return $keys; + } + + /** + * Get all the values in property. + * + * Supports either single scalar values or array of scalar values. + * + * @param string $property Object property to be used to make groups. + * @param string|null $separator Separator, defaults to '.' + * @return array + */ + public function getDistinctValues(string $property, string $separator = null): array + { + $list = []; + + /** @var FlexObjectInterface $element */ + foreach ($this->getIterator() as $element) { + $value = (array)$element->getNestedProperty($property, null, $separator); + foreach ($value as $v) { + if (is_scalar($v)) { + $t = gettype($v) . (string)$v; + $list[$t] = $v; + } + } + } + + return array_values($list); + } + + /** + * {@inheritdoc} + * @see FlexCollectionInterface::withKeyField() + */ + public function withKeyField(string $keyField = null) + { + $keyField = $keyField ?: 'key'; + if ($keyField === $this->getKeyField()) { + return $this; + } + + $entries = []; + foreach ($this as $key => $object) { + // TODO: remove hardcoded logic + if ($keyField === 'storage_key') { + $entries[$object->getStorageKey()] = $object; + } elseif ($keyField === 'flex_key') { + $entries[$object->getFlexKey()] = $object; + } elseif ($keyField === 'key') { + $entries[$object->getKey()] = $object; + } + } + + return $this->createFrom($entries, $keyField); + } + + /** + * {@inheritdoc} + * @see FlexCollectionInterface::getIndex() + */ + public function getIndex() + { + /** @phpstan-var FlexIndexInterface */ + return $this->getFlexDirectory()->getIndex($this->getKeys(), $this->getKeyField()); + } + + /** + * @inheritdoc} + * @see FlexCollectionInterface::getCollection() + * @return $this + */ + public function getCollection() + { + return $this; + } + + /** + * {@inheritdoc} + * @see FlexCollectionInterface::render() + */ + public function render(string $layout = null, array $context = []) + { + if (!$layout) { + $config = $this->getTemplateConfig(); + $layout = $config['collection']['defaults']['layout'] ?? 'default'; + } + + $type = $this->getFlexType(); + + $grav = Grav::instance(); + + /** @var Debugger $debugger */ + $debugger = $grav['debugger']; + $debugger->startTimer('flex-collection-' . ($debugKey = uniqid($type, false)), 'Render Collection ' . $type . ' (' . $layout . ')'); + + $key = null; + foreach ($context as $value) { + if (!is_scalar($value)) { + $key = false; + break; + } + } + + if ($key !== false) { + $key = md5($this->getCacheKey() . '.' . $layout . json_encode($context)); + $cache = $this->getCache('render'); + } else { + $cache = null; + } + + try { + $data = $cache && $key ? $cache->get($key) : null; + + $block = $data ? HtmlBlock::fromArray($data) : null; + } catch (InvalidArgumentException $e) { + $debugger->addException($e); + $block = null; + } catch (\InvalidArgumentException $e) { + $debugger->addException($e); + $block = null; + } + + $checksum = $this->getCacheChecksum(); + if ($block && $checksum !== $block->getChecksum()) { + $block = null; + } + + if (!$block) { + $block = HtmlBlock::create($key ?: null); + $block->setChecksum($checksum); + if (!$key) { + $block->disableCache(); + } + + $event = new Event([ + 'type' => 'flex', + 'directory' => $this->getFlexDirectory(), + 'collection' => $this, + 'layout' => &$layout, + 'context' => &$context + ]); + $this->triggerEvent('onRender', $event); + + $output = $this->getTemplate($layout)->render( + [ + 'grav' => $grav, + 'config' => $grav['config'], + 'block' => $block, + 'directory' => $this->getFlexDirectory(), + 'collection' => $this, + 'layout' => $layout + ] + $context + ); + + if ($debugger->enabled()) { + $output = "\n\n{$output}\n\n"; + } + + $block->setContent($output); + + try { + $cache && $key && $block->isCached() && $cache->set($key, $block->toArray()); + } catch (InvalidArgumentException $e) { + $debugger->addException($e); + } + } + + $debugger->stopTimer('flex-collection-' . $debugKey); + + return $block; + } + + /** + * @param FlexDirectory $type + * @return $this + */ + public function setFlexDirectory(FlexDirectory $type) + { + $this->_flexDirectory = $type; + + return $this; + } + + /** + * @param string $key + * @return array + */ + public function getMetaData($key): array + { + $object = $this->get($key); + + return $object instanceof FlexObjectInterface ? $object->getMetaData() : []; + } + + /** + * @param string|null $namespace + * @return CacheInterface + */ + public function getCache(string $namespace = null) + { + return $this->_flexDirectory->getCache($namespace); + } + + /** + * @return string + */ + public function getKeyField(): string + { + return $this->_keyField; + } + + /** + * @param string $action + * @param string|null $scope + * @param UserInterface|null $user + * @return static + * @phpstan-return static + */ + public function isAuthorized(string $action, string $scope = null, UserInterface $user = null) + { + $list = $this->call('isAuthorized', [$action, $scope, $user]); + $list = array_filter($list); + + /** @var string[] $keys */ + $keys = array_keys($list); + + /** @phpstan-var static */ + return $this->select($keys); + } + + /** + * @param string $value + * @param string $field + * @return FlexObjectInterface|null + * @phpstan-return T|null + */ + public function find($value, $field = 'id') + { + if ($value) { + foreach ($this as $element) { + if (mb_strtolower($element->getProperty($field)) === mb_strtolower($value)) { + return $element; + } + } + } + + return null; + } + + /** + * @return array + */ + #[\ReturnTypeWillChange] + public function jsonSerialize() + { + $elements = []; + + /** + * @var string $key + * @var array|FlexObject $object + */ + foreach ($this->getElements() as $key => $object) { + $elements[$key] = is_array($object) ? $object : $object->jsonSerialize(); + } + + return $elements; + } + + /** + * @return array + */ + #[\ReturnTypeWillChange] + public function __debugInfo() + { + return [ + 'type:private' => $this->getFlexType(), + 'key:private' => $this->getKey(), + 'objects_key:private' => $this->getKeyField(), + 'objects:private' => $this->getElements() + ]; + } + + /** + * Creates a new instance from the specified elements. + * + * This method is provided for derived classes to specify how a new + * instance should be created when constructor semantics have changed. + * + * @param array $elements Elements. + * @param string|null $keyField + * @return static + * @phpstan-return static + * @throws \InvalidArgumentException + */ + protected function createFrom(array $elements, $keyField = null) + { + $collection = new static($elements, $this->_flexDirectory); + $collection->setKeyField($keyField ?: $this->_keyField); + + return $collection; + } + + /** + * @return string + */ + protected function getTypePrefix(): string + { + return 'c.'; + } + + /** + * @return array + */ + protected function getTemplateConfig(): array + { + $config = $this->getFlexDirectory()->getConfig('site.templates', []); + $defaults = array_replace($config['defaults'] ?? [], $config['collection']['defaults'] ?? []); + $config['collection']['defaults'] = $defaults; + + return $config; + } + + /** + * @param string $layout + * @return array + */ + protected function getTemplatePaths(string $layout): array + { + $config = $this->getTemplateConfig(); + $type = $this->getFlexType(); + $defaults = $config['collection']['defaults'] ?? []; + + $ext = $defaults['ext'] ?? '.html.twig'; + $types = array_unique(array_merge([$type], (array)($defaults['type'] ?? null))); + $paths = $config['collection']['paths'] ?? [ + 'flex/{TYPE}/collection/{LAYOUT}{EXT}', + 'flex-objects/layouts/{TYPE}/collection/{LAYOUT}{EXT}' + ]; + $table = ['TYPE' => '%1$s', 'LAYOUT' => '%2$s', 'EXT' => '%3$s']; + + $lookups = []; + foreach ($paths as $path) { + $path = Utils::simpleTemplate($path, $table); + foreach ($types as $type) { + $lookups[] = sprintf($path, $type, $layout, $ext); + } + } + + return array_unique($lookups); + } + + /** + * @param string $layout + * @return Template|TemplateWrapper + * @throws LoaderError + * @throws SyntaxError + */ + protected function getTemplate($layout) + { + $grav = Grav::instance(); + + /** @var Twig $twig */ + $twig = $grav['twig']; + + try { + return $twig->twig()->resolveTemplate($this->getTemplatePaths($layout)); + } catch (LoaderError $e) { + /** @var Debugger $debugger */ + $debugger = Grav::instance()['debugger']; + $debugger->addException($e); + + return $twig->twig()->resolveTemplate(['flex/404.html.twig']); + } + } + + /** + * @param string $type + * @return FlexDirectory + */ + protected function getRelatedDirectory($type): ?FlexDirectory + { + /** @var Flex $flex */ + $flex = Grav::instance()['flex']; + + return $flex->getDirectory($type); + } + + /** + * @param string|null $keyField + * @return void + */ + protected function setKeyField($keyField = null): void + { + $this->_keyField = $keyField ?? 'storage_key'; + } + + // DEPRECATED METHODS + + /** + * @param bool $prefix + * @return string + * @deprecated 1.6 Use `->getFlexType()` instead. + */ + public function getType($prefix = false) + { + user_error(__CLASS__ . '::' . __FUNCTION__ . '() is deprecated since Grav 1.6, use ->getFlexType() method instead', E_USER_DEPRECATED); + + $type = $prefix ? $this->getTypePrefix() : ''; + + return $type . $this->getFlexType(); + } + + /** + * @param string $name + * @param object|null $event + * @return $this + * @deprecated 1.7, moved to \Grav\Common\Flex\Traits\FlexObjectTrait + */ + public function triggerEvent(string $name, $event = null) + { + user_error(__METHOD__ . '() is deprecated since Grav 1.7, moved to \Grav\Common\Flex\Traits\FlexObjectTrait', E_USER_DEPRECATED); + + if (null === $event) { + $event = new Event([ + 'type' => 'flex', + 'directory' => $this->getFlexDirectory(), + 'collection' => $this + ]); + } + if (strpos($name, 'onFlexCollection') !== 0 && strpos($name, 'on') === 0) { + $name = 'onFlexCollection' . substr($name, 2); + } + + $grav = Grav::instance(); + if ($event instanceof Event) { + $grav->fireEvent($name, $event); + } else { + $grav->dispatchEvent($event); + } + + + return $this; + } +} diff --git a/system/src/Grav/Framework/Flex/FlexDirectory.php b/system/src/Grav/Framework/Flex/FlexDirectory.php new file mode 100644 index 0000000..2871597 --- /dev/null +++ b/system/src/Grav/Framework/Flex/FlexDirectory.php @@ -0,0 +1,1187 @@ +[] + */ + protected $indexes = []; + /** + * @var FlexCollectionInterface|null + * @phpstan-var FlexCollectionInterface|null + */ + protected $collection; + /** @var bool */ + protected $enabled; + /** @var array */ + protected $defaults; + /** @var Config */ + protected $config; + /** @var FlexStorageInterface */ + protected $storage; + /** @var CacheInterface[] */ + protected $cache; + /** @var FlexObjectInterface[] */ + protected $objects; + /** @var string */ + protected $objectClassName; + /** @var string */ + protected $collectionClassName; + /** @var string */ + protected $indexClassName; + + /** @var string|null */ + private $_authorize; + + /** + * FlexDirectory constructor. + * @param string $type + * @param string $blueprint_file + * @param array $defaults + */ + public function __construct(string $type, string $blueprint_file, array $defaults = []) + { + $this->type = $type; + $this->blueprints = []; + $this->blueprint_file = $blueprint_file; + $this->defaults = $defaults; + $this->enabled = !empty($defaults['enabled']); + $this->objects = []; + } + + /** + * @return bool + */ + public function isListed(): bool + { + $grav = Grav::instance(); + + /** @var Flex $flex */ + $flex = $grav['flex']; + $directory = $flex->getDirectory($this->type); + + return null !== $directory; + } + + /** + * @return bool + */ + public function isEnabled(): bool + { + return $this->enabled; + } + + /** + * @return string + */ + public function getFlexType(): string + { + return $this->type; + } + + /** + * @return string + */ + public function getTitle(): string + { + return $this->getBlueprintInternal()->get('title', ucfirst($this->getFlexType())); + } + + /** + * @return string + */ + public function getDescription(): string + { + return $this->getBlueprintInternal()->get('description', ''); + } + + /** + * @param string|null $name + * @param mixed $default + * @return mixed + */ + public function getConfig(string $name = null, $default = null) + { + if (null === $this->config) { + $config = $this->getBlueprintInternal()->get('config', []); + $config = is_array($config) ? array_replace_recursive($config, $this->defaults, $this->getDirectoryConfig($config['admin']['views']['configure']['form'] ?? $config['admin']['configure']['form'] ?? null)) : null; + if (!is_array($config)) { + throw new RuntimeException('Bad configuration'); + } + + $this->config = new Config($config); + } + + return null === $name ? $this->config : $this->config->get($name, $default); + } + + /** + * @param string|string[]|null $properties + * @return array + */ + public function getSearchProperties($properties = null): array + { + if (null !== $properties) { + return (array)$properties; + } + + $properties = $this->getConfig('data.search.fields'); + if (!$properties) { + $fields = $this->getConfig('admin.views.list.fields') ?? $this->getConfig('admin.list.fields', []); + foreach ($fields as $property => $value) { + if (!empty($value['link'])) { + $properties[] = $property; + } + } + } + + return $properties; + } + + /** + * @param array|null $options + * @return array + */ + public function getSearchOptions(array $options = null): array + { + if (empty($options['merge'])) { + return $options ?? (array)$this->getConfig('data.search.options'); + } + + unset($options['merge']); + + return $options + (array)$this->getConfig('data.search.options'); + } + + /** + * @param string|null $name + * @param array $options + * @return FlexFormInterface + * @internal + */ + public function getDirectoryForm(string $name = null, array $options = []) + { + $name = $name ?: $this->getConfig('admin.views.configure.form', '') ?: $this->getConfig('admin.configure.form', ''); + + return new FlexDirectoryForm($name ?? '', $this, $options); + } + + /** + * @return Blueprint + * @internal + */ + public function getDirectoryBlueprint() + { + $name = 'configure'; + + $type = $this->getBlueprint(); + $overrides = $type->get("blueprints/{$name}"); + + $path = "blueprints://flex/shared/{$name}.yaml"; + $blueprint = new Blueprint($path); + $blueprint->load(); + if (isset($overrides['fields'])) { + $blueprint->embed('form/fields/tabs/fields', $overrides['fields']); + } + $blueprint->init(); + + return $blueprint; + } + + /** + * @param string $name + * @param array $data + * @return void + * @throws Exception + * @internal + */ + public function saveDirectoryConfig(string $name, array $data) + { + $grav = Grav::instance(); + + /** @var UniformResourceLocator $locator */ + $locator = $grav['locator']; + + $filename = $this->getDirectoryConfigUri($name); + if (file_exists($filename)) { + $filename = $locator->findResource($filename, true); + } else { + $filesystem = Filesystem::getInstance(); + $dirname = $filesystem->dirname($filename); + $basename = $filesystem->basename($filename); + $dirname = $locator->findResource($dirname, true) ?: $locator->findResource($dirname, true, true); + $filename = "{$dirname}/{$basename}"; + } + + $file = YamlFile::instance($filename); + if (!empty($data)) { + $file->save($data); + } else { + $file->delete(); + } + } + + /** + * @param string $name + * @return array + * @internal + */ + public function loadDirectoryConfig(string $name): array + { + $grav = Grav::instance(); + + /** @var UniformResourceLocator $locator */ + $locator = $grav['locator']; + $uri = $this->getDirectoryConfigUri($name); + + // If configuration is found in main configuration, use it. + if (str_starts_with($uri, 'config://')) { + $path = str_replace('/', '.', substr($uri, 9, -5)); + + return (array)$grav['config']->get($path); + } + + // Load the configuration file. + $filename = $locator->findResource($uri, true); + if ($filename === false) { + return []; + } + + $file = YamlFile::instance($filename); + + return $file->content(); + } + + /** + * @param string|null $name + * @return string + */ + public function getDirectoryConfigUri(string $name = null): string + { + $name = $name ?: $this->getFlexType(); + $blueprint = $this->getBlueprint(); + + return $blueprint->get('blueprints/views/configure/file') ?? $blueprint->get('blueprints/configure/file') ?? "config://flex/{$name}.yaml"; + } + + /** + * @param string|null $name + * @return array + */ + protected function getDirectoryConfig(string $name = null): array + { + $grav = Grav::instance(); + + /** @var Config $config */ + $config = $grav['config']; + $name = $name ?: $this->getFlexType(); + + return $config->get("flex.{$name}", []); + } + + /** + * Returns a new uninitialized instance of blueprint. + * + * Always use $object->getBlueprint() or $object->getForm()->getBlueprint() instead. + * + * @param string $type + * @param string $context + * @return Blueprint + */ + public function getBlueprint(string $type = '', string $context = '') + { + return clone $this->getBlueprintInternal($type, $context); + } + + /** + * @param string $view + * @return string + */ + public function getBlueprintFile(string $view = ''): string + { + $file = $this->blueprint_file; + if ($view !== '') { + $file = preg_replace('/\.yaml/', "/{$view}.yaml", $file); + } + + return (string)$file; + } + + /** + * Get collection. In the site this will be filtered by the default filters (published etc). + * + * Use $directory->getIndex() if you want unfiltered collection. + * + * @param array|null $keys Array of keys. + * @param string|null $keyField Field to be used as the key. + * @return FlexCollectionInterface + * @phpstan-return FlexCollectionInterface + */ + public function getCollection(array $keys = null, string $keyField = null): FlexCollectionInterface + { + // Get all selected entries. + $index = $this->getIndex($keys, $keyField); + + if (!Utils::isAdminPlugin()) { + // If not in admin, filter the list by using default filters. + $filters = (array)$this->getConfig('site.filter', []); + + foreach ($filters as $filter) { + $index = $index->{$filter}(); + } + } + + return $index; + } + + /** + * Get the full collection of all stored objects. + * + * Use $directory->getCollection() if you want a filtered collection. + * + * @param array|null $keys Array of keys. + * @param string|null $keyField Field to be used as the key. + * @return FlexIndexInterface + * @phpstan-return FlexIndexInterface + */ + public function getIndex(array $keys = null, string $keyField = null): FlexIndexInterface + { + $keyField = $keyField ?? ''; + $index = $this->indexes[$keyField] ?? $this->loadIndex($keyField); + $index = clone $index; + + if (null !== $keys) { + /** @var FlexIndexInterface $index */ + $index = $index->select($keys); + } + + return $index->getIndex(); + } + + /** + * Returns an object if it exists. If no arguments are passed (or both of them are null), method creates a new empty object. + * + * Note: It is not safe to use the object without checking if the user can access it. + * + * @param string|null $key + * @param string|null $keyField Field to be used as the key. + * @return FlexObjectInterface|null + */ + public function getObject($key = null, string $keyField = null): ?FlexObjectInterface + { + if (null === $key) { + return $this->createObject([], ''); + } + + $keyField = $keyField ?? ''; + $index = $this->indexes[$keyField] ?? $this->loadIndex($keyField); + + return $index->get($key); + } + + /** + * @param string|null $namespace + * @return CacheInterface + */ + public function getCache(string $namespace = null) + { + $namespace = $namespace ?: 'index'; + $cache = $this->cache[$namespace] ?? null; + + if (null === $cache) { + try { + $grav = Grav::instance(); + + /** @var Cache $gravCache */ + $gravCache = $grav['cache']; + $config = $this->getConfig('object.cache.' . $namespace); + if (empty($config['enabled'])) { + $cache = new MemoryCache('flex-objects-' . $this->getFlexType()); + } else { + $lifetime = $config['lifetime'] ?? 60; + + $key = $gravCache->getKey(); + if (Utils::isAdminPlugin()) { + $key = substr($key, 0, -1); + } + $cache = new DoctrineCache($gravCache->getCacheDriver(), 'flex-objects-' . $this->getFlexType() . $key, $lifetime); + } + } catch (Exception $e) { + /** @var Debugger $debugger */ + $debugger = Grav::instance()['debugger']; + $debugger->addException($e); + + $cache = new MemoryCache('flex-objects-' . $this->getFlexType()); + } + + // Disable cache key validation. + $cache->setValidation(false); + $this->cache[$namespace] = $cache; + } + + return $cache; + } + + /** + * @return $this + */ + public function clearCache() + { + $grav = Grav::instance(); + + /** @var Debugger $debugger */ + $debugger = $grav['debugger']; + $debugger->addMessage(sprintf('Flex: Clearing all %s cache', $this->type), 'debug'); + + /** @var UniformResourceLocator $locator */ + $locator = $grav['locator']; + $locator->clearCache(); + + $this->getCache('index')->clear(); + $this->getCache('object')->clear(); + $this->getCache('render')->clear(); + + $this->indexes = []; + $this->objects = []; + + return $this; + } + + /** + * @param string|null $key + * @return string|null + */ + public function getStorageFolder(string $key = null): ?string + { + return $this->getStorage()->getStoragePath($key); + } + + /** + * @param string|null $key + * @return string|null + */ + public function getMediaFolder(string $key = null): ?string + { + return $this->getStorage()->getMediaPath($key); + } + + /** + * @return FlexStorageInterface + */ + public function getStorage(): FlexStorageInterface + { + if (null === $this->storage) { + $this->storage = $this->createStorage(); + } + + return $this->storage; + } + + /** + * @param array $data + * @param string $key + * @param bool $validate + * @return FlexObjectInterface + */ + public function createObject(array $data, string $key = '', bool $validate = false): FlexObjectInterface + { + /** @phpstan-var class-string $className */ + $className = $this->objectClassName ?: $this->getObjectClass(); + if (!is_a($className, FlexObjectInterface::class, true)) { + throw new \RuntimeException('Bad object class: ' . $className); + } + + return new $className($data, $key, $this, $validate); + } + + /** + * @param array $entries + * @param string|null $keyField + * @return FlexCollectionInterface + * @phpstan-return FlexCollectionInterface + */ + public function createCollection(array $entries, string $keyField = null): FlexCollectionInterface + { + /** phpstan-var class-string $className */ + $className = $this->collectionClassName ?: $this->getCollectionClass(); + if (!is_a($className, FlexCollectionInterface::class, true)) { + throw new \RuntimeException('Bad collection class: ' . $className); + } + + return $className::createFromArray($entries, $this, $keyField); + } + + /** + * @param array $entries + * @param string|null $keyField + * @return FlexIndexInterface + * @phpstan-return FlexIndexInterface + */ + public function createIndex(array $entries, string $keyField = null): FlexIndexInterface + { + /** @phpstan-var class-string $className */ + $className = $this->indexClassName ?: $this->getIndexClass(); + if (!is_a($className, FlexIndexInterface::class, true)) { + throw new \RuntimeException('Bad index class: ' . $className); + } + + return $className::createFromArray($entries, $this, $keyField); + } + + /** + * @return string + */ + public function getObjectClass(): string + { + if (!$this->objectClassName) { + $this->objectClassName = $this->getConfig('data.object', GenericObject::class); + } + + return $this->objectClassName; + } + + /** + * @return string + */ + public function getCollectionClass(): string + { + if (!$this->collectionClassName) { + $this->collectionClassName = $this->getConfig('data.collection', GenericCollection::class); + } + + return $this->collectionClassName; + } + + + /** + * @return string + */ + public function getIndexClass(): string + { + if (!$this->indexClassName) { + $this->indexClassName = $this->getConfig('data.index', GenericIndex::class); + } + + return $this->indexClassName; + } + + /** + * @param array $entries + * @param string|null $keyField + * @return FlexCollectionInterface + * @phpstan-return FlexCollectionInterface + */ + public function loadCollection(array $entries, string $keyField = null): FlexCollectionInterface + { + return $this->createCollection($this->loadObjects($entries), $keyField); + } + + /** + * @param array $entries + * @return FlexObjectInterface[] + * @internal + */ + public function loadObjects(array $entries): array + { + /** @var Debugger $debugger */ + $debugger = Grav::instance()['debugger']; + + $keys = []; + $rows = []; + $fetch = []; + + // Build lookup arrays with storage keys for the objects. + foreach ($entries as $key => $value) { + $k = $value['storage_key'] ?? ''; + if ($k === '') { + continue; + } + $v = $this->objects[$k] ?? null; + $keys[$k] = $key; + $rows[$k] = $v; + if (!$v) { + $fetch[] = $k; + } + } + + // Attempt to fetch missing rows from the cache. + if ($fetch) { + $rows = (array)array_replace($rows, $this->loadCachedObjects($fetch)); + } + + // Read missing rows from the storage. + $updated = []; + $storage = $this->getStorage(); + $rows = $storage->readRows($rows, $updated); + + // Create objects from the rows. + $isListed = $this->isListed(); + $list = []; + foreach ($rows as $storageKey => $row) { + $usedKey = $keys[$storageKey]; + + if ($row instanceof FlexObjectInterface) { + $object = $row; + } else { + if ($row === null) { + $debugger->addMessage(sprintf('Flex: Object %s was not found from %s storage', $storageKey, $this->type), 'debug'); + continue; + } + + if (isset($row['__ERROR'])) { + $message = sprintf('Flex: Object %s is broken in %s storage: %s', $storageKey, $this->type, $row['__ERROR']); + $debugger->addException(new RuntimeException($message)); + $debugger->addMessage($message, 'error'); + continue; + } + + if (!isset($row['__META'])) { + $row['__META'] = [ + 'storage_key' => $storageKey, + 'storage_timestamp' => $entries[$usedKey]['storage_timestamp'] ?? 0, + ]; + } + + $key = $row['__META']['key'] ?? $entries[$usedKey]['key'] ?? $usedKey; + $object = $this->createObject($row, $key, false); + $this->objects[$storageKey] = $object; + if ($isListed) { + // If unserialize works for the object, serialize the object to speed up the loading. + $updated[$storageKey] = $object; + } + } + + $list[$usedKey] = $object; + } + + // Store updated rows to the cache. + if ($updated) { + $cache = $this->getCache('object'); + if (!$cache instanceof MemoryCache) { + ///** @var Debugger $debugger */ + //$debugger = Grav::instance()['debugger']; + //$debugger->addMessage(sprintf('Flex: Caching %d %s', \count($entries), $this->type), 'debug'); + } + try { + $cache->setMultiple($updated); + } catch (InvalidArgumentException $e) { + $debugger->addException($e); + // TODO: log about the issue. + } + } + + if ($fetch) { + $debugger->stopTimer('flex-objects'); + } + + return $list; + } + + protected function loadCachedObjects(array $fetch): array + { + if (!$fetch) { + return []; + } + + /** @var Debugger $debugger */ + $debugger = Grav::instance()['debugger']; + + $cache = $this->getCache('object'); + + // Attempt to fetch missing rows from the cache. + $fetched = []; + try { + $loading = count($fetch); + + $debugger->startTimer('flex-objects', sprintf('Flex: Loading %d %s', $loading, $this->type)); + + $fetched = (array)$cache->getMultiple($fetch); + if ($fetched) { + $index = $this->loadIndex('storage_key'); + + // Make sure cached objects are up to date: compare against index checksum/timestamp. + /** + * @var string $key + * @var mixed $value + */ + foreach ($fetched as $key => $value) { + if ($value instanceof FlexObjectInterface) { + $objectMeta = $value->getMetaData(); + } else { + $objectMeta = $value['__META'] ?? []; + } + $indexMeta = $index->getMetaData($key); + + $indexChecksum = $indexMeta['checksum'] ?? $indexMeta['storage_timestamp'] ?? null; + $objectChecksum = $objectMeta['checksum'] ?? $objectMeta['storage_timestamp'] ?? null; + if ($indexChecksum !== $objectChecksum) { + unset($fetched[$key]); + } + } + } + + } catch (InvalidArgumentException $e) { + $debugger->addException($e); + } + + return $fetched; + } + + /** + * @return void + */ + public function reloadIndex(): void + { + $this->getCache('index')->clear(); + $this->getIndex()::loadEntriesFromStorage($this->getStorage()); + + $this->indexes = []; + $this->objects = []; + } + + /** + * @param string $scope + * @param string $action + * @return string + */ + public function getAuthorizeRule(string $scope, string $action): string + { + if (!$this->_authorize) { + $config = $this->getConfig('admin.permissions'); + if ($config) { + $this->_authorize = array_key_first($config) . '.%2$s'; + } else { + $this->_authorize = '%1$s.flex-object.%2$s'; + } + } + + return sprintf($this->_authorize, $scope, $action); + } + + /** + * @param string $type_view + * @param string $context + * @return Blueprint + */ + protected function getBlueprintInternal(string $type_view = '', string $context = '') + { + if (!isset($this->blueprints[$type_view])) { + if (!file_exists($this->blueprint_file)) { + throw new RuntimeException(sprintf('Flex: Blueprint file for %s is missing', $this->type)); + } + + $parts = explode('.', rtrim($type_view, '.'), 2); + $type = array_shift($parts); + $view = array_shift($parts) ?: ''; + + $blueprint = new Blueprint($this->getBlueprintFile($view)); + $blueprint->addDynamicHandler('data', function (array &$field, $property, array &$call) { + $this->dynamicDataField($field, $property, $call); + }); + $blueprint->addDynamicHandler('flex', function (array &$field, $property, array &$call) { + $this->dynamicFlexField($field, $property, $call); + }); + $blueprint->addDynamicHandler('authorize', function (array &$field, $property, array &$call) { + $this->dynamicAuthorizeField($field, $property, $call); + }); + + if ($context) { + $blueprint->setContext($context); + } + + $blueprint->load($type ?: null); + if ($blueprint->get('type') === 'flex-objects' && isset(Grav::instance()['admin'])) { + $blueprintBase = (new Blueprint('plugin://flex-objects/blueprints/flex-objects.yaml'))->load(); + $blueprint->extend($blueprintBase, true); + } + + $this->blueprints[$type_view] = $blueprint; + } + + return $this->blueprints[$type_view]; + } + + /** + * @param array $field + * @param string $property + * @param array $call + * @return void + */ + protected function dynamicDataField(array &$field, $property, array $call) + { + $params = $call['params']; + if (is_array($params)) { + $function = array_shift($params); + } else { + $function = $params; + $params = []; + } + + $object = $call['object']; + if ($function === '\Grav\Common\Page\Pages::pageTypes') { + $params = [$object instanceof PageInterface && $object->isModule() ? 'modular' : 'standard']; + } + + $data = null; + if (is_callable($function)) { + $data = call_user_func_array($function, $params); + } + + // If function returns a value, + if (null !== $data) { + if (is_array($data) && isset($field[$property]) && is_array($field[$property])) { + // Combine field and @data-field together. + $field[$property] += $data; + } else { + // Or create/replace field with @data-field. + $field[$property] = $data; + } + } + } + + /** + * @param array $field + * @param string $property + * @param array $call + * @return void + */ + protected function dynamicFlexField(array &$field, $property, array $call): void + { + $params = (array)$call['params']; + $object = $call['object'] ?? null; + $method = array_shift($params); + $not = false; + if (str_starts_with($method, '!')) { + $method = substr($method, 1); + $not = true; + } elseif (str_starts_with($method, 'not ')) { + $method = substr($method, 4); + $not = true; + } + $method = trim($method); + + if ($object && method_exists($object, $method)) { + $value = $object->{$method}(...$params); + if (is_array($value) && isset($field[$property]) && is_array($field[$property])) { + $value = $this->mergeArrays($field[$property], $value); + } + $value = $not ? !$value : $value; + + if ($property === 'ignore' && $value) { + Blueprint::addPropertyRecursive($field, 'validate', ['ignore' => true]); + } else { + $field[$property] = $value; + } + } + } + + /** + * @param array $field + * @param string $property + * @param array $call + * @return void + */ + protected function dynamicAuthorizeField(array &$field, $property, array $call): void + { + $params = (array)$call['params']; + $object = $call['object'] ?? null; + $permission = array_shift($params); + $not = false; + if (str_starts_with($permission, '!')) { + $permission = substr($permission, 1); + $not = true; + } elseif (str_starts_with($permission, 'not ')) { + $permission = substr($permission, 4); + $not = true; + } + $permission = trim($permission); + + if ($object) { + $value = $object->isAuthorized($permission) ?? false; + + $field[$property] = $not ? !$value : $value; + } + } + + /** + * @param array $array1 + * @param array $array2 + * @return array + */ + protected function mergeArrays(array $array1, array $array2): array + { + foreach ($array2 as $key => $value) { + if (is_array($value) && isset($array1[$key]) && is_array($array1[$key])) { + $array1[$key] = $this->mergeArrays($array1[$key], $value); + } else { + $array1[$key] = $value; + } + } + + return $array1; + } + + /** + * @return FlexStorageInterface + */ + protected function createStorage(): FlexStorageInterface + { + $this->collection = $this->createCollection([]); + + $storage = $this->getConfig('data.storage'); + + if (!is_array($storage)) { + $storage = ['options' => ['folder' => $storage]]; + } + + $className = $storage['class'] ?? SimpleStorage::class; + $options = $storage['options'] ?? []; + + if (!is_a($className, FlexStorageInterface::class, true)) { + throw new \RuntimeException('Bad storage class: ' . $className); + } + + return new $className($options); + } + + /** + * @param string $keyField + * @return FlexIndexInterface + * @phpstan-return FlexIndexInterface + */ + protected function loadIndex(string $keyField): FlexIndexInterface + { + static $i = 0; + + $index = $this->indexes[$keyField] ?? null; + if (null !== $index) { + return $index; + } + + $index = $this->indexes['storage_key'] ?? null; + if (null === $index) { + $i++; + $j = $i; + /** @var Debugger $debugger */ + $debugger = Grav::instance()['debugger']; + $debugger->startTimer('flex-keys-' . $this->type . $j, "Flex: Loading {$this->type} index"); + + $storage = $this->getStorage(); + $cache = $this->getCache('index'); + + try { + $keys = $cache->get('__keys'); + } catch (InvalidArgumentException $e) { + $debugger->addException($e); + $keys = null; + } + + if (!is_array($keys)) { + /** @phpstan-var class-string $className */ + $className = $this->getIndexClass(); + $keys = $className::loadEntriesFromStorage($storage); + if (!$cache instanceof MemoryCache) { + $debugger->addMessage( + sprintf('Flex: Caching %s index of %d objects', $this->type, count($keys)), + 'debug' + ); + } + try { + $cache->set('__keys', $keys); + } catch (InvalidArgumentException $e) { + $debugger->addException($e); + // TODO: log about the issue. + } + } + + $ordering = $this->getConfig('data.ordering', []); + + // We need to do this in two steps as orderBy() calls loadIndex() again and we do not want infinite loop. + $this->indexes['storage_key'] = $index = $this->createIndex($keys, 'storage_key'); + if ($ordering) { + /** @var FlexCollectionInterface $collection */ + $collection = $this->indexes['storage_key']->orderBy($ordering); + $this->indexes['storage_key'] = $index = $collection->getIndex(); + } + + $debugger->stopTimer('flex-keys-' . $this->type . $j); + } + + if ($keyField !== 'storage_key') { + $this->indexes[$keyField] = $index = $index->withKeyField($keyField ?: null); + } + + return $index; + } + + /** + * @param string $action + * @return string + */ + protected function getAuthorizeAction(string $action): string + { + // Handle special action save, which can mean either update or create. + if ($action === 'save') { + $action = 'create'; + } + + return $action; + } + /** + * @return UserInterface|null + */ + protected function getActiveUser(): ?UserInterface + { + /** @var UserInterface|null $user */ + $user = Grav::instance()['user'] ?? null; + + return $user; + } + + /** + * @return string + */ + protected function getAuthorizeScope(): string + { + return isset(Grav::instance()['admin']) ? 'admin' : 'site'; + } + + // DEPRECATED METHODS + + /** + * @return string + * @deprecated 1.6 Use ->getFlexType() method instead. + */ + public function getType(): string + { + user_error(__CLASS__ . '::' . __FUNCTION__ . '() is deprecated since Grav 1.6, use ->getFlexType() method instead', E_USER_DEPRECATED); + + return $this->type; + } + + /** + * @param array $data + * @param string|null $key + * @return FlexObjectInterface + * @deprecated 1.7 Use $object->update()->save() instead. + */ + public function update(array $data, string $key = null): FlexObjectInterface + { + user_error(__CLASS__ . '::' . __FUNCTION__ . '() should not be used anymore: use $object->update()->save() instead.', E_USER_DEPRECATED); + + $object = null !== $key ? $this->getIndex()->get($key): null; + + $storage = $this->getStorage(); + + if (null === $object) { + $object = $this->createObject($data, $key ?? '', true); + $key = $object->getStorageKey(); + + if ($key) { + $storage->replaceRows([$key => $object->prepareStorage()]); + } else { + $storage->createRows([$object->prepareStorage()]); + } + } else { + $oldKey = $object->getStorageKey(); + $object->update($data); + $newKey = $object->getStorageKey(); + + if ($oldKey !== $newKey) { + if (method_exists($object, 'triggerEvent')) { + $object->triggerEvent('move'); + } + $storage->renameRow($oldKey, $newKey); + // TODO: media support. + } + + $object->save(); + } + + try { + $this->clearCache(); + } catch (InvalidArgumentException $e) { + /** @var Debugger $debugger */ + $debugger = Grav::instance()['debugger']; + $debugger->addException($e); + + // Caching failed, but we can ignore that for now. + } + + return $object; + } + + /** + * @param string $key + * @return FlexObjectInterface|null + * @deprecated 1.7 Use $object->delete() instead. + */ + public function remove(string $key): ?FlexObjectInterface + { + user_error(__CLASS__ . '::' . __FUNCTION__ . '() should not be used anymore: use $object->delete() instead.', E_USER_DEPRECATED); + + $object = $this->getIndex()->get($key); + if (!$object) { + return null; + } + + $object->delete(); + + return $object; + } +} diff --git a/system/src/Grav/Framework/Flex/FlexDirectoryForm.php b/system/src/Grav/Framework/Flex/FlexDirectoryForm.php new file mode 100644 index 0000000..459fb49 --- /dev/null +++ b/system/src/Grav/Framework/Flex/FlexDirectoryForm.php @@ -0,0 +1,509 @@ +getDirectoryForm($name, $options); + } + + /** + * FlexForm constructor. + * @param string $name + * @param FlexDirectory $directory + * @param array|null $options + */ + public function __construct(string $name, FlexDirectory $directory, array $options = null) + { + $this->name = $name; + $this->setDirectory($directory); + $this->setName($directory->getFlexType(), $name); + $this->setId($this->getName()); + + $uniqueId = $options['unique_id'] ?? null; + if (!$uniqueId) { + $uniqueId = md5($directory->getFlexType() . '-directory-' . $this->name); + } + $this->setUniqueId($uniqueId); + + $this->setFlashLookupFolder($directory->getDirectoryBlueprint()->get('form/flash_folder') ?? 'tmp://forms/[SESSIONID]'); + $this->form = $options['form'] ?? null; + + if (Utils::isPositive($this->form['disabled'] ?? false)) { + $this->disable(); + } + + $this->initialize(); + } + + /** + * @return $this + */ + public function initialize() + { + $this->messages = []; + $this->submitted = false; + $this->data = new Data($this->directory->loadDirectoryConfig($this->name), $this->getBlueprint()); + $this->files = []; + $this->unsetFlash(); + + /** @var FlexFormFlash $flash */ + $flash = $this->getFlash(); + if ($flash->exists()) { + $data = $flash->getData(); + $includeOriginal = (bool)($this->getBlueprint()->form()['images']['original'] ?? null); + + $directory = $flash->getDirectory(); + if (null === $directory) { + throw new RuntimeException('Flash has no directory'); + } + $this->directory = $directory; + $this->data = $data ? new Data($data, $this->getBlueprint()) : null; + $this->files = $flash->getFilesByFields($includeOriginal); + } + + return $this; + } + + /** + * @param string $uniqueId + * @return void + */ + public function setUniqueId(string $uniqueId): void + { + if ($uniqueId !== '') { + $this->uniqueid = $uniqueId; + } + } + + /** + * @param string $name + * @param mixed $default + * @param string|null $separator + * @return mixed + */ + public function get($name, $default = null, $separator = null) + { + switch (strtolower($name)) { + case 'id': + case 'uniqueid': + case 'name': + case 'noncename': + case 'nonceaction': + case 'action': + case 'data': + case 'files': + case 'errors'; + case 'fields': + case 'blueprint': + case 'page': + $method = 'get' . $name; + return $this->{$method}(); + } + + return $this->traitGet($name, $default, $separator); + } + + /** + * @param string $name + * @param mixed $value + * @param string|null $separator + * @return $this + */ + public function set($name, $value, $separator = null) + { + switch (strtolower($name)) { + case 'id': + case 'uniqueid': + $method = 'set' . $name; + return $this->{$method}(); + } + + return $this->traitSet($name, $value, $separator); + } + + /** + * @return string + */ + public function getName(): string + { + return $this->flexName; + } + + protected function setName(string $type, string $name): void + { + // Make sure that both type and name do not have dash (convert dashes to underscores). + $type = str_replace('-', '_', $type); + $name = str_replace('-', '_', $name); + $this->flexName = $name ? "flex_conf-{$type}-{$name}" : "flex_conf-{$type}"; + } + + /** + * @return Data|object + */ + public function getData() + { + if (null === $this->data) { + $this->data = new Data([], $this->getBlueprint()); + } + + return $this->data; + } + + /** + * Get a value from the form. + * + * Note: Used in form fields. + * + * @param string $name + * @return mixed + */ + public function getValue(string $name) + { + // Attempt to get value from the form data. + $value = $this->data ? $this->data[$name] : null; + + // Return the form data or fall back to the object property. + return $value ?? null; + } + + /** + * @param string $name + * @return array|mixed|null + */ + public function getDefaultValue(string $name) + { + return $this->getBlueprint()->getDefaultValue($name); + } + + /** + * @return array + */ + public function getDefaultValues(): array + { + return $this->getBlueprint()->getDefaults(); + } + /** + * @return string + */ + public function getFlexType(): string + { + return $this->directory->getFlexType(); + } + + /** + * Get form flash object. + * + * @return FormFlashInterface|FlexFormFlash + */ + public function getFlash() + { + if (null === $this->flash) { + $grav = Grav::instance(); + $config = [ + 'session_id' => $this->getSessionId(), + 'unique_id' => $this->getUniqueId(), + 'form_name' => $this->getName(), + 'folder' => $this->getFlashFolder(), + 'id' => $this->getFlashId(), + 'directory' => $this->getDirectory() + ]; + + $this->flash = new FlexFormFlash($config); + $this->flash + ->setUrl($grav['uri']->url) + ->setUser($grav['user'] ?? null); + } + + return $this->flash; + } + + /** + * @return FlexDirectory + */ + public function getDirectory(): FlexDirectory + { + return $this->directory; + } + + /** + * @return Blueprint + */ + public function getBlueprint(): Blueprint + { + if (null === $this->blueprint) { + try { + $blueprint = $this->getDirectory()->getDirectoryBlueprint(); + if ($this->form) { + // We have field overrides available. + $blueprint->extend(['form' => $this->form], true); + $blueprint->init(); + } + } catch (RuntimeException $e) { + if (!isset($this->form['fields'])) { + throw $e; + } + + // Blueprint is not defined, but we have custom form fields available. + $blueprint = new Blueprint(null, ['form' => $this->form]); + $blueprint->load(); + $blueprint->setScope('directory'); + $blueprint->init(); + } + + $this->blueprint = $blueprint; + } + + return $this->blueprint; + } + + /** + * @return Route|null + */ + public function getFileUploadAjaxRoute(): ?Route + { + return null; + } + + /** + * @param string|null $field + * @param string|null $filename + * @return Route|null + */ + public function getFileDeleteAjaxRoute($field = null, $filename = null): ?Route + { + return null; + } + + /** + * @param array $params + * @param string|null $extension + * @return string + */ + public function getMediaTaskRoute(array $params = [], string $extension = null): string + { + return ''; + } + + /** + * @param string $name + * @return mixed|null + */ + #[\ReturnTypeWillChange] + public function __get($name) + { + $method = "get{$name}"; + if (method_exists($this, $method)) { + return $this->{$method}(); + } + + $form = $this->getBlueprint()->form(); + + return $form[$name] ?? null; + } + + /** + * @param string $name + * @param mixed $value + * @return void + */ + #[\ReturnTypeWillChange] + public function __set($name, $value) + { + $method = "set{$name}"; + if (method_exists($this, $method)) { + $this->{$method}($value); + } + } + + /** + * @param string $name + * @return bool + */ + #[\ReturnTypeWillChange] + public function __isset($name) + { + $method = "get{$name}"; + if (method_exists($this, $method)) { + return true; + } + + $form = $this->getBlueprint()->form(); + + return isset($form[$name]); + } + + /** + * @param string $name + * @return void + */ + #[\ReturnTypeWillChange] + public function __unset($name) + { + } + + /** + * @return array|bool + */ + protected function getUnserializeAllowedClasses() + { + return [FlexObject::class]; + } + + /** + * Note: this method clones the object. + * + * @param FlexDirectory $directory + * @return $this + */ + protected function setDirectory(FlexDirectory $directory): self + { + $this->directory = $directory; + + return $this; + } + + /** + * @param string $layout + * @return Template|TemplateWrapper + * @throws LoaderError + * @throws SyntaxError + */ + protected function getTemplate($layout) + { + $grav = Grav::instance(); + + /** @var Twig $twig */ + $twig = $grav['twig']; + + return $twig->twig()->resolveTemplate( + [ + "flex-objects/layouts/{$this->getFlexType()}/form/{$layout}.html.twig", + "flex-objects/layouts/_default/form/{$layout}.html.twig", + "forms/{$layout}/form.html.twig", + 'forms/default/form.html.twig' + ] + ); + } + + /** + * @param array $data + * @param array $files + * @return void + * @throws Exception + */ + protected function doSubmit(array $data, array $files) + { + $this->directory->saveDirectoryConfig($this->name, $data); + + $this->reset(); + } + + /** + * @return array + */ + protected function doSerialize(): array + { + return $this->doTraitSerialize() + [ + 'form' => $this->form, + 'directory' => $this->directory, + 'flexName' => $this->flexName + ]; + } + + /** + * @param array $data + * @return void + */ + protected function doUnserialize(array $data): void + { + $this->doTraitUnserialize($data); + + $this->form = $data['form']; + $this->directory = $data['directory']; + $this->flexName = $data['flexName']; + } + + /** + * Filter validated data. + * + * @param ArrayAccess|Data|null $data + * @phpstan-param ArrayAccess|Data|null $data + */ + protected function filterData($data = null): void + { + if ($data instanceof Data) { + $data->filter(false, true); + } + } +} diff --git a/system/src/Grav/Framework/Flex/FlexForm.php b/system/src/Grav/Framework/Flex/FlexForm.php new file mode 100644 index 0000000..f3a0d1f --- /dev/null +++ b/system/src/Grav/Framework/Flex/FlexForm.php @@ -0,0 +1,610 @@ +getObject($key) ?? $directory->createObject([], $key); + } else { + throw new RuntimeException(__METHOD__ . "(): You need to pass option 'directory' or 'object'", 400); + } + + $name = $options['name'] ?? ''; + + // There is no reason to pass object and directory. + unset($options['object'], $options['directory']); + + return $object->getForm($name, $options); + } + + /** + * FlexForm constructor. + * @param string $name + * @param FlexObjectInterface $object + * @param array|null $options + */ + public function __construct(string $name, FlexObjectInterface $object, array $options = null) + { + $this->name = $name; + $this->setObject($object); + + if (isset($options['form']['name'])) { + // Use custom form name. + $this->flexName = $options['form']['name']; + } else { + // Use standard form name. + $this->setName($object->getFlexType(), $name); + } + $this->setId($this->getName()); + + $uniqueId = $options['unique_id'] ?? null; + if (!$uniqueId) { + if ($object->exists()) { + $uniqueId = $object->getStorageKey(); + } elseif ($object->hasKey()) { + $uniqueId = "{$object->getKey()}:new"; + } else { + $uniqueId = "{$object->getFlexType()}:new"; + } + $uniqueId = md5($uniqueId); + } + $this->setUniqueId($uniqueId); + + $directory = $object->getFlexDirectory(); + $this->setFlashLookupFolder($options['flash_folder'] ?? $directory->getBlueprint()->get('form/flash_folder') ?? 'tmp://forms/[SESSIONID]'); + $this->form = $options['form'] ?? null; + + if (Utils::isPositive($this->items['disabled'] ?? $this->form['disabled'] ?? false)) { + $this->disable(); + } + + if (!empty($options['reset'])) { + $this->getFlash()->delete(); + } + + $this->initialize(); + } + + /** + * @return $this + */ + public function initialize() + { + $this->messages = []; + $this->submitted = false; + $this->data = null; + $this->files = []; + $this->unsetFlash(); + + /** @var FlexFormFlash $flash */ + $flash = $this->getFlash(); + if ($flash->exists()) { + $data = $flash->getData(); + if (null !== $data) { + $data = new Data($data, $this->getBlueprint()); + $data->setKeepEmptyValues(true); + $data->setMissingValuesAsNull(true); + } + + $object = $flash->getObject(); + if (null === $object) { + throw new RuntimeException('Flash has no object'); + } + + $this->object = $object; + $this->data = $data; + + $includeOriginal = (bool)($this->getBlueprint()->form()['images']['original'] ?? null); + $this->files = $flash->getFilesByFields($includeOriginal); + } + + return $this; + } + + /** + * @param string $uniqueId + * @return void + */ + public function setUniqueId(string $uniqueId): void + { + if ($uniqueId !== '') { + $this->uniqueid = $uniqueId; + } + } + + /** + * @param string $name + * @param mixed $default + * @param string|null $separator + * @return mixed + */ + public function get($name, $default = null, $separator = null) + { + switch (strtolower($name)) { + case 'id': + case 'uniqueid': + case 'name': + case 'noncename': + case 'nonceaction': + case 'action': + case 'data': + case 'files': + case 'errors'; + case 'fields': + case 'blueprint': + case 'page': + $method = 'get' . $name; + return $this->{$method}(); + } + + return $this->traitGet($name, $default, $separator); + } + + /** + * @param string $name + * @param mixed $value + * @param string|null $separator + * @return FlexForm + */ + public function set($name, $value, $separator = null) + { + switch (strtolower($name)) { + case 'id': + case 'uniqueid': + $method = 'set' . $name; + return $this->{$method}(); + } + + return $this->traitSet($name, $value, $separator); + } + + /** + * @return string + */ + public function getName(): string + { + return $this->flexName; + } + + /** + * @param callable|null $submitMethod + */ + public function setSubmitMethod(?callable $submitMethod): void + { + $this->submitMethod = $submitMethod; + } + + /** + * @param string $type + * @param string $name + */ + protected function setName(string $type, string $name): void + { + // Make sure that both type and name do not have dash (convert dashes to underscores). + $type = str_replace('-', '_', $type); + $name = str_replace('-', '_', $name); + $this->flexName = $name ? "flex-{$type}-{$name}" : "flex-{$type}"; + } + + /** + * @return Data|FlexObjectInterface|object + */ + public function getData() + { + return $this->data ?? $this->getObject(); + } + + /** + * Get a value from the form. + * + * Note: Used in form fields. + * + * @param string $name + * @return mixed + */ + public function getValue(string $name) + { + // Attempt to get value from the form data. + $value = $this->data ? $this->data[$name] : null; + + // Return the form data or fall back to the object property. + return $value ?? $this->getObject()->getFormValue($name); + } + + /** + * @param string $name + * @return array|mixed|null + */ + public function getDefaultValue(string $name) + { + return $this->object->getDefaultValue($name); + } + + /** + * @return array + */ + public function getDefaultValues(): array + { + return $this->object->getDefaultValues(); + } + /** + * @return string + */ + public function getFlexType(): string + { + return $this->object->getFlexType(); + } + + /** + * Get form flash object. + * + * @return FormFlashInterface|FlexFormFlash + */ + public function getFlash() + { + if (null === $this->flash) { + $grav = Grav::instance(); + $config = [ + 'session_id' => $this->getSessionId(), + 'unique_id' => $this->getUniqueId(), + 'form_name' => $this->getName(), + 'folder' => $this->getFlashFolder(), + 'id' => $this->getFlashId(), + 'object' => $this->getObject() + ]; + + $this->flash = new FlexFormFlash($config); + $this->flash + ->setUrl($grav['uri']->url) + ->setUser($grav['user'] ?? null); + } + + return $this->flash; + } + + /** + * @return FlexObjectInterface + */ + public function getObject(): FlexObjectInterface + { + return $this->object; + } + + /** + * @return FlexObjectInterface + */ + public function updateObject(): FlexObjectInterface + { + $data = $this->data instanceof Data ? $this->data->toArray() : []; + $files = $this->files; + + return $this->getObject()->update($data, $files); + } + + /** + * @return Blueprint + */ + public function getBlueprint(): Blueprint + { + if (null === $this->blueprint) { + try { + $blueprint = $this->getObject()->getBlueprint($this->name); + if ($this->form) { + // We have field overrides available. + $blueprint->extend(['form' => $this->form], true); + $blueprint->init(); + } + } catch (RuntimeException $e) { + if (!isset($this->form['fields'])) { + throw $e; + } + + // Blueprint is not defined, but we have custom form fields available. + $blueprint = new Blueprint(null, ['form' => $this->form]); + $blueprint->load(); + $blueprint->setScope('object'); + $blueprint->init(); + } + + $this->blueprint = $blueprint; + } + + return $this->blueprint; + } + + /** + * @return Route|null + */ + public function getFileUploadAjaxRoute(): ?Route + { + $object = $this->getObject(); + if (!method_exists($object, 'route')) { + /** @var Route $route */ + $route = Grav::instance()['route']; + + return $route->withExtension('json')->withGravParam('task', 'media.upload'); + } + + return $object->route('/edit.json/task:media.upload'); + } + + /** + * @param string|null $field + * @param string|null $filename + * @return Route|null + */ + public function getFileDeleteAjaxRoute($field = null, $filename = null): ?Route + { + $object = $this->getObject(); + if (!method_exists($object, 'route')) { + /** @var Route $route */ + $route = Grav::instance()['route']; + + return $route->withExtension('json')->withGravParam('task', 'media.delete'); + } + + return $object->route('/edit.json/task:media.delete'); + } + + /** + * @param array $params + * @param string|null $extension + * @return string + */ + public function getMediaTaskRoute(array $params = [], string $extension = null): string + { + $grav = Grav::instance(); + /** @var Flex $flex */ + $flex = $grav['flex_objects']; + + if (method_exists($flex, 'adminRoute')) { + return $flex->adminRoute($this->getObject(), $params, $extension ?? 'json'); + } + + return ''; + } + + /** + * @param string $name + * @return mixed|null + */ + #[\ReturnTypeWillChange] + public function __get($name) + { + $method = "get{$name}"; + if (method_exists($this, $method)) { + return $this->{$method}(); + } + + $form = $this->getBlueprint()->form(); + + return $form[$name] ?? null; + } + + /** + * @param string $name + * @param mixed $value + * @return void + */ + #[\ReturnTypeWillChange] + public function __set($name, $value) + { + $method = "set{$name}"; + if (method_exists($this, $method)) { + $this->{$method}($value); + } + } + + /** + * @param string $name + * @return bool + */ + #[\ReturnTypeWillChange] + public function __isset($name) + { + $method = "get{$name}"; + if (method_exists($this, $method)) { + return true; + } + + $form = $this->getBlueprint()->form(); + + return isset($form[$name]); + } + + /** + * @param string $name + * @return void + */ + #[\ReturnTypeWillChange] + public function __unset($name) + { + } + + /** + * @return array|bool + */ + protected function getUnserializeAllowedClasses() + { + return [FlexObject::class]; + } + + /** + * Note: this method clones the object. + * + * @param FlexObjectInterface $object + * @return $this + */ + protected function setObject(FlexObjectInterface $object): self + { + $this->object = clone $object; + + return $this; + } + + /** + * @param string $layout + * @return Template|TemplateWrapper + * @throws LoaderError + * @throws SyntaxError + */ + protected function getTemplate($layout) + { + $grav = Grav::instance(); + + /** @var Twig $twig */ + $twig = $grav['twig']; + + return $twig->twig()->resolveTemplate( + [ + "flex-objects/layouts/{$this->getFlexType()}/form/{$layout}.html.twig", + "flex-objects/layouts/_default/form/{$layout}.html.twig", + "forms/{$layout}/form.html.twig", + 'forms/default/form.html.twig' + ] + ); + } + + /** + * @param array $data + * @param array $files + * @return void + * @throws Exception + */ + protected function doSubmit(array $data, array $files) + { + /** @var FlexObject $object */ + $object = clone $this->getObject(); + + $method = $this->submitMethod; + if ($method) { + $method($data, $files, $object); + } else { + $object->update($data, $files); + $object->save(); + } + + $this->setObject($object); + $this->reset(); + } + + /** + * @return array + */ + protected function doSerialize(): array + { + return $this->doTraitSerialize() + [ + 'items' => $this->items, + 'form' => $this->form, + 'object' => $this->object, + 'flexName' => $this->flexName, + 'submitMethod' => $this->submitMethod, + ]; + } + + /** + * @param array $data + * @return void + */ + protected function doUnserialize(array $data): void + { + $this->doTraitUnserialize($data); + + $this->items = $data['items'] ?? null; + $this->form = $data['form'] ?? null; + $this->object = $data['object'] ?? null; + $this->flexName = $data['flexName'] ?? null; + $this->submitMethod = $data['submitMethod'] ?? null; + } + + /** + * Filter validated data. + * + * @param ArrayAccess|Data|null $data + * @return void + * @phpstan-param ArrayAccess|Data|null $data + */ + protected function filterData($data = null): void + { + if ($data instanceof Data) { + $data->filter(true, true); + } + } +} diff --git a/system/src/Grav/Framework/Flex/FlexFormFlash.php b/system/src/Grav/Framework/Flex/FlexFormFlash.php new file mode 100644 index 0000000..084c346 --- /dev/null +++ b/system/src/Grav/Framework/Flex/FlexFormFlash.php @@ -0,0 +1,130 @@ +object = $object; + $this->directory = $object->getFlexDirectory(); + } + + /** + * @return FlexObjectInterface|null + */ + public function getObject(): ?FlexObjectInterface + { + return $this->object; + } + + /** + * @param FlexDirectory $directory + */ + public function setDirectory(FlexDirectory $directory): void + { + $this->directory = $directory; + } + + /** + * @return FlexDirectory|null + */ + public function getDirectory(): ?FlexDirectory + { + return $this->directory; + } + + /** + * @return array + */ + public function jsonSerialize(): array + { + $serialized = parent::jsonSerialize(); + + $object = $this->getObject(); + if ($object instanceof FlexObjectInterface) { + $serialized['object'] = [ + 'type' => $object->getFlexType(), + 'key' => $object->getKey() ?: null, + 'storage_key' => $object->getStorageKey(), + 'timestamp' => $object->getTimestamp(), + 'serialized' => $object->prepareStorage() + ]; + } else { + $directory = $this->getDirectory(); + if ($directory instanceof FlexDirectory) { + $serialized['directory'] = [ + 'type' => $directory->getFlexType() + ]; + } + } + + return $serialized; + } + + /** + * @param array|null $data + * @param array $config + * @return void + */ + protected function init(?array $data, array $config): void + { + parent::init($data, $config); + + $data = $data ?? []; + /** @var FlexObjectInterface|null $object */ + $object = $config['object'] ?? null; + $create = true; + if ($object) { + $directory = $object->getFlexDirectory(); + $create = !$object->exists(); + } elseif (null === ($directory = $config['directory'] ?? null)) { + $flex = $config['flex'] ?? static::$flex; + $type = $data['object']['type'] ?? $data['directory']['type'] ?? null; + $directory = $flex && $type ? $flex->getDirectory($type) : null; + } + + if ($directory && $create && isset($data['object']['serialized'])) { + // TODO: update instead of create new. + $object = $directory->createObject($data['object']['serialized'], $data['object']['key'] ?? ''); + } + + if ($object) { + $this->setObject($object); + } elseif ($directory) { + $this->setDirectory($directory); + } + } +} diff --git a/system/src/Grav/Framework/Flex/FlexIdentifier.php b/system/src/Grav/Framework/Flex/FlexIdentifier.php new file mode 100644 index 0000000..ec47ed8 --- /dev/null +++ b/system/src/Grav/Framework/Flex/FlexIdentifier.php @@ -0,0 +1,75 @@ + + */ +class FlexIdentifier extends Identifier +{ + /** @var string */ + private $keyField; + /** @var FlexObjectInterface|null */ + private $object = null; + + /** + * @param FlexObjectInterface $object + * @return FlexIdentifier + */ + public static function createFromObject(FlexObjectInterface $object): FlexIdentifier + { + $instance = new static($object->getKey(), $object->getFlexType(), 'key'); + $instance->setObject($object); + + return $instance; + } + + /** + * IdentifierInterface constructor. + * @param string $id + * @param string $type + * @param string $keyField + */ + public function __construct(string $id, string $type, string $keyField = 'key') + { + parent::__construct($id, $type); + + $this->keyField = $keyField; + } + + /** + * @return T + */ + public function getObject(): ?FlexObjectInterface + { + if (!isset($this->object)) { + /** @var Flex $flex */ + $flex = Grav::instance()['flex']; + + $this->object = $flex->getObject($this->getId(), $this->getType(), $this->keyField); + } + + return $this->object; + } + + /** + * @param T $object + */ + public function setObject(FlexObjectInterface $object): void + { + $type = $this->getType(); + if ($type !== $object->getFlexType()) { + throw new RuntimeException(sprintf('Object has to be type %s, %s given', $type, $object->getFlexType())); + } + + $this->object = $object; + } +} diff --git a/system/src/Grav/Framework/Flex/FlexIndex.php b/system/src/Grav/Framework/Flex/FlexIndex.php new file mode 100644 index 0000000..39fec18 --- /dev/null +++ b/system/src/Grav/Framework/Flex/FlexIndex.php @@ -0,0 +1,930 @@ + + * @implements FlexIndexInterface + * @mixin C + */ +class FlexIndex extends ObjectIndex implements FlexIndexInterface +{ + const VERSION = 1; + + /** @var FlexDirectory|null */ + private $_flexDirectory; + /** @var string */ + private $_keyField = 'storage_key'; + /** @var array */ + private $_indexKeys; + + /** + * @param FlexDirectory $directory + * @return static + * @phpstan-return static + */ + public static function createFromStorage(FlexDirectory $directory) + { + return static::createFromArray(static::loadEntriesFromStorage($directory->getStorage()), $directory); + } + + /** + * {@inheritdoc} + * @see FlexCollectionInterface::createFromArray() + */ + public static function createFromArray(array $entries, FlexDirectory $directory, string $keyField = null) + { + $instance = new static($entries, $directory); + $instance->setKeyField($keyField); + + return $instance; + } + + /** + * @param FlexStorageInterface $storage + * @return array + */ + public static function loadEntriesFromStorage(FlexStorageInterface $storage): array + { + return $storage->getExistingKeys(); + } + + /** + * You can define indexes for fast lookup. + * + * Primary key: $meta['key'] + * Secondary keys: $meta['my_field'] + * + * @param array $meta + * @param array $data + * @param FlexStorageInterface $storage + * @return void + */ + public static function updateObjectMeta(array &$meta, array $data, FlexStorageInterface $storage) + { + // For backwards compatibility, no need to call this method when you override this method. + static::updateIndexData($meta, $data); + } + + /** + * Initializes a new FlexIndex. + * + * @param array $entries + * @param FlexDirectory|null $directory + */ + public function __construct(array $entries = [], FlexDirectory $directory = null) + { + // @phpstan-ignore-next-line + if (get_class($this) === __CLASS__) { + user_error('Using ' . __CLASS__ . ' directly is deprecated since Grav 1.7, use \Grav\Common\Flex\Types\Generic\GenericIndex or your own class instead', E_USER_DEPRECATED); + } + + parent::__construct($entries); + + $this->_flexDirectory = $directory; + $this->setKeyField(null); + } + + /** + * @return string + */ + public function getKey() + { + return $this->_key ?: $this->getFlexType() . '@@' . spl_object_hash($this); + } + + /** + * {@inheritdoc} + * @see FlexCommonInterface::hasFlexFeature() + */ + public function hasFlexFeature(string $name): bool + { + return in_array($name, $this->getFlexFeatures(), true); + } + + /** + * {@inheritdoc} + * @see FlexCommonInterface::hasFlexFeature() + */ + public function getFlexFeatures(): array + { + /** @var array $implements */ + $implements = class_implements($this->getFlexDirectory()->getCollectionClass()); + + $list = []; + foreach ($implements as $interface) { + if ($pos = strrpos($interface, '\\')) { + $interface = substr($interface, $pos+1); + } + + $list[] = Inflector::hyphenize(str_replace('Interface', '', $interface)); + } + + return $list; + } + + /** + * {@inheritdoc} + * @see FlexCollectionInterface::search() + */ + public function search(string $search, $properties = null, array $options = null) + { + $directory = $this->getFlexDirectory(); + $properties = $directory->getSearchProperties($properties); + $options = $directory->getSearchOptions($options); + + return $this->__call('search', [$search, $properties, $options]); + } + + /** + * {@inheritdoc} + * @see FlexCollectionInterface::sort() + */ + public function sort(array $orderings) + { + return $this->orderBy($orderings); + } + + /** + * {@inheritdoc} + * @see FlexCollectionInterface::filterBy() + */ + public function filterBy(array $filters) + { + return $this->__call('filterBy', [$filters]); + } + + /** + * {@inheritdoc} + * @see FlexCollectionInterface::getFlexType() + */ + public function getFlexType(): string + { + return $this->getFlexDirectory()->getFlexType(); + } + + /** + * {@inheritdoc} + * @see FlexCollectionInterface::getFlexDirectory() + */ + public function getFlexDirectory(): FlexDirectory + { + if (null === $this->_flexDirectory) { + throw new RuntimeException('Flex Directory not defined, object is not fully defined'); + } + + return $this->_flexDirectory; + } + + /** + * {@inheritdoc} + * @see FlexCollectionInterface::getTimestamp() + */ + public function getTimestamp(): int + { + $timestamps = $this->getTimestamps(); + + return $timestamps ? max($timestamps) : time(); + } + + /** + * {@inheritdoc} + * @see FlexCollectionInterface::getCacheKey() + */ + public function getCacheKey(): string + { + return $this->getTypePrefix() . $this->getFlexType() . '.' . sha1(json_encode($this->getKeys()) . $this->_keyField); + } + + /** + * {@inheritdoc} + * @see FlexCollectionInterface::getCacheChecksum() + */ + public function getCacheChecksum(): string + { + $list = []; + foreach ($this->getEntries() as $key => $value) { + $list[$key] = $value['checksum'] ?? $value['storage_timestamp']; + } + + return sha1((string)json_encode($list)); + } + + /** + * {@inheritdoc} + * @see FlexCollectionInterface::getTimestamps() + */ + public function getTimestamps(): array + { + return $this->getIndexMap('storage_timestamp'); + } + + /** + * {@inheritdoc} + * @see FlexCollectionInterface::getStorageKeys() + */ + public function getStorageKeys(): array + { + return $this->getIndexMap('storage_key'); + } + + /** + * {@inheritdoc} + * @see FlexCollectionInterface::getFlexKeys() + */ + public function getFlexKeys(): array + { + // Get storage keys for the objects. + $keys = []; + $type = $this->getFlexDirectory()->getFlexType() . '.obj:'; + + foreach ($this->getEntries() as $key => $value) { + $keys[$key] = $value['flex_key'] ?? $type . $value['storage_key']; + } + + return $keys; + } + + /** + * {@inheritdoc} + * @see FlexIndexInterface::withKeyField() + */ + public function withKeyField(string $keyField = null) + { + $keyField = $keyField ?: 'key'; + if ($keyField === $this->getKeyField()) { + return $this; + } + + $type = $keyField === 'flex_key' ? $this->getFlexDirectory()->getFlexType() . '.obj:' : ''; + $entries = []; + foreach ($this->getEntries() as $key => $value) { + if (!isset($value['key'])) { + $value['key'] = $key; + } + + if (isset($value[$keyField])) { + $entries[$value[$keyField]] = $value; + } elseif ($keyField === 'flex_key') { + $entries[$type . $value['storage_key']] = $value; + } + } + + return $this->createFrom($entries, $keyField); + } + + /** + * {@inheritdoc} + * @see FlexCollectionInterface::getIndex() + */ + public function getIndex() + { + return $this; + } + + /** + * @return FlexCollectionInterface + * @phpstan-return C + */ + public function getCollection() + { + return $this->loadCollection(); + } + + /** + * {@inheritdoc} + * @see FlexCollectionInterface::render() + */ + public function render(string $layout = null, array $context = []) + { + return $this->__call('render', [$layout, $context]); + } + + /** + * {@inheritdoc} + * @see FlexIndexInterface::getFlexKeys() + */ + public function getIndexMap(string $indexKey = null) + { + if (null === $indexKey) { + return $this->getEntries(); + } + + // Get storage keys for the objects. + $index = []; + foreach ($this->getEntries() as $key => $value) { + $index[$key] = $value[$indexKey] ?? null; + } + + return $index; + } + + /** + * @param string $key + * @return array + */ + public function getMetaData($key): array + { + return $this->getEntries()[$key] ?? []; + } + + /** + * @return string + */ + public function getKeyField(): string + { + return $this->_keyField; + } + + /** + * @param string|null $namespace + * @return CacheInterface + */ + public function getCache(string $namespace = null) + { + return $this->getFlexDirectory()->getCache($namespace); + } + + /** + * @param array $orderings + * @return static + * @phpstan-return static + */ + public function orderBy(array $orderings) + { + if (!$orderings || !$this->count()) { + return $this; + } + + // Handle primary key alias. + $keyField = $this->getFlexDirectory()->getStorage()->getKeyField(); + if ($keyField !== 'key' && $keyField !== 'storage_key' && isset($orderings[$keyField])) { + $orderings['key'] = $orderings[$keyField]; + unset($orderings[$keyField]); + } + + // Check if ordering needs to load the objects. + if (array_diff_key($orderings, $this->getIndexKeys())) { + return $this->__call('orderBy', [$orderings]); + } + + // Ordering can be done by using index only. + $previous = null; + foreach (array_reverse($orderings) as $field => $ordering) { + $field = (string)$field; + if ($this->getKeyField() === $field) { + $keys = $this->getKeys(); + $search = array_combine($keys, $keys) ?: []; + } elseif ($field === 'flex_key') { + $search = $this->getFlexKeys(); + } else { + $search = $this->getIndexMap($field); + } + + // Update current search to match the previous ordering. + if (null !== $previous) { + $search = array_replace($previous, $search); + } + + // Order by current field. + if (strtoupper($ordering) === 'DESC') { + arsort($search, SORT_NATURAL | SORT_FLAG_CASE); + } else { + asort($search, SORT_NATURAL | SORT_FLAG_CASE); + } + + $previous = $search; + } + + return $this->createFrom(array_replace($previous ?? [], $this->getEntries())); + } + + /** + * {@inheritDoc} + */ + public function call($method, array $arguments = []) + { + return $this->__call('call', [$method, $arguments]); + } + + /** + * @param string $name + * @param array $arguments + * @return mixed + */ + #[\ReturnTypeWillChange] + public function __call($name, $arguments) + { + /** @var Debugger $debugger */ + $debugger = Grav::instance()['debugger']; + + /** @phpstan-var class-string $className */ + $className = $this->getFlexDirectory()->getCollectionClass(); + $cachedMethods = $className::getCachedMethods(); + + $flexType = $this->getFlexType(); + + if (!empty($cachedMethods[$name])) { + $type = $cachedMethods[$name]; + if ($type === 'session') { + /** @var Session $session */ + $session = Grav::instance()['session']; + $cacheKey = $session->getId() . ($session->user->username ?? ''); + } else { + $cacheKey = ''; + } + $key = "{$flexType}.idx." . sha1($name . '.' . $cacheKey . json_encode($arguments) . $this->getCacheKey()); + $checksum = $this->getCacheChecksum(); + + $cache = $this->getCache('object'); + + try { + $cached = $cache->get($key); + $test = $cached[0] ?? null; + $result = $test === $checksum ? ($cached[1] ?? null) : null; + + // Make sure the keys aren't changed if the returned type is the same index type. + if ($result instanceof self && $flexType === $result->getFlexType()) { + $result = $result->withKeyField($this->getKeyField()); + } + } catch (InvalidArgumentException $e) { + $debugger->addException($e); + } + + if (!isset($result)) { + $collection = $this->loadCollection(); + $result = $collection->{$name}(...$arguments); + $debugger->addMessage("Cache miss: '{$flexType}::{$name}()'", 'debug'); + + try { + // If flex collection is returned, convert it back to flex index. + if ($result instanceof FlexCollection) { + $cached = $result->getFlexDirectory()->getIndex($result->getKeys(), $this->getKeyField()); + } else { + $cached = $result; + } + + $cache->set($key, [$checksum, $cached]); + } catch (InvalidArgumentException $e) { + $debugger->addException($e); + + // TODO: log error. + } + } + } else { + $collection = $this->loadCollection(); + if (\is_callable([$collection, $name])) { + $result = $collection->{$name}(...$arguments); + if (!isset($cachedMethods[$name])) { + $debugger->addMessage("Call '{$flexType}:{$name}()' isn't cached", 'debug'); + } + } else { + $result = null; + } + } + + return $result; + } + + /** + * @return array + */ + public function __serialize(): array + { + return ['type' => $this->getFlexType(), 'entries' => $this->getEntries()]; + } + + /** + * @param array $data + * @return void + */ + public function __unserialize(array $data): void + { + $this->_flexDirectory = Grav::instance()['flex']->getDirectory($data['type']); + $this->setEntries($data['entries']); + } + + /** + * @return array + */ + #[\ReturnTypeWillChange] + public function __debugInfo() + { + return [ + 'type:private' => $this->getFlexType(), + 'key:private' => $this->getKey(), + 'entries_key:private' => $this->getKeyField(), + 'entries:private' => $this->getEntries() + ]; + } + + /** + * @param array $entries + * @param string|null $keyField + * @return static + * @phpstan-return static + */ + protected function createFrom(array $entries, string $keyField = null) + { + /** @phpstan-var static $index */ + $index = new static($entries, $this->getFlexDirectory()); + $index->setKeyField($keyField ?? $this->_keyField); + + return $index; + } + + /** + * @param string|null $keyField + * @return void + */ + protected function setKeyField(string $keyField = null) + { + $this->_keyField = $keyField ?? 'storage_key'; + } + + /** + * @return array + */ + protected function getIndexKeys() + { + if (null === $this->_indexKeys) { + $entries = $this->getEntries(); + $first = reset($entries); + if ($first) { + $keys = array_keys($first); + $keys = array_combine($keys, $keys) ?: []; + } else { + $keys = []; + } + + $this->setIndexKeys($keys); + } + + return $this->_indexKeys; + } + + /** + * @param array $indexKeys + * @return void + */ + protected function setIndexKeys(array $indexKeys) + { + // Add defaults. + $indexKeys += [ + 'key' => 'key', + 'storage_key' => 'storage_key', + 'storage_timestamp' => 'storage_timestamp', + 'flex_key' => 'flex_key' + ]; + + + $this->_indexKeys = $indexKeys; + } + + /** + * @return string + */ + protected function getTypePrefix() + { + return 'i.'; + } + + /** + * @param string $key + * @param mixed $value + * @return ObjectInterface|null + * @phpstan-return T|null + */ + protected function loadElement($key, $value): ?ObjectInterface + { + /** @phpstan-var T[] $objects */ + $objects = $this->getFlexDirectory()->loadObjects([$key => $value]); + + return $objects ? reset($objects): null; + } + + /** + * @param array|null $entries + * @return ObjectInterface[] + * @phpstan-return T[] + */ + protected function loadElements(array $entries = null): array + { + /** @phpstan-var T[] $objects */ + $objects = $this->getFlexDirectory()->loadObjects($entries ?? $this->getEntries()); + + return $objects; + } + + /** + * @param array|null $entries + * @return CollectionInterface + * @phpstan-return C + */ + protected function loadCollection(array $entries = null): CollectionInterface + { + /** @var C $collection */ + $collection = $this->getFlexDirectory()->loadCollection($entries ?? $this->getEntries(), $this->_keyField); + + return $collection; + } + + /** + * @param mixed $value + * @return bool + */ + protected function isAllowedElement($value): bool + { + return $value instanceof FlexObject; + } + + /** + * @param FlexObjectInterface $object + * @return mixed + */ + protected function getElementMeta($object) + { + return $object->getMetaData(); + } + + /** + * @param FlexObjectInterface $element + * @return string + */ + protected function getCurrentKey($element) + { + $keyField = $this->getKeyField(); + if ($keyField === 'storage_key') { + return $element->getStorageKey(); + } + if ($keyField === 'flex_key') { + return $element->getFlexKey(); + } + if ($keyField === 'key') { + return $element->getKey(); + } + + return $element->getKey(); + } + + /** + * @param FlexStorageInterface $storage + * @param array $index Saved index + * @param array $entries Updated index + * @param array $options + * @return array Compiled list of entries + */ + protected static function updateIndexFile(FlexStorageInterface $storage, array $index, array $entries, array $options = []): array + { + $indexFile = static::getIndexFile($storage); + if (null === $indexFile) { + return $entries; + } + + // Calculate removed objects. + $removed = array_diff_key($index, $entries); + + // First get rid of all removed objects. + if ($removed) { + $index = array_diff_key($index, $removed); + } + + if ($entries && empty($options['force_update'])) { + // Calculate difference between saved index and current data. + foreach ($index as $key => $entry) { + $storage_key = $entry['storage_key'] ?? null; + if (isset($entries[$storage_key]) && $entries[$storage_key]['storage_timestamp'] === $entry['storage_timestamp']) { + // Entry is up to date, no update needed. + unset($entries[$storage_key]); + } + } + + if (empty($entries) && empty($removed)) { + // No objects were added, updated or removed. + return $index; + } + } elseif (!$removed) { + // There are no objects and nothing was removed. + return []; + } + + // Index should be updated, lock the index file for saving. + $indexFile->lock(); + + // Read all the data rows into an array using chunks of 100. + $keys = array_fill_keys(array_keys($entries), null); + $chunks = array_chunk($keys, 100, true); + $updated = $added = []; + foreach ($chunks as $keys) { + $rows = $storage->readRows($keys); + + $keyField = $storage->getKeyField(); + + // Go through all the updated objects and refresh their index data. + foreach ($rows as $key => $row) { + if (null !== $row || !empty($options['include_missing'])) { + $entry = $entries[$key] + ['key' => $key]; + if ($keyField !== 'storage_key' && isset($row[$keyField])) { + $entry['key'] = $row[$keyField]; + } + static::updateObjectMeta($entry, $row ?? [], $storage); + if (isset($row['__ERROR'])) { + $entry['__ERROR'] = true; + static::onException(new RuntimeException(sprintf('Object failed to load: %s (%s)', $key, + $row['__ERROR']))); + } + if (isset($index[$key])) { + // Update object in the index. + $updated[$key] = $entry; + } else { + // Add object into the index. + $added[$key] = $entry; + } + + // Either way, update the entry. + $index[$key] = $entry; + } elseif (isset($index[$key])) { + // Remove object from the index. + $removed[$key] = $index[$key]; + unset($index[$key]); + } + } + unset($rows); + } + + // Sort the index before saving it. + ksort($index, SORT_NATURAL | SORT_FLAG_CASE); + + static::onChanges($index, $added, $updated, $removed); + + $indexFile->save(['version' => static::VERSION, 'timestamp' => time(), 'count' => count($index), 'index' => $index]); + $indexFile->unlock(); + + return $index; + } + + /** + * @param array $entry + * @param array $data + * @return void + * @deprecated 1.7 Use static ::updateObjectMeta() method instead. + */ + protected static function updateIndexData(array &$entry, array $data) + { + } + + /** + * @param FlexStorageInterface $storage + * @return array + */ + protected static function loadIndex(FlexStorageInterface $storage) + { + $indexFile = static::getIndexFile($storage); + + if ($indexFile) { + $data = []; + try { + $data = (array)$indexFile->content(); + $version = $data['version'] ?? null; + if ($version !== static::VERSION) { + $data = []; + } + } catch (Exception $e) { + $e = new RuntimeException(sprintf('Index failed to load: %s', $e->getMessage()), $e->getCode(), $e); + + static::onException($e); + } + + if ($data) { + return $data; + } + } + + return ['version' => static::VERSION, 'timestamp' => 0, 'count' => 0, 'index' => []]; + } + + /** + * @param FlexStorageInterface $storage + * @return array + */ + protected static function loadEntriesFromIndex(FlexStorageInterface $storage) + { + $data = static::loadIndex($storage); + + return $data['index'] ?? []; + } + + /** + * @param FlexStorageInterface $storage + * @return CompiledYamlFile|CompiledJsonFile|null + */ + protected static function getIndexFile(FlexStorageInterface $storage) + { + if (!method_exists($storage, 'isIndexed') || !$storage->isIndexed()) { + return null; + } + + $path = $storage->getStoragePath(); + if (!$path) { + return null; + } + + // Load saved index file. + $grav = Grav::instance(); + $locator = $grav['locator']; + $filename = $locator->findResource("{$path}/index.yaml", true, true); + + return CompiledYamlFile::instance($filename); + } + + /** + * @param Exception $e + * @return void + */ + protected static function onException(Exception $e) + { + $grav = Grav::instance(); + + /** @var Logger $logger */ + $logger = $grav['log']; + $logger->addAlert($e->getMessage()); + + /** @var Debugger $debugger */ + $debugger = $grav['debugger']; + $debugger->addException($e); + $debugger->addMessage($e, 'error'); + } + + /** + * @param array $entries + * @param array $added + * @param array $updated + * @param array $removed + * @return void + */ + protected static function onChanges(array $entries, array $added, array $updated, array $removed) + { + $addedCount = count($added); + $updatedCount = count($updated); + $removedCount = count($removed); + + if ($addedCount + $updatedCount + $removedCount) { + $message = sprintf('Index updated, %d objects (%d added, %d updated, %d removed).', count($entries), $addedCount, $updatedCount, $removedCount); + + $grav = Grav::instance(); + + /** @var Debugger $debugger */ + $debugger = $grav['debugger']; + $debugger->addMessage($message, 'debug'); + } + } + + // DEPRECATED METHODS + + /** + * @param bool $prefix + * @return string + * @deprecated 1.6 Use `->getFlexType()` instead. + */ + public function getType($prefix = false) + { + user_error(__CLASS__ . '::' . __FUNCTION__ . '() is deprecated since Grav 1.6, use ->getFlexType() method instead', E_USER_DEPRECATED); + + $type = $prefix ? $this->getTypePrefix() : ''; + + return $type . $this->getFlexType(); + } +} diff --git a/system/src/Grav/Framework/Flex/FlexObject.php b/system/src/Grav/Framework/Flex/FlexObject.php new file mode 100644 index 0000000..b93b6f2 --- /dev/null +++ b/system/src/Grav/Framework/Flex/FlexObject.php @@ -0,0 +1,1287 @@ + true, + 'getType' => true, + 'getFlexType' => true, + 'getFlexDirectory' => true, + 'hasFlexFeature' => true, + 'getFlexFeatures' => true, + 'getCacheKey' => true, + 'getCacheChecksum' => false, + 'getTimestamp' => true, + 'value' => true, + 'exists' => true, + 'hasProperty' => true, + 'getProperty' => true, + + // FlexAclTrait + 'isAuthorized' => 'session', + ]; + } + + /** + * @param array $elements + * @param array $storage + * @param FlexDirectory $directory + * @param bool $validate + * @return static + */ + public static function createFromStorage(array $elements, array $storage, FlexDirectory $directory, bool $validate = false) + { + $instance = new static($elements, $storage['key'], $directory, $validate); + $instance->setMetaData($storage); + + return $instance; + } + + /** + * {@inheritdoc} + * @see FlexObjectInterface::__construct() + */ + public function __construct(array $elements, $key, FlexDirectory $directory, bool $validate = false) + { + if (get_class($this) === __CLASS__) { + user_error('Using ' . __CLASS__ . ' directly is deprecated since Grav 1.7, use \Grav\Common\Flex\Types\Generic\GenericObject or your own class instead', E_USER_DEPRECATED); + } + + $this->_flexDirectory = $directory; + + if (isset($elements['__META'])) { + $this->setMetaData($elements['__META']); + unset($elements['__META']); + } + + if ($validate) { + $blueprint = $this->getFlexDirectory()->getBlueprint(); + + $blueprint->validate($elements, ['xss_check' => false]); + + $elements = $blueprint->filter($elements, true, true); + } + + $this->filterElements($elements); + + $this->objectConstruct($elements, $key); + } + + /** + * {@inheritdoc} + * @see FlexCommonInterface::hasFlexFeature() + */ + public function hasFlexFeature(string $name): bool + { + return in_array($name, $this->getFlexFeatures(), true); + } + + /** + * {@inheritdoc} + * @see FlexCommonInterface::hasFlexFeature() + */ + public function getFlexFeatures(): array + { + /** @var array $implements */ + $implements = class_implements($this); + + $list = []; + foreach ($implements as $interface) { + if ($pos = strrpos($interface, '\\')) { + $interface = substr($interface, $pos+1); + } + + $list[] = Inflector::hyphenize(str_replace('Interface', '', $interface)); + } + + return $list; + } + + /** + * {@inheritdoc} + * @see FlexObjectInterface::getFlexType() + */ + public function getFlexType(): string + { + return $this->_flexDirectory->getFlexType(); + } + + /** + * {@inheritdoc} + * @see FlexObjectInterface::getFlexDirectory() + */ + public function getFlexDirectory(): FlexDirectory + { + return $this->_flexDirectory; + } + + /** + * Refresh object from the storage. + * + * @param bool $keepMissing + * @return bool True if the object was refreshed + */ + public function refresh(bool $keepMissing = false): bool + { + $key = $this->getStorageKey(); + if ('' === $key) { + return false; + } + + $storage = $this->getFlexDirectory()->getStorage(); + $meta = $storage->getMetaData([$key])[$key] ?? null; + + $newChecksum = $meta['checksum'] ?? $meta['storage_timestamp'] ?? null; + $curChecksum = $this->_meta['checksum'] ?? $this->_meta['storage_timestamp'] ?? null; + + // Check if object is up to date with the storage. + if (null === $newChecksum || $newChecksum === $curChecksum) { + return false; + } + + // Get current elements (if requested). + $current = $keepMissing ? $this->getElements() : []; + // Get elements from the filesystem. + $elements = $storage->readRows([$key => null])[$key] ?? null; + if (null !== $elements) { + $meta = $elements['__META'] ?? $meta; + unset($elements['__META']); + $this->filterElements($elements); + $newKey = $meta['key'] ?? $this->getKey(); + if ($meta) { + $this->setMetaData($meta); + } + $this->objectConstruct($elements, $newKey); + + if ($current) { + // Inject back elements which are missing in the filesystem. + $data = $this->getBlueprint()->flattenData($current); + foreach ($data as $property => $value) { + if (strpos($property, '.') === false) { + $this->defProperty($property, $value); + } else { + $this->defNestedProperty($property, $value); + } + } + } + + /** @var Debugger $debugger */ + $debugger = Grav::instance()['debugger']; + $debugger->addMessage("Refreshed {$this->getFlexType()} object {$this->getKey()}", 'debug'); + } + + return true; + } + + /** + * {@inheritdoc} + * @see FlexObjectInterface::getTimestamp() + */ + public function getTimestamp(): int + { + return $this->_meta['storage_timestamp'] ?? 0; + } + + /** + * {@inheritdoc} + * @see FlexObjectInterface::getCacheKey() + */ + public function getCacheKey(): string + { + return $this->hasKey() ? $this->getTypePrefix() . $this->getFlexType() . '.' . $this->getKey() : ''; + } + + /** + * {@inheritdoc} + * @see FlexObjectInterface::getCacheChecksum() + */ + public function getCacheChecksum(): string + { + return (string)($this->_meta['checksum'] ?? $this->getTimestamp()); + } + + /** + * {@inheritdoc} + * @see FlexObjectInterface::search() + */ + public function search(string $search, $properties = null, array $options = null): float + { + $directory = $this->getFlexDirectory(); + $properties = $directory->getSearchProperties($properties); + $options = $directory->getSearchOptions($options); + + $weight = 0; + foreach ($properties as $property) { + if (strpos($property, '.')) { + $weight += $this->searchNestedProperty($property, $search, $options); + } else { + $weight += $this->searchProperty($property, $search, $options); + } + } + + return $weight > 0 ? min($weight, 1) : 0; + } + + /** + * {@inheritdoc} + * @see ObjectInterface::getFlexKey() + */ + public function getKey() + { + return (string)$this->_key; + } + + /** + * {@inheritdoc} + * @see FlexObjectInterface::getFlexKey() + */ + public function getFlexKey(): string + { + $key = $this->_meta['flex_key'] ?? null; + + if (!$key && $key = $this->getStorageKey()) { + $key = $this->_flexDirectory->getFlexType() . '.obj:' . $key; + } + + return (string)$key; + } + + /** + * {@inheritdoc} + * @see FlexObjectInterface::getStorageKey() + */ + public function getStorageKey(): string + { + return (string)($this->storage_key ?? $this->_meta['storage_key'] ?? null); + } + + /** + * {@inheritdoc} + * @see FlexObjectInterface::getMetaData() + */ + public function getMetaData(): array + { + return $this->_meta ?? []; + } + + /** + * {@inheritdoc} + * @see FlexObjectInterface::exists() + */ + public function exists(): bool + { + $key = $this->getStorageKey(); + + return $key && $this->getFlexDirectory()->getStorage()->hasKey($key); + } + + /** + * @param string $property + * @param string $search + * @param array|null $options + * @return float + */ + public function searchProperty(string $property, string $search, array $options = null): float + { + $options = $options ?? (array)$this->getFlexDirectory()->getConfig('data.search.options'); + $value = $this->getProperty($property); + + return $this->searchValue($property, $value, $search, $options); + } + + /** + * @param string $property + * @param string $search + * @param array|null $options + * @return float + */ + public function searchNestedProperty(string $property, string $search, array $options = null): float + { + $options = $options ?? (array)$this->getFlexDirectory()->getConfig('data.search.options'); + if ($property === 'key') { + $value = $this->getKey(); + } else { + $value = $this->getNestedProperty($property); + } + + return $this->searchValue($property, $value, $search, $options); + } + + /** + * @param string $name + * @param mixed $value + * @param string $search + * @param array|null $options + * @return float + */ + protected function searchValue(string $name, $value, string $search, array $options = null): float + { + $options = $options ?? []; + + // Ignore empty search strings. + $search = trim($search); + if ($search === '') { + return 0; + } + + // Search only non-empty string values. + if (!is_string($value) || $value === '') { + return 0; + } + + $caseSensitive = $options['case_sensitive'] ?? false; + + $tested = false; + if (($tested |= !empty($options['same_as']))) { + if ($caseSensitive) { + if ($value === $search) { + return (float)$options['same_as']; + } + } elseif (mb_strtolower($value) === mb_strtolower($search)) { + return (float)$options['same_as']; + } + } + if (($tested |= !empty($options['starts_with'])) && Utils::startsWith($value, $search, $caseSensitive)) { + return (float)$options['starts_with']; + } + if (($tested |= !empty($options['ends_with'])) && Utils::endsWith($value, $search, $caseSensitive)) { + return (float)$options['ends_with']; + } + if ((!$tested || !empty($options['contains'])) && Utils::contains($value, $search, $caseSensitive)) { + return (float)($options['contains'] ?? 1); + } + + return 0; + } + + /** + * Get original data before update + * + * @return array + */ + public function getOriginalData(): array + { + return $this->_original ?? []; + } + + /** + * Get diff array from the object. + * + * @return array + */ + public function getDiff(): array + { + $blueprint = $this->getBlueprint(); + + $flattenOriginal = $blueprint->flattenData($this->getOriginalData()); + $flattenElements = $blueprint->flattenData($this->getElements()); + $removedElements = array_diff_key($flattenOriginal, $flattenElements); + $diff = []; + + // Include all added or changed keys. + foreach ($flattenElements as $key => $value) { + $orig = $flattenOriginal[$key] ?? null; + if ($orig !== $value) { + $diff[$key] = ['old' => $orig, 'new' => $value]; + } + } + + // Include all removed keys. + foreach ($removedElements as $key => $value) { + $diff[$key] = ['old' => $value, 'new' => null]; + } + + return $diff; + } + + /** + * Get any changes from the object. + * + * @return array + */ + public function getChanges(): array + { + $diff = $this->getDiff(); + + $data = new Data(); + foreach ($diff as $key => $change) { + $data->set($key, $change['new']); + } + + return $data->toArray(); + } + + /** + * @return string + */ + protected function getTypePrefix(): string + { + return 'o.'; + } + + /** + * Alias of getBlueprint() + * + * @return Blueprint + * @deprecated 1.6 Admin compatibility + */ + public function blueprints() + { + return $this->getBlueprint(); + } + + /** + * @param string|null $namespace + * @return CacheInterface + */ + public function getCache(string $namespace = null) + { + return $this->_flexDirectory->getCache($namespace); + } + + /** + * @param string|null $key + * @return $this + */ + public function setStorageKey($key = null) + { + $this->storage_key = $key ?? ''; + + return $this; + } + + /** + * @param int $timestamp + * @return $this + */ + public function setTimestamp($timestamp = null) + { + $this->storage_timestamp = $timestamp ?? time(); + + return $this; + } + + /** + * {@inheritdoc} + * @see FlexObjectInterface::render() + */ + public function render(string $layout = null, array $context = []) + { + if (!$layout) { + $config = $this->getTemplateConfig(); + $layout = $config['object']['defaults']['layout'] ?? 'default'; + } + + $type = $this->getFlexType(); + + $grav = Grav::instance(); + + /** @var Debugger $debugger */ + $debugger = $grav['debugger']; + $debugger->startTimer('flex-object-' . ($debugKey = uniqid($type, false)), 'Render Object ' . $type . ' (' . $layout . ')'); + + $key = $this->getCacheKey(); + + // Disable caching if context isn't all scalars. + if ($key) { + foreach ($context as $value) { + if (!is_scalar($value)) { + $key = ''; + break; + } + } + } + + if ($key) { + // Create a new key which includes layout and context. + $key = md5($key . '.' . $layout . json_encode($context)); + $cache = $this->getCache('render'); + } else { + $cache = null; + } + + try { + $data = $cache ? $cache->get($key) : null; + + $block = $data ? HtmlBlock::fromArray($data) : null; + } catch (InvalidArgumentException $e) { + $debugger->addException($e); + + $block = null; + } catch (\InvalidArgumentException $e) { + $debugger->addException($e); + + $block = null; + } + + $checksum = $this->getCacheChecksum(); + if ($block && $checksum !== $block->getChecksum()) { + $block = null; + } + + if (!$block) { + $block = HtmlBlock::create($key ?: null); + $block->setChecksum($checksum); + if (!$cache) { + $block->disableCache(); + } + + $event = new Event([ + 'type' => 'flex', + 'directory' => $this->getFlexDirectory(), + 'object' => $this, + 'layout' => &$layout, + 'context' => &$context + ]); + $this->triggerEvent('onRender', $event); + + $output = $this->getTemplate($layout)->render( + [ + 'grav' => $grav, + 'config' => $grav['config'], + 'block' => $block, + 'directory' => $this->getFlexDirectory(), + 'object' => $this, + 'layout' => $layout + ] + $context + ); + + if ($debugger->enabled()) { + $name = $this->getKey() . ' (' . $type . ')'; + $output = "\n\n{$output}\n\n"; + } + + $block->setContent($output); + + try { + $cache && $block->isCached() && $cache->set($key, $block->toArray()); + } catch (InvalidArgumentException $e) { + $debugger->addException($e); + } + } + + $debugger->stopTimer('flex-object-' . $debugKey); + + return $block; + } + + /** + * @return array + */ + #[\ReturnTypeWillChange] + public function jsonSerialize() + { + return $this->getElements(); + } + + /** + * {@inheritdoc} + * @see FlexObjectInterface::prepareStorage() + */ + public function prepareStorage(): array + { + return ['__META' => $this->getMetaData()] + $this->getElements(); + } + + /** + * {@inheritdoc} + * @see FlexObjectInterface::update() + */ + public function update(array $data, array $files = []) + { + if ($data) { + // Get currently stored data. + $elements = $this->getElements(); + + // Store original version of the object. + if ($this->_original === null) { + $this->_original = $elements; + } + + $blueprint = $this->getBlueprint(); + + // Process updated data through the object filters. + $this->filterElements($data); + + // Merge existing object to the test data to be validated. + $test = $blueprint->mergeData($elements, $data); + + // Validate and filter elements and throw an error if any issues were found. + $blueprint->validate($test + ['storage_key' => $this->getStorageKey(), 'timestamp' => $this->getTimestamp()], ['xss_check' => false]); + $data = $blueprint->filter($data, true, true); + + // Finally update the object. + $flattenData = $blueprint->flattenData($data); + foreach ($flattenData as $key => $value) { + if ($value === null) { + $this->unsetNestedProperty($key); + } else { + $this->setNestedProperty($key, $value); + } + } + } + + if ($files && method_exists($this, 'setUpdatedMedia')) { + $this->setUpdatedMedia($files); + } + + return $this; + } + + /** + * {@inheritdoc} + * @see FlexObjectInterface::create() + */ + public function create(string $key = null) + { + if ($key) { + $this->setStorageKey($key); + } + + if ($this->exists()) { + throw new RuntimeException('Cannot create new object (Already exists)'); + } + + return $this->save(); + } + + /** + * @param string|null $key + * @return FlexObject|FlexObjectInterface + */ + public function createCopy(string $key = null) + { + $this->markAsCopy(); + + return $this->create($key); + } + + /** + * @param UserInterface|null $user + */ + public function check(UserInterface $user = null): void + { + // If user has been provided, check if the user has permissions to save this object. + if ($user && !$this->isAuthorized('save', null, $user)) { + throw new \RuntimeException('Forbidden', 403); + } + } + + /** + * {@inheritdoc} + * @see FlexObjectInterface::save() + */ + public function save() + { + $this->triggerEvent('onBeforeSave'); + + $storage = $this->getFlexDirectory()->getStorage(); + + $storageKey = $this->getStorageKey() ?: '@@' . spl_object_hash($this); + + $result = $storage->replaceRows([$storageKey => $this->prepareStorage()]); + + if (method_exists($this, 'clearMediaCache')) { + $this->clearMediaCache(); + } + + $value = reset($result); + $meta = $value['__META'] ?? null; + if ($meta) { + /** @phpstan-var class-string $indexClass */ + $indexClass = $this->getFlexDirectory()->getIndexClass(); + $indexClass::updateObjectMeta($meta, $value, $storage); + $this->_meta = $meta; + } + + if ($value) { + $storageKey = $meta['storage_key'] ?? (string)key($result); + if ($storageKey !== '') { + $this->setStorageKey($storageKey); + } + + $newKey = $meta['key'] ?? ($this->hasKey() ? $this->getKey() : null); + $this->setKey($newKey ?? $storageKey); + } + + // FIXME: For some reason locator caching isn't cleared for the file, investigate! + $locator = Grav::instance()['locator']; + $locator->clearCache(); + + if (method_exists($this, 'saveUpdatedMedia')) { + $this->saveUpdatedMedia(); + } + + try { + $this->getFlexDirectory()->reloadIndex(); + if (method_exists($this, 'clearMediaCache')) { + $this->clearMediaCache(); + } + } catch (Exception $e) { + /** @var Debugger $debugger */ + $debugger = Grav::instance()['debugger']; + $debugger->addException($e); + + // Caching failed, but we can ignore that for now. + } + + $this->triggerEvent('onAfterSave'); + + return $this; + } + + /** + * {@inheritdoc} + * @see FlexObjectInterface::delete() + */ + public function delete() + { + if (!$this->exists()) { + return $this; + } + + $this->triggerEvent('onBeforeDelete'); + + $this->getFlexDirectory()->getStorage()->deleteRows([$this->getStorageKey() => $this->prepareStorage()]); + + try { + $this->getFlexDirectory()->reloadIndex(); + if (method_exists($this, 'clearMediaCache')) { + $this->clearMediaCache(); + } + } catch (Exception $e) { + /** @var Debugger $debugger */ + $debugger = Grav::instance()['debugger']; + $debugger->addException($e); + + // Caching failed, but we can ignore that for now. + } + + $this->triggerEvent('onAfterDelete'); + + return $this; + } + + /** + * {@inheritdoc} + * @see FlexObjectInterface::getBlueprint() + */ + public function getBlueprint(string $name = '') + { + if (!isset($this->_blueprint[$name])) { + $blueprint = $this->doGetBlueprint($name); + $blueprint->setScope('object'); + $blueprint->setObject($this); + + $this->_blueprint[$name] = $blueprint->init(); + } + + return $this->_blueprint[$name]; + } + + /** + * {@inheritdoc} + * @see FlexObjectInterface::getForm() + */ + public function getForm(string $name = '', array $options = null) + { + $hash = $name . '-' . md5(json_encode($options, JSON_THROW_ON_ERROR)); + if (!isset($this->_forms[$hash])) { + $this->_forms[$hash] = $this->createFormObject($name, $options); + } + + return $this->_forms[$hash]; + } + + /** + * {@inheritdoc} + * @see FlexObjectInterface::getDefaultValue() + */ + public function getDefaultValue(string $name, string $separator = null) + { + $separator = $separator ?: '.'; + $path = explode($separator, $name); + $offset = array_shift($path); + + $current = $this->getDefaultValues(); + + if (!isset($current[$offset])) { + return null; + } + + $current = $current[$offset]; + + while ($path) { + $offset = array_shift($path); + + if ((is_array($current) || $current instanceof ArrayAccess) && isset($current[$offset])) { + $current = $current[$offset]; + } elseif (is_object($current) && isset($current->{$offset})) { + $current = $current->{$offset}; + } else { + return null; + } + }; + + return $current; + } + + /** + * @return array + */ + public function getDefaultValues(): array + { + return $this->getBlueprint()->getDefaults(); + } + + /** + * {@inheritdoc} + * @see FlexObjectInterface::getFormValue() + */ + public function getFormValue(string $name, $default = null, string $separator = null) + { + if ($name === 'storage_key') { + return $this->getStorageKey(); + } + if ($name === 'storage_timestamp') { + return $this->getTimestamp(); + } + + return $this->getNestedProperty($name, $default, $separator); + } + + /** + * @param FlexDirectory $directory + */ + public function setFlexDirectory(FlexDirectory $directory): void + { + $this->_flexDirectory = $directory; + } + + /** + * Returns a string representation of this object. + * + * @return string + */ + #[\ReturnTypeWillChange] + public function __toString() + { + return $this->getFlexKey(); + } + + /** + * @return array + */ + #[\ReturnTypeWillChange] + public function __debugInfo() + { + return [ + 'type:private' => $this->getFlexType(), + 'storage_key:protected' => $this->getStorageKey(), + 'storage_timestamp:protected' => $this->getTimestamp(), + 'key:private' => $this->getKey(), + 'elements:private' => $this->getElements(), + 'storage:private' => $this->getMetaData() + ]; + } + + /** + * Clone object. + */ + #[\ReturnTypeWillChange] + public function __clone() + { + // Allows future compatibility as parent::__clone() works. + } + + protected function markAsCopy(): void + { + $meta = $this->getMetaData(); + $meta['copy'] = true; + $this->_meta = $meta; + } + + /** + * @param string $name + * @return Blueprint + */ + protected function doGetBlueprint(string $name = ''): Blueprint + { + return $this->_flexDirectory->getBlueprint($name ? '.' . $name : $name); + } + + /** + * @param array $meta + */ + protected function setMetaData(array $meta): void + { + $this->_meta = $meta; + } + + /** + * @return array + */ + protected function doSerialize(): array + { + return [ + 'type' => $this->getFlexType(), + 'key' => $this->getKey(), + 'elements' => $this->getElements(), + 'storage' => $this->getMetaData() + ]; + } + + /** + * @param array $serialized + * @param FlexDirectory|null $directory + * @return void + */ + protected function doUnserialize(array $serialized, FlexDirectory $directory = null): void + { + $type = $serialized['type'] ?? 'unknown'; + + if (!isset($serialized['key'], $serialized['type'], $serialized['elements'])) { + throw new \InvalidArgumentException("Cannot unserialize '{$type}': Bad data"); + } + + if (null === $directory) { + $directory = $this->getFlexContainer()->getDirectory($type); + if (!$directory) { + throw new \InvalidArgumentException("Cannot unserialize Flex type '{$type}': Directory not found"); + } + } + + $this->setFlexDirectory($directory); + $this->setMetaData($serialized['storage']); + $this->setKey($serialized['key']); + $this->setElements($serialized['elements']); + } + + /** + * @return array + */ + protected function getTemplateConfig() + { + $config = $this->getFlexDirectory()->getConfig('site.templates', []); + $defaults = array_replace($config['defaults'] ?? [], $config['object']['defaults'] ?? []); + $config['object']['defaults'] = $defaults; + + return $config; + } + + /** + * @param string $layout + * @return array + */ + protected function getTemplatePaths(string $layout): array + { + $config = $this->getTemplateConfig(); + $type = $this->getFlexType(); + $defaults = $config['object']['defaults'] ?? []; + + $ext = $defaults['ext'] ?? '.html.twig'; + $types = array_unique(array_merge([$type], (array)($defaults['type'] ?? null))); + $paths = $config['object']['paths'] ?? [ + 'flex/{TYPE}/object/{LAYOUT}{EXT}', + 'flex-objects/layouts/{TYPE}/object/{LAYOUT}{EXT}' + ]; + $table = ['TYPE' => '%1$s', 'LAYOUT' => '%2$s', 'EXT' => '%3$s']; + + $lookups = []; + foreach ($paths as $path) { + $path = Utils::simpleTemplate($path, $table); + foreach ($types as $type) { + $lookups[] = sprintf($path, $type, $layout, $ext); + } + } + + return array_unique($lookups); + } + + /** + * Filter data coming to constructor or $this->update() request. + * + * NOTE: The incoming data can be an arbitrary array so do not assume anything from its content. + * + * @param array $elements + */ + protected function filterElements(array &$elements): void + { + if (isset($elements['storage_key'])) { + $elements['storage_key'] = trim($elements['storage_key']); + } + if (isset($elements['storage_timestamp'])) { + $elements['storage_timestamp'] = (int)$elements['storage_timestamp']; + } + + unset($elements['_post_entries_save']); + } + + /** + * This methods allows you to override form objects in child classes. + * + * @param string $name Form name + * @param array|null $options Form optiosn + * @return FlexFormInterface + */ + protected function createFormObject(string $name, array $options = null) + { + return new FlexForm($name, $this, $options); + } + + /** + * @param string $action + * @return string + */ + protected function getAuthorizeAction(string $action): string + { + // Handle special action save, which can mean either update or create. + if ($action === 'save') { + $action = $this->exists() ? 'update' : 'create'; + } + + return $action; + } + + /** + * Method to reset blueprints if the type changes. + * + * @return void + * @since 1.7.18 + */ + protected function resetBlueprints(): void + { + $this->_blueprint = []; + } + + // DEPRECATED METHODS + + /** + * @param bool $prefix + * @return string + * @deprecated 1.6 Use `->getFlexType()` instead. + */ + public function getType($prefix = false) + { + user_error(__METHOD__ . '() is deprecated since Grav 1.6, use ->getFlexType() method instead', E_USER_DEPRECATED); + + $type = $prefix ? $this->getTypePrefix() : ''; + + return $type . $this->getFlexType(); + } + + /** + * @param string $name + * @param mixed|null $default + * @param string|null $separator + * @return mixed + * + * @deprecated 1.6 Use ->getFormValue() method instead. + */ + public function value($name, $default = null, $separator = null) + { + user_error(__METHOD__ . '() is deprecated since Grav 1.6, use ->getFormValue() method instead', E_USER_DEPRECATED); + + return $this->getFormValue($name, $default, $separator); + } + + /** + * @param string $name + * @param object|null $event + * @return $this + * @deprecated 1.7 Moved to \Grav\Common\Flex\Traits\FlexObjectTrait + */ + public function triggerEvent(string $name, $event = null) + { + user_error(__METHOD__ . '() is deprecated since Grav 1.7, moved to \Grav\Common\Flex\Traits\FlexObjectTrait', E_USER_DEPRECATED); + + if (null === $event) { + $event = new Event([ + 'type' => 'flex', + 'directory' => $this->getFlexDirectory(), + 'object' => $this + ]); + } + if (strpos($name, 'onFlexObject') !== 0 && strpos($name, 'on') === 0) { + $name = 'onFlexObject' . substr($name, 2); + } + + $grav = Grav::instance(); + if ($event instanceof Event) { + $grav->fireEvent($name, $event); + } else { + $grav->dispatchEvent($event); + } + + return $this; + } + + /** + * @param array $storage + * @deprecated 1.7 Use `->setMetaData()` instead. + */ + protected function setStorage(array $storage): void + { + user_error(__METHOD__ . '() is deprecated since Grav 1.7, use ->setMetaData() method instead', E_USER_DEPRECATED); + + $this->setMetaData($storage); + } + + /** + * @return array + * @deprecated 1.7 Use `->getMetaData()` instead. + */ + protected function getStorage(): array + { + user_error(__METHOD__ . '() is deprecated since Grav 1.7, use ->getMetaData() method instead', E_USER_DEPRECATED); + + return $this->getMetaData(); + } + + /** + * @param string $layout + * @return Template|TemplateWrapper + * @throws LoaderError + * @throws SyntaxError + * @deprecated 1.7 Moved to \Grav\Common\Flex\Traits\GravTrait + */ + protected function getTemplate($layout) + { + user_error(__METHOD__ . '() is deprecated since Grav 1.7, moved to \Grav\Common\Flex\Traits\GravTrait', E_USER_DEPRECATED); + + $grav = Grav::instance(); + + /** @var Twig $twig */ + $twig = $grav['twig']; + + try { + return $twig->twig()->resolveTemplate($this->getTemplatePaths($layout)); + } catch (LoaderError $e) { + /** @var Debugger $debugger */ + $debugger = Grav::instance()['debugger']; + $debugger->addException($e); + + return $twig->twig()->resolveTemplate(['flex/404.html.twig']); + } + } + + /** + * @return Flex + * @deprecated 1.7 Moved to \Grav\Common\Flex\Traits\GravTrait + */ + protected function getFlexContainer(): Flex + { + user_error(__METHOD__ . '() is deprecated since Grav 1.7, moved to \Grav\Common\Flex\Traits\GravTrait', E_USER_DEPRECATED); + + /** @var Flex $flex */ + $flex = Grav::instance()['flex']; + + return $flex; + } + + /** + * @return UserInterface|null + * @deprecated 1.7 Moved to \Grav\Common\Flex\Traits\GravTrait + */ + protected function getActiveUser(): ?UserInterface + { + user_error(__METHOD__ . '() is deprecated since Grav 1.7, moved to \Grav\Common\Flex\Traits\GravTrait', E_USER_DEPRECATED); + + /** @var UserInterface|null $user */ + $user = Grav::instance()['user'] ?? null; + + return $user; + } + + /** + * @return string + * @deprecated 1.7 Moved to \Grav\Common\Flex\Traits\GravTrait + */ + protected function getAuthorizeScope(): string + { + user_error(__METHOD__ . '() is deprecated since Grav 1.7, moved to \Grav\Common\Flex\Traits\GravTrait', E_USER_DEPRECATED); + + return isset(Grav::instance()['admin']) ? 'admin' : 'site'; + } +} diff --git a/system/src/Grav/Framework/Flex/Interfaces/FlexAuthorizeInterface.php b/system/src/Grav/Framework/Flex/Interfaces/FlexAuthorizeInterface.php new file mode 100644 index 0000000..9561f59 --- /dev/null +++ b/system/src/Grav/Framework/Flex/Interfaces/FlexAuthorizeInterface.php @@ -0,0 +1,33 @@ + + */ +interface FlexCollectionInterface extends FlexCommonInterface, ObjectCollectionInterface, NestedObjectInterface +{ + /** + * Creates a Flex Collection from an array. + * + * @used-by FlexDirectory::createCollection() Official method to create a Flex Collection. + * + * @param FlexObjectInterface[] $entries Associated array of Flex Objects to be included in the collection. + * @param FlexDirectory $directory Flex Directory where all the objects belong into. + * @param string|null $keyField Key field used to index the collection. + * @return static Returns a new Flex Collection. + */ + public static function createFromArray(array $entries, FlexDirectory $directory, string $keyField = null); + + /** + * Creates a new Flex Collection. + * + * @used-by FlexDirectory::createCollection() Official method to create Flex Collection. + * + * @param FlexObjectInterface[] $entries Associated array of Flex Objects to be included in the collection. + * @param FlexDirectory|null $directory Flex Directory where all the objects belong into. + * @throws InvalidArgumentException + */ + public function __construct(array $entries = [], FlexDirectory $directory = null); + + /** + * Search a string from the collection. + * + * @param string $search Search string. + * @param string|string[]|null $properties Properties to search for, defaults to configured properties. + * @param array|null $options Search options, defaults to configured options. + * @return FlexCollectionInterface Returns a Flex Collection with only matching objects. + * @phpstan-return static + * @api + */ + public function search(string $search, $properties = null, array $options = null); + + /** + * Sort the collection. + * + * @param array $orderings Pair of [property => 'ASC'|'DESC', ...]. + * + * @return FlexCollectionInterface Returns a sorted version from the collection. + * @phpstan-return static + */ + public function sort(array $orderings); + + /** + * Filter collection by filter array with keys and values. + * + * @param array $filters + * @return FlexCollectionInterface + * @phpstan-return static + */ + public function filterBy(array $filters); + + /** + * Get timestamps from all the objects in the collection. + * + * This method can be used for example in caching. + * + * @return int[] Returns [key => timestamp, ...] pairs. + */ + public function getTimestamps(): array; + + /** + * Get storage keys from all the objects in the collection. + * + * @see FlexDirectory::getObject() If you want to get Flex Object from the Flex Directory. + * + * @return string[] Returns [key => storage_key, ...] pairs. + */ + public function getStorageKeys(): array; + + /** + * Get Flex keys from all the objects in the collection. + * + * @see Flex::getObjects() If you want to get list of Flex Objects from any Flex Directory. + * + * @return string[] Returns[key => flex_key, ...] pairs. + */ + public function getFlexKeys(): array; + + /** + * Return new collection with a different key. + * + * @param string|null $keyField Switch key field of the collection. + * @return FlexCollectionInterface Returns a new Flex Collection with new key field. + * @phpstan-return static + * @api + */ + public function withKeyField(string $keyField = null); + + /** + * Get Flex Index from the Flex Collection. + * + * @return FlexIndexInterface Returns a Flex Index from the current collection. + * @phpstan-return FlexIndexInterface + */ + public function getIndex(); + + /** + * Load all the objects into memory, + * + * @return FlexCollectionInterface + * @phpstan-return static + */ + public function getCollection(); + + /** + * Get metadata associated to the object + * + * @param string $key Key. + * @return array + */ + public function getMetaData($key): array; +} diff --git a/system/src/Grav/Framework/Flex/Interfaces/FlexCommonInterface.php b/system/src/Grav/Framework/Flex/Interfaces/FlexCommonInterface.php new file mode 100644 index 0000000..03d5f4d --- /dev/null +++ b/system/src/Grav/Framework/Flex/Interfaces/FlexCommonInterface.php @@ -0,0 +1,79 @@ +getBlueprint() or $object->getForm()->getBlueprint() instead. + * + * @param string $type + * @param string $context + * @return Blueprint + */ + public function getBlueprint(string $type = '', string $context = ''); + + /** + * @param string $view + * @return string + */ + public function getBlueprintFile(string $view = ''): string; + + /** + * Get collection. In the site this will be filtered by the default filters (published etc). + * + * Use $directory->getIndex() if you want unfiltered collection. + * + * @param array|null $keys Array of keys. + * @param string|null $keyField Field to be used as the key. + * @return FlexCollectionInterface + * @phpstan-return FlexCollectionInterface + */ + public function getCollection(array $keys = null, string $keyField = null): FlexCollectionInterface; + + /** + * Get the full collection of all stored objects. + * + * Use $directory->getCollection() if you want a filtered collection. + * + * @param array|null $keys Array of keys. + * @param string|null $keyField Field to be used as the key. + * @return FlexIndexInterface + * @phpstan-return FlexIndexInterface + */ + public function getIndex(array $keys = null, string $keyField = null): FlexIndexInterface; + + /** + * Returns an object if it exists. If no arguments are passed (or both of them are null), method creates a new empty object. + * + * Note: It is not safe to use the object without checking if the user can access it. + * + * @param string|null $key + * @param string|null $keyField Field to be used as the key. + * @return FlexObjectInterface|null + */ + public function getObject($key = null, string $keyField = null): ?FlexObjectInterface; + + /** + * @param string|null $namespace + * @return CacheInterface + */ + public function getCache(string $namespace = null); + + /** + * @return $this + */ + public function clearCache(); + + /** + * @param string|null $key + * @return string|null + */ + public function getStorageFolder(string $key = null): ?string; + + /** + * @param string|null $key + * @return string|null + */ + public function getMediaFolder(string $key = null): ?string; + + /** + * @return FlexStorageInterface + */ + public function getStorage(): FlexStorageInterface; + + /** + * @param array $data + * @param string $key + * @param bool $validate + * @return FlexObjectInterface + */ + public function createObject(array $data, string $key = '', bool $validate = false): FlexObjectInterface; + + /** + * @param array $entries + * @param string|null $keyField + * @return FlexCollectionInterface + * @phpstan-return FlexCollectionInterface + */ + public function createCollection(array $entries, string $keyField = null): FlexCollectionInterface; + + /** + * @param array $entries + * @param string|null $keyField + * @return FlexIndexInterface + * @phpstan-return FlexIndexInterface + */ + public function createIndex(array $entries, string $keyField = null): FlexIndexInterface; + + /** + * @return string + */ + public function getObjectClass(): string; + + /** + * @return string + */ + public function getCollectionClass(): string; + + /** + * @return string + */ + public function getIndexClass(): string; + + /** + * @param array $entries + * @param string|null $keyField + * @return FlexCollectionInterface + * @phpstan-return FlexCollectionInterface + */ + public function loadCollection(array $entries, string $keyField = null): FlexCollectionInterface; + + /** + * @param array $entries + * @return FlexObjectInterface[] + * @internal + */ + public function loadObjects(array $entries): array; + + /** + * @return void + */ + public function reloadIndex(): void; + + /** + * @param string $scope + * @param string $action + * @return string + */ + public function getAuthorizeRule(string $scope, string $action): string; +} diff --git a/system/src/Grav/Framework/Flex/Interfaces/FlexFormInterface.php b/system/src/Grav/Framework/Flex/Interfaces/FlexFormInterface.php new file mode 100644 index 0000000..28c528c --- /dev/null +++ b/system/src/Grav/Framework/Flex/Interfaces/FlexFormInterface.php @@ -0,0 +1,51 @@ + + */ +interface FlexIndexInterface extends FlexCollectionInterface +{ + /** + * Helper method to create Flex Index. + * + * @used-by FlexDirectory::getIndex() Official method to get Index from a Flex Directory. + * + * @param FlexDirectory $directory Flex directory. + * @return static Returns a new Flex Index. + */ + public static function createFromStorage(FlexDirectory $directory); + + /** + * Method to load index from the object storage, usually filesystem. + * + * @used-by FlexDirectory::getIndex() Official method to get Index from a Flex Directory. + * + * @param FlexStorageInterface $storage Flex Storage associated to the directory. + * @return array Returns a list of existing objects [storage_key => [storage_key => xxx, storage_timestamp => 123456, ...]] + */ + public static function loadEntriesFromStorage(FlexStorageInterface $storage): array; + + /** + * Return new collection with a different key. + * + * @param string|null $keyField Switch key field of the collection. + * @return static Returns a new Flex Collection with new key field. + * @phpstan-return static + * @api + */ + public function withKeyField(string $keyField = null); + + /** + * @param string|null $indexKey + * @return array + */ + public function getIndexMap(string $indexKey = null); +} diff --git a/system/src/Grav/Framework/Flex/Interfaces/FlexInterface.php b/system/src/Grav/Framework/Flex/Interfaces/FlexInterface.php new file mode 100644 index 0000000..3c9de49 --- /dev/null +++ b/system/src/Grav/Framework/Flex/Interfaces/FlexInterface.php @@ -0,0 +1,100 @@ + + */ + public function getDirectories(array $types = null, bool $keepMissing = false): array; + + /** + * @param string $type + * @return FlexDirectory|null + */ + public function getDirectory(string $type): ?FlexDirectory; + + /** + * @param string $type + * @param array|null $keys + * @param string|null $keyField + * @return FlexCollectionInterface|null + * @phpstan-return FlexCollectionInterface|null + */ + public function getCollection(string $type, array $keys = null, string $keyField = null): ?FlexCollectionInterface; + + /** + * @param array $keys + * @param array $options In addition to the options in getObjects(), following options can be passed: + * collection_class: Class to be used to create the collection. Defaults to ObjectCollection. + * @return FlexCollectionInterface + * @throws RuntimeException + * @phpstan-return FlexCollectionInterface + */ + public function getMixedCollection(array $keys, array $options = []): FlexCollectionInterface; + + /** + * @param array $keys + * @param array $options Following optional options can be passed: + * types: List of allowed types. + * type: Allowed type if types isn't defined, otherwise acts as default_type. + * default_type: Set default type for objects given without type (only used if key_field isn't set). + * keep_missing: Set to true if you want to return missing objects as null. + * key_field: Key field which is used to match the objects. + * @return array + */ + public function getObjects(array $keys, array $options = []): array; + + /** + * @param string $key + * @param string|null $type + * @param string|null $keyField + * @return FlexObjectInterface|null + */ + public function getObject(string $key, string $type = null, string $keyField = null): ?FlexObjectInterface; + + /** + * @return int + */ + public function count(): int; +} diff --git a/system/src/Grav/Framework/Flex/Interfaces/FlexObjectFormInterface.php b/system/src/Grav/Framework/Flex/Interfaces/FlexObjectFormInterface.php new file mode 100644 index 0000000..0370967 --- /dev/null +++ b/system/src/Grav/Framework/Flex/Interfaces/FlexObjectFormInterface.php @@ -0,0 +1,27 @@ + + * @used-by \Grav\Framework\Flex\FlexObject + * @since 1.6 + */ +interface FlexObjectInterface extends FlexCommonInterface, NestedObjectInterface, ArrayAccess +{ + /** + * Construct a new Flex Object instance. + * + * @used-by FlexDirectory::createObject() Method to create Flex Object. + * + * @param array $elements Array of object properties. + * @param string $key Identifier key for the new object. + * @param FlexDirectory $directory Flex Directory the object belongs into. + * @param bool $validate True if the object should be validated against blueprint. + * @throws InvalidArgumentException + */ + public function __construct(array $elements, $key, FlexDirectory $directory, bool $validate = false); + + /** + * Search a string from the object, returns weight between 0 and 1. + * + * Note: If you override this function, make sure you return value in range 0...1! + * + * @used-by FlexCollectionInterface::search() If you want to search a string from a Flex Collection. + * + * @param string $search Search string. + * @param string|string[]|null $properties Properties to search for, defaults to configured properties. + * @param array|null $options Search options, defaults to configured options. + * @return float Returns a weight between 0 and 1. + * @api + */ + public function search(string $search, $properties = null, array $options = null): float; + + /** + * Returns true if object has a key. + * + * @return bool + */ + public function hasKey(); + + /** + * Get a unique key for the object. + * + * Flex Keys can be used without knowing the Directory the Object belongs into. + * + * @see Flex::getObject() If you want to get Flex Object from any Flex Directory. + * @see Flex::getObjects() If you want to get list of Flex Objects from any Flex Directory. + * + * NOTE: Please do not override the method! + * + * @return string Returns Flex Key of the object. + * @api + */ + public function getFlexKey(): string; + + /** + * Get an unique storage key (within the directory) which is used for figuring out the filename or database id. + * + * @see FlexDirectory::getObject() If you want to get Flex Object from the Flex Directory. + * @see FlexDirectory::getCollection() If you want to get Flex Collection with selected keys from the Flex Directory. + * + * @return string Returns storage key of the Object. + * @api + */ + public function getStorageKey(): string; + + /** + * Get index data associated to the object. + * + * @return array Returns metadata of the object. + */ + public function getMetaData(): array; + + /** + * Returns true if the object exists in the storage. + * + * @return bool Returns `true` if the object exists, `false` otherwise. + * @api + */ + public function exists(): bool; + + /** + * Prepare object for saving into the storage. + * + * @return array Returns an array of object properties containing only scalars and arrays. + */ + public function prepareStorage(): array; + + /** + * Updates object in the memory. + * + * @see FlexObjectInterface::save() You need to save the object after calling this method. + * + * @param array $data Data containing updated properties with their values. To unset a value, use `null`. + * @param array|UploadedFileInterface[] $files List of uploaded files to be saved within the object. + * @return static + * @throws RuntimeException + * @api + */ + public function update(array $data, array $files = []); + + /** + * Create new object into the storage. + * + * @see FlexDirectory::createObject() If you want to create a new object instance. + * @see FlexObjectInterface::update() If you want to update properties of the object. + * + * @param string|null $key Optional new key. If key isn't given, random key will be associated to the object. + * @return static + * @throws RuntimeException if object already exists. + * @api + */ + public function create(string $key = null); + + /** + * Save object into the storage. + * + * @see FlexObjectInterface::update() If you want to update properties of the object. + * + * @return static + * @api + */ + public function save(); + + /** + * Delete object from the storage. + * + * @return static + * @api + */ + public function delete(); + + /** + * Returns the blueprint of the object. + * + * @see FlexObjectInterface::getForm() + * @used-by FlexForm::getBlueprint() + * + * @param string $name Name of the Blueprint form. Used to create customized forms for different use cases. + * @return Blueprint Returns a Blueprint. + */ + public function getBlueprint(string $name = ''); + + /** + * Returns a form instance for the object. + * + * @param string $name Name of the form. Can be used to create customized forms for different use cases. + * @param array|null $options Options can be used to further customize the form. + * @return FlexFormInterface Returns a Form. + * @api + */ + public function getForm(string $name = '', array $options = null); + + /** + * Returns default value suitable to be used in a form for the given property. + * + * @see FlexObjectInterface::getForm() + * + * @param string $name Property name. + * @param string|null $separator Optional nested property separator. + * @return mixed|null Returns default value of the field, null if there is no default value. + */ + public function getDefaultValue(string $name, string $separator = null); + + /** + * Returns default values suitable to be used in a form for the given property. + * + * @see FlexObjectInterface::getForm() + * + * @return array Returns default values. + */ + public function getDefaultValues(): array; + + /** + * Returns raw value suitable to be used in a form for the given property. + * + * @see FlexObjectInterface::getForm() + * + * @param string $name Property name. + * @param mixed $default Default value. + * @param string|null $separator Optional nested property separator. + * @return mixed Returns value of the field. + */ + public function getFormValue(string $name, $default = null, string $separator = null); +} diff --git a/system/src/Grav/Framework/Flex/Interfaces/FlexStorageInterface.php b/system/src/Grav/Framework/Flex/Interfaces/FlexStorageInterface.php new file mode 100644 index 0000000..4980696 --- /dev/null +++ b/system/src/Grav/Framework/Flex/Interfaces/FlexStorageInterface.php @@ -0,0 +1,138 @@ + [storage_key => key, storage_timestamp => timestamp], ...]`. + */ + public function getExistingKeys(): array; + + /** + * Check if the key exists in the storage. + * + * @param string $key Storage key of an object. + * @return bool Returns `true` if the key exists in the storage, `false` otherwise. + */ + public function hasKey(string $key): bool; + + /** + * Check if the key exists in the storage. + * + * @param string[] $keys Storage key of an object. + * @return bool[] Returns keys with `true` if the key exists in the storage, `false` otherwise. + */ + public function hasKeys(array $keys): array; + + /** + * Create new rows into the storage. + * + * New keys will be assigned when the objects are created. + * + * @param array $rows List of rows as `[row, ...]`. + * @return array Returns created rows as `[key => row, ...] pairs. + */ + public function createRows(array $rows): array; + + /** + * Read rows from the storage. + * + * If you pass object or array as value, that value will be used to save I/O. + * + * @param array $rows Array of `[key => row, ...]` pairs. + * @param array|null $fetched Optional reference to store only fetched items. + * @return array Returns rows. Note that non-existing rows will have `null` as their value. + */ + public function readRows(array $rows, array &$fetched = null): array; + + /** + * Update existing rows in the storage. + * + * @param array $rows Array of `[key => row, ...]` pairs. + * @return array Returns updated rows. Note that non-existing rows will not be saved and have `null` as their value. + */ + public function updateRows(array $rows): array; + + /** + * Delete rows from the storage. + * + * @param array $rows Array of `[key => row, ...]` pairs. + * @return array Returns deleted rows. Note that non-existing rows have `null` as their value. + */ + public function deleteRows(array $rows): array; + + /** + * Replace rows regardless if they exist or not. + * + * All rows should have a specified key for replace to work properly. + * + * @param array $rows Array of `[key => row, ...]` pairs. + * @return array Returns both created and updated rows. + */ + public function replaceRows(array $rows): array; + + /** + * @param string $src + * @param string $dst + * @return bool + */ + public function copyRow(string $src, string $dst): bool; + + /** + * @param string $src + * @param string $dst + * @return bool + */ + public function renameRow(string $src, string $dst): bool; + + /** + * Get filesystem path for the collection or object storage. + * + * @param string|null $key Optional storage key. + * @return string|null Path in the filesystem. Can be URI or null if storage is not filesystem based. + */ + public function getStoragePath(string $key = null): ?string; + + /** + * Get filesystem path for the collection or object media. + * + * @param string|null $key Optional storage key. + * @return string|null Path in the filesystem. Can be URI or null if media isn't supported. + */ + public function getMediaPath(string $key = null): ?string; +} diff --git a/system/src/Grav/Framework/Flex/Interfaces/FlexTranslateInterface.php b/system/src/Grav/Framework/Flex/Interfaces/FlexTranslateInterface.php new file mode 100644 index 0000000..1ae8b7e --- /dev/null +++ b/system/src/Grav/Framework/Flex/Interfaces/FlexTranslateInterface.php @@ -0,0 +1,51 @@ + + */ +class FlexPageCollection extends FlexCollection +{ + /** + * @return array + */ + public static function getCachedMethods(): array + { + return [ + // Collection filtering + 'withPublished' => true, + 'withVisible' => true, + 'withRoutable' => true, + + 'isFirst' => true, + 'isLast' => true, + + // Find objects + 'prevSibling' => false, + 'nextSibling' => false, + 'adjacentSibling' => false, + 'currentPosition' => true, + + 'getNextOrder' => false, + ] + parent::getCachedMethods(); + } + + /** + * @param bool $bool + * @return static + * @phpstan-return static + */ + public function withPublished(bool $bool = true) + { + /** @var string[] $list */ + $list = array_keys(array_filter($this->call('isPublished', [$bool]))); + + /** @phpstan-var static */ + return $this->select($list); + } + + /** + * @param bool $bool + * @return static + * @phpstan-return static + */ + public function withVisible(bool $bool = true) + { + /** @var string[] $list */ + $list = array_keys(array_filter($this->call('isVisible', [$bool]))); + + /** @phpstan-var static */ + return $this->select($list); + } + + /** + * @param bool $bool + * @return static + * @phpstan-return static + */ + public function withRoutable(bool $bool = true) + { + /** @var string[] $list */ + $list = array_keys(array_filter($this->call('isRoutable', [$bool]))); + + /** @phpstan-var static */ + return $this->select($list); + } + + /** + * Check to see if this item is the first in the collection. + * + * @param string $path + * @return bool True if item is first. + */ + public function isFirst($path): bool + { + $keys = $this->getKeys(); + $first = reset($keys); + + return $path === $first; + } + + /** + * Check to see if this item is the last in the collection. + * + * @param string $path + * @return bool True if item is last. + */ + public function isLast($path): bool + { + $keys = $this->getKeys(); + $last = end($keys); + + return $path === $last; + } + + /** + * Gets the previous sibling based on current position. + * + * @param string $path + * @return PageInterface|false The previous item. + * @phpstan-return T|false + */ + public function prevSibling($path) + { + return $this->adjacentSibling($path, -1); + } + + /** + * Gets the next sibling based on current position. + * + * @param string $path + * @return PageInterface|false The next item. + * @phpstan-return T|false + */ + public function nextSibling($path) + { + return $this->adjacentSibling($path, 1); + } + + /** + * Returns the adjacent sibling based on a direction. + * + * @param string $path + * @param int $direction either -1 or +1 + * @return PageInterface|false The sibling item. + * @phpstan-return T|false + */ + public function adjacentSibling($path, $direction = 1) + { + $keys = $this->getKeys(); + $direction = (int)$direction; + $pos = array_search($path, $keys, true); + + if (is_int($pos)) { + $pos += $direction; + if (isset($keys[$pos])) { + return $this[$keys[$pos]]; + } + } + + return false; + } + + /** + * Returns the item in the current position. + * + * @param string $path the path the item + * @return int|null The index of the current page, null if not found. + */ + public function currentPosition($path): ?int + { + $pos = array_search($path, $this->getKeys(), true); + + return is_int($pos) ? $pos : null; + } + + /** + * @return string + */ + public function getNextOrder() + { + $directory = $this->getFlexDirectory(); + + $collection = $directory->getIndex(); + $keys = $collection->getStorageKeys(); + + // Assign next free order. + $last = null; + $order = 0; + foreach ($keys as $folder => $key) { + preg_match(FlexPageIndex::ORDER_PREFIX_REGEX, $folder, $test); + $test = $test[0] ?? null; + if ($test && $test > $order) { + $order = $test; + $last = $key; + } + } + + /** @var FlexPageObject|null $last */ + $last = $collection[$last]; + + return sprintf('%d.', $last ? $last->getFormValue('order') + 1 : 1); + } +} diff --git a/system/src/Grav/Framework/Flex/Pages/FlexPageIndex.php b/system/src/Grav/Framework/Flex/Pages/FlexPageIndex.php new file mode 100644 index 0000000..507a11f --- /dev/null +++ b/system/src/Grav/Framework/Flex/Pages/FlexPageIndex.php @@ -0,0 +1,48 @@ + + */ +class FlexPageIndex extends FlexIndex +{ + public const ORDER_PREFIX_REGEX = '/^\d+\./u'; + + /** + * @param string $route + * @return string + * @internal + */ + public static function normalizeRoute(string $route) + { + static $case_insensitive; + + if (null === $case_insensitive) { + $case_insensitive = Grav::instance()['config']->get('system.force_lowercase_urls', false); + } + + return $case_insensitive ? mb_strtolower($route) : $route; + } +} diff --git a/system/src/Grav/Framework/Flex/Pages/FlexPageObject.php b/system/src/Grav/Framework/Flex/Pages/FlexPageObject.php new file mode 100644 index 0000000..79d9284 --- /dev/null +++ b/system/src/Grav/Framework/Flex/Pages/FlexPageObject.php @@ -0,0 +1,496 @@ +header)) { + $this->header = clone($this->header); + } + } + + /** + * @return array + */ + public static function getCachedMethods(): array + { + return [ + // Page Content Interface + 'header' => false, + 'summary' => true, + 'content' => true, + 'value' => false, + 'media' => false, + 'title' => true, + 'menu' => true, + 'visible' => true, + 'published' => true, + 'publishDate' => true, + 'unpublishDate' => true, + 'process' => true, + 'slug' => true, + 'order' => true, + 'id' => true, + 'modified' => true, + 'lastModified' => true, + 'folder' => true, + 'date' => true, + 'dateformat' => true, + 'taxonomy' => true, + 'shouldProcess' => true, + 'isPage' => true, + 'isDir' => true, + 'folderExists' => true, + + // Page + 'isPublished' => true, + 'isOrdered' => true, + 'isVisible' => true, + 'isRoutable' => true, + 'getCreated_Timestamp' => true, + 'getPublish_Timestamp' => true, + 'getUnpublish_Timestamp' => true, + 'getUpdated_Timestamp' => true, + ] + parent::getCachedMethods(); + } + + /** + * @param bool $test + * @return bool + */ + public function isPublished(bool $test = true): bool + { + $time = time(); + $start = $this->getPublish_Timestamp(); + $stop = $this->getUnpublish_Timestamp(); + + return $this->published() && $start <= $time && (!$stop || $time <= $stop) === $test; + } + + /** + * @param bool $test + * @return bool + */ + public function isOrdered(bool $test = true): bool + { + return ($this->order() !== false) === $test; + } + + /** + * @param bool $test + * @return bool + */ + public function isVisible(bool $test = true): bool + { + return $this->visible() === $test; + } + + /** + * @param bool $test + * @return bool + */ + public function isRoutable(bool $test = true): bool + { + return $this->routable() === $test; + } + + /** + * @return int + */ + public function getCreated_Timestamp(): int + { + return $this->getFieldTimestamp('created_date') ?? 0; + } + + /** + * @return int + */ + public function getPublish_Timestamp(): int + { + return $this->getFieldTimestamp('publish_date') ?? $this->getCreated_Timestamp(); + } + + /** + * @return int|null + */ + public function getUnpublish_Timestamp(): ?int + { + return $this->getFieldTimestamp('unpublish_date'); + } + + /** + * @return int + */ + public function getUpdated_Timestamp(): int + { + return $this->getFieldTimestamp('updated_date') ?? $this->getPublish_Timestamp(); + } + + /** + * @inheritdoc + */ + public function getFormValue(string $name, $default = null, string $separator = null) + { + $test = new stdClass(); + + $value = $this->pageContentValue($name, $test); + if ($value !== $test) { + return $value; + } + + switch ($name) { + case 'name': + return $this->getProperty('template'); + case 'route': + return $this->hasKey() ? '/' . $this->getKey() : null; + case 'header.permissions.groups': + $encoded = json_encode($this->getPermissions()); + if ($encoded === false) { + throw new RuntimeException('json_encode(): failed to encode group permissions'); + } + + return json_decode($encoded, true); + } + + return parent::getFormValue($name, $default, $separator); + } + + /** + * Get master storage key. + * + * @return string + * @see FlexObjectInterface::getStorageKey() + */ + public function getMasterKey(): string + { + $key = (string)($this->storage_key ?? $this->getMetaData()['storage_key'] ?? null); + if (($pos = strpos($key, '|')) !== false) { + $key = substr($key, 0, $pos); + } + + return $key; + } + + /** + * {@inheritdoc} + * @see FlexObjectInterface::getCacheKey() + */ + public function getCacheKey(): string + { + return $this->hasKey() ? $this->getTypePrefix() . $this->getFlexType() . '.' . $this->getKey() . '.' . $this->getLanguage() : ''; + } + + /** + * @param string|null $key + * @return FlexObjectInterface + */ + public function createCopy(string $key = null) + { + $this->copy(); + + return parent::createCopy($key); + } + + /** + * @param array|bool $reorder + * @return FlexObject|FlexObjectInterface + */ + public function save($reorder = true) + { + return parent::save(); + } + + /** + * Gets the Page Unmodified (original) version of the page. + * + * Assumes that object has been cloned before modifying it. + * + * @return FlexPageObject|null The original version of the page. + */ + public function getOriginal() + { + return $this->_originalObject; + } + + /** + * Store the Page Unmodified (original) version of the page. + * + * Can be called multiple times, only the first call matters. + * + * @return void + */ + public function storeOriginal(): void + { + if (null === $this->_originalObject) { + $this->_originalObject = clone $this; + } + } + + /** + * Get display order for the associated media. + * + * @return array + */ + public function getMediaOrder(): array + { + $order = $this->getNestedProperty('header.media_order'); + + if (is_array($order)) { + return $order; + } + + if (!$order) { + return []; + } + + return array_map('trim', explode(',', $order)); + } + + // Overrides for header properties. + + /** + * Common logic to load header properties. + * + * @param string $property + * @param mixed $var + * @param callable $filter + * @return mixed|null + */ + protected function loadHeaderProperty(string $property, $var, callable $filter) + { + // We have to use parent methods in order to avoid loops. + $value = null === $var ? parent::getProperty($property) : null; + if (null === $value) { + $value = $filter($var ?? $this->getProperty('header')->get($property)); + + parent::setProperty($property, $value); + if ($this->doHasProperty($property)) { + $value = parent::getProperty($property); + } + } + + return $value; + } + + /** + * Common logic to load header properties. + * + * @param string $property + * @param mixed $var + * @param callable $filter + * @return mixed|null + */ + protected function loadProperty(string $property, $var, callable $filter) + { + // We have to use parent methods in order to avoid loops. + $value = null === $var ? parent::getProperty($property) : null; + if (null === $value) { + $value = $filter($var); + + parent::setProperty($property, $value); + if ($this->doHasProperty($property)) { + $value = parent::getProperty($property); + } + } + + return $value; + } + + /** + * @param string $property + * @param mixed $default + * @return mixed + */ + public function getProperty($property, $default = null) + { + $method = static::$headerProperties[$property] ?? static::$calculatedProperties[$property] ?? null; + if ($method && method_exists($this, $method)) { + return $this->{$method}(); + } + + return parent::getProperty($property, $default); + } + + /** + * @param string $property + * @param mixed $value + * @return $this + */ + public function setProperty($property, $value) + { + $method = static::$headerProperties[$property] ?? static::$calculatedProperties[$property] ?? null; + if ($method && method_exists($this, $method)) { + $this->{$method}($value); + + return $this; + } + + parent::setProperty($property, $value); + + return $this; + } + + /** + * @param string $property + * @param mixed $value + * @param string|null $separator + * @return $this + */ + public function setNestedProperty($property, $value, $separator = null) + { + $separator = $separator ?: '.'; + if (strpos($property, 'header' . $separator) === 0) { + $this->getProperty('header')->set(str_replace('header' . $separator, '', $property), $value, $separator); + + return $this; + } + + parent::setNestedProperty($property, $value, $separator); + + return $this; + } + + /** + * @param string $property + * @param string|null $separator + * @return $this + */ + public function unsetNestedProperty($property, $separator = null) + { + $separator = $separator ?: '.'; + if (strpos($property, 'header' . $separator) === 0) { + $this->getProperty('header')->undef(str_replace('header' . $separator, '', $property), $separator); + + return $this; + } + + parent::unsetNestedProperty($property, $separator); + + return $this; + } + + /** + * @param array $elements + * @param bool $extended + * @return void + */ + protected function filterElements(array &$elements, bool $extended = false): void + { + // Markdown storage conversion to page structure. + if (array_key_exists('content', $elements)) { + $elements['markdown'] = $elements['content']; + unset($elements['content']); + } + + if (!$extended) { + $folder = !empty($elements['folder']) ? trim($elements['folder']) : ''; + + if ($folder) { + $order = !empty($elements['order']) ? (int)$elements['order'] : null; + // TODO: broken + $elements['storage_key'] = $order ? sprintf('%02d.%s', $order, $folder) : $folder; + } + } + + parent::filterElements($elements); + } + + /** + * @param string $field + * @return int|null + */ + protected function getFieldTimestamp(string $field): ?int + { + $date = $this->getFieldDateTime($field); + + return $date ? $date->getTimestamp() : null; + } + + /** + * @param string $field + * @return DateTime|null + */ + protected function getFieldDateTime(string $field): ?DateTime + { + try { + $value = $this->getProperty($field); + if (is_numeric($value)) { + $value = '@' . $value; + } + $date = $value ? new DateTime($value) : null; + } catch (Exception $e) { + /** @var Debugger $debugger */ + $debugger = Grav::instance()['debugger']; + $debugger->addException($e); + + $date = null; + } + + return $date; + } + + /** + * @return UserCollectionInterface|null + * @internal + */ + protected function loadAccounts() + { + return Grav::instance()['accounts'] ?? null; + } +} diff --git a/system/src/Grav/Framework/Flex/Pages/Traits/PageAuthorsTrait.php b/system/src/Grav/Framework/Flex/Pages/Traits/PageAuthorsTrait.php new file mode 100644 index 0000000..1061cbb --- /dev/null +++ b/system/src/Grav/Framework/Flex/Pages/Traits/PageAuthorsTrait.php @@ -0,0 +1,249 @@ + */ + private $_authors; + /** @var array|null */ + private $_permissionsCache; + + /** + * Returns true if object has the named author. + * + * @param string $username + * @return bool + */ + public function hasAuthor(string $username): bool + { + $authors = (array)$this->getNestedProperty('header.permissions.authors'); + if (empty($authors)) { + return false; + } + + foreach ($authors as $author) { + if ($username === $author) { + return true; + } + } + + return false; + } + + /** + * Get list of all author objects. + * + * @return array + */ + public function getAuthors(): array + { + if (null === $this->_authors) { + $this->_authors = $this->loadAuthors($this->getNestedProperty('header.permissions.authors', [])); + } + + return $this->_authors; + } + + /** + * @param bool $inherit + * @return array + */ + public function getPermissions(bool $inherit = false) + { + if (null === $this->_permissionsCache) { + $permissions = []; + if ($inherit && $this->getNestedProperty('header.permissions.inherit', true)) { + $parent = $this->parent(); + if ($parent && method_exists($parent, 'getPermissions')) { + $permissions = $parent->getPermissions($inherit); + } + } + + $this->_permissionsCache = $this->loadPermissions($permissions); + } + + return $this->_permissionsCache; + } + + /** + * @param iterable $authors + * @return array + */ + protected function loadAuthors(iterable $authors): array + { + $accounts = $this->loadAccounts(); + if (null === $accounts || empty($authors)) { + return []; + } + + $list = []; + foreach ($authors as $username) { + if (!is_string($username)) { + throw new InvalidArgumentException('Iterable should return username (string).', 500); + } + $list[] = $accounts->load($username); + } + + return $list; + } + + /** + * @param string $action + * @param string|null $scope + * @param UserInterface|null $user + * @param bool $isAuthor + * @return bool|null + */ + public function isParentAuthorized(string $action, string $scope = null, UserInterface $user = null, bool $isAuthor = false): ?bool + { + $scope = $scope ?? $this->getAuthorizeScope(); + + $isMe = null === $user; + if ($isMe) { + $user = $this->getActiveUser(); + } + + if (null === $user) { + return false; + } + + return $this->isAuthorizedByGroup($user, $action, $scope, $isMe, $isAuthor); + } + + /** + * @param UserInterface $user + * @param string $action + * @param string $scope + * @param bool $isMe + * @return bool|null + */ + protected function isAuthorizedOverride(UserInterface $user, string $action, string $scope, bool $isMe): ?bool + { + if ($action === 'delete' && $this->root()) { + // Do not allow deleting root. + return false; + } + + $isAuthor = !$isMe || $user->authorized ? $this->hasAuthor($user->username) : false; + + return $this->isAuthorizedByGroup($user, $action, $scope, $isMe, $isAuthor) ?? parent::isAuthorizedOverride($user, $action, $scope, $isMe); + } + + /** + * Group authorization works as follows: + * + * 1. if any of the groups deny access, return false + * 2. else if any of the groups allow access, return true + * 3. else return null + * + * @param UserInterface $user + * @param string $action + * @param string $scope + * @param bool $isMe + * @param bool $isAuthor + * @return bool|null + */ + protected function isAuthorizedByGroup(UserInterface $user, string $action, string $scope, bool $isMe, bool $isAuthor): ?bool + { + $authorized = null; + + // In admin we want to check against group permissions. + $pageGroups = $this->getPermissions(); + $userGroups = (array)$user->groups; + + /** @var Access $access */ + foreach ($pageGroups as $group => $access) { + if ($group === 'defaults') { + // Special defaults permissions group does not apply to guest. + if ($isMe && !$user->authorized) { + continue; + } + } elseif ($group === 'authors') { + if (!$isAuthor) { + continue; + } + } elseif (!in_array($group, $userGroups, true)) { + continue; + } + + $auth = $access->authorize($action); + if (is_bool($auth)) { + if ($auth === false) { + return false; + } + + $authorized = true; + } + } + + if (null === $authorized && $this->getNestedProperty('header.permissions.inherit', true)) { + // Authorize against parent page. + $parent = $this->parent(); + if ($parent && method_exists($parent, 'isParentAuthorized')) { + $authorized = $parent->isParentAuthorized($action, $scope, !$isMe ? $user : null, $isAuthor); + } + } + + return $authorized; + } + + /** + * @param array $parent + * @return array + */ + protected function loadPermissions(array $parent = []): array + { + static $rules = [ + 'c' => 'create', + 'r' => 'read', + 'u' => 'update', + 'd' => 'delete', + 'p' => 'publish', + 'l' => 'list' + ]; + + $permissions = $this->getNestedProperty('header.permissions.groups'); + $name = $this->root() ? '' : '/' . $this->getKey(); + + $list = []; + if (is_array($permissions)) { + foreach ($permissions as $group => $access) { + $list[$group] = new Access($access, $rules, $name); + } + } + foreach ($parent as $group => $access) { + if (isset($list[$group])) { + $object = $list[$group]; + } else { + $object = new Access([], $rules, $name); + $list[$group] = $object; + } + + $object->inherit($access); + } + + return $list; + } +} diff --git a/system/src/Grav/Framework/Flex/Pages/Traits/PageContentTrait.php b/system/src/Grav/Framework/Flex/Pages/Traits/PageContentTrait.php new file mode 100644 index 0000000..99c5dfd --- /dev/null +++ b/system/src/Grav/Framework/Flex/Pages/Traits/PageContentTrait.php @@ -0,0 +1,842 @@ + 'slug', + 'routes' => false, + 'title' => 'title', + 'language' => 'language', + 'template' => 'template', + 'menu' => 'menu', + 'routable' => 'routable', + 'visible' => 'visible', + 'redirect' => 'redirect', + 'external_url' => false, + 'order_dir' => 'orderDir', + 'order_by' => 'orderBy', + 'order_manual' => 'orderManual', + 'dateformat' => 'dateformat', + 'date' => 'date', + 'markdown_extra' => false, + 'taxonomy' => 'taxonomy', + 'max_count' => 'maxCount', + 'process' => 'process', + 'published' => 'published', + 'publish_date' => 'publishDate', + 'unpublish_date' => 'unpublishDate', + 'expires' => 'expires', + 'cache_control' => 'cacheControl', + 'etag' => 'eTag', + 'last_modified' => 'lastModified', + 'ssl' => 'ssl', + 'template_format' => 'templateFormat', + 'debugger' => false, + ]; + + /** @var array */ + protected static $calculatedProperties = [ + 'name' => 'name', + 'parent' => 'parent', + 'parent_key' => 'parentStorageKey', + 'folder' => 'folder', + 'order' => 'order', + 'template' => 'template', + ]; + + /** @var object|null */ + protected $header; + + /** @var string|null */ + protected $_summary; + + /** @var string|null */ + protected $_content; + + /** + * Method to normalize the route. + * + * @param string $route + * @return string + * @internal + */ + public static function normalizeRoute($route): string + { + $case_insensitive = Grav::instance()['config']->get('system.force_lowercase_urls'); + + return $case_insensitive ? mb_strtolower($route) : $route; + } + + /** + * @inheritdoc + * @return Header + */ + public function header($var = null) + { + if (null !== $var) { + $this->setProperty('header', $var); + } + + return $this->getProperty('header'); + } + + /** + * @inheritdoc + */ + public function summary($size = null, $textOnly = false): string + { + return $this->processSummary($size, $textOnly); + } + + /** + * @inheritdoc + */ + public function setSummary($summary): void + { + $this->_summary = $summary; + } + + /** + * @inheritdoc + * @throws Exception + */ + public function content($var = null): string + { + if (null !== $var) { + $this->_content = $var; + } + + return $this->_content ?? $this->processContent($this->getRawContent()); + } + + /** + * @inheritdoc + */ + public function getRawContent(): string + { + return $this->_content ?? $this->getArrayProperty('markdown') ?? ''; + } + + /** + * @inheritdoc + */ + public function setRawContent($content): void + { + $this->_content = $content ?? ''; + } + + /** + * @inheritdoc + */ + public function rawMarkdown($var = null): string + { + if ($var !== null) { + $this->setProperty('markdown', $var); + } + + return $this->getProperty('markdown') ?? ''; + } + + /** + * @inheritdoc + * + * Implement by calling: + * + * $test = new \stdClass(); + * $value = $this->pageContentValue($name, $test); + * if ($value !== $test) { + * return $value; + * } + * return parent::value($name, $default); + */ + abstract public function value($name, $default = null, $separator = null); + + /** + * @inheritdoc + */ + public function media($var = null): Media + { + if ($var instanceof Media) { + $this->setProperty('media', $var); + } + + return $this->getProperty('media'); + } + + /** + * @inheritdoc + */ + public function title($var = null): string + { + return $this->loadHeaderProperty( + 'title', + $var, + function ($value) { + return trim($value ?? ($this->root() ? '' : ucfirst($this->slug()))); + } + ); + } + + /** + * @inheritdoc + */ + public function menu($var = null): string + { + return $this->loadHeaderProperty( + 'menu', + $var, + function ($value) { + return trim($value ?: $this->title()); + } + ); + } + + /** + * @inheritdoc + */ + public function visible($var = null): bool + { + $value = $this->loadHeaderProperty( + 'visible', + $var, + function ($value) { + return ($value ?? $this->order() !== false) && !$this->isModule(); + } + ); + + return $value && $this->published(); + } + + /** + * @inheritdoc + */ + public function published($var = null): bool + { + return $this->loadHeaderProperty( + 'published', + $var, + static function ($value) { + return (bool)($value ?? true); + } + ); + } + + /** + * @inheritdoc + */ + public function publishDate($var = null): ?int + { + return $this->loadHeaderProperty( + 'publish_date', + $var, + function ($value) { + return $value ? Utils::date2timestamp($value, $this->getProperty('dateformat')) : null; + } + ); + } + + /** + * @inheritdoc + */ + public function unpublishDate($var = null): ?int + { + return $this->loadHeaderProperty( + 'unpublish_date', + $var, + function ($value) { + return $value ? Utils::date2timestamp($value, $this->getProperty('dateformat')) : null; + } + ); + } + + /** + * @inheritdoc + */ + public function process($var = null): array + { + return $this->loadHeaderProperty( + 'process', + $var, + function ($value) { + $value = array_replace(Grav::instance()['config']->get('system.pages.process', []), is_array($value) ? $value : []); + foreach ($value as $process => $status) { + $value[$process] = (bool)$status; + } + + return $value; + } + ); + } + + /** + * @inheritdoc + */ + public function slug($var = null) + { + return $this->loadHeaderProperty( + 'slug', + $var, + function ($value) { + if (is_string($value)) { + return $value; + } + + $folder = $this->folder(); + if (null === $folder) { + return null; + } + + $folder = preg_replace(static::PAGE_ORDER_PREFIX_REGEX, '', $folder); + if (null === $folder) { + return null; + } + + return static::normalizeRoute($folder); + } + ); + } + + /** + * @inheritdoc + */ + public function order($var = null) + { + $property = $this->loadProperty( + 'order', + $var, + function ($value) { + if (null === $value) { + $folder = $this->folder(); + if (null !== $folder) { + preg_match(static::PAGE_ORDER_REGEX, $folder, $order); + } + + $value = $order[1] ?? false; + } + + if ($value === '') { + $value = false; + } + if ($value !== false) { + $value = (int)$value; + } + + return $value; + } + ); + + return $property !== false ? sprintf('%02d.', $property) : false; + } + + /** + * @inheritdoc + */ + public function id($var = null): string + { + $property = 'id'; + $value = null === $var ? $this->getProperty($property) : null; + if (null === $value) { + $value = $this->language() . ($var ?? ($this->modified() . md5('flex-' . $this->getFlexType() . '-' . $this->getKey()))); + + $this->setProperty($property, $value); + if ($this->doHasProperty($property)) { + $value = $this->getProperty($property); + } + } + + return $value; + } + + /** + * @inheritdoc + */ + public function modified($var = null): int + { + $property = 'modified'; + $value = null === $var ? $this->getProperty($property) : null; + if (null === $value) { + $value = (int)($var ?: $this->getTimestamp()); + + $this->setProperty($property, $value); + if ($this->doHasProperty($property)) { + $value = $this->getProperty($property); + } + } + + return $value; + } + + /** + * @inheritdoc + */ + public function lastModified($var = null): bool + { + return $this->loadHeaderProperty( + 'last_modified', + $var, + static function ($value) { + return (bool)($value ?? Grav::instance()['config']->get('system.pages.last_modified')); + } + ); + } + + /** + * @inheritdoc + */ + public function date($var = null): int + { + return $this->loadHeaderProperty( + 'date', + $var, + function ($value) { + $value = $value ? Utils::date2timestamp($value, $this->getProperty('dateformat')) : false; + + return $value ?: $this->modified(); + } + ); + } + + /** + * @inheritdoc + */ + public function dateformat($var = null): ?string + { + return $this->loadHeaderProperty( + 'dateformat', + $var, + static function ($value) { + return $value; + } + ); + } + + /** + * @inheritdoc + */ + public function taxonomy($var = null): array + { + return $this->loadHeaderProperty( + 'taxonomy', + $var, + static function ($value) { + if (is_array($value)) { + // make sure first level are arrays + array_walk($value, static function (&$val) { + $val = (array) $val; + }); + // make sure all values are strings + array_walk_recursive($value, static function (&$val) { + $val = (string) $val; + }); + } + + return $value ?? []; + } + ); + } + + /** + * @inheritdoc + */ + public function shouldProcess($process): bool + { + $test = $this->process(); + + return !empty($test[$process]); + } + + /** + * @inheritdoc + */ + public function isPage(): bool + { + return !in_array($this->template(), ['', 'folder'], true); + } + + /** + * @inheritdoc + */ + public function isDir(): bool + { + return !$this->isPage(); + } + + /** + * @return bool + */ + public function isModule(): bool + { + return $this->modularTwig(); + } + + /** + * @param Header|stdClass|array|null $value + * @return Header + */ + protected function offsetLoad_header($value) + { + if ($value instanceof Header) { + return $value; + } + + if (null === $value) { + $value = []; + } elseif ($value instanceof stdClass) { + $value = (array)$value; + } + + return new Header($value); + } + + /** + * @param Header|stdClass|array|null $value + * @return Header + */ + protected function offsetPrepare_header($value) + { + return $this->offsetLoad_header($value); + } + + /** + * @param Header|null $value + * @return array + */ + protected function offsetSerialize_header(?Header $value) + { + return $value ? $value->toArray() : []; + } + + /** + * @param string $name + * @param mixed|null $default + * @return mixed + */ + protected function pageContentValue($name, $default = null) + { + switch ($name) { + case 'frontmatter': + $frontmatter = $this->getArrayProperty('frontmatter'); + if ($frontmatter === null) { + $header = $this->prepareStorage()['header'] ?? null; + if ($header) { + $formatter = new YamlFormatter(); + $frontmatter = $formatter->encode($header); + } else { + $frontmatter = ''; + } + } + return $frontmatter; + case 'content': + return $this->getProperty('markdown'); + case 'order': + return (string)$this->order(); + case 'menu': + return $this->menu(); + case 'ordering': + return $this->order() !== false ? '1' : '0'; + case 'folder': + $folder = $this->folder(); + + return null !== $folder ? preg_replace(static::PAGE_ORDER_PREFIX_REGEX, '', $folder) : ''; + case 'slug': + return $this->slug(); + case 'published': + return $this->published(); + case 'visible': + return $this->visible(); + case 'media': + return $this->media()->all(); + case 'media.file': + return $this->media()->files(); + case 'media.video': + return $this->media()->videos(); + case 'media.image': + return $this->media()->images(); + case 'media.audio': + return $this->media()->audios(); + } + + return $default; + } + + /** + * @param int|null $size + * @param bool $textOnly + * @return string + */ + protected function processSummary($size = null, $textOnly = false): string + { + $config = (array)Grav::instance()['config']->get('site.summary'); + $config_page = (array)$this->getNestedProperty('header.summary'); + if ($config_page) { + $config = array_merge($config, $config_page); + } + + // Summary is not enabled, return the whole content. + if (empty($config['enabled'])) { + return $this->content(); + } + + $content = $this->_summary ?? $this->content(); + if ($textOnly) { + $content = strip_tags($content); + } + $content_size = mb_strwidth($content, 'utf-8'); + $summary_size = $this->_summary !== null ? $content_size : $this->getProperty('summary_size'); + + // Return calculated summary based on summary divider's position. + $format = $config['format'] ?? ''; + + // Return entire page content on wrong/unknown format. + if ($format !== 'long' && $format !== 'short') { + return $content; + } + + if ($format === 'short' && null !== $summary_size) { + // Slice the string on breakpoint. + if ($content_size > $summary_size) { + return mb_substr($content, 0, $summary_size); + } + + return $content; + } + + // If needed, get summary size from the config. + $size = $size ?? $config['size'] ?? null; + + // Return calculated summary based on defaults. + $size = is_numeric($size) ? (int)$size : -1; + if ($size < 0) { + $size = 300; + } + + // If the size is zero or smaller than the summary limit, return the entire page content. + if ($size === 0 || $content_size <= $size) { + return $content; + } + + // Only return string but not html, wrap whatever html tag you want when using. + if ($textOnly) { + return mb_strimwidth($content, 0, $size, '...', 'UTF-8'); + } + + $summary = Utils::truncateHTML($content, $size); + + return html_entity_decode($summary, ENT_COMPAT | ENT_HTML5, 'UTF-8'); + } + + /** + * Gets and Sets the content based on content portion of the .md file + * + * @param string $content + * @return string + * @throws Exception + */ + protected function processContent($content): string + { + $content = is_string($content) ? $content : ''; + $grav = Grav::instance(); + + /** @var Config $config */ + $config = $grav['config']; + + $process_markdown = $this->shouldProcess('markdown'); + $process_twig = $this->shouldProcess('twig') || $this->isModule(); + $cache_enable = $this->getNestedProperty('header.cache_enable') ?? $config->get('system.cache.enabled', true); + + $twig_first = $this->getNestedProperty('header.twig_first') ?? $config->get('system.pages.twig_first', false); + $never_cache_twig = $this->getNestedProperty('header.never_cache_twig') ?? $config->get('system.pages.never_cache_twig', false); + + if ($cache_enable) { + $cache = $this->getCache('render'); + $key = md5($this->getCacheKey() . '-content'); + $cached = $cache->get($key); + if ($cached && $cached['checksum'] === $this->getCacheChecksum()) { + $this->_content = $cached['content'] ?? ''; + $this->_content_meta = $cached['content_meta'] ?? null; + + if ($process_twig && $never_cache_twig) { + $this->_content = $this->processTwig($this->_content); + } + } + } + + if (null === $this->_content) { + $markdown_options = []; + if ($process_markdown) { + // Build markdown options. + $markdown_options = (array)$config->get('system.pages.markdown'); + $markdown_page_options = (array)$this->getNestedProperty('header.markdown'); + if ($markdown_page_options) { + $markdown_options = array_merge($markdown_options, $markdown_page_options); + } + + // pages.markdown_extra is deprecated, but still check it... + if (!isset($markdown_options['extra'])) { + $extra = $this->getNestedProperty('header.markdown_extra') ?? $config->get('system.pages.markdown_extra'); + if (null !== $extra) { + user_error('Configuration option \'system.pages.markdown_extra\' is deprecated since Grav 1.5, use \'system.pages.markdown.extra\' instead', E_USER_DEPRECATED); + + $markdown_options['extra'] = $extra; + } + } + } + $options = [ + 'markdown' => $markdown_options, + 'images' => $config->get('system.images', []) + ]; + + $this->_content = $content; + $grav->fireEvent('onPageContentRaw', new Event(['page' => $this])); + + if ($twig_first && !$never_cache_twig) { + if ($process_twig) { + $this->_content = $this->processTwig($this->_content); + } + + if ($process_markdown) { + $this->_content = $this->processMarkdown($this->_content, $options); + } + + // Content Processed but not cached yet + $grav->fireEvent('onPageContentProcessed', new Event(['page' => $this])); + } else { + if ($process_markdown) { + $options['keep_twig'] = $process_twig; + $this->_content = $this->processMarkdown($this->_content, $options); + } + + // Content Processed but not cached yet + $grav->fireEvent('onPageContentProcessed', new Event(['page' => $this])); + + if ($cache_enable && $never_cache_twig) { + $this->cachePageContent(); + } + + if ($process_twig) { + \assert(is_string($this->_content)); + $this->_content = $this->processTwig($this->_content); + } + } + + if ($cache_enable && !$never_cache_twig) { + $this->cachePageContent(); + } + } + + \assert(is_string($this->_content)); + + // Handle summary divider + $delimiter = $config->get('site.summary.delimiter', '==='); + $divider_pos = mb_strpos($this->_content, "

    {$delimiter}

    "); + if ($divider_pos !== false) { + $this->setProperty('summary_size', $divider_pos); + $this->_content = str_replace("

    {$delimiter}

    ", '', $this->_content); + } + + // Fire event when Page::content() is called + $grav->fireEvent('onPageContent', new Event(['page' => $this])); + + return $this->_content; + } + + /** + * Process the Twig page content. + * + * @param string $content + * @return string + */ + protected function processTwig($content): string + { + /** @var Twig $twig */ + $twig = Grav::instance()['twig']; + + /** @var PageInterface $this */ + return $twig->processPage($this, $content); + } + + /** + * Process the Markdown content. + * + * Uses Parsedown or Parsedown Extra depending on configuration. + * + * @param string $content + * @param array $options + * @return string + * @throws Exception + */ + protected function processMarkdown($content, array $options = []): string + { + /** @var PageInterface $self */ + $self = $this; + + $excerpts = new Excerpts($self, $options); + + // Initialize the preferred variant of markdown parser. + if (isset($options['extra'])) { + $parsedown = new ParsedownExtra($excerpts); + } else { + $parsedown = new Parsedown($excerpts); + } + + $keepTwig = (bool)($options['keep_twig'] ?? false); + if ($keepTwig) { + $token = [ + '/' . Utils::generateRandomString(3), + Utils::generateRandomString(3) . '/' + ]; + // Base64 encode any twig. + $content = preg_replace_callback( + ['/({#.*?#})/mu', '/({{.*?}})/mu', '/({%.*?%})/mu'], + static function ($matches) use ($token) { return $token[0] . base64_encode($matches[1]) . $token[1]; }, + $content + ); + } + + $content = $parsedown->text($content); + + if ($keepTwig) { + // Base64 decode the encoded twig. + $content = preg_replace_callback( + ['`' . $token[0] . '([A-Za-z0-9+/]+={0,2})' . $token[1] . '`mu'], + static function ($matches) { return base64_decode($matches[1]); }, + $content + ); + } + + return $content; + } + + abstract protected function loadHeaderProperty(string $property, $var, callable $filter); +} diff --git a/system/src/Grav/Framework/Flex/Pages/Traits/PageLegacyTrait.php b/system/src/Grav/Framework/Flex/Pages/Traits/PageLegacyTrait.php new file mode 100644 index 0000000..77c218f --- /dev/null +++ b/system/src/Grav/Framework/Flex/Pages/Traits/PageLegacyTrait.php @@ -0,0 +1,1124 @@ +getFlexDirectory()->getStorage(); + if (method_exists($storage, 'readRaw')) { + return $storage->readRaw($this->getStorageKey()); + } + + $array = $this->prepareStorage(); + $formatter = new MarkdownFormatter(); + + return $formatter->encode($array); + } + + /** + * Gets and Sets the page frontmatter + * + * @param string|null $var + * @return string + */ + public function frontmatter($var = null): string + { + if (null !== $var) { + $formatter = new YamlFormatter(); + $this->setProperty('frontmatter', $var); + $this->setProperty('header', $formatter->decode($var)); + + return $var; + } + + $storage = $this->getFlexDirectory()->getStorage(); + if (method_exists($storage, 'readFrontmatter')) { + return $storage->readFrontmatter($this->getStorageKey()); + } + + $array = $this->prepareStorage(); + $formatter = new YamlFormatter(); + + return $formatter->encode($array['header'] ?? []); + } + + /** + * Modify a header value directly + * + * @param string $key + * @param string|array $value + * @return void + */ + public function modifyHeader($key, $value): void + { + $this->setNestedProperty("header.{$key}", $value); + } + + /** + * @return int + */ + public function httpResponseCode(): int + { + $code = (int)$this->getNestedProperty('header.http_response_code'); + + return $code ?: 200; + } + + /** + * @return array + */ + public function httpHeaders(): array + { + $headers = []; + + $format = $this->templateFormat(); + $cache_control = $this->cacheControl(); + $expires = $this->expires(); + + // Set Content-Type header. + $headers['Content-Type'] = Utils::getMimeByExtension($format, 'text/html'); + + // Calculate Expires Headers if set to > 0. + if ($expires > 0) { + $expires_date = gmdate('D, d M Y H:i:s', time() + $expires) . ' GMT'; + if (!$cache_control) { + $headers['Cache-Control'] = 'max-age=' . $expires; + } + $headers['Expires'] = $expires_date; + } + + // Set Cache-Control header. + if ($cache_control) { + $headers['Cache-Control'] = strtolower($cache_control); + } + + // Set Last-Modified header. + if ($this->lastModified()) { + $last_modified_date = gmdate('D, d M Y H:i:s', $this->modified()) . ' GMT'; + $headers['Last-Modified'] = $last_modified_date; + } + + // Calculate ETag based on the serialized page and modified time. + if ($this->eTag()) { + $headers['ETag'] = '1'; + } + + // Set Vary: Accept-Encoding header. + $grav = Grav::instance(); + if ($grav['config']->get('system.pages.vary_accept_encoding', false)) { + $headers['Vary'] = 'Accept-Encoding'; + } + + return $headers; + } + + /** + * Get the contentMeta array and initialize content first if it's not already + * + * @return array + */ + public function contentMeta(): array + { + // Content meta is generated during the content is being rendered, so make sure we have done it. + $this->content(); + + return $this->_content_meta ?? []; + } + + /** + * Add an entry to the page's contentMeta array + * + * @param string $name + * @param string $value + * @return void + */ + public function addContentMeta($name, $value): void + { + $this->_content_meta[$name] = $value; + } + + /** + * Return the whole contentMeta array as it currently stands + * + * @param string|null $name + * @return string|array|null + */ + public function getContentMeta($name = null) + { + if ($name) { + return $this->_content_meta[$name] ?? null; + } + + return $this->_content_meta ?? []; + } + + /** + * Sets the whole content meta array in one shot + * + * @param array $content_meta + * @return array + */ + public function setContentMeta($content_meta): array + { + return $this->_content_meta = $content_meta; + } + + /** + * Fires the onPageContentProcessed event, and caches the page content using a unique ID for the page + */ + public function cachePageContent(): void + { + $value = [ + 'checksum' => $this->getCacheChecksum(), + 'content' => $this->_content, + 'content_meta' => $this->_content_meta + ]; + + $cache = $this->getCache('render'); + $key = md5($this->getCacheKey() . '-content'); + + $cache->set($key, $value); + } + + /** + * Get file object to the page. + * + * @return MarkdownFile|null + */ + public function file(): ?MarkdownFile + { + // TODO: + throw new RuntimeException(__METHOD__ . '(): Not Implemented'); + } + + /** + * Prepare move page to new location. Moves also everything that's under the current page. + * + * You need to call $this->save() in order to perform the move. + * + * @param PageInterface $parent New parent page. + * @return $this + */ + public function move(PageInterface $parent) + { + if ($this->route() === $parent->route()) { + throw new RuntimeException('Failed: Cannot set page parent to self'); + } + $rawRoute = $this->rawRoute(); + if ($rawRoute && Utils::startsWith($parent->rawRoute(), $rawRoute)) { + throw new RuntimeException('Failed: Cannot set page parent to a child of current page'); + } + + $this->storeOriginal(); + + // TODO: + throw new RuntimeException(__METHOD__ . '(): Not Implemented'); + } + + /** + * Prepare a copy from the page. Copies also everything that's under the current page. + * + * Returns a new Page object for the copy. + * You need to call $this->save() in order to perform the move. + * + * @param PageInterface|null $parent New parent page. + * @return $this + */ + public function copy(PageInterface $parent = null) + { + $this->storeOriginal(); + + $filesystem = Filesystem::getInstance(false); + + $parentStorageKey = ltrim($filesystem->dirname("/{$this->getMasterKey()}"), '/'); + + /** @var FlexPageIndex> $index */ + $index = $this->getFlexDirectory()->getIndex(); + + if ($parent) { + if ($parent instanceof FlexPageObject) { + $k = $parent->getMasterKey(); + if ($k !== $parentStorageKey) { + $parentStorageKey = $k; + } + } else { + throw new RuntimeException('Cannot copy page, parent is of unknown type'); + } + } else { + $parent = $parentStorageKey + ? $this->getFlexDirectory()->getObject($parentStorageKey, 'storage_key') + : (method_exists($index, 'getRoot') ? $index->getRoot() : null); + } + + // Find non-existing key. + $parentKey = $parent ? $parent->getKey() : ''; + if ($this instanceof FlexPageObject) { + $key = trim($parentKey . '/' . $this->folder(), '/'); + $key = preg_replace(static::PAGE_ORDER_PREFIX_REGEX, '', $key); + \assert(is_string($key)); + } else { + $key = trim($parentKey . '/' . Utils::basename($this->getKey()), '/'); + } + + if ($index->containsKey($key)) { + $key = preg_replace('/\d+$/', '', $key); + $i = 1; + do { + $i++; + $test = "{$key}{$i}"; + } while ($index->containsKey($test)); + $key = $test; + } + $folder = Utils::basename($key); + + // Get the folder name. + $order = $this->getProperty('order'); + if ($order) { + $order++; + } + + $parts = []; + if ($parentStorageKey !== '') { + $parts[] = $parentStorageKey; + } + $parts[] = $order ? sprintf('%02d.%s', $order, $folder) : $folder; + + // Finally update the object. + $this->setKey($key); + $this->setStorageKey(implode('/', $parts)); + + $this->markAsCopy(); + + return $this; + } + + /** + * Get the blueprint name for this page. Use the blueprint form field if set + * + * @return string + */ + public function blueprintName(): string + { + if (!isset($_POST['blueprint'])) { + return $this->template(); + } + + $post_value = $_POST['blueprint']; + $sanitized_value = htmlspecialchars(strip_tags($post_value), ENT_QUOTES, 'UTF-8'); + + return $sanitized_value ?: $this->template(); + } + + /** + * Validate page header. + * + * @return void + * @throws Exception + */ + public function validate(): void + { + $blueprint = $this->getBlueprint(); + $blueprint->validate($this->toArray()); + } + + /** + * Filter page header from illegal contents. + * + * @return void + */ + public function filter(): void + { + $blueprints = $this->getBlueprint(); + $values = $blueprints->filter($this->toArray()); + if ($values && isset($values['header'])) { + $this->header($values['header']); + } + } + + /** + * Get unknown header variables. + * + * @return array + */ + public function extra(): array + { + $data = $this->prepareStorage(); + + return $this->getBlueprint()->extra((array)($data['header'] ?? []), 'header.'); + } + + /** + * Convert page to an array. + * + * @return array + */ + public function toArray(): array + { + return [ + 'header' => (array)$this->header(), + 'content' => (string)$this->getFormValue('content') + ]; + } + + /** + * Convert page to YAML encoded string. + * + * @return string + */ + public function toYaml(): string + { + return Yaml::dump($this->toArray(), 20); + } + + /** + * Convert page to JSON encoded string. + * + * @return string + */ + public function toJson(): string + { + $json = json_encode($this->toArray()); + if (!is_string($json)) { + throw new RuntimeException('Internal error'); + } + + return $json; + } + + /** + * Gets and sets the name field. If no name field is set, it will return 'default.md'. + * + * @param string|null $var The name of this page. + * @return string The name of this page. + */ + public function name($var = null): string + { + return $this->loadProperty( + 'name', + $var, + function ($value) { + $value = $value ?? $this->getMetaData()['template'] ?? 'default'; + if (!preg_match('/\.md$/', $value)) { + $language = $this->language(); + if ($language) { + // TODO: better language support + $value .= ".{$language}"; + } + $value .= '.md'; + } + $value = preg_replace('|^modular/|', '', $value); + + $this->unsetProperty('template'); + + return $value; + } + ); + } + + /** + * Returns child page type. + * + * @return string + */ + public function childType(): string + { + return (string)$this->getNestedProperty('header.child_type'); + } + + /** + * Gets and sets the template field. This is used to find the correct Twig template file to render. + * If no field is set, it will return the name without the .md extension + * + * @param string|null $var the template name + * @return string the template name + */ + public function template($var = null): string + { + return $this->loadHeaderProperty( + 'template', + $var, + function ($value) { + return trim($value ?? (($this->isModule() ? 'modular/' : '') . str_replace($this->extension(), '', $this->name()))); + } + ); + } + + /** + * Allows a page to override the output render format, usually the extension provided in the URL. + * (e.g. `html`, `json`, `xml`, etc). + * + * @param string|null $var + * @return string + */ + public function templateFormat($var = null): string + { + return $this->loadHeaderProperty( + 'template_format', + $var, + function ($value) { + return ltrim($value ?? $this->getNestedProperty('header.append_url_extension') ?: Utils::getPageFormat(), '.'); + } + ); + } + + /** + * Gets and sets the extension field. + * + * @param string|null $var + * @return string + */ + public function extension($var = null): string + { + if (null !== $var) { + $this->setProperty('format', $var); + } + + $language = $this->language(); + if ($language) { + $language = '.' . $language; + } + $format = '.' . ($this->getProperty('format') ?? Utils::pathinfo($this->name(), PATHINFO_EXTENSION)); + + return $language . $format; + } + + /** + * Gets and sets the expires field. If not set will return the default + * + * @param int|null $var The new expires value. + * @return int The expires value + */ + public function expires($var = null): int + { + return $this->loadHeaderProperty( + 'expires', + $var, + static function ($value) { + return (int)($value ?? Grav::instance()['config']->get('system.pages.expires')); + } + ); + } + + /** + * Gets and sets the cache-control property. If not set it will return the default value (null) + * https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Cache-Control for more details on valid options + * + * @param string|null $var + * @return string|null + */ + public function cacheControl($var = null): ?string + { + return $this->loadHeaderProperty( + 'cache_control', + $var, + static function ($value) { + return ((string)($value ?? Grav::instance()['config']->get('system.pages.cache_control'))) ?: null; + } + ); + } + + /** + * @param bool|null $var + * @return bool|null + */ + public function ssl($var = null): ?bool + { + return $this->loadHeaderProperty( + 'ssl', + $var, + static function ($value) { + return $value ? (bool)$value : null; + } + ); + } + + /** + * Returns the state of the debugger override setting for this page + * + * @return bool + */ + public function debugger(): bool + { + return (bool)$this->getNestedProperty('header.debugger', true); + } + + /** + * Function to merge page metadata tags and build an array of Metadata objects + * that can then be rendered in the page. + * + * @param array|null $var an Array of metadata values to set + * @return array an Array of metadata values for the page + */ + public function metadata($var = null): array + { + if ($var !== null) { + $this->_metadata = (array)$var; + } + + // if not metadata yet, process it. + if (null === $this->_metadata) { + $this->_metadata = []; + + $config = Grav::instance()['config']; + + // Set the Generator tag + $defaultMetadata = ['generator' => 'GravCMS']; + $siteMetadata = $config->get('site.metadata', []); + $headerMetadata = $this->getNestedProperty('header.metadata', []); + + // Get initial metadata for the page + $metadata = array_merge($defaultMetadata, $siteMetadata, $headerMetadata); + + $header_tag_http_equivs = ['content-type', 'default-style', 'refresh', 'x-ua-compatible', 'content-security-policy']; + $escape = !$config->get('system.strict_mode.twig_compat', false) || $config->get('system.twig.autoescape', true); + + // Build an array of meta objects.. + foreach ($metadata as $key => $value) { + // Lowercase the key + $key = strtolower($key); + + // If this is a property type metadata: "og", "twitter", "facebook" etc + // Backward compatibility for nested arrays in metas + if (is_array($value)) { + foreach ($value as $property => $prop_value) { + $prop_key = $key . ':' . $property; + $this->_metadata[$prop_key] = [ + 'name' => $prop_key, + 'property' => $prop_key, + 'content' => $escape ? htmlspecialchars($prop_value, ENT_QUOTES | ENT_HTML5, 'UTF-8') : $prop_value + ]; + } + } elseif ($value) { + // If it this is a standard meta data type + if (in_array($key, $header_tag_http_equivs, true)) { + $this->_metadata[$key] = [ + 'http_equiv' => $key, + 'content' => $escape ? htmlspecialchars($value, ENT_COMPAT, 'UTF-8') : $value + ]; + } elseif ($key === 'charset') { + $this->_metadata[$key] = ['charset' => $escape ? htmlspecialchars($value, ENT_QUOTES | ENT_HTML5, 'UTF-8') : $value]; + } else { + // if it's a social metadata with separator, render as property + $separator = strpos($key, ':'); + $hasSeparator = $separator && $separator < strlen($key) - 1; + $entry = [ + 'content' => $escape ? htmlspecialchars($value, ENT_QUOTES | ENT_HTML5, 'UTF-8') : $value + ]; + + if ($hasSeparator && !Utils::startsWith($key, 'twitter')) { + $entry['property'] = $key; + } else { + $entry['name'] = $key; + } + + $this->_metadata[$key] = $entry; + } + } + } + } + + return $this->_metadata; + } + + /** + * Reset the metadata and pull from header again + */ + public function resetMetadata(): void + { + $this->_metadata = null; + } + + /** + * Gets and sets the option to show the etag header for the page. + * + * @param bool|null $var show etag header + * @return bool show etag header + */ + public function eTag($var = null): bool + { + return $this->loadHeaderProperty( + 'etag', + $var, + static function ($value) { + return (bool)($value ?? Grav::instance()['config']->get('system.pages.etag')); + } + ); + } + + /** + * Gets and sets the path to the .md file for this Page object. + * + * @param string|null $var the file path + * @return string|null the file path + */ + public function filePath($var = null): ?string + { + if (null !== $var) { + // TODO: + throw new RuntimeException(__METHOD__ . '(string): Not Implemented'); + } + + $folder = $this->getStorageFolder(); + if (!$folder) { + return null; + } + + /** @var UniformResourceLocator $locator */ + $locator = Grav::instance()['locator']; + $folder = $locator->isStream($folder) ? $locator->getResource($folder) : GRAV_ROOT . "/{$folder}"; + + return $folder . '/' . ($this->isPage() ? $this->name() : 'default.md'); + } + + /** + * Gets the relative path to the .md file + * + * @return string|null The relative file path + */ + public function filePathClean(): ?string + { + $folder = $this->getStorageFolder(); + if (!$folder) { + return null; + } + + /** @var UniformResourceLocator $locator */ + $locator = Grav::instance()['locator']; + $folder = $locator->isStream($folder) ? $locator->getResource($folder, false) : $folder; + + return $folder . '/' . ($this->isPage() ? $this->name() : 'default.md'); + } + + /** + * Gets and sets the order by which any sub-pages should be sorted. + * + * @param string|null $var the order, either "asc" or "desc" + * @return string the order, either "asc" or "desc" + */ + public function orderDir($var = null): string + { + return $this->loadHeaderProperty( + 'order_dir', + $var, + static function ($value) { + return strtolower(trim($value) ?: Grav::instance()['config']->get('system.pages.order.dir')) === 'desc' ? 'desc' : 'asc'; + } + ); + } + + /** + * Gets and sets the order by which the sub-pages should be sorted. + * + * default - is the order based on the file system, ie 01.Home before 02.Advark + * title - is the order based on the title set in the pages + * date - is the order based on the date set in the pages + * folder - is the order based on the name of the folder with any numerics omitted + * + * @param string|null $var supported options include "default", "title", "date", and "folder" + * @return string supported options include "default", "title", "date", and "folder" + */ + public function orderBy($var = null): string + { + return $this->loadHeaderProperty( + 'order_by', + $var, + static function ($value) { + return trim($value) ?: Grav::instance()['config']->get('system.pages.order.by'); + } + ); + } + + /** + * Gets the manual order set in the header. + * + * @param string|null $var supported options include "default", "title", "date", and "folder" + * @return array + */ + public function orderManual($var = null): array + { + return $this->loadHeaderProperty( + 'order_manual', + $var, + static function ($value) { + return (array)$value; + } + ); + } + + /** + * Gets and sets the maxCount field which describes how many sub-pages should be displayed if the + * sub_pages header property is set for this page object. + * + * @param int|null $var the maximum number of sub-pages + * @return int the maximum number of sub-pages + */ + public function maxCount($var = null): int + { + return $this->loadHeaderProperty( + 'max_count', + $var, + static function ($value) { + return (int)($value ?? Grav::instance()['config']->get('system.pages.list.count')); + } + ); + } + + /** + * Gets and sets the modular var that helps identify this page is a modular child + * + * @param bool|null $var true if modular_twig + * @return bool true if modular_twig + * @deprecated 1.7 Use ->isModule() or ->modularTwig() method instead. + */ + public function modular($var = null): bool + { + user_error(__METHOD__ . '() is deprecated since Grav 1.7, use ->isModule() or ->modularTwig() method instead', E_USER_DEPRECATED); + + return $this->modularTwig($var); + } + + /** + * Gets and sets the modular_twig var that helps identify this page as a modular child page that will need + * twig processing handled differently from a regular page. + * + * @param bool|null $var true if modular_twig + * @return bool true if modular_twig + */ + public function modularTwig($var = null): bool + { + if ($var !== null) { + $this->setProperty('modular_twig', (bool)$var); + if ($var) { + $this->visible(false); + } + } + + return (bool)($this->getProperty('modular_twig') ?? strpos($this->slug(), '_') === 0); + } + + /** + * Returns children of this page. + * + * @return PageCollectionInterface|FlexIndexInterface + */ + public function children() + { + $meta = $this->getMetaData(); + $keys = array_keys($meta['children'] ?? []); + $prefix = $this->getMasterKey(); + if ($prefix) { + foreach ($keys as &$key) { + $key = $prefix . '/' . $key; + } + unset($key); + } + + return $this->getFlexDirectory()->getIndex($keys, 'storage_key'); + } + + /** + * Check to see if this item is the first in an array of sub-pages. + * + * @return bool True if item is first. + */ + public function isFirst(): bool + { + $parent = $this->parent(); + $children = $parent ? $parent->children() : null; + if ($children instanceof FlexCollectionInterface) { + $children = $children->withKeyField(); + } + + return $children instanceof PageCollectionInterface ? $children->isFirst($this->getKey()) : true; + } + + /** + * Check to see if this item is the last in an array of sub-pages. + * + * @return bool True if item is last + */ + public function isLast(): bool + { + $parent = $this->parent(); + $children = $parent ? $parent->children() : null; + if ($children instanceof FlexCollectionInterface) { + $children = $children->withKeyField(); + } + + return $children instanceof PageCollectionInterface ? $children->isLast($this->getKey()) : true; + } + + /** + * Gets the previous sibling based on current position. + * + * @return PageInterface|false the previous Page item + */ + public function prevSibling() + { + return $this->adjacentSibling(-1); + } + + /** + * Gets the next sibling based on current position. + * + * @return PageInterface|false the next Page item + */ + public function nextSibling() + { + return $this->adjacentSibling(1); + } + + /** + * Returns the adjacent sibling based on a direction. + * + * @param int $direction either -1 or +1 + * @return PageInterface|false the sibling page + */ + public function adjacentSibling($direction = 1) + { + $parent = $this->parent(); + $children = $parent ? $parent->children() : null; + if ($children instanceof FlexCollectionInterface) { + $children = $children->withKeyField(); + } + + if ($children instanceof PageCollectionInterface) { + $child = $children->adjacentSibling($this->getKey(), $direction); + if ($child instanceof PageInterface) { + return $child; + } + } + + return false; + } + + /** + * Helper method to return an ancestor page. + * + * @param string|null $lookup Name of the parent folder + * @return PageInterface|null page you were looking for if it exists + */ + public function ancestor($lookup = null) + { + /** @var Pages $pages */ + $pages = Grav::instance()['pages']; + + return $pages->ancestor($this->getProperty('parent_route'), $lookup); + } + + /** + * Helper method to return an ancestor page to inherit from. The current + * page object is returned. + * + * @param string $field Name of the parent folder + * @return PageInterface|null + */ + public function inherited($field) + { + [$inherited, $currentParams] = $this->getInheritedParams($field); + + $this->modifyHeader($field, $currentParams); + + return $inherited; + } + + /** + * Helper method to return an ancestor field only to inherit from. The + * first occurrence of an ancestor field will be returned if at all. + * + * @param string $field Name of the parent folder + * @return array + */ + public function inheritedField($field): array + { + [, $currentParams] = $this->getInheritedParams($field); + + return $currentParams; + } + + /** + * Method that contains shared logic for inherited() and inheritedField() + * + * @param string $field Name of the parent folder + * @return array + */ + protected function getInheritedParams($field): array + { + /** @var Pages $pages */ + $pages = Grav::instance()['pages']; + + $inherited = $pages->inherited($this->getProperty('parent_route'), $field); + $inheritedParams = $inherited ? (array)$inherited->value('header.' . $field) : []; + $currentParams = (array)$this->getFormValue('header.' . $field); + if ($inheritedParams && is_array($inheritedParams)) { + $currentParams = array_replace_recursive($inheritedParams, $currentParams); + } + + return [$inherited, $currentParams]; + } + + /** + * Helper method to return a page. + * + * @param string $url the url of the page + * @param bool $all + * @return PageInterface|null page you were looking for if it exists + */ + public function find($url, $all = false) + { + /** @var Pages $pages */ + $pages = Grav::instance()['pages']; + + return $pages->find($url, $all); + } + + /** + * Get a collection of pages in the current context. + * + * @param string|array $params + * @param bool $pagination + * @return PageCollectionInterface|Collection + * @throws InvalidArgumentException + */ + public function collection($params = 'content', $pagination = true) + { + if (is_string($params)) { + // Look into a page header field. + $params = (array)$this->getFormValue('header.' . $params); + } elseif (!is_array($params)) { + throw new InvalidArgumentException('Argument should be either header variable name or array of parameters'); + } + + if (!$pagination) { + $params['pagination'] = false; + } + $context = [ + 'pagination' => $pagination, + 'self' => $this + ]; + + /** @var Pages $pages */ + $pages = Grav::instance()['pages']; + + return $pages->getCollection($params, $context); + } + + /** + * @param string|array $value + * @param bool $only_published + * @return PageCollectionInterface|Collection + */ + public function evaluate($value, $only_published = true) + { + $params = [ + 'items' => $value, + 'published' => $only_published + ]; + $context = [ + 'event' => false, + 'pagination' => false, + 'url_taxonomy_filters' => false, + 'self' => $this + ]; + + /** @var Pages $pages */ + $pages = Grav::instance()['pages']; + + return $pages->getCollection($params, $context); + } + + /** + * Returns whether or not the current folder exists + * + * @return bool + */ + public function folderExists(): bool + { + return $this->exists() || is_dir($this->getStorageFolder() ?? ''); + } + + /** + * Gets the action. + * + * @return string|null The Action string. + */ + public function getAction(): ?string + { + $meta = $this->getMetaData(); + if (!empty($meta['copy'])) { + return 'copy'; + } + if (isset($meta['storage_key']) && $this->getStorageKey() !== $meta['storage_key']) { + return 'move'; + } + + return null; + } +} diff --git a/system/src/Grav/Framework/Flex/Pages/Traits/PageRoutableTrait.php b/system/src/Grav/Framework/Flex/Pages/Traits/PageRoutableTrait.php new file mode 100644 index 0000000..918ad67 --- /dev/null +++ b/system/src/Grav/Framework/Flex/Pages/Traits/PageRoutableTrait.php @@ -0,0 +1,550 @@ +loadHeaderProperty( + 'url_extension', + null, + function ($value) { + if ($this->home()) { + return ''; + } + + return $value ?? Grav::instance()['config']->get('system.pages.append_url_extension', ''); + } + ); + } + + /** + * Gets and Sets whether or not this Page is routable, ie you can reach it via a URL. + * The page must be *routable* and *published* + * + * @param bool|null $var true if the page is routable + * @return bool true if the page is routable + */ + public function routable($var = null): bool + { + $value = $this->loadHeaderProperty( + 'routable', + $var, + static function ($value) { + return $value ?? true; + } + ); + + return $value && $this->published() && !$this->isModule() && !$this->root() && $this->getLanguages(true); + } + + /** + * Gets the URL for a page - alias of url(). + * + * @param bool $include_host + * @return string the permalink + */ + public function link($include_host = false): string + { + return $this->url($include_host); + } + + /** + * Gets the URL with host information, aka Permalink. + * @return string The permalink. + */ + public function permalink(): string + { + return $this->url(true, false, true, true); + } + + /** + * Returns the canonical URL for a page + * + * @param bool $include_lang + * @return string + */ + public function canonical($include_lang = true): string + { + return $this->url(true, true, $include_lang); + } + + /** + * Gets the url for the Page. + * + * @param bool $include_host Defaults false, but true would include http://yourhost.com + * @param bool $canonical true to return the canonical URL + * @param bool $include_base + * @param bool $raw_route + * @return string The url. + */ + public function url($include_host = false, $canonical = false, $include_base = true, $raw_route = false): string + { + // Override any URL when external_url is set + $external = $this->getNestedProperty('header.external_url'); + if ($external) { + return $external; + } + + $grav = Grav::instance(); + + /** @var Pages $pages */ + $pages = $grav['pages']; + + /** @var Config $config */ + $config = $grav['config']; + + // get base route (multi-site base and language) + $route = $include_base ? $pages->baseRoute() : ''; + + // add full route if configured to do so + if (!$include_host && $config->get('system.absolute_urls', false)) { + $include_host = true; + } + + if ($canonical) { + $route .= $this->routeCanonical(); + } elseif ($raw_route) { + $route .= $this->rawRoute(); + } else { + $route .= $this->route(); + } + + /** @var Uri $uri */ + $uri = $grav['uri']; + $url = $uri->rootUrl($include_host) . '/' . trim($route, '/') . $this->urlExtension(); + + return Uri::filterPath($url); + } + + /** + * Gets the route for the page based on the route headers if available, else from + * the parents route and the current Page's slug. + * + * @param string $var Set new default route. + * @return string|null The route for the Page. + */ + public function route($var = null): ?string + { + if (null !== $var) { + // TODO: not the best approach, but works... + $this->setNestedProperty('header.routes.default', $var); + } + + // Return default route if given. + $default = $this->getNestedProperty('header.routes.default'); + if (is_string($default)) { + return $default; + } + + return $this->routeInternal(); + } + + /** + * @return string|null + */ + protected function routeInternal(): ?string + { + $route = $this->_route; + if (null !== $route) { + return $route; + } + + if ($this->root()) { + return null; + } + + // Root and orphan nodes have no route. + $parent = $this->parent(); + if (!$parent) { + return null; + } + + if ($parent->home()) { + /** @var Config $config */ + $config = Grav::instance()['config']; + $hide = (bool)$config->get('system.home.hide_in_urls', false); + $route = '/' . ($hide ? '' : $parent->slug()); + } else { + $route = $parent->route(); + } + + if ($route !== '' && $route !== '/') { + $route .= '/'; + } + + if (!$this->home()) { + $route .= $this->slug(); + } + + $this->_route = $route; + + return $route; + } + + /** + * Helper method to clear the route out so it regenerates next time you use it + */ + public function unsetRouteSlug(): void + { + // TODO: + throw new RuntimeException(__METHOD__ . '(): Not Implemented'); + } + + /** + * Gets and Sets the page raw route + * + * @param string|null $var + * @return string|null + */ + public function rawRoute($var = null): ?string + { + if (null !== $var) { + // TODO: + throw new RuntimeException(__METHOD__ . '(string): Not Implemented'); + } + + if ($this->root()) { + return null; + } + + return '/' . $this->getKey(); + } + + /** + * Gets the route aliases for the page based on page headers. + * + * @param array|null $var list of route aliases + * @return array The route aliases for the Page. + */ + public function routeAliases($var = null): array + { + if (null !== $var) { + $this->setNestedProperty('header.routes.aliases', (array)$var); + } + + $aliases = (array)$this->getNestedProperty('header.routes.aliases'); + $default = $this->getNestedProperty('header.routes.default'); + if ($default) { + $aliases[] = $default; + } + + return $aliases; + } + + /** + * Gets the canonical route for this page if its set. If provided it will use + * that value, else if it's `true` it will use the default route. + * + * @param string|null $var + * @return string|null + */ + public function routeCanonical($var = null): ?string + { + if (null !== $var) { + $this->setNestedProperty('header.routes.canonical', (array)$var); + } + + $canonical = $this->getNestedProperty('header.routes.canonical'); + + return is_string($canonical) ? $canonical : $this->route(); + } + + /** + * Gets the redirect set in the header. + * + * @param string|null $var redirect url + * @return string|null + */ + public function redirect($var = null): ?string + { + return $this->loadHeaderProperty( + 'redirect', + $var, + static function ($value) { + return trim($value) ?: null; + } + ); + } + + /** + * Returns the clean path to the page file + * + * Needed in admin for Page Media. + */ + public function relativePagePath(): ?string + { + $folder = $this->getMediaFolder(); + if (!$folder) { + return null; + } + + /** @var UniformResourceLocator $locator */ + $locator = Grav::instance()['locator']; + $path = $locator->isStream($folder) ? $locator->findResource($folder, false) : $folder; + + return is_string($path) ? $path : null; + } + + /** + * Gets and sets the path to the folder where the .md for this Page object resides. + * This is equivalent to the filePath but without the filename. + * + * @param string|null $var the path + * @return string|null the path + */ + public function path($var = null): ?string + { + if (null !== $var) { + // TODO: + throw new RuntimeException(__METHOD__ . '(string): Not Implemented'); + } + + $path = $this->_path; + if ($path) { + return $path; + } + + if ($this->root()) { + $folder = $this->getFlexDirectory()->getStorageFolder(); + } else { + $folder = $this->getStorageFolder(); + } + + if ($folder) { + /** @var UniformResourceLocator $locator */ + $locator = Grav::instance()['locator']; + $folder = $locator->isStream($folder) ? $locator->getResource($folder) : GRAV_ROOT . "/{$folder}"; + } + + return $this->_path = is_string($folder) ? $folder : null; + } + + /** + * Get/set the folder. + * + * @param string|null $var Optional path, including numeric prefix. + * @return string|null + */ + public function folder($var = null): ?string + { + return $this->loadProperty( + 'folder', + $var, + function ($value) { + if (null === $value) { + $value = $this->getMasterKey() ?: $this->getKey(); + } + + return Utils::basename($value) ?: null; + } + ); + } + + /** + * Get/set the folder. + * + * @param string|null $var Optional path, including numeric prefix. + * @return string|null + */ + public function parentStorageKey($var = null): ?string + { + return $this->loadProperty( + 'parent_key', + $var, + function ($value) { + if (null === $value) { + $filesystem = Filesystem::getInstance(false); + $value = $this->getMasterKey() ?: $this->getKey(); + $value = ltrim($filesystem->dirname("/{$value}"), '/') ?: ''; + } + + return $value; + } + ); + } + + /** + * Gets and Sets the parent object for this page + * + * @param PageInterface|null $var the parent page object + * @return PageInterface|null the parent page object if it exists. + */ + public function parent(PageInterface $var = null) + { + if (null !== $var) { + // TODO: + throw new RuntimeException(__METHOD__ . '(PageInterface): Not Implemented'); + } + + if ($this->_parentCache || $this->root()) { + return $this->_parentCache; + } + + // Use filesystem as \dirname() does not work in Windows because of '/foo' becomes '\'. + $filesystem = Filesystem::getInstance(false); + $directory = $this->getFlexDirectory(); + $parentKey = ltrim($filesystem->dirname("/{$this->getKey()}"), '/'); + if ('' !== $parentKey) { + $parent = $directory->getObject($parentKey); + $language = $this->getLanguage(); + if ($language && $parent && method_exists($parent, 'getTranslation')) { + $parent = $parent->getTranslation($language) ?? $parent; + } + + $this->_parentCache = $parent; + } else { + $index = $directory->getIndex(); + + $this->_parentCache = \is_callable([$index, 'getRoot']) ? $index->getRoot() : null; + } + + return $this->_parentCache; + } + + /** + * Gets the top parent object for this page. Can return page itself. + * + * @return PageInterface The top parent page object. + */ + public function topParent() + { + $topParent = $this; + while ($topParent) { + $parent = $topParent->parent(); + if (!$parent || !$parent->parent()) { + break; + } + $topParent = $parent; + } + + return $topParent; + } + + /** + * Returns the item in the current position. + * + * @return int|null the index of the current page. + */ + public function currentPosition(): ?int + { + $parent = $this->parent(); + $collection = $parent ? $parent->collection('content', false) : null; + if ($collection instanceof PageCollectionInterface && $path = $this->path()) { + return $collection->currentPosition($path); + } + + return 1; + } + + /** + * Returns whether or not this page is the currently active page requested via the URL. + * + * @return bool True if it is active + */ + public function active(): bool + { + $grav = Grav::instance(); + $uri_path = rtrim(urldecode($grav['uri']->path()), '/') ?: '/'; + $routes = $grav['pages']->routes(); + + return isset($routes[$uri_path]) && $routes[$uri_path] === $this->path(); + } + + /** + * Returns whether or not this URI's URL contains the URL of the active page. + * Or in other words, is this page's URL in the current URL + * + * @return bool True if active child exists + */ + public function activeChild(): bool + { + $grav = Grav::instance(); + /** @var Uri $uri */ + $uri = $grav['uri']; + /** @var Pages $pages */ + $pages = $grav['pages']; + $uri_path = rtrim(urldecode($uri->path()), '/'); + $routes = $pages->routes(); + + if (isset($routes[$uri_path])) { + $page = $pages->find($uri->route()); + /** @var PageInterface|null $child_page */ + $child_page = $page ? $page->parent() : null; + while ($child_page && !$child_page->root()) { + if ($this->path() === $child_page->path()) { + return true; + } + $child_page = $child_page->parent(); + } + } + + return false; + } + + /** + * Returns whether or not this page is the currently configured home page. + * + * @return bool True if it is the homepage + */ + public function home(): bool + { + $home = Grav::instance()['config']->get('system.home.alias'); + + return '/' . $this->getKey() === $home; + } + + /** + * Returns whether or not this page is the root node of the pages tree. + * + * @param bool|null $var + * @return bool True if it is the root + */ + public function root($var = null): bool + { + if (null !== $var) { + $this->root = (bool)$var; + } + + return $this->root === true || $this->getKey() === '/'; + } +} diff --git a/system/src/Grav/Framework/Flex/Pages/Traits/PageTranslateTrait.php b/system/src/Grav/Framework/Flex/Pages/Traits/PageTranslateTrait.php new file mode 100644 index 0000000..2bdfa87 --- /dev/null +++ b/system/src/Grav/Framework/Flex/Pages/Traits/PageTranslateTrait.php @@ -0,0 +1,291 @@ +translatedLanguages(true); + } + + /** + * @param string|null $languageCode + * @param bool|null $fallback + * @return bool + */ + public function hasTranslation(string $languageCode = null, bool $fallback = null): bool + { + $code = $this->findTranslation($languageCode, $fallback); + + return null !== $code; + } + + /** + * @param string|null $languageCode + * @param bool|null $fallback + * @return FlexObjectInterface|PageInterface|null + */ + public function getTranslation(string $languageCode = null, bool $fallback = null) + { + if ($this->root()) { + return $this; + } + + $code = $this->findTranslation($languageCode, $fallback); + if (null === $code) { + $object = null; + } elseif ('' === $code) { + $object = $this->getLanguage() ? $this->getFlexDirectory()->getObject($this->getMasterKey(), 'storage_key') : $this; + } else { + $meta = $this->getMetaData(); + $meta['template'] = $this->getLanguageTemplates()[$code] ?? $meta['template']; + $key = $this->getStorageKey() . '|' . $meta['template'] . '.' . $code; + $meta['storage_key'] = $key; + $meta['lang'] = $code; + $object = $this->getFlexDirectory()->loadObjects([$key => $meta])[$key] ?? null; + } + + return $object; + } + + /** + * @param bool $includeDefault If set to true, return separate entries for '' and 'en' (default) language. + * @return array + */ + public function getAllLanguages(bool $includeDefault = false): array + { + $grav = Grav::instance(); + + /** @var Language $language */ + $language = $grav['language']; + $languages = $language->getLanguages(); + if (!$languages) { + return []; + } + + $translated = $this->getLanguageTemplates(); + + if ($includeDefault) { + $languages[] = ''; + } elseif (isset($translated[''])) { + $default = $language->getDefault(); + if (is_bool($default)) { + $default = ''; + } + $translated[$default] = $translated['']; + unset($translated['']); + } + + $languages = array_fill_keys($languages, false); + $translated = array_fill_keys(array_keys($translated), true); + + return array_replace($languages, $translated); + } + + /** + * Returns all translated languages. + * + * @param bool $includeDefault If set to true, return separate entries for '' and 'en' (default) language. + * @return array + */ + public function getLanguages(bool $includeDefault = false): array + { + $languages = $this->getLanguageTemplates(); + + if (!$includeDefault && isset($languages[''])) { + $grav = Grav::instance(); + + /** @var Language $language */ + $language = $grav['language']; + $default = $language->getDefault(); + if (is_bool($default)) { + $default = ''; + } + $languages[$default] = $languages['']; + unset($languages['']); + } + + return array_keys($languages); + } + + /** + * @return string + */ + public function getLanguage(): string + { + return $this->language() ?? ''; + } + + /** + * @param string|null $languageCode + * @param bool|null $fallback + * @return string|null + */ + public function findTranslation(string $languageCode = null, bool $fallback = null): ?string + { + $translated = $this->getLanguageTemplates(); + + // If there's no translations (including default), we have an empty folder. + if (!$translated) { + return ''; + } + + // FIXME: only published is not implemented... + $languages = $this->getFallbackLanguages($languageCode, $fallback); + + $language = null; + foreach ($languages as $code) { + if (isset($translated[$code])) { + $language = $code; + break; + } + } + + return $language; + } + + /** + * Return an array with the routes of other translated languages + * + * @param bool $onlyPublished only return published translations + * @return array the page translated languages + */ + public function translatedLanguages($onlyPublished = false): array + { + // FIXME: only published is not implemented... + $translated = $this->getLanguageTemplates(); + if (!$translated) { + return $translated; + } + + $grav = Grav::instance(); + + /** @var Language $language */ + $language = $grav['language']; + $languages = $language->getLanguages(); + $languages[] = ''; + + $translated = array_intersect_key($translated, array_flip($languages)); + $list = array_fill_keys($languages, null); + foreach ($translated as $languageCode => $languageFile) { + $path = ($languageCode ? '/' : '') . $languageCode; + $list[$languageCode] = "{$path}/{$this->getKey()}"; + } + + return array_filter($list); + } + + /** + * Return an array listing untranslated languages available + * + * @param bool $includeUnpublished also list unpublished translations + * @return array the page untranslated languages + */ + public function untranslatedLanguages($includeUnpublished = false): array + { + $grav = Grav::instance(); + + /** @var Language $language */ + $language = $grav['language']; + + $languages = $language->getLanguages(); + $translated = array_keys($this->translatedLanguages(!$includeUnpublished)); + + return array_values(array_diff($languages, $translated)); + } + + /** + * Get page language + * + * @param string|null $var + * @return string|null + */ + public function language($var = null): ?string + { + return $this->loadHeaderProperty( + 'lang', + $var, + function ($value) { + $value = $value ?? $this->getMetaData()['lang'] ?? ''; + + return trim($value) ?: null; + } + ); + } + + /** + * @return array + */ + protected function getLanguageTemplates(): array + { + if (null === $this->_languages) { + $template = $this->getProperty('template'); + $meta = $this->getMetaData(); + $translations = $meta['markdown'] ?? []; + $list = []; + foreach ($translations as $code => $search) { + if (isset($search[$template])) { + // Use main template if possible. + $list[$code] = $template; + } elseif (!empty($search)) { + // Fall back to first matching template. + $list[$code] = key($search); + } + } + + $this->_languages = $list; + } + + return $this->_languages; + } + + /** + * @param string|null $languageCode + * @param bool|null $fallback + * @return array + */ + protected function getFallbackLanguages(string $languageCode = null, bool $fallback = null): array + { + $fallback = $fallback ?? true; + if (!$fallback && null !== $languageCode) { + return [$languageCode]; + } + + $grav = Grav::instance(); + + /** @var Language $language */ + $language = $grav['language']; + $languageCode = $languageCode ?? ($language->getLanguage() ?: ''); + if ($languageCode === '' && $fallback) { + return $language->getFallbackLanguages(null, true); + } + + return $fallback ? $language->getFallbackLanguages($languageCode, true) : [$languageCode]; + } +} diff --git a/system/src/Grav/Framework/Flex/Storage/AbstractFilesystemStorage.php b/system/src/Grav/Framework/Flex/Storage/AbstractFilesystemStorage.php new file mode 100644 index 0000000..d919f3a --- /dev/null +++ b/system/src/Grav/Framework/Flex/Storage/AbstractFilesystemStorage.php @@ -0,0 +1,232 @@ +hasKey((string)$key); + } + + return $list; + } + + /** + * {@inheritDoc} + * @see FlexStorageInterface::getKeyField() + */ + public function getKeyField(): string + { + return $this->keyField; + } + + /** + * @param array $keys + * @param bool $includeParams + * @return string + */ + public function buildStorageKey(array $keys, bool $includeParams = true): string + { + $key = $keys['key'] ?? ''; + $params = $includeParams ? $this->buildStorageKeyParams($keys) : ''; + + return $params ? "{$key}|{$params}" : $key; + } + + /** + * @param array $keys + * @return string + */ + public function buildStorageKeyParams(array $keys): string + { + return ''; + } + + /** + * @param array $row + * @return array + */ + public function extractKeysFromRow(array $row): array + { + return [ + 'key' => $this->normalizeKey($row[$this->keyField] ?? '') + ]; + } + + /** + * @param string $key + * @return array + */ + public function extractKeysFromStorageKey(string $key): array + { + return [ + 'key' => $key + ]; + } + + /** + * @param string|array $formatter + * @return void + */ + protected function initDataFormatter($formatter): void + { + // Initialize formatter. + if (!is_array($formatter)) { + $formatter = ['class' => $formatter]; + } + $formatterClassName = $formatter['class'] ?? JsonFormatter::class; + $formatterOptions = $formatter['options'] ?? []; + + if (!is_a($formatterClassName, FileFormatterInterface::class, true)) { + throw new \InvalidArgumentException('Bad Data Formatter'); + } + + $this->dataFormatter = new $formatterClassName($formatterOptions); + } + + /** + * @param string $filename + * @return string|null + */ + protected function detectDataFormatter(string $filename): ?string + { + if (preg_match('|(\.[a-z0-9]*)$|ui', $filename, $matches)) { + switch ($matches[1]) { + case '.json': + return JsonFormatter::class; + case '.yaml': + return YamlFormatter::class; + case '.md': + return MarkdownFormatter::class; + } + } + + return null; + } + + /** + * @param string $filename + * @return CompiledJsonFile|CompiledYamlFile|CompiledMarkdownFile + */ + protected function getFile(string $filename) + { + $filename = $this->resolvePath($filename); + + // TODO: start using the new file classes. + switch ($this->dataFormatter->getDefaultFileExtension()) { + case '.json': + $file = CompiledJsonFile::instance($filename); + break; + case '.yaml': + $file = CompiledYamlFile::instance($filename); + break; + case '.md': + $file = CompiledMarkdownFile::instance($filename); + break; + default: + throw new RuntimeException('Unknown extension type ' . $this->dataFormatter->getDefaultFileExtension()); + } + + return $file; + } + + /** + * @param string $path + * @return string + */ + protected function resolvePath(string $path): string + { + /** @var UniformResourceLocator $locator */ + $locator = Grav::instance()['locator']; + + if (!$locator->isStream($path)) { + return GRAV_ROOT . "/{$path}"; + } + + return $locator->getResource($path); + } + + /** + * Generates a random, unique key for the row. + * + * @return string + */ + protected function generateKey(): string + { + return substr(hash('sha256', random_bytes($this->keyLen)), 0, $this->keyLen); + } + + /** + * @param string $key + * @return string + */ + public function normalizeKey(string $key): string + { + if ($this->caseSensitive === true) { + return $key; + } + + return mb_strtolower($key); + } + + /** + * Checks if a key is valid. + * + * @param string $key + * @return bool + */ + protected function validateKey(string $key): bool + { + return $key && (bool) preg_match('/^[^\\/?*:;{}\\\\\\n]+$/u', $key); + } +} diff --git a/system/src/Grav/Framework/Flex/Storage/FileStorage.php b/system/src/Grav/Framework/Flex/Storage/FileStorage.php new file mode 100644 index 0000000..2770128 --- /dev/null +++ b/system/src/Grav/Framework/Flex/Storage/FileStorage.php @@ -0,0 +1,160 @@ +dataPattern = '{FOLDER}/{KEY}{EXT}'; + + if (!isset($options['formatter']) && isset($options['pattern'])) { + $options['formatter'] = $this->detectDataFormatter($options['pattern']); + } + + parent::__construct($options); + } + + /** + * {@inheritdoc} + * @see FlexStorageInterface::getMediaPath() + */ + public function getMediaPath(string $key = null): ?string + { + $path = $this->getStoragePath(); + if (!$path) { + return null; + } + + return $key ? "{$path}/{$key}" : $path; + } + + /** + * @param string $src + * @param string $dst + * @return bool + */ + public function copyRow(string $src, string $dst): bool + { + if ($this->hasKey($dst)) { + throw new RuntimeException("Cannot copy object: key '{$dst}' is already taken"); + } + + if (!$this->hasKey($src)) { + return false; + } + + return true; + } + + /** + * {@inheritdoc} + * @see FlexStorageInterface::renameRow() + */ + public function renameRow(string $src, string $dst): bool + { + if (!$this->hasKey($src)) { + return false; + } + + // Remove old file. + $path = $this->getPathFromKey($src); + $file = $this->getFile($path); + $file->delete(); + $file->free(); + unset($file); + + return true; + } + + /** + * @param string $src + * @param string $dst + * @return bool + */ + protected function copyFolder(string $src, string $dst): bool + { + // Nothing to copy. + return true; + } + + /** + * @param string $src + * @param string $dst + * @return bool + */ + protected function moveFolder(string $src, string $dst): bool + { + // Nothing to move. + return true; + } + + /** + * @param string $key + * @return bool + */ + protected function canDeleteFolder(string $key): bool + { + return false; + } + + /** + * {@inheritdoc} + */ + protected function getKeyFromPath(string $path): string + { + return Utils::basename($path, $this->dataFormatter->getDefaultFileExtension()); + } + + /** + * {@inheritdoc} + */ + protected function buildIndex(): array + { + $this->clearCache(); + + $path = $this->getStoragePath(); + if (!$path || !file_exists($path)) { + return []; + } + + $flags = FilesystemIterator::KEY_AS_PATHNAME | FilesystemIterator::CURRENT_AS_FILEINFO | FilesystemIterator::SKIP_DOTS | FilesystemIterator::UNIX_PATHS; + $iterator = new FilesystemIterator($path, $flags); + $list = []; + /** @var SplFileInfo $info */ + foreach ($iterator as $filename => $info) { + if (!$info->isFile() || !($key = $this->getKeyFromPath($filename)) || strpos($info->getFilename(), '.') === 0) { + continue; + } + + $list[$key] = $this->getObjectMeta($key); + } + + ksort($list, SORT_NATURAL | SORT_FLAG_CASE); + + return $list; + } +} diff --git a/system/src/Grav/Framework/Flex/Storage/FolderStorage.php b/system/src/Grav/Framework/Flex/Storage/FolderStorage.php new file mode 100644 index 0000000..157449d --- /dev/null +++ b/system/src/Grav/Framework/Flex/Storage/FolderStorage.php @@ -0,0 +1,708 @@ + '%1$s', 'KEY' => '%2$s', 'KEY:2' => '%3$s', 'FILE' => '%4$s', 'EXT' => '%5$s']; + /** @var string Filename for the object. */ + protected $dataFile; + /** @var string File extension for the object. */ + protected $dataExt; + /** @var bool */ + protected $prefixed; + /** @var bool */ + protected $indexed; + /** @var array */ + protected $meta = []; + + /** + * {@inheritdoc} + */ + public function __construct(array $options) + { + if (!isset($options['folder'])) { + throw new InvalidArgumentException("Argument \$options is missing 'folder'"); + } + + $this->initDataFormatter($options['formatter'] ?? []); + $this->initOptions($options); + } + + /** + * @return bool + */ + public function isIndexed(): bool + { + return $this->indexed; + } + + /** + * @return void + */ + public function clearCache(): void + { + $this->meta = []; + } + + /** + * @param string[] $keys + * @param bool $reload + * @return array + */ + public function getMetaData(array $keys, bool $reload = false): array + { + $list = []; + foreach ($keys as $key) { + $list[$key] = $this->getObjectMeta((string)$key, $reload); + } + + return $list; + } + + /** + * {@inheritdoc} + * @see FlexStorageInterface::getExistingKeys() + */ + public function getExistingKeys(): array + { + return $this->buildIndex(); + } + + /** + * {@inheritdoc} + * @see FlexStorageInterface::hasKey() + */ + public function hasKey(string $key): bool + { + $meta = $this->getObjectMeta($key); + + return array_key_exists('exists', $meta) ? $meta['exists'] : !empty($meta['storage_timestamp']); + } + + /** + * {@inheritdoc} + * @see FlexStorageInterface::createRows() + */ + public function createRows(array $rows): array + { + $list = []; + foreach ($rows as $key => $row) { + $list[$key] = $this->saveRow('@@', $row); + } + + return $list; + } + + /** + * {@inheritdoc} + * @see FlexStorageInterface::readRows() + */ + public function readRows(array $rows, array &$fetched = null): array + { + $list = []; + foreach ($rows as $key => $row) { + if (null === $row || is_scalar($row)) { + // Only load rows which haven't been loaded before. + $key = (string)$key; + $list[$key] = $this->loadRow($key); + + if (null !== $fetched) { + $fetched[$key] = $list[$key]; + } + } else { + // Keep the row if it has been loaded. + $list[$key] = $row; + } + } + + return $list; + } + + /** + * {@inheritdoc} + * @see FlexStorageInterface::updateRows() + */ + public function updateRows(array $rows): array + { + $list = []; + foreach ($rows as $key => $row) { + $key = (string)$key; + $list[$key] = $this->hasKey($key) ? $this->saveRow($key, $row) : null; + } + + return $list; + } + + /** + * {@inheritdoc} + * @see FlexStorageInterface::deleteRows() + */ + public function deleteRows(array $rows): array + { + $list = []; + $baseMediaPath = $this->getMediaPath(); + foreach ($rows as $key => $row) { + $key = (string)$key; + if (!$this->hasKey($key)) { + $list[$key] = null; + } else { + $path = $this->getPathFromKey($key); + $file = $this->getFile($path); + $list[$key] = $this->deleteFile($file); + + if ($this->canDeleteFolder($key)) { + $storagePath = $this->getStoragePath($key); + $mediaPath = $this->getMediaPath($key); + + if ($storagePath) { + $this->deleteFolder($storagePath, true); + } + if ($mediaPath && $mediaPath !== $storagePath && $mediaPath !== $baseMediaPath) { + $this->deleteFolder($mediaPath, true); + } + } + } + } + + return $list; + } + + /** + * {@inheritdoc} + * @see FlexStorageInterface::replaceRows() + */ + public function replaceRows(array $rows): array + { + $list = []; + foreach ($rows as $key => $row) { + $key = (string)$key; + $list[$key] = $this->saveRow($key, $row); + } + + return $list; + } + + /** + * @param string $src + * @param string $dst + * @return bool + * @throws RuntimeException + */ + public function copyRow(string $src, string $dst): bool + { + if ($this->hasKey($dst)) { + throw new RuntimeException("Cannot copy object: key '{$dst}' is already taken"); + } + + if (!$this->hasKey($src)) { + return false; + } + + $srcPath = $this->getStoragePath($src); + $dstPath = $this->getStoragePath($dst); + if (!$srcPath || !$dstPath) { + return false; + } + + return $this->copyFolder($srcPath, $dstPath); + } + + /** + * {@inheritdoc} + * @see FlexStorageInterface::renameRow() + * @throws RuntimeException + */ + public function renameRow(string $src, string $dst): bool + { + if (!$this->hasKey($src)) { + return false; + } + + $srcPath = $this->getStoragePath($src); + $dstPath = $this->getStoragePath($dst); + if (!$srcPath || !$dstPath) { + throw new RuntimeException("Destination path '{$dst}' is empty"); + } + + if ($srcPath === $dstPath) { + return true; + } + + if ($this->hasKey($dst)) { + throw new RuntimeException("Cannot rename object '{$src}': key '{$dst}' is already taken $srcPath $dstPath"); + } + + return $this->moveFolder($srcPath, $dstPath); + } + + /** + * {@inheritdoc} + * @see FlexStorageInterface::getStoragePath() + */ + public function getStoragePath(string $key = null): ?string + { + if (null === $key || $key === '') { + $path = $this->dataFolder; + } else { + $parts = $this->parseKey($key, false); + $options = [ + $this->dataFolder, // {FOLDER} + $parts['key'], // {KEY} + $parts['key:2'], // {KEY:2} + '***', // {FILE} + '***' // {EXT} + ]; + + $path = rtrim(explode('***', sprintf($this->dataPattern, ...$options))[0], '/'); + } + + return $path; + } + + /** + * {@inheritdoc} + * @see FlexStorageInterface::getMediaPath() + */ + public function getMediaPath(string $key = null): ?string + { + return $this->getStoragePath($key); + } + + /** + * Get filesystem path from the key. + * + * @param string $key + * @return string + */ + public function getPathFromKey(string $key): string + { + $parts = $this->parseKey($key); + $options = [ + $this->dataFolder, // {FOLDER} + $parts['key'], // {KEY} + $parts['key:2'], // {KEY:2} + $parts['file'], // {FILE} + $this->dataExt // {EXT} + ]; + + return sprintf($this->dataPattern, ...$options); + } + + /** + * @param string $key + * @param bool $variations + * @return array + */ + public function parseKey(string $key, bool $variations = true): array + { + $keys = [ + 'key' => $key, + 'key:2' => mb_substr($key, 0, 2), + ]; + if ($variations) { + $keys['file'] = $this->dataFile; + } + + return $keys; + } + + /** + * Get key from the filesystem path. + * + * @param string $path + * @return string + */ + protected function getKeyFromPath(string $path): string + { + return Utils::basename($path); + } + + /** + * Prepares the row for saving and returns the storage key for the record. + * + * @param array $row + * @return void + */ + protected function prepareRow(array &$row): void + { + if (array_key_exists($this->keyField, $row)) { + $key = $row[$this->keyField]; + if ($key === $this->normalizeKey($key)) { + unset($row[$this->keyField]); + } + } + } + + /** + * @param string $key + * @return array + */ + protected function loadRow(string $key): ?array + { + $path = $this->getPathFromKey($key); + $file = $this->getFile($path); + try { + $data = (array)$file->content(); + if (isset($data[0])) { + throw new RuntimeException('Broken object file'); + } + + // Add key field to the object. + $keyField = $this->keyField; + if ($keyField !== 'storage_key' && !isset($data[$keyField])) { + $data[$keyField] = $key; + } + } catch (RuntimeException $e) { + $data = ['__ERROR' => $e->getMessage()]; + } finally { + $file->free(); + unset($file); + } + + $data['__META'] = $this->getObjectMeta($key); + + return $data; + } + + /** + * @param string $key + * @param array $row + * @return array + */ + protected function saveRow(string $key, array $row): array + { + try { + if (isset($row[$this->keyField])) { + $key = $row[$this->keyField]; + } + if (strpos($key, '@@') !== false) { + $key = $this->getNewKey(); + } + + $key = $this->normalizeKey($key); + + // Check if the row already exists and if the key has been changed. + $oldKey = $row['__META']['storage_key'] ?? null; + if (is_string($oldKey) && $oldKey !== $key) { + $isCopy = $row['__META']['copy'] ?? false; + if ($isCopy) { + $this->copyRow($oldKey, $key); + } else { + $this->renameRow($oldKey, $key); + } + } + + $this->prepareRow($row); + unset($row['__META'], $row['__ERROR']); + + $path = $this->getPathFromKey($key); + $file = $this->getFile($path); + + $file->save($row); + + } catch (RuntimeException $e) { + throw new RuntimeException(sprintf('Flex saveFile(%s): %s', $path ?? $key, $e->getMessage())); + } finally { + /** @var UniformResourceLocator $locator */ + $locator = Grav::instance()['locator']; + $locator->clearCache(); + + if (isset($file)) { + $file->free(); + unset($file); + } + } + + $row['__META'] = $this->getObjectMeta($key, true); + + return $row; + } + + /** + * @param File $file + * @return array|string + */ + protected function deleteFile(File $file) + { + $filename = $file->filename(); + try { + $data = $file->content(); + if ($file->exists()) { + $file->delete(); + } + } catch (RuntimeException $e) { + throw new RuntimeException(sprintf('Flex deleteFile(%s): %s', $filename, $e->getMessage())); + } finally { + /** @var UniformResourceLocator $locator */ + $locator = Grav::instance()['locator']; + $locator->clearCache(); + + $file->free(); + } + + return $data; + } + + /** + * @param string $src + * @param string $dst + * @return bool + */ + protected function copyFolder(string $src, string $dst): bool + { + try { + Folder::copy($this->resolvePath($src), $this->resolvePath($dst)); + } catch (RuntimeException $e) { + throw new RuntimeException(sprintf('Flex copyFolder(%s, %s): %s', $src, $dst, $e->getMessage())); + } finally { + /** @var UniformResourceLocator $locator */ + $locator = Grav::instance()['locator']; + $locator->clearCache(); + } + + return true; + } + + /** + * @param string $src + * @param string $dst + * @return bool + */ + protected function moveFolder(string $src, string $dst): bool + { + try { + Folder::move($this->resolvePath($src), $this->resolvePath($dst)); + } catch (RuntimeException $e) { + throw new RuntimeException(sprintf('Flex moveFolder(%s, %s): %s', $src, $dst, $e->getMessage())); + } finally { + /** @var UniformResourceLocator $locator */ + $locator = Grav::instance()['locator']; + $locator->clearCache(); + } + + return true; + } + + /** + * @param string $path + * @param bool $include_target + * @return bool + */ + protected function deleteFolder(string $path, bool $include_target = false): bool + { + try { + return Folder::delete($this->resolvePath($path), $include_target); + } catch (RuntimeException $e) { + throw new RuntimeException(sprintf('Flex deleteFolder(%s): %s', $path, $e->getMessage())); + } finally { + /** @var UniformResourceLocator $locator */ + $locator = Grav::instance()['locator']; + $locator->clearCache(); + } + } + + /** + * @param string $key + * @return bool + */ + protected function canDeleteFolder(string $key): bool + { + return true; + } + + /** + * Returns list of all stored keys in [key => timestamp] pairs. + * + * @return array + */ + protected function buildIndex(): array + { + $this->clearCache(); + + $path = $this->getStoragePath(); + if (!$path || !file_exists($path)) { + return []; + } + + if ($this->prefixed) { + $list = $this->buildPrefixedIndexFromFilesystem($path); + } else { + $list = $this->buildIndexFromFilesystem($path); + } + + ksort($list, SORT_NATURAL | SORT_FLAG_CASE); + + return $list; + } + + /** + * @param string $key + * @param bool $reload + * @return array + */ + protected function getObjectMeta(string $key, bool $reload = false): array + { + if (!$reload && isset($this->meta[$key])) { + return $this->meta[$key]; + } + + if ($key && strpos($key, '@@') === false) { + $filename = $this->getPathFromKey($key); + $modified = is_file($filename) ? filemtime($filename) : 0; + } else { + $modified = 0; + } + + $meta = [ + 'storage_key' => $key, + 'storage_timestamp' => $modified + ]; + + $this->meta[$key] = $meta; + + return $meta; + } + + /** + * @param string $path + * @return array + */ + protected function buildIndexFromFilesystem($path) + { + $flags = FilesystemIterator::KEY_AS_PATHNAME | FilesystemIterator::CURRENT_AS_FILEINFO | FilesystemIterator::SKIP_DOTS | FilesystemIterator::UNIX_PATHS; + + $iterator = new FilesystemIterator($path, $flags); + $list = []; + /** @var SplFileInfo $info */ + foreach ($iterator as $filename => $info) { + if (!$info->isDir() || strpos($info->getFilename(), '.') === 0) { + continue; + } + + $key = $this->getKeyFromPath($filename); + $meta = $this->getObjectMeta($key); + if ($meta['storage_timestamp']) { + $list[$key] = $meta; + } + } + + return $list; + } + + /** + * @param string $path + * @return array + */ + protected function buildPrefixedIndexFromFilesystem($path) + { + $flags = FilesystemIterator::KEY_AS_PATHNAME | FilesystemIterator::CURRENT_AS_FILEINFO | FilesystemIterator::SKIP_DOTS | FilesystemIterator::UNIX_PATHS; + + $iterator = new FilesystemIterator($path, $flags); + $list = [[]]; + /** @var SplFileInfo $info */ + foreach ($iterator as $filename => $info) { + if (!$info->isDir() || strpos($info->getFilename(), '.') === 0) { + continue; + } + + $list[] = $this->buildIndexFromFilesystem($filename); + } + + return array_merge(...$list); + } + + /** + * @return string + */ + protected function getNewKey(): string + { + // Make sure that the file doesn't exist. + do { + $key = $this->generateKey(); + } while (file_exists($this->getPathFromKey($key))); + + return $key; + } + + /** + * @param array $options + * @return void + */ + protected function initOptions(array $options): void + { + $extension = $this->dataFormatter->getDefaultFileExtension(); + + /** @var string $pattern */ + $pattern = !empty($options['pattern']) ? $options['pattern'] : $this->dataPattern; + + /** @var UniformResourceLocator $locator */ + $locator = Grav::instance()['locator']; + $folder = $options['folder']; + if ($locator->isStream($folder)) { + $folder = $locator->getResource($folder, false); + } + + $this->dataFolder = $folder; + $this->dataFile = $options['file'] ?? 'item'; + $this->dataExt = $extension; + if (mb_strpos($pattern, '{FILE}') === false && mb_strpos($pattern, '{EXT}') === false) { + if (isset($options['file'])) { + $pattern .= '/{FILE}{EXT}'; + } else { + $filesystem = Filesystem::getInstance(true); + $this->dataFile = Utils::basename($pattern, $extension); + $pattern = $filesystem->dirname($pattern) . '/{FILE}{EXT}'; + } + } + $this->prefixed = (bool)($options['prefixed'] ?? strpos($pattern, '/{KEY:2}/')); + $this->indexed = (bool)($options['indexed'] ?? false); + $this->keyField = $options['key'] ?? 'storage_key'; + $this->keyLen = (int)($options['key_len'] ?? 32); + $this->caseSensitive = (bool)($options['case_sensitive'] ?? true); + + $pattern = Utils::simpleTemplate($pattern, $this->variables); + if (!$pattern) { + throw new RuntimeException('Bad storage folder pattern'); + } + + $this->dataPattern = $pattern; + } +} diff --git a/system/src/Grav/Framework/Flex/Storage/SimpleStorage.php b/system/src/Grav/Framework/Flex/Storage/SimpleStorage.php new file mode 100644 index 0000000..5a92023 --- /dev/null +++ b/system/src/Grav/Framework/Flex/Storage/SimpleStorage.php @@ -0,0 +1,507 @@ +detectDataFormatter($options['folder']); + $this->initDataFormatter($formatter); + + $filesystem = Filesystem::getInstance(true); + + $extension = $this->dataFormatter->getDefaultFileExtension(); + $pattern = Utils::basename($options['folder']); + + $this->dataPattern = Utils::basename($pattern, $extension) . $extension; + $this->dataFolder = $filesystem->dirname($options['folder']); + $this->keyField = $options['key'] ?? 'storage_key'; + $this->keyLen = (int)($options['key_len'] ?? 32); + $this->prefix = $options['prefix'] ?? null; + + // Make sure that the data folder exists. + if (!file_exists($this->dataFolder)) { + try { + Folder::create($this->dataFolder); + } catch (RuntimeException $e) { + throw new RuntimeException(sprintf('Flex: %s', $e->getMessage())); + } + } + } + + /** + * @return void + */ + public function clearCache(): void + { + $this->data = null; + $this->modified = 0; + } + + /** + * @param string[] $keys + * @param bool $reload + * @return array + */ + public function getMetaData(array $keys, bool $reload = false): array + { + if (null === $this->data || $reload) { + $this->buildIndex(); + } + + $list = []; + foreach ($keys as $key) { + $list[$key] = $this->getObjectMeta((string)$key); + } + + return $list; + } + + /** + * {@inheritdoc} + * @see FlexStorageInterface::getExistingKeys() + */ + public function getExistingKeys(): array + { + return $this->buildIndex(); + } + + /** + * {@inheritdoc} + * @see FlexStorageInterface::hasKey() + */ + public function hasKey(string $key): bool + { + if (null === $this->data) { + $this->buildIndex(); + } + + return $key && strpos($key, '@@') === false && isset($this->data[$key]); + } + + /** + * {@inheritdoc} + * @see FlexStorageInterface::createRows() + */ + public function createRows(array $rows): array + { + if (null === $this->data) { + $this->buildIndex(); + } + + $list = []; + foreach ($rows as $key => $row) { + $list[$key] = $this->saveRow('@@', $rows); + } + + if ($list) { + $this->save(); + } + + return $list; + } + + /** + * {@inheritdoc} + * @see FlexStorageInterface::readRows() + */ + public function readRows(array $rows, array &$fetched = null): array + { + if (null === $this->data) { + $this->buildIndex(); + } + + $list = []; + foreach ($rows as $key => $row) { + if (null === $row || is_scalar($row)) { + // Only load rows which haven't been loaded before. + $key = (string)$key; + $list[$key] = $this->hasKey($key) ? $this->loadRow($key) : null; + if (null !== $fetched) { + $fetched[$key] = $list[$key]; + } + } else { + // Keep the row if it has been loaded. + $list[$key] = $row; + } + } + + return $list; + } + + /** + * {@inheritdoc} + * @see FlexStorageInterface::updateRows() + */ + public function updateRows(array $rows): array + { + if (null === $this->data) { + $this->buildIndex(); + } + + $save = false; + $list = []; + foreach ($rows as $key => $row) { + $key = (string)$key; + if ($this->hasKey($key)) { + $list[$key] = $this->saveRow($key, $row); + $save = true; + } else { + $list[$key] = null; + } + } + + if ($save) { + $this->save(); + } + + return $list; + } + + /** + * {@inheritdoc} + * @see FlexStorageInterface::deleteRows() + */ + public function deleteRows(array $rows): array + { + if (null === $this->data) { + $this->buildIndex(); + } + + $list = []; + foreach ($rows as $key => $row) { + $key = (string)$key; + if ($this->hasKey($key)) { + unset($this->data[$key]); + $list[$key] = $row; + } + } + + if ($list) { + $this->save(); + } + + return $list; + } + + /** + * {@inheritdoc} + * @see FlexStorageInterface::replaceRows() + */ + public function replaceRows(array $rows): array + { + if (null === $this->data) { + $this->buildIndex(); + } + + $list = []; + foreach ($rows as $key => $row) { + $list[$key] = $this->saveRow((string)$key, $row); + } + + if ($list) { + $this->save(); + } + + return $list; + } + + /** + * @param string $src + * @param string $dst + * @return bool + */ + public function copyRow(string $src, string $dst): bool + { + if ($this->hasKey($dst)) { + throw new RuntimeException("Cannot copy object: key '{$dst}' is already taken"); + } + + if (!$this->hasKey($src)) { + return false; + } + + $this->data[$dst] = $this->data[$src]; + + return true; + } + + /** + * {@inheritdoc} + * @see FlexStorageInterface::renameRow() + */ + public function renameRow(string $src, string $dst): bool + { + if (null === $this->data) { + $this->buildIndex(); + } + + if ($this->hasKey($dst)) { + throw new RuntimeException("Cannot rename object: key '{$dst}' is already taken"); + } + + if (!$this->hasKey($src)) { + return false; + } + + // Change single key in the array without changing the order or value. + $keys = array_keys($this->data); + $keys[array_search($src, $keys, true)] = $dst; + + $data = array_combine($keys, $this->data); + if (false === $data) { + throw new LogicException('Bad data'); + } + + $this->data = $data; + + return true; + } + + /** + * {@inheritdoc} + * @see FlexStorageInterface::getStoragePath() + */ + public function getStoragePath(string $key = null): ?string + { + return $this->dataFolder . '/' . $this->dataPattern; + } + + /** + * {@inheritdoc} + * @see FlexStorageInterface::getMediaPath() + */ + public function getMediaPath(string $key = null): ?string + { + return null; + } + + /** + * Prepares the row for saving and returns the storage key for the record. + * + * @param array $row + */ + protected function prepareRow(array &$row): void + { + unset($row[$this->keyField]); + } + + /** + * @param string $key + * @return array + */ + protected function loadRow(string $key): ?array + { + $data = $this->data[$key] ?? []; + if ($this->keyField !== 'storage_key') { + $data[$this->keyField] = $key; + } + $data['__META'] = $this->getObjectMeta($key); + + return $data; + } + + /** + * @param string $key + * @param array $row + * @return array + */ + protected function saveRow(string $key, array $row): array + { + try { + if (isset($row[$this->keyField])) { + $key = $row[$this->keyField]; + } + if (strpos($key, '@@') !== false) { + $key = $this->getNewKey(); + } + + // Check if the row already exists and if the key has been changed. + $oldKey = $row['__META']['storage_key'] ?? null; + if (is_string($oldKey) && $oldKey !== $key) { + $isCopy = $row['__META']['copy'] ?? false; + if ($isCopy) { + $this->copyRow($oldKey, $key); + } else { + $this->renameRow($oldKey, $key); + } + } + + $this->prepareRow($row); + unset($row['__META'], $row['__ERROR']); + + $this->data[$key] = $row; + } catch (RuntimeException $e) { + throw new RuntimeException(sprintf('Flex saveRow(%s): %s', $key, $e->getMessage())); + } + + $row['__META'] = $this->getObjectMeta($key, true); + + return $row; + } + + /** + * @param string $key + * @param bool $variations + * @return array + */ + public function parseKey(string $key, bool $variations = true): array + { + return [ + 'key' => $key, + ]; + } + + protected function save(): void + { + if (null === $this->data) { + $this->buildIndex(); + } + + try { + $path = $this->getStoragePath(); + if (!$path) { + throw new RuntimeException('Storage path is not defined'); + } + $file = $this->getFile($path); + if ($this->prefix) { + $data = new Data((array)$file->content()); + $content = $data->set($this->prefix, $this->data)->toArray(); + } else { + $content = $this->data; + } + $file->save($content); + $this->modified = (int)$file->modified(); // cast false to 0 + } catch (RuntimeException $e) { + throw new RuntimeException(sprintf('Flex save(): %s', $e->getMessage())); + } finally { + if (isset($file)) { + $file->free(); + unset($file); + } + } + } + + /** + * Get key from the filesystem path. + * + * @param string $path + * @return string + */ + protected function getKeyFromPath(string $path): string + { + return Utils::basename($path); + } + + /** + * Returns list of all stored keys in [key => timestamp] pairs. + * + * @return array + */ + protected function buildIndex(): array + { + $path = $this->getStoragePath(); + if (!$path) { + $this->data = []; + + return []; + } + + $file = $this->getFile($path); + $this->modified = (int)$file->modified(); // cast false to 0 + + $content = (array) $file->content(); + if ($this->prefix) { + $data = new Data($content); + $content = $data->get($this->prefix, []); + } + + $file->free(); + unset($file); + + $this->data = $content; + + $list = []; + foreach ($this->data as $key => $info) { + $list[$key] = $this->getObjectMeta((string)$key); + } + + return $list; + } + + /** + * @param string $key + * @param bool $reload + * @return array + */ + protected function getObjectMeta(string $key, bool $reload = false): array + { + $modified = isset($this->data[$key]) ? $this->modified : 0; + + return [ + 'storage_key' => $key, + 'key' => $key, + 'storage_timestamp' => $modified + ]; + } + + /** + * @return string + */ + protected function getNewKey(): string + { + if (null === $this->data) { + $this->buildIndex(); + } + + // Make sure that the key doesn't exist. + do { + $key = $this->generateKey(); + } while (isset($this->data[$key])); + + return $key; + } +} diff --git a/system/src/Grav/Framework/Flex/Traits/FlexAuthorizeTrait.php b/system/src/Grav/Framework/Flex/Traits/FlexAuthorizeTrait.php new file mode 100644 index 0000000..a821300 --- /dev/null +++ b/system/src/Grav/Framework/Flex/Traits/FlexAuthorizeTrait.php @@ -0,0 +1,126 @@ +getAuthorizeAction($action); + $scope = $scope ?? $this->getAuthorizeScope(); + + $isMe = null === $user; + if ($isMe) { + $user = $this->getActiveUser(); + } + + if (null === $user) { + return false; + } + + // Finally authorize against given action. + return $this->isAuthorizedOverride($user, $action, $scope, $isMe); + } + + /** + * Please override this method + * + * @param UserInterface $user + * @param string $action + * @param string $scope + * @param bool $isMe + * @return bool|null + */ + protected function isAuthorizedOverride(UserInterface $user, string $action, string $scope, bool $isMe): ?bool + { + return $this->isAuthorizedAction($user, $action, $scope, $isMe); + } + + /** + * Check if user is authorized for the action. + * + * @param UserInterface $user + * @param string $action + * @param string $scope + * @param bool $isMe + * @return bool|null + */ + protected function isAuthorizedAction(UserInterface $user, string $action, string $scope, bool $isMe): ?bool + { + // Check if the action has been denied in the flex type configuration. + $directory = $this instanceof FlexDirectory ? $this : $this->getFlexDirectory(); + $config = $directory->getConfig(); + $allowed = $config->get("{$scope}.actions.{$action}") ?? $config->get("actions.{$action}") ?? true; + if (false === $allowed) { + return false; + } + + // TODO: Not needed anymore with flex users, remove in 2.0. + $auth = $user instanceof FlexObjectInterface ? null : $user->authorize('admin.super'); + if (true === $auth) { + return true; + } + + // Finally authorize the action. + return $user->authorize($this->getAuthorizeRule($scope, $action), !$isMe ? 'test' : null); + } + + /** + * @param UserInterface $user + * @return bool|null + * @deprecated 1.7 Not needed for Flex Users. + */ + protected function isAuthorizedSuperAdmin(UserInterface $user): ?bool + { + // Action authorization includes super user authorization if using Flex Users. + if ($user instanceof FlexObjectInterface) { + return null; + } + + return $user->authorize('admin.super'); + } + + /** + * @param string $scope + * @param string $action + * @return string + */ + protected function getAuthorizeRule(string $scope, string $action): string + { + if ($this instanceof FlexDirectory) { + return $this->getAuthorizeRule($scope, $action); + } + + return $this->getFlexDirectory()->getAuthorizeRule($scope, $action); + } +} diff --git a/system/src/Grav/Framework/Flex/Traits/FlexMediaTrait.php b/system/src/Grav/Framework/Flex/Traits/FlexMediaTrait.php new file mode 100644 index 0000000..a4d9a7e --- /dev/null +++ b/system/src/Grav/Framework/Flex/Traits/FlexMediaTrait.php @@ -0,0 +1,576 @@ +exists() ? $this->getFlexDirectory()->getStorageFolder($this->getStorageKey()) : null; + } + + /** + * @return string|null + */ + public function getMediaFolder() + { + return $this->exists() ? $this->getFlexDirectory()->getMediaFolder($this->getStorageKey()) : null; + } + + /** + * @return MediaCollectionInterface + */ + public function getMedia() + { + $media = $this->media; + if (null === $media) { + $media = $this->getExistingMedia(); + + // Include uploaded media to the object media. + $this->addUpdatedMedia($media); + } + + return $media; + } + + /** + * @param string $field + * @return MediaCollectionInterface|null + */ + public function getMediaField(string $field): ?MediaCollectionInterface + { + // Field specific media. + $settings = $this->getFieldSettings($field); + if (!empty($settings['media_field'])) { + $var = 'destination'; + } elseif (!empty($settings['media_picker_field'])) { + $var = 'folder'; + } + + if (empty($var)) { + // Not a media field. + $media = null; + } elseif ($settings['self']) { + // Uses main media. + $media = $this->getMedia(); + } else { + // Uses custom media. + $media = new Media($settings[$var]); + $this->addUpdatedMedia($media); + } + + return $media; + } + + /** + * @param string $field + * @return array|null + */ + public function getFieldSettings(string $field): ?array + { + if ($field === '') { + return null; + } + + // Load settings for the field. + $schema = $this->getBlueprint()->schema(); + $settings = (array)$schema->getProperty($field); + if (!is_array($settings)) { + return null; + } + + $type = $settings['type'] ?? ''; + + // Media field. + if (!empty($settings['media_field']) || array_key_exists('destination', $settings) || in_array($type, ['avatar', 'file', 'pagemedia'], true)) { + $settings['media_field'] = true; + $var = 'destination'; + } + + // Media picker field. + if (!empty($settings['media_picker_field']) || in_array($type, ['filepicker', 'pagemediaselect'], true)) { + $settings['media_picker_field'] = true; + $var = 'folder'; + } + + // Set media folder for media fields. + if (isset($var)) { + $folder = $settings[$var] ?? ''; + if (in_array(rtrim($folder, '/'), ['', '@self', 'self@', '@self@'], true)) { + $settings[$var] = $this->getMediaFolder(); + $settings['self'] = true; + } else { + $settings[$var] = Utils::getPathFromToken($folder, $this); + $settings['self'] = false; + } + } + + return $settings; + } + + /** + * @param string $field + * @return array + * @internal + */ + protected function getMediaFieldSettings(string $field): array + { + $settings = $this->getFieldSettings($field) ?? []; + + return $settings + ['accept' => '*', 'limit' => 1000, 'self' => true]; + } + + /** + * @return array + */ + protected function getMediaFields(): array + { + // Load settings for the field. + $schema = $this->getBlueprint()->schema(); + + $list = []; + foreach ($schema->getState()['items'] as $field => $settings) { + if (isset($settings['type']) && (in_array($settings['type'], ['avatar', 'file', 'pagemedia']) || !empty($settings['destination']))) { + $list[] = $field; + } + } + + return $list; + } + + /** + * @param array|mixed $value + * @param array $settings + * @return array|mixed + */ + protected function parseFileProperty($value, array $settings = []) + { + if (!is_array($value)) { + return $value; + } + + $media = $this->getMedia(); + $originalMedia = is_callable([$this, 'getOriginalMedia']) ? $this->getOriginalMedia() : null; + + $list = []; + foreach ($value as $filename => $info) { + if (!is_array($info)) { + $list[$filename] = $info; + continue; + } + + if (is_int($filename)) { + $filename = $info['path'] ?? $info['name']; + } + + /** @var Medium|null $imageFile */ + $imageFile = $media[$filename]; + + /** @var Medium|null $originalFile */ + $originalFile = $originalMedia ? $originalMedia[$filename] : null; + + $url = $imageFile ? $imageFile->url() : null; + $originalUrl = $originalFile ? $originalFile->url() : null; + $list[$filename] = [ + 'name' => $info['name'] ?? null, + 'type' => $info['type'] ?? null, + 'size' => $info['size'] ?? null, + 'path' => $filename, + 'thumb_url' => $url, + 'image_url' => $originalUrl ?? $url + ]; + if ($originalFile) { + $list[$filename]['cropData'] = (object)($originalFile->metadata()['upload']['crop'] ?? []); + } + } + + return $list; + } + + /** + * @param UploadedFileInterface $uploadedFile + * @param string|null $filename + * @param string|null $field + * @return void + * @internal + */ + public function checkUploadedMediaFile(UploadedFileInterface $uploadedFile, string $filename = null, string $field = null) + { + $media = $this->getMedia(); + if (!$media instanceof MediaUploadInterface) { + throw new RuntimeException("Media for {$this->getFlexDirectory()->getFlexType()} doesn't support file uploads."); + } + + $media->checkUploadedFile($uploadedFile, $filename, $this->getMediaFieldSettings($field ?? '')); + } + + /** + * @param UploadedFileInterface $uploadedFile + * @param string|null $filename + * @param string|null $field + * @return void + * @internal + */ + public function uploadMediaFile(UploadedFileInterface $uploadedFile, string $filename = null, string $field = null): void + { + $settings = $this->getMediaFieldSettings($field ?? ''); + + $media = $field ? $this->getMediaField($field) : $this->getMedia(); + if (!$media instanceof MediaUploadInterface) { + throw new RuntimeException("Media for {$this->getFlexDirectory()->getFlexType()} doesn't support file uploads."); + } + + $filename = $media->checkUploadedFile($uploadedFile, $filename, $settings); + $media->copyUploadedFile($uploadedFile, $filename, $settings); + $this->clearMediaCache(); + } + + /** + * @param string $filename + * @return void + * @internal + */ + public function deleteMediaFile(string $filename): void + { + $media = $this->getMedia(); + if (!$media instanceof MediaUploadInterface) { + throw new RuntimeException("Media for {$this->getFlexDirectory()->getFlexType()} doesn't support file uploads."); + } + + $media->deleteFile($filename); + $this->clearMediaCache(); + } + + /** + * @return array + */ + #[\ReturnTypeWillChange] + public function __debugInfo() + { + return parent::__debugInfo() + [ + 'uploads:private' => $this->getUpdatedMedia() + ]; + } + + /** + * @param string|null $field + * @param string $filename + * @param MediaObjectInterface|null $image + * @return MediaObject|UploadedMediaObject + */ + protected function buildMediaObject(?string $field, string $filename, MediaObjectInterface $image = null) + { + if (!$image) { + $media = $field ? $this->getMediaField($field) : null; + if ($media) { + $image = $media[$filename]; + } + } + + return new MediaObject($field, $filename, $image, $this); + } + + /** + * @param string|null $field + * @return array + */ + protected function buildMediaList(?string $field): array + { + $names = $field ? (array)$this->getNestedProperty($field) : []; + $media = $field ? $this->getMediaField($field) : null; + if (null === $media) { + $media = $this->getMedia(); + } + + $list = []; + foreach ($names as $key => $val) { + $name = is_string($val) ? $val : $key; + $medium = $media[$name]; + if ($medium) { + if ($medium->uploaded_file) { + $upload = $medium->uploaded_file; + $id = $upload instanceof FormFlashFile ? $upload->getId() : "{$field}-{$name}"; + + $list[] = new UploadedMediaObject($id, $field, $name, $upload); + } else { + $list[] = $this->buildMediaObject($field, $name, $medium); + } + } + } + + return $list; + } + + /** + * @param array $files + * @return void + */ + protected function setUpdatedMedia(array $files): void + { + $media = $this->getMedia(); + if (!$media instanceof MediaUploadInterface) { + return; + } + + $filesystem = Filesystem::getInstance(false); + + $list = []; + foreach ($files as $field => $group) { + $field = (string)$field; + // Ignore files without a field and resized images. + if ($field === '' || strpos($field, '/')) { + continue; + } + + // Load settings for the field. + $settings = $this->getMediaFieldSettings($field); + foreach ($group as $filename => $file) { + if ($file) { + // File upload. + $filename = $file->getClientFilename(); + + /** @var FormFlashFile $file */ + $data = $file->jsonSerialize(); + unset($data['tmp_name'], $data['path']); + } else { + // File delete. + $data = null; + } + + if ($file) { + // Check file upload against media limits (except for max size). + $filename = $media->checkUploadedFile($file, $filename, ['filesize' => 0] + $settings); + } + + $self = $settings['self']; + if ($this->_loadMedia && $self) { + $filepath = $filename; + } else { + $filepath = "{$settings['destination']}/{$filename}"; + } + + // Calculate path without the retina scaling factor. + $realpath = $filesystem->pathname($filepath) . str_replace(['@3x', '@2x'], '', Utils::basename($filepath)); + + $list[$filename] = [$file, $settings]; + + $path = str_replace('.', "\n", $field); + if (null !== $data) { + $data['name'] = $filename; + $data['path'] = $filepath; + + $this->setNestedProperty("{$path}\n{$realpath}", $data, "\n"); + } else { + $this->unsetNestedProperty("{$path}\n{$realpath}", "\n"); + } + } + } + + $this->clearMediaCache(); + + $this->_uploads = $list; + } + + /** + * @param MediaCollectionInterface $media + */ + protected function addUpdatedMedia(MediaCollectionInterface $media): void + { + $updated = false; + foreach ($this->getUpdatedMedia() as $filename => $upload) { + if (is_array($upload)) { + /** @var array{UploadedFileInterface,array} $upload */ + $settings = $upload[1]; + if (isset($settings['destination']) && $settings['destination'] === $media->getPath()) { + $upload = $upload[0]; + } else { + $upload = false; + } + } + if (false !== $upload) { + $medium = $upload ? MediumFactory::fromUploadedFile($upload) : null; + $updated = true; + if ($medium) { + $medium->uploaded = true; + $medium->uploaded_file = $upload; + $media->add($filename, $medium); + } elseif (is_callable([$media, 'hide'])) { + $media->hide($filename); + } + } + } + + if ($updated) { + $media->setTimestamps(); + } + } + + /** + * @return array + */ + protected function getUpdatedMedia(): array + { + return $this->_uploads; + } + + /** + * @return void + */ + protected function saveUpdatedMedia(): void + { + $media = $this->getMedia(); + if (!$media instanceof MediaUploadInterface) { + return; + } + + // Upload/delete altered files. + /** + * @var string $filename + * @var UploadedFileInterface|array|null $file + */ + foreach ($this->getUpdatedMedia() as $filename => $file) { + if (is_array($file)) { + [$file, $settings] = $file; + } else { + $settings = null; + } + if ($file instanceof UploadedFileInterface) { + $media->copyUploadedFile($file, $filename, $settings); + } else { + $media->deleteFile($filename, $settings); + } + } + + $this->setUpdatedMedia([]); + $this->clearMediaCache(); + } + + /** + * @return void + */ + protected function freeMedia(): void + { + $this->unsetObjectProperty('media'); + } + + /** + * @param string $uri + * @return Medium|null + */ + protected function createMedium($uri) + { + $grav = Grav::instance(); + + /** @var UniformResourceLocator $locator */ + $locator = $grav['locator']; + + $file = $uri && $locator->isStream($uri) ? $locator->findResource($uri) : $uri; + + return is_string($file) && file_exists($file) ? MediumFactory::fromFile($file) : null; + } + + /** + * @return CacheInterface + */ + protected function getMediaCache() + { + return $this->getCache('object'); + } + + /** + * @return MediaCollectionInterface + */ + protected function offsetLoad_media() + { + return $this->getMedia(); + } + + /** + * @return null + */ + protected function offsetSerialize_media() + { + return null; + } + + /** + * @return FlexDirectory + */ + abstract public function getFlexDirectory(): FlexDirectory; + + /** + * @return string + */ + abstract public function getStorageKey(): string; + + /** + * @param string $filename + * @return void + * @deprecated 1.7 Use Media class that implements MediaUploadInterface instead. + */ + public function checkMediaFilename(string $filename) + { + user_error(__METHOD__ . '() is deprecated since Grav 1.7, use Media class that implements MediaUploadInterface instead', E_USER_DEPRECATED); + + // Check the file extension. + $extension = strtolower(Utils::pathinfo($filename, PATHINFO_EXTENSION)); + + $grav = Grav::instance(); + + /** @var Config $config */ + $config = $grav['config']; + + // If not a supported type, return + if (!$extension || !$config->get("media.types.{$extension}")) { + $language = $grav['language']; + throw new RuntimeException($language->translate('PLUGIN_ADMIN.UNSUPPORTED_FILE_TYPE') . ': ' . $extension, 400); + } + } +} diff --git a/system/src/Grav/Framework/Flex/Traits/FlexRelatedDirectoryTrait.php b/system/src/Grav/Framework/Flex/Traits/FlexRelatedDirectoryTrait.php new file mode 100644 index 0000000..2922f03 --- /dev/null +++ b/system/src/Grav/Framework/Flex/Traits/FlexRelatedDirectoryTrait.php @@ -0,0 +1,59 @@ + + */ + protected function getCollectionByProperty($type, $property) + { + $directory = $this->getRelatedDirectory($type); + $collection = $directory->getCollection(); + $list = $this->getNestedProperty($property) ?: []; + + /** @var FlexCollectionInterface $collection */ + $collection = $collection->filter(static function ($object) use ($list) { + return in_array($object->getKey(), $list, true); + }); + + return $collection; + } + + /** + * @param string $type + * @return FlexDirectory + * @throws RuntimeException + */ + protected function getRelatedDirectory($type): FlexDirectory + { + $directory = $this->getFlexContainer()->getDirectory($type); + if (!$directory) { + throw new RuntimeException(ucfirst($type). ' directory does not exist!'); + } + + return $directory; + } +} diff --git a/system/src/Grav/Framework/Flex/Traits/FlexRelationshipsTrait.php b/system/src/Grav/Framework/Flex/Traits/FlexRelationshipsTrait.php new file mode 100644 index 0000000..2a73eba --- /dev/null +++ b/system/src/Grav/Framework/Flex/Traits/FlexRelationshipsTrait.php @@ -0,0 +1,61 @@ +_relationships)) { + $blueprint = $this->getBlueprint(); + $options = $blueprint->get('config/relationships', []); + $parent = FlexIdentifier::createFromObject($this); + + $this->_relationships = new Relationships($parent, $options); + } + + return $this->_relationships; + } + + /** + * @param string $name + * @return RelationshipInterface|null + */ + public function getRelationship(string $name): ?RelationshipInterface + { + return $this->getRelationships()[$name]; + } + + protected function resetRelationships(): void + { + $this->_relationships = null; + } + + /** + * @param iterable $collection + * @return array + */ + protected function buildFlexIdentifierList(iterable $collection): array + { + $list = []; + foreach ($collection as $object) { + $list[] = FlexIdentifier::createFromObject($object); + } + + return $list; + } +} diff --git a/system/src/Grav/Framework/Form/FormFlash.php b/system/src/Grav/Framework/Form/FormFlash.php new file mode 100644 index 0000000..db1d8d4 --- /dev/null +++ b/system/src/Grav/Framework/Form/FormFlash.php @@ -0,0 +1,586 @@ + $args[0], + 'unique_id' => $args[1] ?? null, + 'form_name' => $args[2] ?? null, + ]; + $config = array_filter($config, static function ($val) { + return $val !== null; + }); + } + + $this->id = $config['id'] ?? ''; + $this->sessionId = $config['session_id'] ?? ''; + $this->uniqueId = $config['unique_id'] ?? ''; + + $this->setUser($config['user'] ?? null); + + $folder = $config['folder'] ?? ($this->sessionId ? 'tmp://forms/' . $this->sessionId : ''); + + /** @var UniformResourceLocator $locator */ + $locator = Grav::instance()['locator']; + + $this->folder = $folder && $locator->isStream($folder) ? $locator->findResource($folder, true, true) : $folder; + + $this->init($this->loadStoredForm(), $config); + } + + /** + * @param array|null $data + * @param array $config + */ + protected function init(?array $data, array $config): void + { + if (null === $data) { + $this->exists = false; + $this->formName = $config['form_name'] ?? ''; + $this->url = ''; + $this->createdTimestamp = $this->updatedTimestamp = time(); + $this->files = []; + } else { + $this->exists = true; + $this->formName = $data['form'] ?? $config['form_name'] ?? ''; + $this->url = $data['url'] ?? ''; + $this->user = $data['user'] ?? null; + $this->updatedTimestamp = $data['timestamps']['updated'] ?? time(); + $this->createdTimestamp = $data['timestamps']['created'] ?? $this->updatedTimestamp; + $this->data = $data['data'] ?? null; + $this->files = $data['files'] ?? []; + } + } + + /** + * Load raw flex flash data from the filesystem. + * + * @return array|null + */ + protected function loadStoredForm(): ?array + { + $file = $this->getTmpIndex(); + $exists = $file && $file->exists(); + + $data = null; + if ($exists) { + try { + $data = (array)$file->content(); + } catch (Exception $e) { + } + } + + return $data; + } + + /** + * @inheritDoc + */ + public function getId(): string + { + return $this->id && $this->uniqueId ? $this->id . '/' . $this->uniqueId : ''; + } + + /** + * @inheritDoc + */ + public function getSessionId(): string + { + return $this->sessionId; + } + + /** + * @inheritDoc + */ + public function getUniqueId(): string + { + return $this->uniqueId; + } + + /** + * @return string + * @deprecated 1.6.11 Use '->getUniqueId()' method instead. + */ + public function getUniqieId(): string + { + user_error(__CLASS__ . '::' . __FUNCTION__ . '() is deprecated since Grav 1.6.11, use ->getUniqueId() method instead', E_USER_DEPRECATED); + + return $this->getUniqueId(); + } + + /** + * @inheritDoc + */ + public function getFormName(): string + { + return $this->formName; + } + + + /** + * @inheritDoc + */ + public function getUrl(): string + { + return $this->url; + } + + /** + * @inheritDoc + */ + public function getUsername(): string + { + return $this->user['username'] ?? ''; + } + + /** + * @inheritDoc + */ + public function getUserEmail(): string + { + return $this->user['email'] ?? ''; + } + + /** + * @inheritDoc + */ + public function getCreatedTimestamp(): int + { + return $this->createdTimestamp; + } + + /** + * @inheritDoc + */ + public function getUpdatedTimestamp(): int + { + return $this->updatedTimestamp; + } + + + /** + * @inheritDoc + */ + public function getData(): ?array + { + return $this->data; + } + + /** + * @inheritDoc + */ + public function setData(?array $data): void + { + $this->data = $data; + } + + /** + * @inheritDoc + */ + public function exists(): bool + { + return $this->exists; + } + + /** + * @inheritDoc + */ + public function save(bool $force = false) + { + if (!($this->folder && $this->uniqueId)) { + return $this; + } + + if ($force || $this->data || $this->files) { + // Only save if there is data or files to be saved. + $file = $this->getTmpIndex(); + if ($file) { + $file->save($this->jsonSerialize()); + $this->exists = true; + } + } elseif ($this->exists) { + // Delete empty form flash if it exists (it carries no information). + return $this->delete(); + } + + return $this; + } + + /** + * @inheritDoc + */ + public function delete() + { + if ($this->folder && $this->uniqueId) { + $this->removeTmpDir(); + $this->files = []; + $this->exists = false; + } + + return $this; + } + + /** + * @inheritDoc + */ + public function getFilesByField(string $field): array + { + if (!isset($this->uploadObjects[$field])) { + $objects = []; + foreach ($this->files[$field] ?? [] as $name => $upload) { + $objects[$name] = $upload ? new FormFlashFile($field, $upload, $this) : null; + } + $this->uploadedFiles[$field] = $objects; + } + + return $this->uploadedFiles[$field]; + } + + /** + * @inheritDoc + */ + public function getFilesByFields($includeOriginal = false): array + { + $list = []; + foreach ($this->files as $field => $values) { + if (!$includeOriginal && strpos($field, '/')) { + continue; + } + $list[$field] = $this->getFilesByField($field); + } + + return $list; + } + + /** + * @inheritDoc + */ + public function addUploadedFile(UploadedFileInterface $upload, string $field = null, array $crop = null): string + { + $tmp_dir = $this->getTmpDir(); + $tmp_name = Utils::generateRandomString(12); + $name = $upload->getClientFilename(); + if (!$name) { + throw new RuntimeException('Uploaded file has no filename'); + } + + // Prepare upload data for later save + $data = [ + 'name' => $name, + 'type' => $upload->getClientMediaType(), + 'size' => $upload->getSize(), + 'tmp_name' => $tmp_name + ]; + + Folder::create($tmp_dir); + $upload->moveTo("{$tmp_dir}/{$tmp_name}"); + + $this->addFileInternal($field, $name, $data, $crop); + + return $name; + } + + /** + * @inheritDoc + */ + public function addFile(string $filename, string $field, array $crop = null): bool + { + if (!file_exists($filename)) { + throw new RuntimeException("File not found: {$filename}"); + } + + // Prepare upload data for later save + $data = [ + 'name' => Utils::basename($filename), + 'type' => Utils::getMimeByLocalFile($filename), + 'size' => filesize($filename), + ]; + + $this->addFileInternal($field, $data['name'], $data, $crop); + + return true; + } + + /** + * @inheritDoc + */ + public function removeFile(string $name, string $field = null): bool + { + if (!$name) { + return false; + } + + $field = $field ?: 'undefined'; + + $upload = $this->files[$field][$name] ?? null; + if (null !== $upload) { + $this->removeTmpFile($upload['tmp_name'] ?? ''); + } + $upload = $this->files[$field . '/original'][$name] ?? null; + if (null !== $upload) { + $this->removeTmpFile($upload['tmp_name'] ?? ''); + } + + // Mark file as deleted. + $this->files[$field][$name] = null; + $this->files[$field . '/original'][$name] = null; + + unset( + $this->uploadedFiles[$field][$name], + $this->uploadedFiles[$field . '/original'][$name] + ); + + return true; + } + + /** + * @inheritDoc + */ + public function clearFiles() + { + foreach ($this->files as $files) { + foreach ($files as $upload) { + $this->removeTmpFile($upload['tmp_name'] ?? ''); + } + } + + $this->files = []; + } + + /** + * @inheritDoc + */ + public function jsonSerialize(): array + { + return [ + 'form' => $this->formName, + 'id' => $this->getId(), + 'unique_id' => $this->uniqueId, + 'url' => $this->url, + 'user' => $this->user, + 'timestamps' => [ + 'created' => $this->createdTimestamp, + 'updated' => time(), + ], + 'data' => $this->data, + 'files' => $this->files + ]; + } + + /** + * @param string $url + * @return $this + */ + public function setUrl(string $url): self + { + $this->url = $url; + + return $this; + } + + /** + * @param UserInterface|null $user + * @return $this + */ + public function setUser(UserInterface $user = null) + { + if ($user && $user->username) { + $this->user = [ + 'username' => $user->username, + 'email' => $user->email ?? '' + ]; + } else { + $this->user = null; + } + + return $this; + } + + /** + * @param string|null $username + * @return $this + */ + public function setUserName(string $username = null): self + { + $this->user['username'] = $username; + + return $this; + } + + /** + * @param string|null $email + * @return $this + */ + public function setUserEmail(string $email = null): self + { + $this->user['email'] = $email; + + return $this; + } + + /** + * @return string + */ + public function getTmpDir(): string + { + return $this->folder && $this->uniqueId ? "{$this->folder}/{$this->uniqueId}" : ''; + } + + /** + * @return ?YamlFile + */ + protected function getTmpIndex(): ?YamlFile + { + $tmpDir = $this->getTmpDir(); + + // Do not use CompiledYamlFile as the file can change multiple times per second. + return $tmpDir ? YamlFile::instance($tmpDir . '/index.yaml') : null; + } + + /** + * @param string $name + */ + protected function removeTmpFile(string $name): void + { + $tmpDir = $this->getTmpDir(); + $filename = $tmpDir ? $tmpDir . '/' . $name : ''; + if ($name && $filename && is_file($filename)) { + unlink($filename); + } + } + + /** + * @return void + */ + protected function removeTmpDir(): void + { + // Make sure that index file cache gets always cleared. + $file = $this->getTmpIndex(); + if ($file) { + $file->free(); + } + + $tmpDir = $this->getTmpDir(); + if ($tmpDir && file_exists($tmpDir)) { + Folder::delete($tmpDir); + } + } + + /** + * @param string|null $field + * @param string $name + * @param array $data + * @param array|null $crop + * @return void + */ + protected function addFileInternal(?string $field, string $name, array $data, array $crop = null): void + { + if (!($this->folder && $this->uniqueId)) { + throw new RuntimeException('Cannot upload files: form flash folder not defined'); + } + + $field = $field ?: 'undefined'; + if (!isset($this->files[$field])) { + $this->files[$field] = []; + } + + $oldUpload = $this->files[$field][$name] ?? null; + + if ($crop) { + // Deal with crop upload + if ($oldUpload) { + $originalUpload = $this->files[$field . '/original'][$name] ?? null; + if ($originalUpload) { + // If there is original file already present, remove the modified file + $this->files[$field . '/original'][$name]['crop'] = $crop; + $this->removeTmpFile($oldUpload['tmp_name'] ?? ''); + } else { + // Otherwise make the previous file as original + $oldUpload['crop'] = $crop; + $this->files[$field . '/original'][$name] = $oldUpload; + } + } else { + $this->files[$field . '/original'][$name] = [ + 'name' => $name, + 'type' => $data['type'], + 'crop' => $crop + ]; + } + } else { + // Deal with replacing upload + $originalUpload = $this->files[$field . '/original'][$name] ?? null; + $this->files[$field . '/original'][$name] = null; + + $this->removeTmpFile($oldUpload['tmp_name'] ?? ''); + $this->removeTmpFile($originalUpload['tmp_name'] ?? ''); + } + + // Prepare data to be saved later + $this->files[$field][$name] = $data; + } +} diff --git a/system/src/Grav/Framework/Form/FormFlashFile.php b/system/src/Grav/Framework/Form/FormFlashFile.php new file mode 100644 index 0000000..3dcf59e --- /dev/null +++ b/system/src/Grav/Framework/Form/FormFlashFile.php @@ -0,0 +1,266 @@ +id = $flash->getId() ?: $flash->getUniqueId(); + $this->field = $field; + $this->upload = $upload; + $this->flash = $flash; + + $tmpFile = $this->getTmpFile(); + if (!$tmpFile && $this->isOk()) { + $this->upload['error'] = \UPLOAD_ERR_NO_FILE; + } + + if (!isset($this->upload['size'])) { + $this->upload['size'] = $tmpFile && $this->isOk() ? filesize($tmpFile) : 0; + } + } + + /** + * @return StreamInterface + */ + public function getStream() + { + $this->validateActive(); + + $tmpFile = $this->getTmpFile(); + if (null === $tmpFile) { + throw new RuntimeException('No temporary file'); + } + + $resource = fopen($tmpFile, 'rb'); + if (false === $resource) { + throw new RuntimeException('No temporary file'); + } + + return Stream::create($resource); + } + + /** + * @param string $targetPath + * @return void + */ + public function moveTo($targetPath) + { + $this->validateActive(); + + if (!is_string($targetPath) || empty($targetPath)) { + throw new InvalidArgumentException('Invalid path provided for move operation; must be a non-empty string'); + } + $tmpFile = $this->getTmpFile(); + if (null === $tmpFile) { + throw new RuntimeException('No temporary file'); + } + + $this->moved = copy($tmpFile, $targetPath); + + if (false === $this->moved) { + throw new RuntimeException(sprintf('Uploaded file could not be moved to %s', $targetPath)); + } + + $filename = $this->getClientFilename(); + if ($filename) { + $this->flash->removeFile($filename, $this->field); + } + } + + public function getId(): string + { + return $this->id; + } + + /** + * @return string + */ + public function getField(): string + { + return $this->field; + } + + /** + * @return int + */ + public function getSize() + { + return $this->upload['size']; + } + + /** + * @return int + */ + public function getError() + { + return $this->upload['error'] ?? \UPLOAD_ERR_OK; + } + + /** + * @return string + */ + public function getClientFilename() + { + return $this->upload['name'] ?? 'unknown'; + } + + /** + * @return string + */ + public function getClientMediaType() + { + return $this->upload['type'] ?? 'application/octet-stream'; + } + + /** + * @return bool + */ + public function isMoved(): bool + { + return $this->moved; + } + + /** + * @return array + */ + public function getMetaData(): array + { + if (isset($this->upload['crop'])) { + return ['crop' => $this->upload['crop']]; + } + + return []; + } + + /** + * @return string + */ + public function getDestination() + { + return $this->upload['path'] ?? ''; + } + + /** + * @return array + */ + #[\ReturnTypeWillChange] + public function jsonSerialize() + { + return $this->upload; + } + + /** + * @return void + */ + public function checkXss(): void + { + $tmpFile = $this->getTmpFile(); + $mime = $this->getClientMediaType(); + if (Utils::contains($mime, 'svg', false)) { + $response = Security::detectXssFromSvgFile($tmpFile); + if ($response) { + throw new RuntimeException(sprintf('SVG file XSS check failed on %s', $response)); + } + } + } + + /** + * @return string|null + */ + public function getTmpFile(): ?string + { + $tmpName = $this->upload['tmp_name'] ?? null; + + if (!$tmpName) { + return null; + } + + $tmpFile = $this->flash->getTmpDir() . '/' . $tmpName; + + return file_exists($tmpFile) ? $tmpFile : null; + } + + /** + * @return array + */ + #[\ReturnTypeWillChange] + public function __debugInfo() + { + return [ + 'id:private' => $this->id, + 'field:private' => $this->field, + 'moved:private' => $this->moved, + 'upload:private' => $this->upload, + ]; + } + + /** + * @return void + * @throws RuntimeException if is moved or not ok + */ + private function validateActive(): void + { + if (!$this->isOk()) { + throw new RuntimeException('Cannot retrieve stream due to upload error'); + } + + if ($this->moved) { + throw new RuntimeException('Cannot retrieve stream after it has already been moved'); + } + + if (!$this->getTmpFile()) { + throw new RuntimeException('Cannot retrieve stream as the file is missing'); + } + } + + /** + * @return bool return true if there is no upload error + */ + private function isOk(): bool + { + return \UPLOAD_ERR_OK === $this->getError(); + } +} diff --git a/system/src/Grav/Framework/Form/Interfaces/FormFactoryInterface.php b/system/src/Grav/Framework/Form/Interfaces/FormFactoryInterface.php new file mode 100644 index 0000000..1bc2ca6 --- /dev/null +++ b/system/src/Grav/Framework/Form/Interfaces/FormFactoryInterface.php @@ -0,0 +1,42 @@ +|Data|null */ + private $data; + /** @var UploadedFileInterface[] */ + private $files = []; + /** @var FormFlashInterface|null */ + private $flash; + /** @var string */ + private $flashFolder; + /** @var Blueprint */ + private $blueprint; + + /** + * @return string + */ + public function getId(): string + { + return $this->id; + } + + /** + * @param string $id + */ + public function setId(string $id): void + { + $this->id = $id; + } + + /** + * @return void + */ + public function disable(): void + { + $this->enabled = false; + } + + /** + * @return void + */ + public function enable(): void + { + $this->enabled = true; + } + + /** + * @return bool + */ + public function isEnabled(): bool + { + return $this->enabled; + } + + /** + * @return string + */ + public function getUniqueId(): string + { + return $this->uniqueid; + } + + /** + * @param string $uniqueId + * @return void + */ + public function setUniqueId(string $uniqueId): void + { + $this->uniqueid = $uniqueId; + } + + /** + * @return string + */ + public function getName(): string + { + return $this->name; + } + + /** + * @return string + */ + public function getFormName(): string + { + return $this->name; + } + + /** + * @return string + */ + public function getNonceName(): string + { + return 'form-nonce'; + } + + /** + * @return string + */ + public function getNonceAction(): string + { + return 'form'; + } + + /** + * @return string + */ + public function getNonce(): string + { + return Utils::getNonce($this->getNonceAction()); + } + + /** + * @return string + */ + public function getAction(): string + { + return ''; + } + + /** + * @return string + */ + public function getTask(): string + { + return $this->getBlueprint()->get('form/task') ?? ''; + } + + /** + * @param string|null $name + * @return mixed + */ + public function getData(string $name = null) + { + return null !== $name ? $this->data[$name] : $this->data; + } + + /** + * @return array|UploadedFileInterface[] + */ + public function getFiles(): array + { + return $this->files; + } + + /** + * @param string $name + * @return mixed|null + */ + public function getValue(string $name) + { + return $this->data[$name] ?? null; + } + + /** + * @param string $name + * @return mixed|null + */ + public function getDefaultValue(string $name) + { + $path = explode('.', $name); + $offset = array_shift($path); + + $current = $this->getDefaultValues(); + + if (!isset($current[$offset])) { + return null; + } + + $current = $current[$offset]; + + while ($path) { + $offset = array_shift($path); + + if ((is_array($current) || $current instanceof ArrayAccess) && isset($current[$offset])) { + $current = $current[$offset]; + } elseif (is_object($current) && isset($current->{$offset})) { + $current = $current->{$offset}; + } else { + return null; + } + }; + + return $current; + } + + /** + * @return array + */ + public function getDefaultValues(): array + { + return $this->getBlueprint()->getDefaults(); + } + + /** + * @param ServerRequestInterface $request + * @return FormInterface|$this + */ + public function handleRequest(ServerRequestInterface $request): FormInterface + { + // Set current form to be active. + $grav = Grav::instance(); + $forms = $grav['forms'] ?? null; + if ($forms) { + $forms->setActiveForm($this); + + /** @var Twig $twig */ + $twig = $grav['twig']; + $twig->twig_vars['form'] = $this; + } + + try { + [$data, $files] = $this->parseRequest($request); + + $this->submit($data, $files); + } catch (Exception $e) { + /** @var Debugger $debugger */ + $debugger = $grav['debugger']; + $debugger->addException($e); + + $this->setError($e->getMessage()); + } + + return $this; + } + + /** + * @param ServerRequestInterface $request + * @return FormInterface|$this + */ + public function setRequest(ServerRequestInterface $request): FormInterface + { + [$data, $files] = $this->parseRequest($request); + + $this->data = new Data($data, $this->getBlueprint()); + $this->files = $files; + + return $this; + } + + /** + * @return bool + */ + public function isValid(): bool + { + return $this->status === 'success'; + } + + /** + * @return string|null + */ + public function getError(): ?string + { + return !$this->isValid() ? $this->message : null; + } + + /** + * @return array + */ + public function getErrors(): array + { + return !$this->isValid() ? $this->messages : []; + } + + /** + * @return bool + */ + public function isSubmitted(): bool + { + return $this->submitted; + } + + /** + * @return bool + */ + public function validate(): bool + { + if (!$this->isValid()) { + return false; + } + + try { + $this->validateData($this->data); + $this->validateUploads($this->getFiles()); + } catch (ValidationException $e) { + $this->setErrors($e->getMessages()); + } catch (Exception $e) { + /** @var Debugger $debugger */ + $debugger = Grav::instance()['debugger']; + $debugger->addException($e); + + $this->setError($e->getMessage()); + } + + $this->filterData($this->data); + + return $this->isValid(); + } + + /** + * @param array $data + * @param UploadedFileInterface[]|null $files + * @return FormInterface|$this + */ + public function submit(array $data, array $files = null): FormInterface + { + try { + if ($this->isSubmitted()) { + throw new RuntimeException('Form has already been submitted'); + } + + $this->data = new Data($data, $this->getBlueprint()); + $this->files = $files ?? []; + + if (!$this->validate()) { + return $this; + } + + $this->doSubmit($this->data->toArray(), $this->files); + + $this->submitted = true; + } catch (Exception $e) { + /** @var Debugger $debugger */ + $debugger = Grav::instance()['debugger']; + $debugger->addException($e); + + $this->setError($e->getMessage()); + } + + return $this; + } + + /** + * @return void + */ + public function reset(): void + { + // Make sure that the flash object gets deleted. + $this->getFlash()->delete(); + + $this->data = null; + $this->files = []; + $this->status = 'success'; + $this->message = null; + $this->messages = []; + $this->submitted = false; + $this->flash = null; + } + + /** + * @return array + */ + public function getFields(): array + { + return $this->getBlueprint()->fields(); + } + + /** + * @return array + */ + public function getButtons(): array + { + return $this->getBlueprint()->get('form/buttons') ?? []; + } + + /** + * @return array + */ + public function getTasks(): array + { + return $this->getBlueprint()->get('form/tasks') ?? []; + } + + /** + * @return Blueprint + */ + abstract public function getBlueprint(): Blueprint; + + /** + * Get form flash object. + * + * @return FormFlashInterface + */ + public function getFlash() + { + if (null === $this->flash) { + $grav = Grav::instance(); + $config = [ + 'session_id' => $this->getSessionId(), + 'unique_id' => $this->getUniqueId(), + 'form_name' => $this->getName(), + 'folder' => $this->getFlashFolder(), + 'id' => $this->getFlashId() + ]; + + $this->flash = new FormFlash($config); + $this->flash->setUrl($grav['uri']->url)->setUser($grav['user'] ?? null); + } + + return $this->flash; + } + + /** + * Get all available form flash objects for this form. + * + * @return FormFlashInterface[] + */ + public function getAllFlashes(): array + { + $folder = $this->getFlashFolder(); + if (!$folder || !is_dir($folder)) { + return []; + } + + $name = $this->getName(); + + $list = []; + /** @var SplFileInfo $file */ + foreach (new FilesystemIterator($folder) as $file) { + $uniqueId = $file->getFilename(); + $config = [ + 'session_id' => $this->getSessionId(), + 'unique_id' => $uniqueId, + 'form_name' => $name, + 'folder' => $this->getFlashFolder(), + 'id' => $this->getFlashId() + ]; + $flash = new FormFlash($config); + if ($flash->exists() && $flash->getFormName() === $name) { + $list[] = $flash; + } + } + + return $list; + } + + /** + * {@inheritdoc} + * @see FormInterface::render() + */ + public function render(string $layout = null, array $context = []) + { + if (null === $layout) { + $layout = 'default'; + } + + $grav = Grav::instance(); + + $block = HtmlBlock::create(); + $block->disableCache(); + + $output = $this->getTemplate($layout)->render( + ['grav' => $grav, 'config' => $grav['config'], 'block' => $block, 'form' => $this, 'layout' => $layout] + $context + ); + + $block->setContent($output); + + return $block; + } + + /** + * @return array + */ + public function jsonSerialize(): array + { + return $this->doSerialize(); + } + + /** + * @return array + */ + final public function __serialize(): array + { + return $this->doSerialize(); + } + + /** + * @param array $data + * @return void + */ + final public function __unserialize(array $data): void + { + $this->doUnserialize($data); + } + + protected function getSessionId(): string + { + if (null === $this->sessionid) { + /** @var Grav $grav */ + $grav = Grav::instance(); + + /** @var SessionInterface|null $session */ + $session = $grav['session'] ?? null; + + $this->sessionid = $session ? ($session->getId() ?? '') : ''; + } + + return $this->sessionid; + } + + /** + * @param string $sessionId + * @return void + */ + protected function setSessionId(string $sessionId): void + { + $this->sessionid = $sessionId; + } + + /** + * @return void + */ + protected function unsetFlash(): void + { + $this->flash = null; + } + + /** + * @return string|null + */ + protected function getFlashFolder(): ?string + { + $grav = Grav::instance(); + + /** @var UserInterface|null $user */ + $user = $grav['user'] ?? null; + if (null !== $user && $user->exists()) { + $username = $user->username; + $mediaFolder = $user->getMediaFolder(); + } else { + $username = null; + $mediaFolder = null; + } + $session = $grav['session'] ?? null; + $sessionId = $session ? $session->getId() : null; + + // Fill template token keys/value pairs. + $dataMap = [ + '[FORM_NAME]' => $this->getName(), + '[SESSIONID]' => $sessionId ?? '!!', + '[USERNAME]' => $username ?? '!!', + '[USERNAME_OR_SESSIONID]' => $username ?? $sessionId ?? '!!', + '[ACCOUNT]' => $mediaFolder ?? '!!' + ]; + + $flashLookupFolder = $this->getFlashLookupFolder(); + + $path = str_replace(array_keys($dataMap), array_values($dataMap), $flashLookupFolder); + + // Make sure we only return valid paths. + return strpos($path, '!!') === false ? rtrim($path, '/') : null; + } + + /** + * @return string|null + */ + protected function getFlashId(): ?string + { + // Fill template token keys/value pairs. + $dataMap = [ + '[FORM_NAME]' => $this->getName(), + '[SESSIONID]' => 'session', + '[USERNAME]' => '!!', + '[USERNAME_OR_SESSIONID]' => '!!', + '[ACCOUNT]' => 'account' + ]; + + $flashLookupFolder = $this->getFlashLookupFolder(); + + $path = str_replace(array_keys($dataMap), array_values($dataMap), $flashLookupFolder); + + // Make sure we only return valid paths. + return strpos($path, '!!') === false ? rtrim($path, '/') : null; + } + + /** + * @return string + */ + protected function getFlashLookupFolder(): string + { + if (null === $this->flashFolder) { + $this->flashFolder = $this->getBlueprint()->get('form/flash_folder') ?? 'tmp://forms/[SESSIONID]'; + } + + return $this->flashFolder; + } + + /** + * @param string $folder + * @return void + */ + protected function setFlashLookupFolder(string $folder): void + { + $this->flashFolder = $folder; + } + + /** + * Set a single error. + * + * @param string $error + * @return void + */ + protected function setError(string $error): void + { + $this->status = 'error'; + $this->message = $error; + } + + /** + * Set all errors. + * + * @param array $errors + * @return void + */ + protected function setErrors(array $errors): void + { + $this->status = 'error'; + $this->messages = $errors; + } + + /** + * @param string $layout + * @return Template|TemplateWrapper + * @throws LoaderError + * @throws SyntaxError + */ + protected function getTemplate($layout) + { + $grav = Grav::instance(); + + /** @var Twig $twig */ + $twig = $grav['twig']; + + return $twig->twig()->resolveTemplate( + [ + "forms/{$layout}/form.html.twig", + 'forms/default/form.html.twig' + ] + ); + } + + /** + * Parse PSR-7 ServerRequest into data and files. + * + * @param ServerRequestInterface $request + * @return array + */ + protected function parseRequest(ServerRequestInterface $request): array + { + $method = $request->getMethod(); + if (!in_array($method, ['PUT', 'POST', 'PATCH'])) { + throw new RuntimeException(sprintf('FlexForm: Bad HTTP method %s', $method)); + } + + $body = (array)$request->getParsedBody(); + $data = isset($body['data']) ? $this->decodeData($body['data']) : null; + + $flash = $this->getFlash(); + /* + if (null !== $data) { + $flash->setData($data); + $flash->save(); + } + */ + + $blueprint = $this->getBlueprint(); + $includeOriginal = (bool)($blueprint->form()['images']['original'] ?? null); + $files = $flash->getFilesByFields($includeOriginal); + + $data = $blueprint->processForm($data ?? [], $body['toggleable_data'] ?? []); + + return [ + $data, + $files + ]; + } + + /** + * Validate data and throw validation exceptions if validation fails. + * + * @param ArrayAccess|Data|null $data + * @return void + * @throws ValidationException + * @phpstan-param ArrayAccess|Data|null $data + * @throws Exception + */ + protected function validateData($data = null): void + { + if ($data instanceof Data) { + $data->validate(); + } + } + + /** + * Filter validated data. + * + * @param ArrayAccess|Data|null $data + * @return void + * @phpstan-param ArrayAccess|Data|null $data + */ + protected function filterData($data = null): void + { + if ($data instanceof Data) { + $data->filter(); + } + } + + /** + * Validate all uploaded files. + * + * @param array $files + * @return void + */ + protected function validateUploads(array $files): void + { + foreach ($files as $file) { + if (null === $file) { + continue; + } + if ($file instanceof UploadedFileInterface) { + $this->validateUpload($file); + } else { + $this->validateUploads($file); + } + } + } + + /** + * Validate uploaded file. + * + * @param UploadedFileInterface $file + * @return void + */ + protected function validateUpload(UploadedFileInterface $file): void + { + // Handle bad filenames. + $filename = $file->getClientFilename(); + if ($filename && !Utils::checkFilename($filename)) { + $grav = Grav::instance(); + throw new RuntimeException( + sprintf($grav['language']->translate('PLUGIN_FORM.FILEUPLOAD_UNABLE_TO_UPLOAD', null, true), $filename, 'Bad filename') + ); + } + + if ($file instanceof FormFlashFile) { + $file->checkXss(); + } + } + + /** + * Decode POST data + * + * @param array $data + * @return array + */ + protected function decodeData($data): array + { + if (!is_array($data)) { + return []; + } + + // Decode JSON encoded fields and merge them to data. + if (isset($data['_json'])) { + $data = array_replace_recursive($data, $this->jsonDecode($data['_json'])); + + unset($data['_json']); + } + + return $data; + } + + /** + * Recursively JSON decode POST data. + * + * @param array $data + * @return array + */ + protected function jsonDecode(array $data): array + { + foreach ($data as $key => &$value) { + if (is_array($value)) { + $value = $this->jsonDecode($value); + } elseif (trim($value) === '') { + unset($data[$key]); + } else { + $value = json_decode($value, true); + if ($value === null && json_last_error() !== JSON_ERROR_NONE) { + unset($data[$key]); + $this->setError("Badly encoded JSON data (for {$key}) was sent to the form"); + } + } + } + + return $data; + } + + /** + * @return array + */ + protected function doSerialize(): array + { + $data = $this->data instanceof Data ? $this->data->toArray() : null; + + return [ + 'name' => $this->name, + 'id' => $this->id, + 'uniqueid' => $this->uniqueid, + 'submitted' => $this->submitted, + 'status' => $this->status, + 'message' => $this->message, + 'messages' => $this->messages, + 'data' => $data, + 'files' => $this->files, + ]; + } + + /** + * @param array $data + * @return void + */ + protected function doUnserialize(array $data): void + { + $this->name = $data['name']; + $this->id = $data['id']; + $this->uniqueid = $data['uniqueid']; + $this->submitted = $data['submitted'] ?? false; + $this->status = $data['status'] ?? 'success'; + $this->message = $data['message'] ?? null; + $this->messages = $data['messages'] ?? []; + $this->data = isset($data['data']) ? new Data($data['data'], $this->getBlueprint()) : null; + $this->files = $data['files'] ?? []; + } +} diff --git a/system/src/Grav/Framework/Interfaces/RenderInterface.php b/system/src/Grav/Framework/Interfaces/RenderInterface.php new file mode 100644 index 0000000..0cefae3 --- /dev/null +++ b/system/src/Grav/Framework/Interfaces/RenderInterface.php @@ -0,0 +1,38 @@ +render('custom', ['variable' => 'value']); + * @example {% render object layout 'custom' with { variable: 'value' } %} + * + * @param string|null $layout Layout to be used. + * @param array $context Extra context given to the renderer. + * + * @return ContentBlockInterface|HtmlBlock Returns `HtmlBlock` containing the rendered output. + * @api + */ + public function render(string $layout = null, array $context = []); +} diff --git a/system/src/Grav/Framework/Logger/Processors/UserProcessor.php b/system/src/Grav/Framework/Logger/Processors/UserProcessor.php new file mode 100644 index 0000000..b42c09e --- /dev/null +++ b/system/src/Grav/Framework/Logger/Processors/UserProcessor.php @@ -0,0 +1,34 @@ +exists()) { + $record['extra']['user'] = ['username' => $user->username, 'email' => $user->email]; + } + + return $record; + } +} diff --git a/system/src/Grav/Framework/Media/Interfaces/MediaCollectionInterface.php b/system/src/Grav/Framework/Media/Interfaces/MediaCollectionInterface.php new file mode 100644 index 0000000..f0b5636 --- /dev/null +++ b/system/src/Grav/Framework/Media/Interfaces/MediaCollectionInterface.php @@ -0,0 +1,23 @@ + + * @extends Iterator + */ +interface MediaCollectionInterface extends ArrayAccess, Countable, Iterator +{ +} diff --git a/system/src/Grav/Framework/Media/Interfaces/MediaInterface.php b/system/src/Grav/Framework/Media/Interfaces/MediaInterface.php new file mode 100644 index 0000000..a4c0d0d --- /dev/null +++ b/system/src/Grav/Framework/Media/Interfaces/MediaInterface.php @@ -0,0 +1,37 @@ +get('this.is.my.nested.variable'); + * + * @param string $name Dot separated path to the requested value. + * @param mixed $default Default value (or null). + * @param string|null $separator Separator, defaults to '.' + * @return mixed Value. + */ + public function get($name, $default = null, $separator = null); +} diff --git a/system/src/Grav/Framework/Media/MediaIdentifier.php b/system/src/Grav/Framework/Media/MediaIdentifier.php new file mode 100644 index 0000000..986e997 --- /dev/null +++ b/system/src/Grav/Framework/Media/MediaIdentifier.php @@ -0,0 +1,150 @@ + + */ +class MediaIdentifier extends Identifier +{ + /** @var MediaObjectInterface|null */ + private $object = null; + + /** + * @param MediaObjectInterface $object + * @return MediaIdentifier + */ + public static function createFromObject(MediaObjectInterface $object): MediaIdentifier + { + $instance = new static($object->getId()); + $instance->setObject($object); + + return $instance; + } + + /** + * @param string $id + */ + public function __construct(string $id) + { + parent::__construct($id, 'media'); + } + + /** + * @return T + */ + public function getObject(): ?MediaObjectInterface + { + if (!isset($this->object)) { + $type = $this->getType(); + $id = $this->getId(); + + $parts = explode('/', $id); + if ($type === 'media' && str_starts_with($id, 'uploads/')) { + array_shift($parts); + [, $folder, $uniqueId, $field, $filename] = $this->findFlash($parts); + + $flash = $this->getFlash($folder, $uniqueId); + if ($flash->exists()) { + + $uploadedFile = $flash->getFilesByField($field)[$filename] ?? null; + + $this->object = UploadedMediaObject::createFromFlash($flash, $field, $filename, $uploadedFile); + } + } else { + $type = array_shift($parts); + $key = array_shift($parts); + $field = array_shift($parts); + $filename = implode('/', $parts); + + $flexObject = $this->getFlexObject($type, $key); + if ($flexObject && method_exists($flexObject, 'getMediaField') && method_exists($flexObject, 'getMedia')) { + $media = $field !== 'media' ? $flexObject->getMediaField($field) : $flexObject->getMedia(); + $image = null; + if ($media) { + $image = $media[$filename]; + } + + $this->object = new MediaObject($field, $filename, $image, $flexObject); + } + } + + if (!isset($this->object)) { + throw new \RuntimeException(sprintf('Object not found for identifier {type: "%s", id: "%s"}', $type, $id)); + } + } + + return $this->object; + } + + /** + * @param T $object + */ + public function setObject(MediaObjectInterface $object): void + { + $type = $this->getType(); + $objectType = $object->getType(); + + if ($type !== $objectType) { + throw new \RuntimeException(sprintf('Object has to be type %s, %s given', $type, $objectType)); + } + + $this->object = $object; + } + + protected function findFlash(array $parts): ?array + { + $type = array_shift($parts); + if ($type === 'account') { + /** @var UserInterface|null $user */ + $user = Grav::instance()['user'] ?? null; + $folder = $user->getMediaFolder(); + } else { + $folder = 'tmp://'; + } + + if (!$folder) { + return null; + } + + do { + $part = array_shift($parts); + $folder .= "/{$part}"; + } while (!str_starts_with($part, 'flex-')); + + $uniqueId = array_shift($parts); + $field = array_shift($parts); + $filename = implode('/', $parts); + + return [$type, $folder, $uniqueId, $field, $filename]; + } + + protected function getFlash(string $folder, string $uniqueId): FlexFormFlash + { + $config = [ + 'unique_id' => $uniqueId, + 'folder' => $folder + ]; + + return new FlexFormFlash($config); + } + + protected function getFlexObject(string $type, string $key): ?FlexObjectInterface + { + /** @var Flex $flex */ + $flex = Grav::instance()['flex']; + + return $flex->getObject($key, $type); + } +} diff --git a/system/src/Grav/Framework/Media/MediaObject.php b/system/src/Grav/Framework/Media/MediaObject.php new file mode 100644 index 0000000..8a438bf --- /dev/null +++ b/system/src/Grav/Framework/Media/MediaObject.php @@ -0,0 +1,215 @@ +field = $field; + $this->filename = $filename; + $this->media = $media; + $this->object = $object; + } + + /** + * @return string + */ + public function getType(): string + { + return 'media'; + } + + /** + * @return string + */ + public function getId(): string + { + $field = $this->field; + $object = $this->object; + $path = $field ? "/{$field}/" : '/media/'; + + return $object->getType() . '/' . $object->getKey() . $path . basename($this->filename); + } + + /** + * @return bool + */ + public function exists(): bool + { + return $this->media !== null; + } + + /** + * @return array + */ + public function getMeta(): array + { + if (!isset($this->media)) { + return []; + } + + return $this->media->getMeta(); + } + + /** + * @param string $field + * @return mixed|null + */ + public function get(string $field) + { + if (!isset($this->media)) { + return null; + } + + return $this->media->get($field); + } + + /** + * @return string + */ + public function getUrl(): string + { + if (!isset($this->media)) { + return ''; + } + + return $this->media->url(); + } + + /** + * Create media response. + * + * @param array $actions + * @return Response + */ + public function createResponse(array $actions): ResponseInterface + { + if (!isset($this->media)) { + return $this->create404Response($actions); + } + + $media = $this->media; + + if ($actions) { + $media = $this->processMediaActions($media, $actions); + } + + // FIXME: This only works for images + if (!$media instanceof ImageMedium) { + throw new \RuntimeException('Not Implemented', 500); + } + + $filename = $media->path(false); + $time = filemtime($filename); + $size = filesize($filename); + $body = fopen($filename, 'rb'); + $headers = [ + 'Content-Type' => $media->get('mime'), + 'Last-Modified' => gmdate('D, d M Y H:i:s', $time) . ' GMT', + 'ETag' => sprintf('%x-%x', $size, $time) + ]; + + return new Response(200, $headers, $body); + } + + /** + * Process media actions + * + * @param GravMediaObjectInterface $medium + * @param array $actions + * @return GravMediaObjectInterface + */ + protected function processMediaActions(GravMediaObjectInterface $medium, array $actions): GravMediaObjectInterface + { + // loop through actions for the image and call them + foreach ($actions as $method => $params) { + $matches = []; + + if (preg_match('/\[(.*)]/', $params, $matches)) { + $args = [explode(',', $matches[1])]; + } else { + $args = explode(',', $params); + } + + try { + $medium->{$method}(...$args); + } catch (Throwable $e) { + // Ignore all errors for now and just skip the action. + } + } + + return $medium; + } + + /** + * @param array $actions + * @return Response + */ + protected function create404Response(array $actions): Response + { + // Display placeholder image. + $filename = static::$placeholderImage; + + $time = filemtime($filename); + $size = filesize($filename); + $body = fopen($filename, 'rb'); + $headers = [ + 'Content-Type' => 'image/svg', + 'Last-Modified' => gmdate('D, d M Y H:i:s', $time) . ' GMT', + 'ETag' => sprintf('%x-%x', $size, $time) + ]; + + return new Response(404, $headers, $body); + } + + /** + * @return array + */ + public function jsonSerialize(): array + { + return [ + 'type' => $this->getType(), + 'id' => $this->getId() + ]; + } + + /** + * @return string[] + */ + public function __debugInfo(): array + { + return $this->jsonSerialize(); + } +} diff --git a/system/src/Grav/Framework/Media/UploadedMediaObject.php b/system/src/Grav/Framework/Media/UploadedMediaObject.php new file mode 100644 index 0000000..0fe12e1 --- /dev/null +++ b/system/src/Grav/Framework/Media/UploadedMediaObject.php @@ -0,0 +1,172 @@ +getId(); + + return new static($id, $field, $filename, $uploadedFile); + } + + /** + * @param string $id + * @param string|null $field + * @param string $filename + * @param UploadedFileInterface|null $uploadedFile + */ + public function __construct(string $id, ?string $field, string $filename, ?UploadedFileInterface $uploadedFile = null) + { + $this->id = $id; + $this->field = $field; + $this->filename = $filename; + $this->uploadedFile = $uploadedFile; + if ($uploadedFile) { + $this->meta = [ + 'filename' => $uploadedFile->getClientFilename(), + 'mime' => $uploadedFile->getClientMediaType(), + 'size' => $uploadedFile->getSize() + ]; + } else { + $this->meta = []; + } + } + + /** + * @return string + */ + public function getType(): string + { + return 'media'; + } + + /** + * @return string + */ + public function getId(): string + { + $id = $this->id; + $field = $this->field; + $path = $field ? "/{$field}/" : ''; + + return 'uploads/' . $id . $path . basename($this->filename); + } + + /** + * @return bool + */ + public function exists(): bool + { + //return $this->uploadedFile !== null; + return false; + } + + /** + * @return array + */ + public function getMeta(): array + { + return $this->meta; + } + + /** + * @param string $field + * @return mixed|null + */ + public function get(string $field) + { + return $this->meta[$field] ?? null; + } + + /** + * @return string + */ + public function getUrl(): string + { + return ''; + } + + /** + * @return UploadedFileInterface|null + */ + public function getUploadedFile(): ?UploadedFileInterface + { + return $this->uploadedFile; + } + + /** + * @param array $actions + * @return Response + */ + public function createResponse(array $actions): ResponseInterface + { + // Display placeholder image. + $filename = static::$placeholderImage; + + $time = filemtime($filename); + $size = filesize($filename); + $body = fopen($filename, 'rb'); + $headers = [ + 'Content-Type' => 'image/svg', + 'Last-Modified' => gmdate('D, d M Y H:i:s', $time) . ' GMT', + 'ETag' => sprintf('%x-%x', $size, $time) + ]; + + return new Response(404, $headers, $body); + } + + /** + * @return array + */ + public function jsonSerialize(): array + { + return [ + 'type' => $this->getType(), + 'id' => $this->getId() + ]; + } + + /** + * @return string[] + */ + public function __debugInfo(): array + { + return $this->jsonSerialize(); + } +} diff --git a/system/src/Grav/Framework/Mime/MimeTypes.php b/system/src/Grav/Framework/Mime/MimeTypes.php new file mode 100644 index 0000000..bc81f92 --- /dev/null +++ b/system/src/Grav/Framework/Mime/MimeTypes.php @@ -0,0 +1,107 @@ + ['mime/type', 'mime/type2']] + */ + public static function createFromMimes(array $mimes): self + { + $extensions = []; + foreach ($mimes as $ext => $list) { + foreach ($list as $mime) { + $list = $extensions[$mime] ?? []; + if (!in_array($ext, $list, true)) { + $list[] = $ext; + $extensions[$mime] = $list; + } + } + } + + return new static($extensions, $mimes); + } + + /** + * @param string $extension + * @return string|null + */ + public function getMimeType(string $extension): ?string + { + $extension = $this->cleanInput($extension); + + return $this->mimes[$extension][0] ?? null; + } + + /** + * @param string $mime + * @return string|null + */ + public function getExtension(string $mime): ?string + { + $mime = $this->cleanInput($mime); + + return $this->extensions[$mime][0] ?? null; + } + + /** + * @param string $extension + * @return array + */ + public function getMimeTypes(string $extension): array + { + $extension = $this->cleanInput($extension); + + return $this->mimes[$extension] ?? []; + } + + /** + * @param string $mime + * @return array + */ + public function getExtensions(string $mime): array + { + $mime = $this->cleanInput($mime); + + return $this->extensions[$mime] ?? []; + } + + /** + * @param string $input + * @return string + */ + protected function cleanInput(string $input): string + { + return strtolower(trim($input)); + } + + /** + * @param array $extensions + * @param array $mimes + */ + protected function __construct(array $extensions, array $mimes) + { + $this->extensions = $extensions; + $this->mimes = $mimes; + } +} diff --git a/system/src/Grav/Framework/Object/Access/ArrayAccessTrait.php b/system/src/Grav/Framework/Object/Access/ArrayAccessTrait.php new file mode 100644 index 0000000..de6c6b9 --- /dev/null +++ b/system/src/Grav/Framework/Object/Access/ArrayAccessTrait.php @@ -0,0 +1,66 @@ +hasProperty($offset); + } + + /** + * Returns the value at specified offset. + * + * @param mixed $offset The offset to retrieve. + * @return mixed Can return all value types. + */ + #[\ReturnTypeWillChange] + public function offsetGet($offset) + { + return $this->getProperty($offset); + } + + /** + * Assigns a value to the specified offset. + * + * @param mixed $offset The offset to assign the value to. + * @param mixed $value The value to set. + * @return void + */ + #[\ReturnTypeWillChange] + public function offsetSet($offset, $value) + { + $this->setProperty($offset, $value); + } + + /** + * Unsets an offset. + * + * @param mixed $offset The offset to unset. + * @return void + */ + #[\ReturnTypeWillChange] + public function offsetUnset($offset) + { + $this->unsetProperty($offset); + } +} diff --git a/system/src/Grav/Framework/Object/Access/NestedArrayAccessTrait.php b/system/src/Grav/Framework/Object/Access/NestedArrayAccessTrait.php new file mode 100644 index 0000000..938ec26 --- /dev/null +++ b/system/src/Grav/Framework/Object/Access/NestedArrayAccessTrait.php @@ -0,0 +1,66 @@ +hasNestedProperty($offset); + } + + /** + * Returns the value at specified offset. + * + * @param mixed $offset The offset to retrieve. + * @return mixed Can return all value types. + */ + #[\ReturnTypeWillChange] + public function offsetGet($offset) + { + return $this->getNestedProperty($offset); + } + + /** + * Assigns a value to the specified offset. + * + * @param mixed $offset The offset to assign the value to. + * @param mixed $value The value to set. + * @return void + */ + #[\ReturnTypeWillChange] + public function offsetSet($offset, $value) + { + $this->setNestedProperty($offset, $value); + } + + /** + * Unsets an offset. + * + * @param mixed $offset The offset to unset. + * @return void + */ + #[\ReturnTypeWillChange] + public function offsetUnset($offset) + { + $this->unsetNestedProperty($offset); + } +} diff --git a/system/src/Grav/Framework/Object/Access/NestedPropertyCollectionTrait.php b/system/src/Grav/Framework/Object/Access/NestedPropertyCollectionTrait.php new file mode 100644 index 0000000..1d749e3 --- /dev/null +++ b/system/src/Grav/Framework/Object/Access/NestedPropertyCollectionTrait.php @@ -0,0 +1,120 @@ +getIterator() as $id => $element) { + $list[$id] = $element->hasNestedProperty($property, $separator); + } + + return $list; + } + + /** + * @param string $property Object property to be fetched. + * @param mixed $default Default value if not set. + * @param string|null $separator Separator, defaults to '.' + * @return array Key/Value pairs of the properties. + */ + public function getNestedProperty($property, $default = null, $separator = null) + { + $list = []; + + /** @var NestedObjectInterface $element */ + foreach ($this->getIterator() as $id => $element) { + $list[$id] = $element->getNestedProperty($property, $default, $separator); + } + + return $list; + } + + /** + * @param string $property Object property to be updated. + * @param mixed $value New value. + * @param string|null $separator Separator, defaults to '.' + * @return $this + */ + public function setNestedProperty($property, $value, $separator = null) + { + /** @var NestedObjectInterface $element */ + foreach ($this->getIterator() as $element) { + $element->setNestedProperty($property, $value, $separator); + } + + return $this; + } + + /** + * @param string $property Object property to be updated. + * @param string|null $separator Separator, defaults to '.' + * @return $this + */ + public function unsetNestedProperty($property, $separator = null) + { + /** @var NestedObjectInterface $element */ + foreach ($this->getIterator() as $element) { + $element->unsetNestedProperty($property, $separator); + } + + return $this; + } + + /** + * @param string $property Object property to be updated. + * @param string $default Default value. + * @param string|null $separator Separator, defaults to '.' + * @return $this + */ + public function defNestedProperty($property, $default, $separator = null) + { + /** @var NestedObjectInterface $element */ + foreach ($this->getIterator() as $element) { + $element->defNestedProperty($property, $default, $separator); + } + + return $this; + } + + /** + * Group items in the collection by a field. + * + * @param string $property Object property to be used to make groups. + * @param string|null $separator Separator, defaults to '.' + * @return array + */ + public function group($property, $separator = null) + { + $list = []; + + /** @var NestedObjectInterface $element */ + foreach ($this->getIterator() as $element) { + $list[(string) $element->getNestedProperty($property, null, $separator)][] = $element; + } + + return $list; + } +} diff --git a/system/src/Grav/Framework/Object/Access/NestedPropertyTrait.php b/system/src/Grav/Framework/Object/Access/NestedPropertyTrait.php new file mode 100644 index 0000000..3bfebe0 --- /dev/null +++ b/system/src/Grav/Framework/Object/Access/NestedPropertyTrait.php @@ -0,0 +1,180 @@ +getNestedProperty($property, $test, $separator) !== $test; + } + + /** + * @param string $property Object property to be fetched. + * @param mixed|null $default Default value if property has not been set. + * @param string|null $separator Separator, defaults to '.' + * @return mixed Property value. + */ + public function getNestedProperty($property, $default = null, $separator = null) + { + $separator = $separator ?: '.'; + $path = explode($separator, (string) $property); + $offset = array_shift($path); + + if (!$this->hasProperty($offset)) { + return $default; + } + + $current = $this->getProperty($offset); + + while ($path) { + // Get property of nested Object. + if ($current instanceof ObjectInterface) { + if (method_exists($current, 'getNestedProperty')) { + return $current->getNestedProperty(implode($separator, $path), $default, $separator); + } + return $current->getProperty(implode($separator, $path), $default); + } + + $offset = array_shift($path); + + if ((is_array($current) || is_a($current, 'ArrayAccess')) && isset($current[$offset])) { + $current = $current[$offset]; + } elseif (is_object($current) && isset($current->{$offset})) { + $current = $current->{$offset}; + } else { + return $default; + } + }; + + return $current; + } + + + /** + * @param string $property Object property to be updated. + * @param mixed $value New value. + * @param string|null $separator Separator, defaults to '.' + * @return $this + * @throws RuntimeException + */ + public function setNestedProperty($property, $value, $separator = null) + { + $separator = $separator ?: '.'; + $path = explode($separator, $property); + $offset = array_shift($path); + + if (!$path) { + $this->setProperty($offset, $value); + + return $this; + } + + $current = &$this->doGetProperty($offset, null, true); + + while ($path) { + $offset = array_shift($path); + + // Handle arrays and scalars. + if ($current === null) { + $current = [$offset => []]; + } elseif (is_array($current)) { + if (!isset($current[$offset])) { + $current[$offset] = []; + } + } else { + throw new RuntimeException("Cannot set nested property {$property} on non-array value"); + } + + $current = &$current[$offset]; + }; + + $current = $value; + + return $this; + } + + /** + * @param string $property Object property to be updated. + * @param string|null $separator Separator, defaults to '.' + * @return $this + * @throws RuntimeException + */ + public function unsetNestedProperty($property, $separator = null) + { + $separator = $separator ?: '.'; + $path = explode($separator, $property); + $offset = array_shift($path); + + if (!$path) { + $this->unsetProperty($offset); + + return $this; + } + + $last = array_pop($path); + $current = &$this->doGetProperty($offset, null, true); + + while ($path) { + $offset = array_shift($path); + + // Handle arrays and scalars. + if ($current === null) { + return $this; + } + if (is_array($current)) { + if (!isset($current[$offset])) { + return $this; + } + } else { + throw new RuntimeException("Cannot unset nested property {$property} on non-array value"); + } + + $current = &$current[$offset]; + }; + + unset($current[$last]); + + return $this; + } + + /** + * @param string $property Object property to be updated. + * @param mixed $default Default value. + * @param string|null $separator Separator, defaults to '.' + * @return $this + * @throws RuntimeException + */ + public function defNestedProperty($property, $default, $separator = null) + { + if (!$this->hasNestedProperty($property, $separator)) { + $this->setNestedProperty($property, $default, $separator); + } + + return $this; + } +} diff --git a/system/src/Grav/Framework/Object/Access/OverloadedPropertyTrait.php b/system/src/Grav/Framework/Object/Access/OverloadedPropertyTrait.php new file mode 100644 index 0000000..428473a --- /dev/null +++ b/system/src/Grav/Framework/Object/Access/OverloadedPropertyTrait.php @@ -0,0 +1,66 @@ +hasProperty($offset); + } + + /** + * Returns the value at specified offset. + * + * @param mixed $offset The offset to retrieve. + * @return mixed Can return all value types. + */ + #[\ReturnTypeWillChange] + public function __get($offset) + { + return $this->getProperty($offset); + } + + /** + * Assigns a value to the specified offset. + * + * @param mixed $offset The offset to assign the value to. + * @param mixed $value The value to set. + * @return void + */ + #[\ReturnTypeWillChange] + public function __set($offset, $value) + { + $this->setProperty($offset, $value); + } + + /** + * Magic method to unset the attribute + * + * @param mixed $offset The name value to unset + * @return void + */ + #[\ReturnTypeWillChange] + public function __unset($offset) + { + $this->unsetProperty($offset); + } +} diff --git a/system/src/Grav/Framework/Object/ArrayObject.php b/system/src/Grav/Framework/Object/ArrayObject.php new file mode 100644 index 0000000..e8d258a --- /dev/null +++ b/system/src/Grav/Framework/Object/ArrayObject.php @@ -0,0 +1,31 @@ + + */ +class ArrayObject implements NestedObjectInterface, ArrayAccess +{ + use ObjectTrait; + use ArrayPropertyTrait; + use NestedPropertyTrait; + use OverloadedPropertyTrait; + use NestedArrayAccessTrait; +} diff --git a/system/src/Grav/Framework/Object/Base/ObjectCollectionTrait.php b/system/src/Grav/Framework/Object/Base/ObjectCollectionTrait.php new file mode 100644 index 0000000..4c7f621 --- /dev/null +++ b/system/src/Grav/Framework/Object/Base/ObjectCollectionTrait.php @@ -0,0 +1,377 @@ +getTypePrefix() : ''; + + if (static::$type) { + return $type . static::$type; + } + + $class = get_class($this); + + return $type . strtolower(substr($class, strrpos($class, '\\') + 1)); + } + + /** + * @return string + */ + public function getKey() + { + return $this->_key ?: $this->getType() . '@@' . spl_object_hash($this); + } + + /** + * @return bool + */ + public function hasKey() + { + return !empty($this->_key); + } + + /** + * @param string $property Object property name. + * @return bool[] True if property has been defined (can be null). + */ + public function hasProperty($property) + { + return $this->doHasProperty($property); + } + + /** + * @param string $property Object property to be fetched. + * @param mixed $default Default value if property has not been set. + * @return mixed[] Property values. + */ + public function getProperty($property, $default = null) + { + return $this->doGetProperty($property, $default); + } + + /** + * @param string $property Object property to be updated. + * @param mixed $value New value. + * @return $this + */ + public function setProperty($property, $value) + { + $this->doSetProperty($property, $value); + + return $this; + } + + /** + * @param string $property Object property to be unset. + * @return $this + */ + public function unsetProperty($property) + { + $this->doUnsetProperty($property); + + return $this; + } + + /** + * @param string $property Object property to be defined. + * @param mixed $default Default value. + * @return $this + */ + public function defProperty($property, $default) + { + if (!$this->hasProperty($property)) { + $this->setProperty($property, $default); + } + + return $this; + } + + /** + * @return array + */ + final public function __serialize(): array + { + return $this->doSerialize(); + } + + /** + * @param array $data + * @return void + */ + final public function __unserialize(array $data): void + { + if (method_exists($this, 'initObjectProperties')) { + $this->initObjectProperties(); + } + + $this->doUnserialize($data); + } + + + /** + * @return array + */ + protected function doSerialize() + { + return [ + 'key' => $this->getKey(), + 'type' => $this->getType(), + 'elements' => $this->getElements() + ]; + } + + /** + * @param array $data + * @return void + */ + protected function doUnserialize(array $data) + { + if (!isset($data['key'], $data['type'], $data['elements']) || $data['type'] !== $this->getType()) { + throw new InvalidArgumentException("Cannot unserialize '{$this->getType()}': Bad data"); + } + + $this->setKey($data['key']); + $this->setElements($data['elements']); + } + + /** + * Implements JsonSerializable interface. + * + * @return array + */ + #[\ReturnTypeWillChange] + public function jsonSerialize() + { + return $this->doSerialize(); + } + + /** + * Returns a string representation of this object. + * + * @return string + */ + #[\ReturnTypeWillChange] + public function __toString() + { + return $this->getKey(); + } + + /** + * @param string $key + * @return $this + */ + public function setKey($key) + { + $this->_key = (string) $key; + + return $this; + } + + /** + * Create a copy from this collection by cloning all objects in the collection. + * + * @return static + */ + public function copy() + { + $list = []; + foreach ($this->getIterator() as $key => $value) { + /** @phpstan-ignore-next-line */ + $list[$key] = is_object($value) ? clone $value : $value; + } + + /** @phpstan-var static */ + return $this->createFrom($list); + } + + /** + * @return string[] + */ + public function getObjectKeys() + { + return $this->call('getKey'); + } + + /** + * @param string $property Object property to be matched. + * @return bool[] Key/Value pairs of the properties. + */ + public function doHasProperty($property) + { + $list = []; + + /** @var ObjectInterface $element */ + foreach ($this->getIterator() as $id => $element) { + $list[$id] = (bool)$element->hasProperty($property); + } + + return $list; + } + + /** + * @param string $property Object property to be fetched. + * @param mixed $default Default value if not set. + * @param bool $doCreate Not being used. + * @return mixed[] Key/Value pairs of the properties. + */ + public function &doGetProperty($property, $default = null, $doCreate = false) + { + $list = []; + + /** @var ObjectInterface $element */ + foreach ($this->getIterator() as $id => $element) { + $list[$id] = $element->getProperty($property, $default); + } + + return $list; + } + + /** + * @param string $property Object property to be updated. + * @param mixed $value New value. + * @return $this + */ + public function doSetProperty($property, $value) + { + /** @var ObjectInterface $element */ + foreach ($this->getIterator() as $element) { + $element->setProperty($property, $value); + } + + return $this; + } + + /** + * @param string $property Object property to be updated. + * @return $this + */ + public function doUnsetProperty($property) + { + /** @var ObjectInterface $element */ + foreach ($this->getIterator() as $element) { + $element->unsetProperty($property); + } + + return $this; + } + + /** + * @param string $property Object property to be updated. + * @param mixed $default Default value. + * @return $this + */ + public function doDefProperty($property, $default) + { + /** @var ObjectInterface $element */ + foreach ($this->getIterator() as $element) { + $element->defProperty($property, $default); + } + + return $this; + } + + /** + * @param string $method Method name. + * @param array $arguments List of arguments passed to the function. + * @return mixed[] Return values. + */ + public function call($method, array $arguments = []) + { + $list = []; + + /** + * @var string|int $id + * @var ObjectInterface $element + */ + foreach ($this->getIterator() as $id => $element) { + $callable = [$element, $method]; + $list[$id] = is_callable($callable) ? call_user_func_array($callable, $arguments) : null; + } + + return $list; + } + + /** + * Group items in the collection by a field and return them as associated array. + * + * @param string $property + * @return array + * @phpstan-return array + */ + public function group($property) + { + $list = []; + + /** @var ObjectInterface $element */ + foreach ($this->getIterator() as $element) { + $list[(string) $element->getProperty($property)][] = $element; + } + + return $list; + } + + /** + * Group items in the collection by a field and return them as associated array of collections. + * + * @param string $property + * @return static[] + * @phpstan-return array> + */ + public function collectionGroup($property) + { + $collections = []; + foreach ($this->group($property) as $id => $elements) { + /** @phpstan-var static $collection */ + $collection = $this->createFrom($elements); + + $collections[$id] = $collection; + } + + return $collections; + } +} diff --git a/system/src/Grav/Framework/Object/Base/ObjectTrait.php b/system/src/Grav/Framework/Object/Base/ObjectTrait.php new file mode 100644 index 0000000..522e514 --- /dev/null +++ b/system/src/Grav/Framework/Object/Base/ObjectTrait.php @@ -0,0 +1,202 @@ +getTypePrefix() : ''; + + if (static::$type) { + return $type . static::$type; + } + + $class = get_class($this); + return $type . strtolower(substr($class, strrpos($class, '\\') + 1)); + } + + /** + * @return string + */ + public function getKey() + { + return $this->_key ?: $this->getType() . '@@' . spl_object_hash($this); + } + + /** + * @return bool + */ + public function hasKey() + { + return !empty($this->_key); + } + + /** + * @param string $property Object property name. + * @return bool True if property has been defined (can be null). + */ + public function hasProperty($property) + { + return $this->doHasProperty($property); + } + + /** + * @param string $property Object property to be fetched. + * @param mixed $default Default value if property has not been set. + * @return mixed Property value. + */ + public function getProperty($property, $default = null) + { + return $this->doGetProperty($property, $default); + } + + /** + * @param string $property Object property to be updated. + * @param mixed $value New value. + * @return $this + */ + public function setProperty($property, $value) + { + $this->doSetProperty($property, $value); + + return $this; + } + + /** + * @param string $property Object property to be unset. + * @return $this + */ + public function unsetProperty($property) + { + $this->doUnsetProperty($property); + + return $this; + } + + /** + * @param string $property Object property to be defined. + * @param mixed $default Default value. + * @return $this + */ + public function defProperty($property, $default) + { + if (!$this->hasProperty($property)) { + $this->setProperty($property, $default); + } + + return $this; + } + + /** + * @return array + */ + final public function __serialize(): array + { + return $this->doSerialize(); + } + + /** + * @param array $data + * @return void + */ + final public function __unserialize(array $data): void + { + if (method_exists($this, 'initObjectProperties')) { + $this->initObjectProperties(); + } + + $this->doUnserialize($data); + } + + /** + * @return array + */ + protected function doSerialize() + { + return ['key' => $this->getKey(), 'type' => $this->getType(), 'elements' => $this->getElements()]; + } + + /** + * @param array $serialized + * @return void + */ + protected function doUnserialize(array $serialized) + { + if (!isset($serialized['key'], $serialized['type'], $serialized['elements']) || $serialized['type'] !== $this->getType()) { + throw new InvalidArgumentException("Cannot unserialize '{$this->getType()}': Bad data"); + } + + $this->setKey($serialized['key']); + $this->setElements($serialized['elements']); + } + + /** + * Implements JsonSerializable interface. + * + * @return array + */ + #[\ReturnTypeWillChange] + public function jsonSerialize() + { + return $this->doSerialize(); + } + + /** + * Returns a string representation of this object. + * + * @return string + */ + #[\ReturnTypeWillChange] + public function __toString() + { + return $this->getKey(); + } + + /** + * @param string $key + * @return $this + */ + protected function setKey($key) + { + $this->_key = (string) $key; + + return $this; + } +} diff --git a/system/src/Grav/Framework/Object/Collection/ObjectExpressionVisitor.php b/system/src/Grav/Framework/Object/Collection/ObjectExpressionVisitor.php new file mode 100644 index 0000000..5b28ab0 --- /dev/null +++ b/system/src/Grav/Framework/Object/Collection/ObjectExpressionVisitor.php @@ -0,0 +1,240 @@ +{$accessor}(); + break; + } + } + + if ($op) { + $function = 'filter' . ucfirst(strtolower($op)); + if (method_exists(static::class, $function)) { + $value = static::$function($value); + } + } + + return $value; + } + + /** + * @param string $str + * @return string + */ + public static function filterLower($str) + { + return mb_strtolower($str); + } + + /** + * @param string $str + * @return string + */ + public static function filterUpper($str) + { + return mb_strtoupper($str); + } + + /** + * @param string $str + * @return int + */ + public static function filterLength($str) + { + return mb_strlen($str); + } + + /** + * @param string $str + * @return string + */ + public static function filterLtrim($str) + { + return ltrim($str); + } + + /** + * @param string $str + * @return string + */ + public static function filterRtrim($str) + { + return rtrim($str); + } + + /** + * @param string $str + * @return string + */ + public static function filterTrim($str) + { + return trim($str); + } + + /** + * Helper for sorting arrays of objects based on multiple fields + orientations. + * + * Comparison between two strings is natural and case insensitive. + * + * @param string $name + * @param int $orientation + * @param Closure|null $next + * + * @return Closure + */ + public static function sortByField($name, $orientation = 1, Closure $next = null) + { + if (!$next) { + $next = function ($a, $b) { + return 0; + }; + } + + return function ($a, $b) use ($name, $next, $orientation) { + $aValue = static::getObjectFieldValue($a, $name); + $bValue = static::getObjectFieldValue($b, $name); + + if ($aValue === $bValue) { + return $next($a, $b); + } + + // For strings we use natural case insensitive sorting. + if (is_string($aValue) && is_string($bValue)) { + return strnatcasecmp($aValue, $bValue) * $orientation; + } + + return (($aValue > $bValue) ? 1 : -1) * $orientation; + }; + } + + /** + * {@inheritDoc} + */ + public function walkComparison(Comparison $comparison) + { + $field = $comparison->getField(); + $value = $comparison->getValue()->getValue(); // shortcut for walkValue() + + switch ($comparison->getOperator()) { + case Comparison::EQ: + return function ($object) use ($field, $value) { + return static::getObjectFieldValue($object, $field) === $value; + }; + + case Comparison::NEQ: + return function ($object) use ($field, $value) { + return static::getObjectFieldValue($object, $field) !== $value; + }; + + case Comparison::LT: + return function ($object) use ($field, $value) { + return static::getObjectFieldValue($object, $field) < $value; + }; + + case Comparison::LTE: + return function ($object) use ($field, $value) { + return static::getObjectFieldValue($object, $field) <= $value; + }; + + case Comparison::GT: + return function ($object) use ($field, $value) { + return static::getObjectFieldValue($object, $field) > $value; + }; + + case Comparison::GTE: + return function ($object) use ($field, $value) { + return static::getObjectFieldValue($object, $field) >= $value; + }; + + case Comparison::IN: + return function ($object) use ($field, $value) { + return in_array(static::getObjectFieldValue($object, $field), $value, true); + }; + + case Comparison::NIN: + return function ($object) use ($field, $value) { + return !in_array(static::getObjectFieldValue($object, $field), $value, true); + }; + + case Comparison::CONTAINS: + return function ($object) use ($field, $value) { + return false !== strpos(static::getObjectFieldValue($object, $field), $value); + }; + + case Comparison::MEMBER_OF: + return function ($object) use ($field, $value) { + $fieldValues = static::getObjectFieldValue($object, $field); + if (!is_array($fieldValues)) { + $fieldValues = iterator_to_array($fieldValues); + } + return in_array($value, $fieldValues, true); + }; + + case Comparison::STARTS_WITH: + return function ($object) use ($field, $value) { + return 0 === strpos(static::getObjectFieldValue($object, $field), $value); + }; + + case Comparison::ENDS_WITH: + return function ($object) use ($field, $value) { + return $value === substr(static::getObjectFieldValue($object, $field), -strlen($value)); + }; + + default: + throw new RuntimeException('Unknown comparison operator: ' . $comparison->getOperator()); + } + } +} diff --git a/system/src/Grav/Framework/Object/Identifiers/Identifier.php b/system/src/Grav/Framework/Object/Identifiers/Identifier.php new file mode 100644 index 0000000..69f41d2 --- /dev/null +++ b/system/src/Grav/Framework/Object/Identifiers/Identifier.php @@ -0,0 +1,66 @@ +id = $id; + $this->type = $type; + } + + /** + * @return string + * @phpstan-pure + */ + public function getId(): string + { + return $this->id; + } + + /** + * @return string + * @phpstan-pure + */ + public function getType(): string + { + return $this->type; + } + + /** + * @return array + */ + public function jsonSerialize(): array + { + return [ + 'type' => $this->type, + 'id' => $this->id + ]; + } + + /** + * @return array + */ + public function __debugInfo(): array + { + return $this->jsonSerialize(); + } +} diff --git a/system/src/Grav/Framework/Object/Interfaces/NestedObjectCollectionInterface.php b/system/src/Grav/Framework/Object/Interfaces/NestedObjectCollectionInterface.php new file mode 100644 index 0000000..ed81bb2 --- /dev/null +++ b/system/src/Grav/Framework/Object/Interfaces/NestedObjectCollectionInterface.php @@ -0,0 +1,64 @@ + + */ +interface NestedObjectCollectionInterface extends ObjectCollectionInterface +{ + /** + * @param string $property Object property name. + * @param string|null $separator Separator, defaults to '.' + * @return bool[] List of [key => bool] pairs. + */ + public function hasNestedProperty($property, $separator = null); + + /** + * @param string $property Object property to be fetched. + * @param mixed|null $default Default value if property has not been set. + * @param string|null $separator Separator, defaults to '.' + * @return mixed[] List of [key => value] pairs. + */ + public function getNestedProperty($property, $default = null, $separator = null); + + /** + * @param string $property Object property to be updated. + * @param mixed $value New value. + * @param string|null $separator Separator, defaults to '.' + * @return $this + * @throws RuntimeException + */ + public function setNestedProperty($property, $value, $separator = null); + + /** + * @param string $property Object property to be defined. + * @param mixed $default Default value. + * @param string|null $separator Separator, defaults to '.' + * @return $this + * @throws RuntimeException + */ + public function defNestedProperty($property, $default, $separator = null); + + /** + * @param string $property Object property to be unset. + * @param string|null $separator Separator, defaults to '.' + * @return $this + * @throws RuntimeException + */ + public function unsetNestedProperty($property, $separator = null); +} diff --git a/system/src/Grav/Framework/Object/Interfaces/NestedObjectInterface.php b/system/src/Grav/Framework/Object/Interfaces/NestedObjectInterface.php new file mode 100644 index 0000000..647f6c7 --- /dev/null +++ b/system/src/Grav/Framework/Object/Interfaces/NestedObjectInterface.php @@ -0,0 +1,60 @@ + + * @extends Selectable + */ +interface ObjectCollectionInterface extends CollectionInterface, Selectable, Serializable +{ + /** + * @return string + */ + public function getType(); + + /** + * @return string + */ + public function getKey(); + + /** + * @param string $key + * @return $this + */ + public function setKey($key); + + /** + * @param string $property Object property name. + * @return bool[] List of [key => bool] pairs. + */ + public function hasProperty($property); + + /** + * @param string $property Object property to be fetched. + * @param mixed|null $default Default value if property has not been set. + * @return mixed[] List of [key => value] pairs. + */ + public function getProperty($property, $default = null); + + /** + * @param string $property Object property to be updated. + * @param mixed $value New value. + * @return $this + */ + public function setProperty($property, $value); + + /** + * @param string $property Object property to be defined. + * @param mixed $default Default value. + * @return $this + */ + public function defProperty($property, $default); + + /** + * @param string $property Object property to be unset. + * @return $this + */ + public function unsetProperty($property); + + /** + * Create a copy from this collection by cloning all objects in the collection. + * + * @return static + * @phpstan-return static + */ + public function copy(); + + /** + * @return array + */ + public function getObjectKeys(); + + /** + * @param string $name Method name. + * @param array $arguments List of arguments passed to the function. + * @return array Return values. + */ + public function call($name, array $arguments = []); + + /** + * Group items in the collection by a field and return them as associated array. + * + * @param string $property + * @return array + */ + public function group($property); + + /** + * Group items in the collection by a field and return them as associated array of collections. + * + * @param string $property + * @return static[] + * @phpstan-return array> + */ + public function collectionGroup($property); + + /** + * @param array $ordering + * @return ObjectCollectionInterface + * @phpstan-return static + */ + public function orderBy(array $ordering); + + /** + * @param int $start + * @param int|null $limit + * @return ObjectCollectionInterface + * @phpstan-return static + */ + public function limit($start, $limit = null); +} diff --git a/system/src/Grav/Framework/Object/Interfaces/ObjectInterface.php b/system/src/Grav/Framework/Object/Interfaces/ObjectInterface.php new file mode 100644 index 0000000..f505f47 --- /dev/null +++ b/system/src/Grav/Framework/Object/Interfaces/ObjectInterface.php @@ -0,0 +1,63 @@ + + */ +class LazyObject implements NestedObjectInterface, ArrayAccess +{ + use ObjectTrait; + use LazyPropertyTrait; + use NestedPropertyTrait; + use OverloadedPropertyTrait; + use NestedArrayAccessTrait; +} diff --git a/system/src/Grav/Framework/Object/ObjectCollection.php b/system/src/Grav/Framework/Object/ObjectCollection.php new file mode 100644 index 0000000..ce6fa0b --- /dev/null +++ b/system/src/Grav/Framework/Object/ObjectCollection.php @@ -0,0 +1,131 @@ + + * @implements NestedObjectCollectionInterface + */ +class ObjectCollection extends ArrayCollection implements NestedObjectCollectionInterface +{ + /** @phpstan-use ObjectCollectionTrait */ + use ObjectCollectionTrait; + use NestedPropertyCollectionTrait { + NestedPropertyCollectionTrait::group insteadof ObjectCollectionTrait; + } + + /** + * @param array $elements + * @param string|null $key + * @throws InvalidArgumentException + */ + public function __construct(array $elements = [], $key = null) + { + parent::__construct($this->setElements($elements)); + + $this->setKey($key ?? ''); + } + + /** + * @param array $ordering + * @return static + * @phpstan-return static + */ + public function orderBy(array $ordering) + { + $criteria = Criteria::create()->orderBy($ordering); + + return $this->matching($criteria); + } + + /** + * @param int $start + * @param int|null $limit + * @return static + * @phpstan-return static + */ + public function limit($start, $limit = null) + { + /** @phpstan-var static */ + return $this->createFrom($this->slice($start, $limit)); + } + + /** + * @param Criteria $criteria + * @return static + * @phpstan-return static + */ + public function matching(Criteria $criteria) + { + $expr = $criteria->getWhereExpression(); + $filtered = $this->getElements(); + + if ($expr) { + $visitor = new ObjectExpressionVisitor(); + $filter = $visitor->dispatch($expr); + $filtered = array_filter($filtered, $filter); + } + + if ($orderings = $criteria->getOrderings()) { + $next = null; + foreach (array_reverse($orderings) as $field => $ordering) { + $next = ObjectExpressionVisitor::sortByField($field, $ordering === Criteria::DESC ? -1 : 1, $next); + } + + /** @phpstan-ignore-next-line */ + if ($next) { + uasort($filtered, $next); + } + } + + $offset = $criteria->getFirstResult(); + $length = $criteria->getMaxResults(); + + if ($offset || $length) { + $filtered = array_slice($filtered, (int)$offset, $length); + } + + /** @phpstan-var static */ + return $this->createFrom($filtered); + } + + /** + * @return array + * @phpstan-return array + */ + protected function getElements() + { + return $this->toArray(); + } + + /** + * @param array $elements + * @return array + * @phpstan-return array + */ + protected function setElements(array $elements) + { + /** @phpstan-var array $elements */ + return $elements; + } +} diff --git a/system/src/Grav/Framework/Object/ObjectIndex.php b/system/src/Grav/Framework/Object/ObjectIndex.php new file mode 100644 index 0000000..a241eda --- /dev/null +++ b/system/src/Grav/Framework/Object/ObjectIndex.php @@ -0,0 +1,281 @@ + + * @implements NestedObjectCollectionInterface + */ +abstract class ObjectIndex extends AbstractIndexCollection implements NestedObjectCollectionInterface +{ + /** @var string */ + protected static $type; + + /** @var string */ + protected $_key; + + /** + * @param bool $prefix + * @return string + */ + public function getType($prefix = true) + { + $type = $prefix ? $this->getTypePrefix() : ''; + + if (static::$type) { + return $type . static::$type; + } + + $class = get_class($this); + return $type . strtolower(substr($class, strrpos($class, '\\') + 1)); + } + + /** + * @return string + */ + public function getKey() + { + return $this->_key ?: $this->getType() . '@@' . spl_object_hash($this); + } + + /** + * @param string $key + * @return $this + */ + public function setKey($key) + { + $this->_key = $key; + + return $this; + } + + /** + * @param string $property Object property name. + * @return bool[] True if property has been defined (can be null). + */ + public function hasProperty($property) + { + return $this->__call('hasProperty', [$property]); + } + + /** + * @param string $property Object property to be fetched. + * @param mixed $default Default value if property has not been set. + * @return mixed[] Property values. + */ + public function getProperty($property, $default = null) + { + return $this->__call('getProperty', [$property, $default]); + } + + /** + * @param string $property Object property to be updated. + * @param string $value New value. + * @return ObjectCollectionInterface + * @phpstan-return C + */ + public function setProperty($property, $value) + { + return $this->__call('setProperty', [$property, $value]); + } + + /** + * @param string $property Object property to be defined. + * @param mixed $default Default value. + * @return ObjectCollectionInterface + * @phpstan-return C + */ + public function defProperty($property, $default) + { + return $this->__call('defProperty', [$property, $default]); + } + + /** + * @param string $property Object property to be unset. + * @return ObjectCollectionInterface + * @phpstan-return C + */ + public function unsetProperty($property) + { + return $this->__call('unsetProperty', [$property]); + } + + /** + * @param string $property Object property name. + * @param string|null $separator Separator, defaults to '.' + * @return bool[] True if property has been defined (can be null). + */ + public function hasNestedProperty($property, $separator = null) + { + return $this->__call('hasNestedProperty', [$property, $separator]); + } + + /** + * @param string $property Object property to be fetched. + * @param mixed $default Default value if property has not been set. + * @param string|null $separator Separator, defaults to '.' + * @return mixed[] Property values. + */ + public function getNestedProperty($property, $default = null, $separator = null) + { + return $this->__call('getNestedProperty', [$property, $default, $separator]); + } + + /** + * @param string $property Object property to be updated. + * @param mixed $value New value. + * @param string|null $separator Separator, defaults to '.' + * @return ObjectCollectionInterface + * @phpstan-return C + */ + public function setNestedProperty($property, $value, $separator = null) + { + return $this->__call('setNestedProperty', [$property, $value, $separator]); + } + + /** + * @param string $property Object property to be defined. + * @param mixed $default Default value. + * @param string|null $separator Separator, defaults to '.' + * @return ObjectCollectionInterface + * @phpstan-return C + */ + public function defNestedProperty($property, $default, $separator = null) + { + return $this->__call('defNestedProperty', [$property, $default, $separator]); + } + + /** + * @param string $property Object property to be unset. + * @param string|null $separator Separator, defaults to '.' + * @return ObjectCollectionInterface + * @phpstan-return C + */ + public function unsetNestedProperty($property, $separator = null) + { + return $this->__call('unsetNestedProperty', [$property, $separator]); + } + + /** + * Create a copy from this collection by cloning all objects in the collection. + * + * @return static + * @return static + */ + public function copy() + { + $list = []; + foreach ($this->getIterator() as $key => $value) { + /** @phpstan-ignore-next-line */ + $list[$key] = is_object($value) ? clone $value : $value; + } + + /** @phpstan-var static */ + return $this->createFrom($list); + } + + /** + * @return array + */ + public function getObjectKeys() + { + return $this->getKeys(); + } + + /** + * @param array $ordering + * @return ObjectCollectionInterface + * @phpstan-return C + */ + public function orderBy(array $ordering) + { + return $this->__call('orderBy', [$ordering]); + } + + /** + * @param string $method + * @param array $arguments + * @return array|mixed + */ + public function call($method, array $arguments = []) + { + return $this->__call('call', [$method, $arguments]); + } + + /** + * Group items in the collection by a field and return them as associated array. + * + * @param string $property + * @return array + */ + public function group($property) + { + return $this->__call('group', [$property]); + } + + /** + * Group items in the collection by a field and return them as associated array of collections. + * + * @param string $property + * @return ObjectCollectionInterface[] + * @phpstan-return C[] + */ + public function collectionGroup($property) + { + return $this->__call('collectionGroup', [$property]); + } + + /** + * @param Criteria $criteria + * @return ObjectCollectionInterface + * @phpstan-return C + */ + public function matching(Criteria $criteria) + { + $collection = $this->loadCollection($this->getEntries()); + + /** @phpstan-var C $matching */ + $matching = $collection->matching($criteria); + + return $matching; + } + + /** + * @param string $name + * @param array $arguments + * @return mixed + */ + #[\ReturnTypeWillChange] + abstract public function __call($name, $arguments); + + /** + * @return string + */ + protected function getTypePrefix() + { + return ''; + } +} diff --git a/system/src/Grav/Framework/Object/Property/ArrayPropertyTrait.php b/system/src/Grav/Framework/Object/Property/ArrayPropertyTrait.php new file mode 100644 index 0000000..0c0a549 --- /dev/null +++ b/system/src/Grav/Framework/Object/Property/ArrayPropertyTrait.php @@ -0,0 +1,115 @@ +setElements($elements); + $this->setKey($key ?? ''); + } + + /** + * @param string $property Object property name. + * @return bool True if property has been defined (can be null). + */ + protected function doHasProperty($property) + { + return array_key_exists($property, $this->_elements); + } + + /** + * @param string $property Object property to be fetched. + * @param mixed $default Default value if property has not been set. + * @param bool $doCreate Set true to create variable. + * @return mixed Property value. + */ + protected function &doGetProperty($property, $default = null, $doCreate = false) + { + if (!array_key_exists($property, $this->_elements)) { + if ($doCreate) { + $this->_elements[$property] = null; + } else { + return $default; + } + } + + return $this->_elements[$property]; + } + + /** + * @param string $property Object property to be updated. + * @param mixed $value New value. + * @return void + */ + protected function doSetProperty($property, $value) + { + $this->_elements[$property] = $value; + } + + /** + * @param string $property Object property to be unset. + * @return void + */ + protected function doUnsetProperty($property) + { + unset($this->_elements[$property]); + } + + /** + * @param string $property + * @param mixed|null $default + * @return mixed|null + */ + protected function getElement($property, $default = null) + { + return array_key_exists($property, $this->_elements) ? $this->_elements[$property] : $default; + } + + /** + * @return array + */ + protected function getElements() + { + return array_filter($this->_elements, static function ($val) { + return $val !== null; + }); + } + + /** + * @param array $elements + * @return void + */ + protected function setElements(array $elements) + { + $this->_elements = $elements; + } + + abstract protected function setKey($key); +} diff --git a/system/src/Grav/Framework/Object/Property/LazyPropertyTrait.php b/system/src/Grav/Framework/Object/Property/LazyPropertyTrait.php new file mode 100644 index 0000000..fe00d50 --- /dev/null +++ b/system/src/Grav/Framework/Object/Property/LazyPropertyTrait.php @@ -0,0 +1,114 @@ +offsetLoad($offset, $value)` called first time object property gets accessed + * - `$this->offsetPrepare($offset, $value)` called on every object property set + * - `$this->offsetSerialize($offset, $value)` called when the raw or serialized object property value is needed + * + * @package Grav\Framework\Object\Property + */ +trait LazyPropertyTrait +{ + use ArrayPropertyTrait, ObjectPropertyTrait { + ObjectPropertyTrait::__construct insteadof ArrayPropertyTrait; + ArrayPropertyTrait::doHasProperty as hasArrayProperty; + ArrayPropertyTrait::doGetProperty as getArrayProperty; + ArrayPropertyTrait::doSetProperty as setArrayProperty; + ArrayPropertyTrait::doUnsetProperty as unsetArrayProperty; + ArrayPropertyTrait::getElement as getArrayElement; + ArrayPropertyTrait::getElements as getArrayElements; + ArrayPropertyTrait::setElements insteadof ObjectPropertyTrait; + ObjectPropertyTrait::doHasProperty as hasObjectProperty; + ObjectPropertyTrait::doGetProperty as getObjectProperty; + ObjectPropertyTrait::doSetProperty as setObjectProperty; + ObjectPropertyTrait::doUnsetProperty as unsetObjectProperty; + ObjectPropertyTrait::getElement as getObjectElement; + ObjectPropertyTrait::getElements as getObjectElements; + } + + /** + * @param string $property Object property name. + * @return bool True if property has been defined (can be null). + */ + protected function doHasProperty($property) + { + return $this->hasArrayProperty($property) || $this->hasObjectProperty($property); + } + + /** + * @param string $property Object property to be fetched. + * @param mixed $default Default value if property has not been set. + * @param bool $doCreate + * @return mixed Property value. + */ + protected function &doGetProperty($property, $default = null, $doCreate = false) + { + if ($this->hasObjectProperty($property)) { + return $this->getObjectProperty($property, $default, function ($default = null) use ($property) { + return $this->getArrayProperty($property, $default); + }); + } + + return $this->getArrayProperty($property, $default, $doCreate); + } + + /** + * @param string $property Object property to be updated. + * @param mixed $value New value. + * @return void + */ + protected function doSetProperty($property, $value) + { + if ($this->hasObjectProperty($property)) { + $this->setObjectProperty($property, $value); + } else { + $this->setArrayProperty($property, $value); + } + } + + /** + * @param string $property Object property to be unset. + * @return void + */ + protected function doUnsetProperty($property) + { + $this->hasObjectProperty($property) ? $this->unsetObjectProperty($property) : $this->unsetArrayProperty($property); + } + + /** + * @param string $property + * @param mixed|null $default + * @return mixed|null + */ + protected function getElement($property, $default = null) + { + if ($this->isPropertyLoaded($property)) { + return $this->getObjectElement($property, $default); + } + + return $this->getArrayElement($property, $default); + } + + /** + * @return array + */ + protected function getElements() + { + return $this->getObjectElements() + $this->getArrayElements(); + } +} diff --git a/system/src/Grav/Framework/Object/Property/MixedPropertyTrait.php b/system/src/Grav/Framework/Object/Property/MixedPropertyTrait.php new file mode 100644 index 0000000..3734760 --- /dev/null +++ b/system/src/Grav/Framework/Object/Property/MixedPropertyTrait.php @@ -0,0 +1,121 @@ +offsetLoad($offset, $value)` called first time object property gets accessed + * - `$this->offsetPrepare($offset, $value)` called on every object property set + * - `$this->offsetSerialize($offset, $value)` called when the raw or serialized object property value is needed + + * + * @package Grav\Framework\Object\Property + */ +trait MixedPropertyTrait +{ + use ArrayPropertyTrait, ObjectPropertyTrait { + ObjectPropertyTrait::__construct insteadof ArrayPropertyTrait; + ArrayPropertyTrait::doHasProperty as hasArrayProperty; + ArrayPropertyTrait::doGetProperty as getArrayProperty; + ArrayPropertyTrait::doSetProperty as setArrayProperty; + ArrayPropertyTrait::doUnsetProperty as unsetArrayProperty; + ArrayPropertyTrait::getElement as getArrayElement; + ArrayPropertyTrait::getElements as getArrayElements; + ArrayPropertyTrait::setElements as setArrayElements; + ObjectPropertyTrait::doHasProperty as hasObjectProperty; + ObjectPropertyTrait::doGetProperty as getObjectProperty; + ObjectPropertyTrait::doSetProperty as setObjectProperty; + ObjectPropertyTrait::doUnsetProperty as unsetObjectProperty; + ObjectPropertyTrait::getElement as getObjectElement; + ObjectPropertyTrait::getElements as getObjectElements; + ObjectPropertyTrait::setElements as setObjectElements; + } + + /** + * @param string $property Object property name. + * @return bool True if property has been defined (can be null). + */ + protected function doHasProperty($property) + { + return $this->hasArrayProperty($property) || $this->hasObjectProperty($property); + } + + /** + * @param string $property Object property to be fetched. + * @param mixed $default Default value if property has not been set. + * @param bool $doCreate + * @return mixed Property value. + */ + protected function &doGetProperty($property, $default = null, $doCreate = false) + { + if ($this->hasObjectProperty($property)) { + return $this->getObjectProperty($property); + } + + return $this->getArrayProperty($property, $default, $doCreate); + } + + /** + * @param string $property Object property to be updated. + * @param mixed $value New value. + * @return void + */ + protected function doSetProperty($property, $value) + { + $this->hasObjectProperty($property) + ? $this->setObjectProperty($property, $value) : $this->setArrayProperty($property, $value); + } + + /** + * @param string $property Object property to be unset. + * @return void + */ + protected function doUnsetProperty($property) + { + $this->hasObjectProperty($property) ? + $this->unsetObjectProperty($property) : $this->unsetArrayProperty($property); + } + + /** + * @param string $property + * @param mixed|null $default + * @return mixed|null + */ + protected function getElement($property, $default = null) + { + if ($this->hasObjectProperty($property)) { + return $this->getObjectElement($property, $default); + } + + return $this->getArrayElement($property, $default); + } + + /** + * @return array + */ + protected function getElements() + { + return $this->getObjectElements() + $this->getArrayElements(); + } + + /** + * @param array $elements + * @return void + */ + protected function setElements(array $elements) + { + $this->setObjectElements(array_intersect_key($elements, $this->_definedProperties)); + $this->setArrayElements(array_diff_key($elements, $this->_definedProperties)); + } +} diff --git a/system/src/Grav/Framework/Object/Property/ObjectPropertyTrait.php b/system/src/Grav/Framework/Object/Property/ObjectPropertyTrait.php new file mode 100644 index 0000000..618dbbd --- /dev/null +++ b/system/src/Grav/Framework/Object/Property/ObjectPropertyTrait.php @@ -0,0 +1,213 @@ +offsetLoad($offset, $value)` called first time object property gets accessed + * - `$this->offsetPrepare($offset, $value)` called on every object property set + * - `$this->offsetSerialize($offset, $value)` called when the raw or serialized object property value is needed + * + * @package Grav\Framework\Object\Property + */ +trait ObjectPropertyTrait +{ + /** @var array */ + private $_definedProperties; + + /** + * @param array $elements + * @param string|null $key + * @throws InvalidArgumentException + */ + public function __construct(array $elements = [], $key = null) + { + $this->initObjectProperties(); + $this->setElements($elements); + $this->setKey($key ?? ''); + } + + /** + * @param string $property Object property name. + * @return bool True if property has been loaded. + */ + protected function isPropertyLoaded($property) + { + return !empty($this->_definedProperties[$property]); + } + + /** + * @param string $offset + * @param mixed $value + * @return mixed + */ + protected function offsetLoad($offset, $value) + { + $methodName = "offsetLoad_{$offset}"; + + return method_exists($this, $methodName)? $this->{$methodName}($value) : $value; + } + + /** + * @param string $offset + * @param mixed $value + * @return mixed + */ + protected function offsetPrepare($offset, $value) + { + $methodName = "offsetPrepare_{$offset}"; + + return method_exists($this, $methodName) ? $this->{$methodName}($value) : $value; + } + + /** + * @param string $offset + * @param mixed $value + * @return mixed + */ + protected function offsetSerialize($offset, $value) + { + $methodName = "offsetSerialize_{$offset}"; + + return method_exists($this, $methodName) ? $this->{$methodName}($value) : $value; + } + + /** + * @param string $property Object property name. + * @return bool True if property has been defined (can be null). + */ + protected function doHasProperty($property) + { + return array_key_exists($property, $this->_definedProperties); + } + + /** + * @param string $property Object property to be fetched. + * @param mixed $default Default value if property has not been set. + * @param callable|bool $doCreate Set true to create variable. + * @return mixed Property value. + */ + protected function &doGetProperty($property, $default = null, $doCreate = false) + { + if (!array_key_exists($property, $this->_definedProperties)) { + throw new InvalidArgumentException("Property '{$property}' does not exist in the object!"); + } + + if (empty($this->_definedProperties[$property])) { + if ($doCreate === true) { + $this->_definedProperties[$property] = true; + $this->{$property} = null; + } elseif (is_callable($doCreate)) { + $this->_definedProperties[$property] = true; + $this->{$property} = $this->offsetLoad($property, $doCreate()); + } else { + return $default; + } + } + + return $this->{$property}; + } + + /** + * @param string $property Object property to be updated. + * @param mixed $value New value. + * @return void + * @throws InvalidArgumentException + */ + protected function doSetProperty($property, $value) + { + if (!array_key_exists($property, $this->_definedProperties)) { + throw new InvalidArgumentException("Property '{$property}' does not exist in the object!"); + } + + $this->_definedProperties[$property] = true; + $this->{$property} = $this->offsetPrepare($property, $value); + } + + /** + * @param string $property Object property to be unset. + * @return void + */ + protected function doUnsetProperty($property) + { + if (!array_key_exists($property, $this->_definedProperties)) { + return; + } + + $this->_definedProperties[$property] = false; + $this->{$property} = null; + } + + /** + * @return void + */ + protected function initObjectProperties() + { + $this->_definedProperties = []; + foreach (get_object_vars($this) as $property => $value) { + if ($property[0] !== '_') { + $this->_definedProperties[$property] = ($value !== null); + } + } + } + + /** + * @param string $property + * @param mixed|null $default + * @return mixed|null + */ + protected function getElement($property, $default = null) + { + if (empty($this->_definedProperties[$property])) { + return $default; + } + + return $this->offsetSerialize($property, $this->{$property}); + } + + /** + * @return array + */ + protected function getElements() + { + $properties = array_intersect_key(get_object_vars($this), array_filter($this->_definedProperties)); + + $elements = []; + foreach ($properties as $offset => $value) { + $serialized = $this->offsetSerialize($offset, $value); + if ($serialized !== null) { + $elements[$offset] = $this->offsetSerialize($offset, $value); + } + } + + return $elements; + } + + /** + * @param array $elements + * @return void + */ + protected function setElements(array $elements) + { + foreach ($elements as $property => $value) { + $this->setProperty($property, $value); + } + } +} diff --git a/system/src/Grav/Framework/Object/PropertyObject.php b/system/src/Grav/Framework/Object/PropertyObject.php new file mode 100644 index 0000000..b61d154 --- /dev/null +++ b/system/src/Grav/Framework/Object/PropertyObject.php @@ -0,0 +1,32 @@ + + */ +class PropertyObject implements NestedObjectInterface, ArrayAccess +{ + use ObjectTrait; + use ObjectPropertyTrait; + use NestedPropertyTrait; + use OverloadedPropertyTrait; + use NestedArrayAccessTrait; +} diff --git a/system/src/Grav/Framework/Pagination/AbstractPagination.php b/system/src/Grav/Framework/Pagination/AbstractPagination.php new file mode 100644 index 0000000..084fb1d --- /dev/null +++ b/system/src/Grav/Framework/Pagination/AbstractPagination.php @@ -0,0 +1,429 @@ + 'page', + 'limit' => 10, + 'display' => 5, + 'opening' => 0, + 'ending' => 0, + 'url' => null, + 'param' => null, + 'use_query_param' => false + ]; + /** @var array */ + private $items; + + /** + * @return bool + */ + public function isEnabled(): bool + { + return $this->count() > 1; + } + + /** + * @return array + */ + public function getOptions(): array + { + return $this->options; + } + + /** + * @return Route|null + */ + public function getRoute(): ?Route + { + return $this->route; + } + + /** + * @return int + */ + public function getTotalPages(): int + { + return $this->pages; + } + + /** + * @return int + */ + public function getPageNumber(): int + { + return $this->page ?? 1; + } + + /** + * @param int $count + * @return int|null + */ + public function getPrevNumber(int $count = 1): ?int + { + $page = $this->page - $count; + + return $page >= 1 ? $page : null; + } + + /** + * @param int $count + * @return int|null + */ + public function getNextNumber(int $count = 1): ?int + { + $page = $this->page + $count; + + return $page <= $this->pages ? $page : null; + } + + /** + * @param int $page + * @param string|null $label + * @return PaginationPage|null + */ + public function getPage(int $page, string $label = null): ?PaginationPage + { + if ($page < 1 || $page > $this->pages) { + return null; + } + + $start = ($page - 1) * $this->limit; + $type = $this->getOptions()['type']; + $param = $this->getOptions()['param']; + $useQuery = $this->getOptions()['use_query_param']; + if ($type === 'page') { + $param = $param ?? 'page'; + $offset = $page; + } else { + $param = $param ?? 'start'; + $offset = $start; + } + + if ($useQuery) { + $route = $this->route->withQueryParam($param, $offset); + } else { + $route = $this->route->withGravParam($param, $offset); + } + + return new PaginationPage( + [ + 'label' => $label ?? (string)$page, + 'number' => $page, + 'offset_start' => $start, + 'offset_end' => min($start + $this->limit, $this->total) - 1, + 'enabled' => $page !== $this->page || $this->viewAll, + 'active' => $page === $this->page, + 'route' => $route + ] + ); + } + + /** + * @param string|null $label + * @param int $count + * @return PaginationPage|null + */ + public function getFirstPage(string $label = null, int $count = 0): ?PaginationPage + { + return $this->getPage(1 + $count, $label ?? $this->getOptions()['label_first'] ?? null); + } + + /** + * @param string|null $label + * @param int $count + * @return PaginationPage|null + */ + public function getPrevPage(string $label = null, int $count = 1): ?PaginationPage + { + return $this->getPage($this->page - $count, $label ?? $this->getOptions()['label_prev'] ?? null); + } + + /** + * @param string|null $label + * @param int $count + * @return PaginationPage|null + */ + public function getNextPage(string $label = null, int $count = 1): ?PaginationPage + { + return $this->getPage($this->page + $count, $label ?? $this->getOptions()['label_next'] ?? null); + } + + /** + * @param string|null $label + * @param int $count + * @return PaginationPage|null + */ + public function getLastPage(string $label = null, int $count = 0): ?PaginationPage + { + return $this->getPage($this->pages - $count, $label ?? $this->getOptions()['label_last'] ?? null); + } + + /** + * @return int + */ + public function getStart(): int + { + return $this->start ?? 0; + } + + /** + * @return int + */ + public function getLimit(): int + { + return $this->limit; + } + + /** + * @return int + */ + public function getTotal(): int + { + return $this->total; + } + + /** + * @return int + */ + public function count(): int + { + $this->loadItems(); + + return count($this->items); + } + + /** + * @return ArrayIterator + * @phpstan-return ArrayIterator + */ + #[\ReturnTypeWillChange] + public function getIterator() + { + $this->loadItems(); + + return new ArrayIterator($this->items); + } + + /** + * @return array + */ + public function getPages(): array + { + $this->loadItems(); + + return $this->items; + } + + /** + * @return void + */ + protected function loadItems() + { + $this->calculateRange(); + + // Make list like: 1 ... 4 5 6 ... 10 + $range = range($this->pagesStart, $this->pagesStop); + //$range[] = 1; + //$range[] = $this->pages; + natsort($range); + $range = array_unique($range); + + $this->items = []; + foreach ($range as $i) { + $this->items[$i] = $this->getPage($i); + } + } + + /** + * @param Route $route + * @return $this + */ + protected function setRoute(Route $route) + { + $this->route = $route; + + return $this; + } + + /** + * @param array|null $options + * @return $this + */ + protected function setOptions(array $options = null) + { + $this->options = $options ? array_merge($this->defaultOptions, $options) : $this->defaultOptions; + + return $this; + } + + /** + * @param int|null $page + * @return $this + */ + protected function setPage(int $page = null) + { + $this->page = (int)max($page, 1); + $this->start = null; + + return $this; + } + + /** + * @param int|null $start + * @return $this + */ + protected function setStart(int $start = null) + { + $this->start = (int)max($start, 0); + $this->page = null; + + return $this; + } + + /** + * @param int|null $limit + * @return $this + */ + protected function setLimit(int $limit = null) + { + $this->limit = (int)max($limit ?? $this->getOptions()['limit'], 0); + + // No limit, display all records in a single page. + $this->viewAll = !$limit; + + return $this; + } + + /** + * @param int $total + * @return $this + */ + protected function setTotal(int $total) + { + $this->total = (int)max($total, 0); + + return $this; + } + + /** + * @param Route $route + * @param int $total + * @param int|null $pos + * @param int|null $limit + * @param array|null $options + * @return void + */ + protected function initialize(Route $route, int $total, int $pos = null, int $limit = null, array $options = null) + { + $this->setRoute($route); + $this->setOptions($options); + $this->setTotal($total); + if ($this->getOptions()['type'] === 'start') { + $this->setStart($pos); + } else { + $this->setPage($pos); + } + $this->setLimit($limit); + $this->calculateLimits(); + } + + /** + * @return void + */ + protected function calculateLimits() + { + $limit = $this->limit; + $total = $this->total; + + if (!$limit || $limit > $total) { + // All records fit into a single page. + $this->start = 0; + $this->page = 1; + $this->pages = 1; + + return; + } + + if (null === $this->start) { + // If we are using page, convert it to start. + $this->start = (int)(($this->page - 1) * $limit); + } + + if ($this->start > $total - $limit) { + // If start is greater than total count (i.e. we are asked to display records that don't exist) + // then set start to display the last natural page of results. + $this->start = (int)max(0, (ceil($total / $limit) - 1) * $limit); + } + + // Set the total pages and current page values. + $this->page = (int)ceil(($this->start + 1) / $limit); + $this->pages = (int)ceil($total / $limit); + } + + /** + * @return void + */ + protected function calculateRange() + { + $options = $this->getOptions(); + $displayed = $options['display']; + $opening = $options['opening']; + $ending = $options['ending']; + + // Set the pagination iteration loop values. + $this->pagesStart = $this->page - (int)($displayed / 2); + if ($this->pagesStart < 1 + $opening) { + $this->pagesStart = 1 + $opening; + } + if ($this->pagesStart + $displayed - $opening > $this->pages) { + $this->pagesStop = $this->pages; + if ($this->pages < $displayed) { + $this->pagesStart = 1 + $opening; + } else { + $this->pagesStart = $this->pages - $displayed + 1 + $opening; + } + } else { + $this->pagesStop = (int)max(1, $this->pagesStart + $displayed - 1 - $ending); + } + } +} diff --git a/system/src/Grav/Framework/Pagination/AbstractPaginationPage.php b/system/src/Grav/Framework/Pagination/AbstractPaginationPage.php new file mode 100644 index 0000000..9a61060 --- /dev/null +++ b/system/src/Grav/Framework/Pagination/AbstractPaginationPage.php @@ -0,0 +1,78 @@ +options['active'] ?? false; + } + + /** + * @return bool + */ + public function isEnabled(): bool + { + return $this->options['enabled'] ?? false; + } + + /** + * @return array + */ + public function getOptions(): array + { + return $this->options; + } + + /** + * @return int|null + */ + public function getNumber(): ?int + { + return $this->options['number'] ?? null; + } + + /** + * @return string + */ + public function getLabel(): string + { + return $this->options['label'] ?? (string)$this->getNumber(); + } + + /** + * @return string|null + */ + public function getUrl(): ?string + { + return $this->options['route'] ? (string)$this->options['route']->getUri() : null; + } + + /** + * @param array $options + */ + protected function setOptions(array $options): void + { + $this->options = $options; + } +} diff --git a/system/src/Grav/Framework/Pagination/Interfaces/PaginationInterface.php b/system/src/Grav/Framework/Pagination/Interfaces/PaginationInterface.php new file mode 100644 index 0000000..b329c53 --- /dev/null +++ b/system/src/Grav/Framework/Pagination/Interfaces/PaginationInterface.php @@ -0,0 +1,104 @@ + + */ +interface PaginationInterface extends Countable, IteratorAggregate +{ + /** + * @return int + */ + public function getTotalPages(): int; + + /** + * @return int + */ + public function getPageNumber(): int; + + /** + * @param int $count + * @return int|null + */ + public function getPrevNumber(int $count = 1): ?int; + + /** + * @param int $count + * @return int|null + */ + public function getNextNumber(int $count = 1): ?int; + + /** + * @return int + */ + public function getStart(): int; + + /** + * @return int + */ + public function getLimit(): int; + + /** + * @return int + */ + public function getTotal(): int; + + /** + * @return int + */ + public function count(): int; + + /** + * @return array + */ + public function getOptions(): array; + + /** + * @param int $page + * @param string|null $label + * @return PaginationPage|null + */ + public function getPage(int $page, string $label = null): ?PaginationPage; + + /** + * @param string|null $label + * @param int $count + * @return PaginationPage|null + */ + public function getFirstPage(string $label = null, int $count = 0): ?PaginationPage; + + /** + * @param string|null $label + * @param int $count + * @return PaginationPage|null + */ + public function getPrevPage(string $label = null, int $count = 1): ?PaginationPage; + + /** + * @param string|null $label + * @param int $count + * @return PaginationPage|null + */ + public function getNextPage(string $label = null, int $count = 1): ?PaginationPage; + + /** + * @param string|null $label + * @param int $count + * @return PaginationPage|null + */ + public function getLastPage(string $label = null, int $count = 0): ?PaginationPage; +} diff --git a/system/src/Grav/Framework/Pagination/Interfaces/PaginationPageInterface.php b/system/src/Grav/Framework/Pagination/Interfaces/PaginationPageInterface.php new file mode 100644 index 0000000..082f292 --- /dev/null +++ b/system/src/Grav/Framework/Pagination/Interfaces/PaginationPageInterface.php @@ -0,0 +1,47 @@ +initialize($route, $total, $pos, $limit, $options); + } +} diff --git a/system/src/Grav/Framework/Pagination/PaginationPage.php b/system/src/Grav/Framework/Pagination/PaginationPage.php new file mode 100644 index 0000000..0a04b6a --- /dev/null +++ b/system/src/Grav/Framework/Pagination/PaginationPage.php @@ -0,0 +1,26 @@ +setOptions($options); + } +} diff --git a/system/src/Grav/Framework/Psr7/AbstractUri.php b/system/src/Grav/Framework/Psr7/AbstractUri.php new file mode 100644 index 0000000..f009135 --- /dev/null +++ b/system/src/Grav/Framework/Psr7/AbstractUri.php @@ -0,0 +1,412 @@ + 80, + 'https' => 443 + ]; + + /** @var string Uri scheme. */ + private $scheme = ''; + /** @var string Uri user. */ + private $user = ''; + /** @var string Uri password. */ + private $password = ''; + /** @var string Uri host. */ + private $host = ''; + /** @var int|null Uri port. */ + private $port; + /** @var string Uri path. */ + private $path = ''; + /** @var string Uri query string (without ?). */ + private $query = ''; + /** @var string Uri fragment (without #). */ + private $fragment = ''; + + /** + * Please define constructor which calls $this->init(). + */ + abstract public function __construct(); + + /** + * @inheritdoc + */ + public function getScheme() + { + return $this->scheme; + } + + /** + * @inheritdoc + */ + public function getAuthority() + { + $authority = $this->host; + + $userInfo = $this->getUserInfo(); + if ($userInfo !== '') { + $authority = $userInfo . '@' . $authority; + } + + if ($this->port !== null) { + $authority .= ':' . $this->port; + } + + return $authority; + } + + /** + * @inheritdoc + */ + public function getUserInfo() + { + $userInfo = $this->user; + + if ($this->password !== '') { + $userInfo .= ':' . $this->password; + } + + return $userInfo; + } + + /** + * @inheritdoc + */ + public function getHost() + { + return $this->host; + } + + /** + * @inheritdoc + */ + public function getPort() + { + return $this->port; + } + + /** + * @inheritdoc + */ + public function getPath() + { + return $this->path; + } + + /** + * @inheritdoc + */ + public function getQuery() + { + return $this->query; + } + + /** + * @inheritdoc + */ + public function getFragment() + { + return $this->fragment; + } + + /** + * @inheritdoc + */ + public function withScheme($scheme) + { + $scheme = UriPartsFilter::filterScheme($scheme); + + if ($this->scheme === $scheme) { + return $this; + } + + $new = clone $this; + $new->scheme = $scheme; + $new->unsetDefaultPort(); + $new->validate(); + + return $new; + } + + /** + * @inheritdoc + * @throws InvalidArgumentException + */ + public function withUserInfo($user, $password = null) + { + $user = UriPartsFilter::filterUserInfo($user); + $password = UriPartsFilter::filterUserInfo($password ?? ''); + + if ($this->user === $user && $this->password === $password) { + return $this; + } + + $new = clone $this; + $new->user = $user; + $new->password = $user !== '' ? $password : ''; + $new->validate(); + + return $new; + } + + /** + * @inheritdoc + */ + public function withHost($host) + { + $host = UriPartsFilter::filterHost($host); + + if ($this->host === $host) { + return $this; + } + + $new = clone $this; + $new->host = $host; + $new->validate(); + + return $new; + } + + /** + * @inheritdoc + */ + public function withPort($port) + { + $port = UriPartsFilter::filterPort($port); + + if ($this->port === $port) { + return $this; + } + + $new = clone $this; + $new->port = $port; + $new->unsetDefaultPort(); + $new->validate(); + + return $new; + } + + /** + * @inheritdoc + */ + public function withPath($path) + { + $path = UriPartsFilter::filterPath($path); + + if ($this->path === $path) { + return $this; + } + + $new = clone $this; + $new->path = $path; + $new->validate(); + + return $new; + } + + /** + * @inheritdoc + */ + public function withQuery($query) + { + $query = UriPartsFilter::filterQueryOrFragment($query); + + if ($this->query === $query) { + return $this; + } + + $new = clone $this; + $new->query = $query; + + return $new; + } + + /** + * @inheritdoc + * @throws InvalidArgumentException + */ + public function withFragment($fragment) + { + $fragment = UriPartsFilter::filterQueryOrFragment($fragment); + + if ($this->fragment === $fragment) { + return $this; + } + + $new = clone $this; + $new->fragment = $fragment; + + return $new; + } + + /** + * @return string + */ + #[\ReturnTypeWillChange] + public function __toString() + { + return $this->getUrl(); + } + + /** + * @return array + */ + protected function getParts() + { + return [ + 'scheme' => $this->scheme, + 'host' => $this->host, + 'port' => $this->port, + 'user' => $this->user, + 'pass' => $this->password, + 'path' => $this->path, + 'query' => $this->query, + 'fragment' => $this->fragment + ]; + } + + /** + * Return the fully qualified base URL ( like http://getgrav.org ). + * + * Note that this method never includes a trailing / + * + * @return string + */ + protected function getBaseUrl() + { + $uri = ''; + + $scheme = $this->getScheme(); + if ($scheme !== '') { + $uri .= $scheme . ':'; + } + + $authority = $this->getAuthority(); + if ($authority !== '' || $scheme === 'file') { + $uri .= '//' . $authority; + } + + return $uri; + } + + /** + * @return string + */ + protected function getUrl() + { + $uri = $this->getBaseUrl() . $this->getPath(); + + $query = $this->getQuery(); + if ($query !== '') { + $uri .= '?' . $query; + } + + $fragment = $this->getFragment(); + if ($fragment !== '') { + $uri .= '#' . $fragment; + } + + return $uri; + } + + /** + * @return string + */ + protected function getUser() + { + return $this->user; + } + + /** + * @return string + */ + protected function getPassword() + { + return $this->password; + } + + /** + * @param array $parts + * @return void + * @throws InvalidArgumentException + */ + protected function initParts(array $parts) + { + $this->scheme = isset($parts['scheme']) ? UriPartsFilter::filterScheme($parts['scheme']) : ''; + $this->user = isset($parts['user']) ? UriPartsFilter::filterUserInfo($parts['user']) : ''; + $this->password = isset($parts['pass']) ? UriPartsFilter::filterUserInfo($parts['pass']) : ''; + $this->host = isset($parts['host']) ? UriPartsFilter::filterHost($parts['host']) : ''; + $this->port = isset($parts['port']) ? UriPartsFilter::filterPort((int)$parts['port']) : null; + $this->path = isset($parts['path']) ? UriPartsFilter::filterPath($parts['path']) : ''; + $this->query = isset($parts['query']) ? UriPartsFilter::filterQueryOrFragment($parts['query']) : ''; + $this->fragment = isset($parts['fragment']) ? UriPartsFilter::filterQueryOrFragment($parts['fragment']) : ''; + + $this->unsetDefaultPort(); + $this->validate(); + } + + /** + * @return void + * @throws InvalidArgumentException + */ + private function validate() + { + if ($this->host === '' && ($this->scheme === 'http' || $this->scheme === 'https')) { + throw new InvalidArgumentException('Uri with a scheme must have a host'); + } + + if ($this->getAuthority() === '') { + if (0 === strpos($this->path, '//')) { + throw new InvalidArgumentException('The path of a URI without an authority must not start with two slashes \'//\''); + } + if ($this->scheme === '' && false !== strpos(explode('/', $this->path, 2)[0], ':')) { + throw new InvalidArgumentException('A relative URI must not have a path beginning with a segment containing a colon'); + } + } elseif (isset($this->path[0]) && $this->path[0] !== '/') { + throw new InvalidArgumentException('The path of a URI with an authority must start with a slash \'/\' or be empty'); + } + } + + /** + * @return bool + */ + protected function isDefaultPort() + { + $scheme = $this->scheme; + $port = $this->port; + + return $this->port === null + || (isset(static::$defaultPorts[$scheme]) && $port === static::$defaultPorts[$scheme]); + } + + /** + * @return void + */ + private function unsetDefaultPort() + { + if ($this->isDefaultPort()) { + $this->port = null; + } + } +} diff --git a/system/src/Grav/Framework/Psr7/Request.php b/system/src/Grav/Framework/Psr7/Request.php new file mode 100644 index 0000000..ced441f --- /dev/null +++ b/system/src/Grav/Framework/Psr7/Request.php @@ -0,0 +1,34 @@ +message = new \Nyholm\Psr7\Request($method, $uri, $headers, $body, $version); + } +} diff --git a/system/src/Grav/Framework/Psr7/Response.php b/system/src/Grav/Framework/Psr7/Response.php new file mode 100644 index 0000000..4126ff8 --- /dev/null +++ b/system/src/Grav/Framework/Psr7/Response.php @@ -0,0 +1,265 @@ +message = new \Nyholm\Psr7\Response($status, $headers, $body, $version, $reason); + } + + /** + * Json. + * + * Note: This method is not part of the PSR-7 standard. + * + * This method prepares the response object to return an HTTP Json + * response to the client. + * + * @param mixed $data The data + * @param int|null $status The HTTP status code. + * @param int $options Json encoding options + * @param int $depth Json encoding max depth + * @return static + * @phpstan-param positive-int $depth + */ + public function withJson($data, int $status = null, int $options = 0, int $depth = 512): ResponseInterface + { + $json = (string) json_encode($data, $options, $depth); + + if (json_last_error() !== JSON_ERROR_NONE) { + throw new RuntimeException(json_last_error_msg(), json_last_error()); + } + + $response = $this->getResponse() + ->withHeader('Content-Type', 'application/json;charset=utf-8') + ->withBody(new Stream($json)); + + if ($status !== null) { + $response = $response->withStatus($status); + } + + $new = clone $this; + $new->message = $response; + + return $new; + } + + /** + * Redirect. + * + * Note: This method is not part of the PSR-7 standard. + * + * This method prepares the response object to return an HTTP Redirect + * response to the client. + * + * @param string $url The redirect destination. + * @param int|null $status The redirect HTTP status code. + * @return static + */ + public function withRedirect(string $url, $status = null): ResponseInterface + { + $response = $this->getResponse()->withHeader('Location', $url); + + if ($status === null) { + $status = 302; + } + + $new = clone $this; + $new->message = $response->withStatus($status); + + return $new; + } + + /** + * Is this response empty? + * + * Note: This method is not part of the PSR-7 standard. + * + * @return bool + */ + public function isEmpty(): bool + { + return in_array($this->getResponse()->getStatusCode(), [204, 205, 304], true); + } + + + /** + * Is this response OK? + * + * Note: This method is not part of the PSR-7 standard. + * + * @return bool + */ + public function isOk(): bool + { + return $this->getResponse()->getStatusCode() === 200; + } + + /** + * Is this response a redirect? + * + * Note: This method is not part of the PSR-7 standard. + * + * @return bool + */ + public function isRedirect(): bool + { + return in_array($this->getResponse()->getStatusCode(), [301, 302, 303, 307, 308], true); + } + + /** + * Is this response forbidden? + * + * Note: This method is not part of the PSR-7 standard. + * + * @return bool + * @api + */ + public function isForbidden(): bool + { + return $this->getResponse()->getStatusCode() === 403; + } + + /** + * Is this response not Found? + * + * Note: This method is not part of the PSR-7 standard. + * + * @return bool + */ + public function isNotFound(): bool + { + return $this->getResponse()->getStatusCode() === 404; + } + + /** + * Is this response informational? + * + * Note: This method is not part of the PSR-7 standard. + * + * @return bool + */ + public function isInformational(): bool + { + $response = $this->getResponse(); + + return $response->getStatusCode() >= 100 && $response->getStatusCode() < 200; + } + + /** + * Is this response successful? + * + * Note: This method is not part of the PSR-7 standard. + * + * @return bool + */ + public function isSuccessful(): bool + { + $response = $this->getResponse(); + + return $response->getStatusCode() >= 200 && $response->getStatusCode() < 300; + } + + /** + * Is this response a redirection? + * + * Note: This method is not part of the PSR-7 standard. + * + * @return bool + */ + public function isRedirection(): bool + { + $response = $this->getResponse(); + + return $response->getStatusCode() >= 300 && $response->getStatusCode() < 400; + } + + /** + * Is this response a client error? + * + * Note: This method is not part of the PSR-7 standard. + * + * @return bool + */ + public function isClientError(): bool + { + $response = $this->getResponse(); + + return $response->getStatusCode() >= 400 && $response->getStatusCode() < 500; + } + + /** + * Is this response a server error? + * + * Note: This method is not part of the PSR-7 standard. + * + * @return bool + */ + public function isServerError(): bool + { + $response = $this->getResponse(); + + return $response->getStatusCode() >= 500 && $response->getStatusCode() < 600; + } + + /** + * Convert response to string. + * + * Note: This method is not part of the PSR-7 standard. + * + * @return string + */ + public function __toString(): string + { + $response = $this->getResponse(); + $output = sprintf( + 'HTTP/%s %s %s%s', + $response->getProtocolVersion(), + $response->getStatusCode(), + $response->getReasonPhrase(), + self::EOL + ); + + foreach ($response->getHeaders() as $name => $values) { + $output .= sprintf('%s: %s', $name, $response->getHeaderLine($name)) . self::EOL; + } + + $output .= self::EOL; + $output .= $response->getBody(); + + return $output; + } +} diff --git a/system/src/Grav/Framework/Psr7/ServerRequest.php b/system/src/Grav/Framework/Psr7/ServerRequest.php new file mode 100644 index 0000000..79f273b --- /dev/null +++ b/system/src/Grav/Framework/Psr7/ServerRequest.php @@ -0,0 +1,364 @@ +message = new \Nyholm\Psr7\ServerRequest($method, $uri, $headers, $body, $version, $serverParams); + } + + /** + * Get serverRequest content character set, if known. + * + * Note: This method is not part of the PSR-7 standard. + * + * @return string|null + */ + public function getContentCharset(): ?string + { + $mediaTypeParams = $this->getMediaTypeParams(); + + if (isset($mediaTypeParams['charset'])) { + return $mediaTypeParams['charset']; + } + + return null; + } + + /** + * Get serverRequest content type. + * + * Note: This method is not part of the PSR-7 standard. + * + * @return string|null The serverRequest content type, if known + */ + public function getContentType(): ?string + { + $result = $this->getRequest()->getHeader('Content-Type'); + + return $result ? $result[0] : null; + } + + /** + * Get serverRequest content length, if known. + * + * Note: This method is not part of the PSR-7 standard. + * + * @return int|null + */ + public function getContentLength(): ?int + { + $result = $this->getRequest()->getHeader('Content-Length'); + + return $result ? (int) $result[0] : null; + } + + /** + * Fetch cookie value from cookies sent by the client to the server. + * + * Note: This method is not part of the PSR-7 standard. + * + * @param string $key The attribute name. + * @param mixed $default Default value to return if the attribute does not exist. + * + * @return mixed + */ + public function getCookieParam($key, $default = null) + { + $cookies = $this->getRequest()->getCookieParams(); + + return $cookies[$key] ?? $default; + } + + /** + * Get serverRequest media type, if known. + * + * Note: This method is not part of the PSR-7 standard. + * + * @return string|null The serverRequest media type, minus content-type params + */ + public function getMediaType(): ?string + { + $contentType = $this->getContentType(); + + if ($contentType) { + $contentTypeParts = preg_split('/\s*[;,]\s*/', $contentType); + if ($contentTypeParts === false) { + return null; + } + return strtolower($contentTypeParts[0]); + } + + return null; + } + + /** + * Get serverRequest media type params, if known. + * + * Note: This method is not part of the PSR-7 standard. + * + * @return mixed[] + */ + public function getMediaTypeParams(): array + { + $contentType = $this->getContentType(); + $contentTypeParams = []; + + if ($contentType) { + $contentTypeParts = preg_split('/\s*[;,]\s*/', $contentType); + if ($contentTypeParts !== false) { + $contentTypePartsLength = count($contentTypeParts); + for ($i = 1; $i < $contentTypePartsLength; $i++) { + $paramParts = explode('=', $contentTypeParts[$i]); + $contentTypeParams[strtolower($paramParts[0])] = $paramParts[1]; + } + } + } + + return $contentTypeParams; + } + + /** + * Fetch serverRequest parameter value from body or query string (in that order). + * + * Note: This method is not part of the PSR-7 standard. + * + * @param string $key The parameter key. + * @param string|null $default The default value. + * + * @return mixed The parameter value. + */ + public function getParam($key, $default = null) + { + $postParams = $this->getParsedBody(); + $getParams = $this->getQueryParams(); + $result = $default; + + if (is_array($postParams) && isset($postParams[$key])) { + $result = $postParams[$key]; + } elseif (is_object($postParams) && property_exists($postParams, $key)) { + $result = $postParams->$key; + } elseif (isset($getParams[$key])) { + $result = $getParams[$key]; + } + + return $result; + } + + /** + * Fetch associative array of body and query string parameters. + * + * Note: This method is not part of the PSR-7 standard. + * + * @return mixed[] + */ + public function getParams(): array + { + $params = $this->getQueryParams(); + $postParams = $this->getParsedBody(); + + if ($postParams) { + $params = array_merge($params, (array)$postParams); + } + + return $params; + } + + /** + * Fetch parameter value from serverRequest body. + * + * Note: This method is not part of the PSR-7 standard. + * + * @param string $key + * @param mixed $default + * + * @return mixed + */ + public function getParsedBodyParam($key, $default = null) + { + $postParams = $this->getParsedBody(); + $result = $default; + + if (is_array($postParams) && isset($postParams[$key])) { + $result = $postParams[$key]; + } elseif (is_object($postParams) && property_exists($postParams, $key)) { + $result = $postParams->{$key}; + } + + return $result; + } + + /** + * Fetch parameter value from query string. + * + * Note: This method is not part of the PSR-7 standard. + * + * @param string $key + * @param mixed $default + * + * @return mixed + */ + public function getQueryParam($key, $default = null) + { + $getParams = $this->getQueryParams(); + + return $getParams[$key] ?? $default; + } + + /** + * Retrieve a server parameter. + * + * Note: This method is not part of the PSR-7 standard. + * + * @param string $key + * @param mixed $default + * @return mixed + */ + public function getServerParam($key, $default = null) + { + $serverParams = $this->getRequest()->getServerParams(); + + return $serverParams[$key] ?? $default; + } + + /** + * Does this serverRequest use a given method? + * + * Note: This method is not part of the PSR-7 standard. + * + * @param string $method HTTP method + * @return bool + */ + public function isMethod($method): bool + { + return $this->getRequest()->getMethod() === $method; + } + + /** + * Is this a DELETE serverRequest? + * + * Note: This method is not part of the PSR-7 standard. + * + * @return bool + */ + public function isDelete(): bool + { + return $this->isMethod('DELETE'); + } + + /** + * Is this a GET serverRequest? + * + * Note: This method is not part of the PSR-7 standard. + * + * @return bool + */ + public function isGet(): bool + { + return $this->isMethod('GET'); + } + + /** + * Is this a HEAD serverRequest? + * + * Note: This method is not part of the PSR-7 standard. + * + * @return bool + */ + public function isHead(): bool + { + return $this->isMethod('HEAD'); + } + + /** + * Is this a OPTIONS serverRequest? + * + * Note: This method is not part of the PSR-7 standard. + * + * @return bool + */ + public function isOptions(): bool + { + return $this->isMethod('OPTIONS'); + } + + /** + * Is this a PATCH serverRequest? + * + * Note: This method is not part of the PSR-7 standard. + * + * @return bool + */ + public function isPatch(): bool + { + return $this->isMethod('PATCH'); + } + + /** + * Is this a POST serverRequest? + * + * Note: This method is not part of the PSR-7 standard. + * + * @return bool + */ + public function isPost(): bool + { + return $this->isMethod('POST'); + } + + /** + * Is this a PUT serverRequest? + * + * Note: This method is not part of the PSR-7 standard. + * + * @return bool + */ + public function isPut(): bool + { + return $this->isMethod('PUT'); + } + + /** + * Is this an XHR serverRequest? + * + * Note: This method is not part of the PSR-7 standard. + * + * @return bool + */ + public function isXhr(): bool + { + return $this->getRequest()->getHeaderLine('X-Requested-With') === 'XMLHttpRequest'; + } +} diff --git a/system/src/Grav/Framework/Psr7/Stream.php b/system/src/Grav/Framework/Psr7/Stream.php new file mode 100644 index 0000000..abed632 --- /dev/null +++ b/system/src/Grav/Framework/Psr7/Stream.php @@ -0,0 +1,43 @@ +stream = \Nyholm\Psr7\Stream::create($body); + } +} diff --git a/system/src/Grav/Framework/Psr7/Traits/MessageDecoratorTrait.php b/system/src/Grav/Framework/Psr7/Traits/MessageDecoratorTrait.php new file mode 100644 index 0000000..1eb1d2e --- /dev/null +++ b/system/src/Grav/Framework/Psr7/Traits/MessageDecoratorTrait.php @@ -0,0 +1,140 @@ + + */ +trait MessageDecoratorTrait +{ + /** @var MessageInterface */ + private $message; + + /** + * Returns the decorated message. + * + * Since the underlying Message is immutable as well + * exposing it is not an issue, because it's state cannot be altered + * + * @return MessageInterface + */ + public function getMessage(): MessageInterface + { + return $this->message; + } + + /** + * {@inheritdoc} + */ + public function getProtocolVersion(): string + { + return $this->message->getProtocolVersion(); + } + + /** + * {@inheritdoc} + */ + public function withProtocolVersion($version): self + { + $new = clone $this; + $new->message = $this->message->withProtocolVersion($version); + + return $new; + } + + /** + * {@inheritdoc} + */ + public function getHeaders(): array + { + return $this->message->getHeaders(); + } + + /** + * {@inheritdoc} + */ + public function hasHeader($header): bool + { + return $this->message->hasHeader($header); + } + + /** + * {@inheritdoc} + */ + public function getHeader($header): array + { + return $this->message->getHeader($header); + } + + /** + * {@inheritdoc} + */ + public function getHeaderLine($header): string + { + return $this->message->getHeaderLine($header); + } + + /** + * {@inheritdoc} + */ + public function getBody(): StreamInterface + { + return $this->message->getBody(); + } + + /** + * {@inheritdoc} + */ + public function withHeader($header, $value): self + { + $new = clone $this; + $new->message = $this->message->withHeader($header, $value); + + return $new; + } + + /** + * {@inheritdoc} + */ + public function withAddedHeader($header, $value): self + { + $new = clone $this; + $new->message = $this->message->withAddedHeader($header, $value); + + return $new; + } + + /** + * {@inheritdoc} + */ + public function withoutHeader($header): self + { + $new = clone $this; + $new->message = $this->message->withoutHeader($header); + + return $new; + } + + /** + * {@inheritdoc} + */ + public function withBody(StreamInterface $body): self + { + $new = clone $this; + $new->message = $this->message->withBody($body); + + return $new; + } +} diff --git a/system/src/Grav/Framework/Psr7/Traits/RequestDecoratorTrait.php b/system/src/Grav/Framework/Psr7/Traits/RequestDecoratorTrait.php new file mode 100644 index 0000000..8f97065 --- /dev/null +++ b/system/src/Grav/Framework/Psr7/Traits/RequestDecoratorTrait.php @@ -0,0 +1,112 @@ + + */ +trait RequestDecoratorTrait +{ + use MessageDecoratorTrait { + getMessage as private; + } + + /** + * Returns the decorated request. + * + * Since the underlying Request is immutable as well + * exposing it is not an issue, because it's state cannot be altered + * + * @return RequestInterface + */ + public function getRequest(): RequestInterface + { + /** @var RequestInterface $message */ + $message = $this->getMessage(); + + return $message; + } + + /** + * Exchanges the underlying request with another. + * + * @param RequestInterface $request + * @return self + */ + public function withRequest(RequestInterface $request): self + { + $new = clone $this; + $new->message = $request; + + return $new; + } + + /** + * {@inheritdoc} + */ + public function getRequestTarget(): string + { + return $this->getRequest()->getRequestTarget(); + } + + /** + * {@inheritdoc} + */ + public function withRequestTarget($requestTarget): self + { + $new = clone $this; + $new->message = $this->getRequest()->withRequestTarget($requestTarget); + + return $new; + } + + /** + * {@inheritdoc} + */ + public function getMethod(): string + { + return $this->getRequest()->getMethod(); + } + + /** + * {@inheritdoc} + */ + public function withMethod($method): self + { + $new = clone $this; + $new->message = $this->getRequest()->withMethod($method); + + return $new; + } + + /** + * {@inheritdoc} + */ + public function getUri(): UriInterface + { + return $this->getRequest()->getUri(); + } + + /** + * {@inheritdoc} + */ + public function withUri(UriInterface $uri, $preserveHost = false): self + { + $new = clone $this; + $new->message = $this->getRequest()->withUri($uri, $preserveHost); + + return $new; + } +} diff --git a/system/src/Grav/Framework/Psr7/Traits/ResponseDecoratorTrait.php b/system/src/Grav/Framework/Psr7/Traits/ResponseDecoratorTrait.php new file mode 100644 index 0000000..cb8ec98 --- /dev/null +++ b/system/src/Grav/Framework/Psr7/Traits/ResponseDecoratorTrait.php @@ -0,0 +1,82 @@ + + */ +trait ResponseDecoratorTrait +{ + use MessageDecoratorTrait { + getMessage as private; + } + + /** + * Returns the decorated response. + * + * Since the underlying Response is immutable as well + * exposing it is not an issue, because it's state cannot be altered + * + * @return ResponseInterface + */ + public function getResponse(): ResponseInterface + { + /** @var ResponseInterface $message */ + $message = $this->getMessage(); + + return $message; + } + + /** + * Exchanges the underlying response with another. + * + * @param ResponseInterface $response + * + * @return self + */ + public function withResponse(ResponseInterface $response): self + { + $new = clone $this; + $new->message = $response; + + return $new; + } + + /** + * {@inheritdoc} + */ + public function getStatusCode(): int + { + return $this->getResponse()->getStatusCode(); + } + + /** + * {@inheritdoc} + */ + public function withStatus($code, $reasonPhrase = ''): self + { + $new = clone $this; + $new->message = $this->getResponse()->withStatus($code, $reasonPhrase); + + return $new; + } + + /** + * {@inheritdoc} + */ + public function getReasonPhrase(): string + { + return $this->getResponse()->getReasonPhrase(); + } +} diff --git a/system/src/Grav/Framework/Psr7/Traits/ServerRequestDecoratorTrait.php b/system/src/Grav/Framework/Psr7/Traits/ServerRequestDecoratorTrait.php new file mode 100644 index 0000000..82acc68 --- /dev/null +++ b/system/src/Grav/Framework/Psr7/Traits/ServerRequestDecoratorTrait.php @@ -0,0 +1,176 @@ +getMessage(); + + return $message; + } + + /** + * @inheritdoc + */ + public function getAttribute($name, $default = null) + { + return $this->getRequest()->getAttribute($name, $default); + } + + /** + * @inheritdoc + */ + public function getAttributes() + { + return $this->getRequest()->getAttributes(); + } + + + /** + * @inheritdoc + */ + public function getCookieParams() + { + return $this->getRequest()->getCookieParams(); + } + + /** + * @inheritdoc + */ + public function getParsedBody() + { + return $this->getRequest()->getParsedBody(); + } + + /** + * @inheritdoc + */ + public function getQueryParams() + { + return $this->getRequest()->getQueryParams(); + } + + /** + * @inheritdoc + */ + public function getServerParams() + { + return $this->getRequest()->getServerParams(); + } + + /** + * @inheritdoc + */ + public function getUploadedFiles() + { + return $this->getRequest()->getUploadedFiles(); + } + + /** + * @inheritdoc + */ + public function withAttribute($name, $value) + { + $new = clone $this; + $new->message = $this->getRequest()->withAttribute($name, $value); + + return $new; + } + + /** + * @param array $attributes + * @return ServerRequestInterface + */ + public function withAttributes(array $attributes) + { + $new = clone $this; + foreach ($attributes as $attribute => $value) { + $new->message = $new->withAttribute($attribute, $value); + } + + return $new; + } + + /** + * @inheritdoc + */ + public function withoutAttribute($name) + { + $new = clone $this; + $new->message = $this->getRequest()->withoutAttribute($name); + + return $new; + } + + /** + * @inheritdoc + */ + public function withCookieParams(array $cookies) + { + $new = clone $this; + $new->message = $this->getRequest()->withCookieParams($cookies); + + return $new; + } + + /** + * @inheritdoc + */ + public function withParsedBody($data) + { + $new = clone $this; + $new->message = $this->getRequest()->withParsedBody($data); + + return $new; + } + + /** + * @inheritdoc + */ + public function withQueryParams(array $query) + { + $new = clone $this; + $new->message = $this->getRequest()->withQueryParams($query); + + return $new; + } + + /** + * @inheritdoc + */ + public function withUploadedFiles(array $uploadedFiles) + { + $new = clone $this; + $new->message = $this->getRequest()->withUploadedFiles($uploadedFiles); + + return $new; + } +} diff --git a/system/src/Grav/Framework/Psr7/Traits/StreamDecoratorTrait.php b/system/src/Grav/Framework/Psr7/Traits/StreamDecoratorTrait.php new file mode 100644 index 0000000..a093732 --- /dev/null +++ b/system/src/Grav/Framework/Psr7/Traits/StreamDecoratorTrait.php @@ -0,0 +1,153 @@ +stream->__toString(); + } + + /** + * @return void + */ + #[\ReturnTypeWillChange] + public function __destruct() + { + $this->stream->close(); + } + + /** + * {@inheritdoc} + */ + public function close(): void + { + $this->stream->close(); + } + + /** + * {@inheritdoc} + */ + public function detach() + { + return $this->stream->detach(); + } + + /** + * {@inheritdoc} + */ + public function getSize(): ?int + { + return $this->stream->getSize(); + } + + /** + * {@inheritdoc} + */ + public function tell(): int + { + return $this->stream->tell(); + } + + /** + * {@inheritdoc} + */ + public function eof(): bool + { + return $this->stream->eof(); + } + + /** + * {@inheritdoc} + */ + public function isSeekable(): bool + { + return $this->stream->isSeekable(); + } + + /** + * {@inheritdoc} + */ + public function seek($offset, $whence = \SEEK_SET): void + { + $this->stream->seek($offset, $whence); + } + + /** + * {@inheritdoc} + */ + public function rewind(): void + { + $this->stream->rewind(); + } + + /** + * {@inheritdoc} + */ + public function isWritable(): bool + { + return $this->stream->isWritable(); + } + + /** + * {@inheritdoc} + */ + public function write($string): int + { + return $this->stream->write($string); + } + + /** + * {@inheritdoc} + */ + public function isReadable(): bool + { + return $this->stream->isReadable(); + } + + /** + * {@inheritdoc} + */ + public function read($length): string + { + return $this->stream->read($length); + } + + /** + * {@inheritdoc} + */ + public function getContents(): string + { + return $this->stream->getContents(); + } + + /** + * {@inheritdoc} + */ + public function getMetadata($key = null) + { + return $this->stream->getMetadata($key); + } +} diff --git a/system/src/Grav/Framework/Psr7/Traits/UploadedFileDecoratorTrait.php b/system/src/Grav/Framework/Psr7/Traits/UploadedFileDecoratorTrait.php new file mode 100644 index 0000000..0bd835d --- /dev/null +++ b/system/src/Grav/Framework/Psr7/Traits/UploadedFileDecoratorTrait.php @@ -0,0 +1,73 @@ +uploadedFile->getStream(); + } + + /** + * @param string $targetPath + */ + public function moveTo($targetPath): void + { + $this->uploadedFile->moveTo($targetPath); + } + + /** + * @return int|null + */ + public function getSize(): ?int + { + return $this->uploadedFile->getSize(); + } + + /** + * @return int + */ + public function getError(): int + { + return $this->uploadedFile->getError(); + } + + /** + * @return string|null + */ + public function getClientFilename(): ?string + { + return $this->uploadedFile->getClientFilename(); + } + + /** + * @return string|null + */ + public function getClientMediaType(): ?string + { + return $this->uploadedFile->getClientMediaType(); + } +} diff --git a/system/src/Grav/Framework/Psr7/Traits/UriDecorationTrait.php b/system/src/Grav/Framework/Psr7/Traits/UriDecorationTrait.php new file mode 100644 index 0000000..5e43942 --- /dev/null +++ b/system/src/Grav/Framework/Psr7/Traits/UriDecorationTrait.php @@ -0,0 +1,188 @@ +uri->__toString(); + } + + /** + * @return string + */ + public function getScheme(): string + { + return $this->uri->getScheme(); + } + + /** + * @return string + */ + public function getAuthority(): string + { + return $this->uri->getAuthority(); + } + + /** + * @return string + */ + public function getUserInfo(): string + { + return $this->uri->getUserInfo(); + } + + /** + * @return string + */ + public function getHost(): string + { + return $this->uri->getHost(); + } + + /** + * @return int|null + */ + public function getPort(): ?int + { + return $this->uri->getPort(); + } + + /** + * @return string + */ + public function getPath(): string + { + return $this->uri->getPath(); + } + + /** + * @return string + */ + public function getQuery(): string + { + return $this->uri->getQuery(); + } + + /** + * @return string + */ + public function getFragment(): string + { + return $this->uri->getFragment(); + } + + /** + * @param string $scheme + * @return UriInterface + */ + public function withScheme($scheme): UriInterface + { + $new = clone $this; + $new->uri = $this->uri->withScheme($scheme); + + /** @var UriInterface $new */ + return $new; + } + + /** + * @param string $user + * @param string|null $password + * @return UriInterface + */ + public function withUserInfo($user, $password = null): UriInterface + { + $new = clone $this; + $new->uri = $this->uri->withUserInfo($user, $password); + + /** @var UriInterface $new */ + return $new; + } + + /** + * @param string $host + * @return UriInterface + */ + public function withHost($host): UriInterface + { + $new = clone $this; + $new->uri = $this->uri->withHost($host); + + /** @var UriInterface $new */ + return $new; + } + + /** + * @param int|null $port + * @return UriInterface + */ + public function withPort($port): UriInterface + { + $new = clone $this; + $new->uri = $this->uri->withPort($port); + + /** @var UriInterface $new */ + return $new; + } + + /** + * @param string $path + * @return UriInterface + */ + public function withPath($path): UriInterface + { + $new = clone $this; + $new->uri = $this->uri->withPath($path); + + /** @var UriInterface $new */ + return $new; + } + + /** + * @param string $query + * @return UriInterface + */ + public function withQuery($query): UriInterface + { + $new = clone $this; + $new->uri = $this->uri->withQuery($query); + + /** @var UriInterface $new */ + return $new; + } + + /** + * @param string $fragment + * @return UriInterface + */ + public function withFragment($fragment): UriInterface + { + $new = clone $this; + $new->uri = $this->uri->withFragment($fragment); + + /** @var UriInterface $new */ + return $new; + } +} diff --git a/system/src/Grav/Framework/Psr7/UploadedFile.php b/system/src/Grav/Framework/Psr7/UploadedFile.php new file mode 100644 index 0000000..f7b5fef --- /dev/null +++ b/system/src/Grav/Framework/Psr7/UploadedFile.php @@ -0,0 +1,70 @@ +uploadedFile = new \Nyholm\Psr7\UploadedFile($streamOrFile, $size, $errorStatus, $clientFilename, $clientMediaType); + } + + /** + * @param array $meta + * @return $this + */ + public function setMeta(array $meta) + { + $this->meta = $meta; + + return $this; + } + + /** + * @param array $meta + * @return $this + */ + public function addMeta(array $meta) + { + $this->meta = array_merge($this->meta, $meta); + + return $this; + } + + /** + * @return array + */ + public function getMeta(): array + { + return $this->meta; + } +} diff --git a/system/src/Grav/Framework/Psr7/Uri.php b/system/src/Grav/Framework/Psr7/Uri.php new file mode 100644 index 0000000..2638876 --- /dev/null +++ b/system/src/Grav/Framework/Psr7/Uri.php @@ -0,0 +1,135 @@ +uri = new \Nyholm\Psr7\Uri($uri); + } + + /** + * @return array + */ + public function getQueryParams(): array + { + return UriFactory::parseQuery($this->getQuery()); + } + + /** + * @param array $params + * @return UriInterface + */ + public function withQueryParams(array $params): UriInterface + { + $query = UriFactory::buildQuery($params); + + return $this->withQuery($query); + } + + /** + * Whether the URI has the default port of the current scheme. + * + * `$uri->getPort()` may return the standard port. This method can be used for some non-http/https Uri. + * + * @return bool + */ + public function isDefaultPort(): bool + { + return $this->getPort() === null || GuzzleUri::isDefaultPort($this); + } + + /** + * Whether the URI is absolute, i.e. it has a scheme. + * + * An instance of UriInterface can either be an absolute URI or a relative reference. This method returns true + * if it is the former. An absolute URI has a scheme. A relative reference is used to express a URI relative + * to another URI, the base URI. Relative references can be divided into several forms: + * - network-path references, e.g. '//example.com/path' + * - absolute-path references, e.g. '/path' + * - relative-path references, e.g. 'subpath' + * + * @return bool + * @link https://tools.ietf.org/html/rfc3986#section-4 + */ + public function isAbsolute(): bool + { + return GuzzleUri::isAbsolute($this); + } + + /** + * Whether the URI is a network-path reference. + * + * A relative reference that begins with two slash characters is termed an network-path reference. + * + * @return bool + * @link https://tools.ietf.org/html/rfc3986#section-4.2 + */ + public function isNetworkPathReference(): bool + { + return GuzzleUri::isNetworkPathReference($this); + } + + /** + * Whether the URI is a absolute-path reference. + * + * A relative reference that begins with a single slash character is termed an absolute-path reference. + * + * @return bool + * @link https://tools.ietf.org/html/rfc3986#section-4.2 + */ + public function isAbsolutePathReference(): bool + { + return GuzzleUri::isAbsolutePathReference($this); + } + + /** + * Whether the URI is a relative-path reference. + * + * A relative reference that does not begin with a slash character is termed a relative-path reference. + * + * @return bool + * @link https://tools.ietf.org/html/rfc3986#section-4.2 + */ + public function isRelativePathReference(): bool + { + return GuzzleUri::isRelativePathReference($this); + } + + /** + * Whether the URI is a same-document reference. + * + * A same-document reference refers to a URI that is, aside from its fragment + * component, identical to the base URI. When no base URI is given, only an empty + * URI reference (apart from its fragment) is considered a same-document reference. + * + * @param UriInterface|null $base An optional base URI to compare against + * @return bool + * @link https://tools.ietf.org/html/rfc3986#section-4.4 + */ + public function isSameDocumentReference(UriInterface $base = null): bool + { + return GuzzleUri::isSameDocumentReference($this, $base); + } +} diff --git a/system/src/Grav/Framework/Relationships/Relationships.php b/system/src/Grav/Framework/Relationships/Relationships.php new file mode 100644 index 0000000..6485682 --- /dev/null +++ b/system/src/Grav/Framework/Relationships/Relationships.php @@ -0,0 +1,217 @@ + + */ +class Relationships implements RelationshipsInterface +{ + /** @var P */ + protected $parent; + /** @var array */ + protected $options; + + /** @var RelationshipInterface[] */ + protected $relationships; + + /** + * Relationships constructor. + * @param P $parent + * @param array $options + */ + public function __construct(IdentifierInterface $parent, array $options) + { + $this->parent = $parent; + $this->options = $options; + $this->relationships = []; + } + + /** + * @return bool + * @phpstan-pure + */ + public function isModified(): bool + { + return !empty($this->getModified()); + } + + /** + * @return RelationshipInterface[] + * @phpstan-pure + */ + public function getModified(): array + { + $list = []; + foreach ($this->relationships as $name => $relationship) { + if ($relationship->isModified()) { + $list[$name] = $relationship; + } + } + + return $list; + } + + /** + * @return int + * @phpstan-pure + */ + public function count(): int + { + return count($this->options); + } + + /** + * @param string $offset + * @return bool + * @phpstan-pure + */ + public function offsetExists($offset): bool + { + return isset($this->options[$offset]); + } + + /** + * @param string $offset + * @return RelationshipInterface|null + */ + public function offsetGet($offset): ?RelationshipInterface + { + if (!isset($this->relationships[$offset])) { + $options = $this->options[$offset] ?? null; + if (null === $options) { + return null; + } + + $this->relationships[$offset] = $this->createRelationship($offset, $options); + } + + return $this->relationships[$offset]; + } + + /** + * @param string $offset + * @param mixed $value + * @return never-return + */ + public function offsetSet($offset, $value) + { + throw new RuntimeException('Setting relationship is not supported', 500); + } + + /** + * @param string $offset + * @return never-return + */ + public function offsetUnset($offset) + { + throw new RuntimeException('Removing relationship is not allowed', 500); + } + + /** + * @return RelationshipInterface|null + */ + public function current(): ?RelationshipInterface + { + $name = key($this->options); + if ($name === null) { + return null; + } + + return $this->offsetGet($name); + } + + /** + * @return string + * @phpstan-pure + */ + public function key(): string + { + return key($this->options); + } + + /** + * @return void + * @phpstan-pure + */ + public function next(): void + { + next($this->options); + } + + /** + * @return void + * @phpstan-pure + */ + public function rewind(): void + { + reset($this->options); + } + + /** + * @return bool + * @phpstan-pure + */ + public function valid(): bool + { + return key($this->options) !== null; + } + + /** + * @return array + */ + public function jsonSerialize(): array + { + $list = []; + foreach ($this as $name => $relationship) { + $list[$name] = $relationship->jsonSerialize(); + } + + return $list; + } + + /** + * @param string $name + * @param array $options + * @return ToOneRelationship|ToManyRelationship + */ + private function createRelationship(string $name, array $options): RelationshipInterface + { + $data = null; + + $parent = $this->parent; + if ($parent instanceof FlexIdentifier) { + $object = $parent->getObject(); + if (!method_exists($object, 'initRelationship')) { + throw new RuntimeException(sprintf('Bad relationship %s', $name), 500); + } + + $data = $object->initRelationship($name); + } + + $cardinality = $options['cardinality'] ?? ''; + switch ($cardinality) { + case 'to-one': + $relationship = new ToOneRelationship($parent, $name, $options, $data); + break; + case 'to-many': + $relationship = new ToManyRelationship($parent, $name, $options, $data ?? []); + break; + default: + throw new RuntimeException(sprintf('Bad relationship cardinality %s', $cardinality), 500); + } + + return $relationship; + } +} diff --git a/system/src/Grav/Framework/Relationships/ToManyRelationship.php b/system/src/Grav/Framework/Relationships/ToManyRelationship.php new file mode 100644 index 0000000..3ea501b --- /dev/null +++ b/system/src/Grav/Framework/Relationships/ToManyRelationship.php @@ -0,0 +1,259 @@ + + */ +class ToManyRelationship implements ToManyRelationshipInterface +{ + /** @template-use RelationshipTrait */ + use RelationshipTrait; + use Serializable; + + /** @var IdentifierInterface[] */ + protected $identifiers = []; + + /** + * ToManyRelationship constructor. + * @param string $name + * @param IdentifierInterface $parent + * @param iterable $identifiers + */ + public function __construct(IdentifierInterface $parent, string $name, array $options, iterable $identifiers = []) + { + $this->parent = $parent; + $this->name = $name; + + $this->parseOptions($options); + $this->addIdentifiers($identifiers); + + $this->modified = false; + } + + /** + * @return string + * @phpstan-pure + */ + public function getCardinality(): string + { + return 'to-many'; + } + + /** + * @return int + * @phpstan-pure + */ + public function count(): int + { + return count($this->identifiers); + } + + /** + * @return array + */ + public function fetch(): array + { + $list = []; + foreach ($this->identifiers as $identifier) { + if (is_callable([$identifier, 'getObject'])) { + $identifier = $identifier->getObject(); + } + $list[] = $identifier; + } + + return $list; + } + + /** + * @param string $id + * @param string|null $type + * @return bool + * @phpstan-pure + */ + public function has(string $id, string $type = null): bool + { + return $this->getIdentifier($id, $type) !== null; + } + + /** + * @param positive-int $pos + * @return IdentifierInterface|null + */ + public function getNthIdentifier(int $pos): ?IdentifierInterface + { + $items = array_keys($this->identifiers); + $key = $items[$pos - 1] ?? null; + if (null === $key) { + return null; + } + + return $this->identifiers[$key] ?? null; + } + + /** + * @param string $id + * @param string|null $type + * @return IdentifierInterface|null + * @phpstan-pure + */ + public function getIdentifier(string $id, string $type = null): ?IdentifierInterface + { + if (null === $type) { + $type = $this->getType(); + } + + if ($type === 'media' && !str_contains($id, '/')) { + $name = $this->name; + $id = $this->parent->getType() . '/' . $this->parent->getId() . '/'. $name . '/' . $id; + } + + $key = "{$type}/{$id}"; + + return $this->identifiers[$key] ?? null; + } + + /** + * @param string $id + * @param string|null $type + * @return T|null + */ + public function getObject(string $id, string $type = null): ?object + { + $identifier = $this->getIdentifier($id, $type); + if ($identifier && is_callable([$identifier, 'getObject'])) { + $identifier = $identifier->getObject(); + } + + return $identifier; + } + + /** + * @param IdentifierInterface $identifier + * @return bool + */ + public function addIdentifier(IdentifierInterface $identifier): bool + { + return $this->addIdentifiers([$identifier]); + } + + /** + * @param IdentifierInterface|null $identifier + * @return bool + */ + public function removeIdentifier(IdentifierInterface $identifier = null): bool + { + return !$identifier || $this->removeIdentifiers([$identifier]); + } + + /** + * @param iterable $identifiers + * @return bool + */ + public function addIdentifiers(iterable $identifiers): bool + { + foreach ($identifiers as $identifier) { + $type = $identifier->getType(); + $id = $identifier->getId(); + $key = "{$type}/{$id}"; + + $this->identifiers[$key] = $this->checkIdentifier($identifier); + $this->modified = true; + } + + return true; + } + + /** + * @param iterable $identifiers + * @return bool + */ + public function replaceIdentifiers(iterable $identifiers): bool + { + $this->identifiers = []; + $this->modified = true; + + return $this->addIdentifiers($identifiers); + } + + /** + * @param iterable $identifiers + * @return bool + */ + public function removeIdentifiers(iterable $identifiers): bool + { + foreach ($identifiers as $identifier) { + $type = $identifier->getType(); + $id = $identifier->getId(); + $key = "{$type}/{$id}"; + + unset($this->identifiers[$key]); + $this->modified = true; + } + + return true; + } + + /** + * @return iterable + * @phpstan-pure + */ + public function getIterator(): iterable + { + return new ArrayIterator($this->identifiers); + } + + /** + * @return array + */ + public function jsonSerialize(): array + { + $list = []; + foreach ($this->getIterator() as $item) { + $list[] = $item->jsonSerialize(); + } + + return $list; + } + + /** + * @return array + */ + public function __serialize(): array + { + return [ + 'parent' => $this->parent, + 'name' => $this->name, + 'type' => $this->type, + 'options' => $this->options, + 'modified' => $this->modified, + 'identifiers' => $this->identifiers, + ]; + } + + /** + * @param array $data + * @return void + */ + public function __unserialize(array $data): void + { + $this->parent = $data['parent']; + $this->name = $data['name']; + $this->type = $data['type']; + $this->options = $data['options']; + $this->modified = $data['modified']; + $this->identifiers = $data['identifiers']; + } +} diff --git a/system/src/Grav/Framework/Relationships/ToOneRelationship.php b/system/src/Grav/Framework/Relationships/ToOneRelationship.php new file mode 100644 index 0000000..9b09651 --- /dev/null +++ b/system/src/Grav/Framework/Relationships/ToOneRelationship.php @@ -0,0 +1,207 @@ + + */ +class ToOneRelationship implements ToOneRelationshipInterface +{ + /** @template-use RelationshipTrait */ + use RelationshipTrait; + use Serializable; + + /** @var IdentifierInterface|null */ + protected $identifier = null; + + public function __construct(IdentifierInterface $parent, string $name, array $options, IdentifierInterface $identifier = null) + { + $this->parent = $parent; + $this->name = $name; + + $this->parseOptions($options); + $this->replaceIdentifier($identifier); + + $this->modified = false; + } + + /** + * @return string + * @phpstan-pure + */ + public function getCardinality(): string + { + return 'to-one'; + } + + /** + * @return int + * @phpstan-pure + */ + public function count(): int + { + return $this->identifier ? 1 : 0; + } + + /** + * @return object|null + */ + public function fetch(): ?object + { + $identifier = $this->identifier; + if (is_callable([$identifier, 'getObject'])) { + $identifier = $identifier->getObject(); + } + + return $identifier; + } + + + /** + * @param string|null $id + * @param string|null $type + * @return bool + * @phpstan-pure + */ + public function has(string $id = null, string $type = null): bool + { + return $this->getIdentifier($id, $type) !== null; + } + + /** + * @param string|null $id + * @param string|null $type + * @return IdentifierInterface|null + * @phpstan-pure + */ + public function getIdentifier(string $id = null, string $type = null): ?IdentifierInterface + { + if ($id && $this->getType() === 'media' && !str_contains($id, '/')) { + $name = $this->name; + $id = $this->parent->getType() . '/' . $this->parent->getId() . '/'. $name . '/' . $id; + } + + $identifier = $this->identifier ?? null; + if (null === $identifier || ($type && $type !== $identifier->getType()) || ($id && $id !== $identifier->getId())) { + return null; + } + + return $identifier; + } + + /** + * @param string|null $id + * @param string|null $type + * @return T|null + */ + public function getObject(string $id = null, string $type = null): ?object + { + $identifier = $this->getIdentifier($id, $type); + if ($identifier && is_callable([$identifier, 'getObject'])) { + $identifier = $identifier->getObject(); + } + + return $identifier; + } + + /** + * @param IdentifierInterface $identifier + * @return bool + */ + public function addIdentifier(IdentifierInterface $identifier): bool + { + $this->identifier = $this->checkIdentifier($identifier); + $this->modified = true; + + return true; + } + + /** + * @param IdentifierInterface|null $identifier + * @return bool + */ + public function replaceIdentifier(IdentifierInterface $identifier = null): bool + { + if ($identifier === null) { + $this->identifier = null; + $this->modified = true; + + return true; + } + + return $this->addIdentifier($identifier); + } + + /** + * @param IdentifierInterface|null $identifier + * @return bool + */ + public function removeIdentifier(IdentifierInterface $identifier = null): bool + { + if (null === $identifier || $this->has($identifier->getId(), $identifier->getType())) { + $this->identifier = null; + $this->modified = true; + + return true; + } + + return false; + } + + /** + * @return iterable + * @phpstan-pure + */ + public function getIterator(): iterable + { + return new ArrayIterator((array)$this->identifier); + } + + /** + * @return array|null + */ + public function jsonSerialize(): ?array + { + return $this->identifier ? $this->identifier->jsonSerialize() : null; + } + + /** + * @return array + */ + public function __serialize(): array + { + return [ + 'parent' => $this->parent, + 'name' => $this->name, + 'type' => $this->type, + 'options' => $this->options, + 'modified' => $this->modified, + 'identifier' => $this->identifier, + ]; + } + + /** + * @param array $data + * @return void + */ + public function __unserialize(array $data): void + { + $this->parent = $data['parent']; + $this->name = $data['name']; + $this->type = $data['type']; + $this->options = $data['options']; + $this->modified = $data['modified']; + $this->identifier = $data['identifier']; + } +} diff --git a/system/src/Grav/Framework/Relationships/Traits/RelationshipTrait.php b/system/src/Grav/Framework/Relationships/Traits/RelationshipTrait.php new file mode 100644 index 0000000..dbe146f --- /dev/null +++ b/system/src/Grav/Framework/Relationships/Traits/RelationshipTrait.php @@ -0,0 +1,128 @@ +name; + } + + /** + * @return string + * @phpstan-pure + */ + public function getType(): string + { + return $this->type; + } + + /** + * @return bool + * @phpstan-pure + */ + public function isModified(): bool + { + return $this->modified; + } + + /** + * @return IdentifierInterface + * @phpstan-pure + */ + public function getParent(): IdentifierInterface + { + return $this->parent; + } + + /** + * @param IdentifierInterface $identifier + * @return bool + * @phpstan-pure + */ + public function hasIdentifier(IdentifierInterface $identifier): bool + { + return $this->getIdentifier($identifier->getId(), $identifier->getType()) !== null; + } + + /** + * @return int + * @phpstan-pure + */ + abstract public function count(): int; + + /** + * @return void + * @phpstan-pure + */ + public function check(): void + { + $min = $this->options['min'] ?? 0; + $max = $this->options['max'] ?? 0; + + if ($min || $max) { + $count = $this->count(); + if ($min && $count < $min) { + throw new RuntimeException(sprintf('%s relationship has too few objects in it', $this->name)); + } + if ($max && $count > $max) { + throw new RuntimeException(sprintf('%s relationship has too many objects in it', $this->name)); + } + } + } + + /** + * @param IdentifierInterface $identifier + * @return IdentifierInterface + */ + private function checkIdentifier(IdentifierInterface $identifier): IdentifierInterface + { + if ($this->type !== $identifier->getType()) { + throw new RuntimeException(sprintf('Bad identifier type %s', $identifier->getType())); + } + + if (get_class($identifier) !== Identifier::class) { + return $identifier; + } + + if ($this->type === 'media') { + return new MediaIdentifier($identifier->getId()); + } + + return new FlexIdentifier($identifier->getId(), $identifier->getType()); + } + + private function parseOptions(array $options): void + { + $this->type = $options['type']; + $this->options = $options; + } +} diff --git a/system/src/Grav/Framework/RequestHandler/Exception/InvalidArgumentException.php b/system/src/Grav/Framework/RequestHandler/Exception/InvalidArgumentException.php new file mode 100644 index 0000000..e6d084b --- /dev/null +++ b/system/src/Grav/Framework/RequestHandler/Exception/InvalidArgumentException.php @@ -0,0 +1,49 @@ +invalidMiddleware = $invalidMiddleware; + } + + /** + * Return the invalid middleware + * + * @return mixed|null + */ + public function getInvalidMiddleware() + { + return $this->invalidMiddleware; + } +} diff --git a/system/src/Grav/Framework/RequestHandler/Exception/NotFoundException.php b/system/src/Grav/Framework/RequestHandler/Exception/NotFoundException.php new file mode 100644 index 0000000..9d6a55a --- /dev/null +++ b/system/src/Grav/Framework/RequestHandler/Exception/NotFoundException.php @@ -0,0 +1,37 @@ +getMethod()), ['PUT', 'PATCH', 'DELETE'])) { + parent::__construct($request, 'Method Not Allowed', 405, $previous); + } else { + parent::__construct($request, 'Not Found', 404, $previous); + } + } +} diff --git a/system/src/Grav/Framework/RequestHandler/Exception/NotHandledException.php b/system/src/Grav/Framework/RequestHandler/Exception/NotHandledException.php new file mode 100644 index 0000000..9183638 --- /dev/null +++ b/system/src/Grav/Framework/RequestHandler/Exception/NotHandledException.php @@ -0,0 +1,20 @@ + 'Bad Request', + 401 => 'Unauthorized', + 402 => 'Payment Required', + 403 => 'Forbidden', + 404 => 'Not Found', + 405 => 'Method Not Allowed', + 406 => 'Not Acceptable', + 407 => 'Proxy Authentication Required', + 408 => 'Request Time-out', + 409 => 'Conflict', + 410 => 'Gone', + 411 => 'Length Required', + 412 => 'Precondition Failed', + 413 => 'Request Entity Too Large', + 414 => 'Request-URI Too Large', + 415 => 'Unsupported Media Type', + 416 => 'Requested range not satisfiable', + 417 => 'Expectation Failed', + 418 => 'I\'m a teapot', + 419 => 'Page Expired', + 422 => 'Unprocessable Entity', + 423 => 'Locked', + 424 => 'Failed Dependency', + 425 => 'Unordered Collection', + 426 => 'Upgrade Required', + 428 => 'Precondition Required', + 429 => 'Too Many Requests', + 431 => 'Request Header Fields Too Large', + 451 => 'Unavailable For Legal Reasons', + + 500 => 'Internal Server Error', + 501 => 'Not Implemented', + 502 => 'Bad Gateway', + 503 => 'Service Unavailable', + 504 => 'Gateway Time-out', + 505 => 'HTTP Version not supported', + 506 => 'Variant Also Negotiates', + 507 => 'Insufficient Storage', + 508 => 'Loop Detected', + 511 => 'Network Authentication Required', + ]; + + /** @var ServerRequestInterface */ + private $request; + + /** + * @param ServerRequestInterface $request + * @param string $message + * @param int $code + * @param Throwable|null $previous + */ + public function __construct(ServerRequestInterface $request, string $message, int $code = 500, Throwable $previous = null) + { + $this->request = $request; + + parent::__construct($message, $code, $previous); + } + + /** + * @return ServerRequestInterface + */ + public function getRequest(): ServerRequestInterface + { + return $this->request; + } + + public function getHttpCode(): int + { + $code = $this->getCode(); + + return isset(self::$phrases[$code]) ? $code : 500; + } + + public function getHttpReason(): ?string + { + return self::$phrases[$this->getCode()] ?? self::$phrases[500]; + } +} diff --git a/system/src/Grav/Framework/RequestHandler/Middlewares/Exceptions.php b/system/src/Grav/Framework/RequestHandler/Middlewares/Exceptions.php new file mode 100644 index 0000000..80deef0 --- /dev/null +++ b/system/src/Grav/Framework/RequestHandler/Middlewares/Exceptions.php @@ -0,0 +1,78 @@ +handle($request); + } catch (Throwable $exception) { + $code = $exception->getCode(); + if ($exception instanceof ValidationException) { + $message = $exception->getMessage(); + } else { + $message = htmlspecialchars($exception->getMessage(), ENT_QUOTES | ENT_HTML5, 'UTF-8'); + } + + $extra = $exception instanceof JsonSerializable ? $exception->jsonSerialize() : []; + + $response = [ + 'code' => $code, + 'status' => 'error', + 'message' => $message, + 'error' => [ + 'code' => $code, + 'message' => $message, + ] + $extra + ]; + + /** @var Debugger $debugger */ + $debugger = Grav::instance()['debugger']; + if ($debugger->enabled()) { + $response['error'] += [ + 'type' => get_class($exception), + 'file' => $exception->getFile(), + 'line' => $exception->getLine(), + 'trace' => explode("\n", $exception->getTraceAsString()), + ]; + } + + /** @var string $json */ + $json = json_encode($response, JSON_THROW_ON_ERROR); + + return new Response($code ?: 500, ['Content-Type' => 'application/json'], $json); + } + } +} diff --git a/system/src/Grav/Framework/RequestHandler/Middlewares/MultipartRequestSupport.php b/system/src/Grav/Framework/RequestHandler/Middlewares/MultipartRequestSupport.php new file mode 100644 index 0000000..6e36e8f --- /dev/null +++ b/system/src/Grav/Framework/RequestHandler/Middlewares/MultipartRequestSupport.php @@ -0,0 +1,123 @@ +getHeaderLine('content-type'); + $method = $request->getMethod(); + if (!str_starts_with($contentType, 'multipart/form-data') || !in_array($method, ['PUT', 'PATH'], true)) { + return $handler->handle($request); + } + + $boundary = explode('; boundary=', $contentType, 2)[1] ?? ''; + $parts = explode("--{$boundary}", $request->getBody()->getContents()); + $parts = array_slice($parts, 1, count($parts) - 2); + + $params = []; + $files = []; + foreach ($parts as $part) { + $this->processPart($params, $files, $part); + } + + return $handler->handle($request->withParsedBody($params)->withUploadedFiles($files)); + } + + /** + * @param array $params + * @param array $files + * @param string $part + * @return void + */ + protected function processPart(array &$params, array &$files, string $part): void + { + $part = ltrim($part, "\r\n"); + [$rawHeaders, $body] = explode("\r\n\r\n", $part, 2); + + // Parse headers. + $rawHeaders = explode("\r\n", $rawHeaders); + $headers = array_reduce( + $rawHeaders, + static function (array $headers, $header) { + [$name, $value] = explode(':', $header); + $headers[strtolower($name)] = ltrim($value, ' '); + + return $headers; + }, + [] + ); + + if (!isset($headers['content-disposition'])) { + return; + } + + // Parse content disposition header. + $contentDisposition = $headers['content-disposition']; + preg_match('/^(.+); *name="([^"]+)"(; *filename="([^"]+)")?/', $contentDisposition, $matches); + $name = $matches[2]; + $filename = $matches[4] ?? null; + + if ($filename !== null) { + $stream = Stream::create($body); + $this->addFile($files, $name, new UploadedFile($stream, strlen($body), UPLOAD_ERR_OK, $filename, $headers['content-type'] ?? null)); + } elseif (strpos($contentDisposition, 'filename') !== false) { + // Not uploaded file. + $stream = Stream::create(''); + $this->addFile($files, $name, new UploadedFile($stream, 0, UPLOAD_ERR_NO_FILE)); + } else { + // Regular field. + $params[$name] = substr($body, 0, -2); + } + } + + /** + * @param array $files + * @param string $name + * @param UploadedFileInterface $file + * @return void + */ + protected function addFile(array &$files, string $name, UploadedFileInterface $file): void + { + if (strpos($name, '[]') === strlen($name) - 2) { + $name = substr($name, 0, -2); + + if (isset($files[$name]) && is_array($files[$name])) { + $files[$name][] = $file; + } else { + $files[$name] = [$file]; + } + } else { + $files[$name] = $file; + } + } +} diff --git a/system/src/Grav/Framework/RequestHandler/RequestHandler.php b/system/src/Grav/Framework/RequestHandler/RequestHandler.php new file mode 100644 index 0000000..44fb7f9 --- /dev/null +++ b/system/src/Grav/Framework/RequestHandler/RequestHandler.php @@ -0,0 +1,80 @@ +middleware = $middleware; + $this->handler = $default; + $this->container = $container; + } + + /** + * Add callable initializing Middleware that will be executed as soon as possible. + * + * @param string $name + * @param callable $callable + * @return $this + */ + public function addCallable(string $name, callable $callable): self + { + if (null !== $this->container) { + assert($this->container instanceof Container); + $this->container[$name] = $callable; + } + + array_unshift($this->middleware, $name); + + return $this; + } + + /** + * Add Middleware that will be executed as soon as possible. + * + * @param string $name + * @param MiddlewareInterface $middleware + * @return $this + */ + public function addMiddleware(string $name, MiddlewareInterface $middleware): self + { + if (null !== $this->container) { + assert($this->container instanceof Container); + $this->container[$name] = $middleware; + } + + array_unshift($this->middleware, $name); + + return $this; + } +} diff --git a/system/src/Grav/Framework/RequestHandler/Traits/RequestHandlerTrait.php b/system/src/Grav/Framework/RequestHandler/Traits/RequestHandlerTrait.php new file mode 100644 index 0000000..b9d1cba --- /dev/null +++ b/system/src/Grav/Framework/RequestHandler/Traits/RequestHandlerTrait.php @@ -0,0 +1,64 @@ + */ + protected $middleware; + + /** @var callable */ + protected $handler; + + /** @var ContainerInterface|null */ + protected $container; + + /** + * {@inheritdoc} + * @throws InvalidArgumentException + */ + public function handle(ServerRequestInterface $request): ResponseInterface + { + $middleware = array_shift($this->middleware); + + // Use default callable if there is no middleware. + if ($middleware === null) { + return call_user_func($this->handler, $request); + } + + if ($middleware instanceof MiddlewareInterface) { + return $middleware->process($request, clone $this); + } + + if (null === $this->container || !$this->container->has($middleware)) { + throw new InvalidArgumentException( + sprintf('The middleware is not a valid %s and is not passed in the Container', MiddlewareInterface::class), + $middleware + ); + } + + array_unshift($this->middleware, $this->container->get($middleware)); + + return $this->handle($request); + } +} diff --git a/system/src/Grav/Framework/Route/Route.php b/system/src/Grav/Framework/Route/Route.php new file mode 100644 index 0000000..c65a827 --- /dev/null +++ b/system/src/Grav/Framework/Route/Route.php @@ -0,0 +1,452 @@ +initParts($parts); + } + + /** + * @return array + */ + public function getParts() + { + return [ + 'path' => $this->getUriPath(true), + 'query' => $this->getUriQuery(), + 'grav' => [ + 'root' => $this->root, + 'language' => $this->language, + 'route' => $this->route, + 'extension' => $this->extension, + 'grav_params' => $this->gravParams, + 'query_params' => $this->queryParams, + ], + ]; + } + + /** + * @return string + */ + public function getRootPrefix() + { + return $this->root; + } + + /** + * @return string + */ + public function getLanguage() + { + return $this->language; + } + + /** + * @return string + */ + public function getLanguagePrefix() + { + return $this->language !== '' ? '/' . $this->language : ''; + } + + /** + * @param string|null $language + * @return string + */ + public function getBase(string $language = null): string + { + $parts = [$this->root]; + + if (null === $language) { + $language = $this->language; + } + + if ($language !== '') { + $parts[] = $language; + } + + return implode('/', $parts); + } + + /** + * @param int $offset + * @param int|null $length + * @return string + */ + public function getRoute($offset = 0, $length = null) + { + if ($offset !== 0 || $length !== null) { + return ($offset === 0 ? '/' : '') . implode('/', $this->getRouteParts($offset, $length)); + } + + return '/' . $this->route; + } + + /** + * @return string + */ + public function getExtension() + { + return $this->extension; + } + + /** + * @param int $offset + * @param int|null $length + * @return array + */ + public function getRouteParts($offset = 0, $length = null) + { + $parts = explode('/', $this->route); + + if ($offset !== 0 || $length !== null) { + $parts = array_slice($parts, $offset, $length); + } + + return $parts; + } + + /** + * Return array of both query and Grav parameters. + * + * If a parameter exists in both, prefer Grav parameter. + * + * @return array + */ + public function getParams() + { + return $this->gravParams + $this->queryParams; + } + + /** + * @return array + */ + public function getGravParams() + { + return $this->gravParams; + } + + /** + * @return array + */ + public function getQueryParams() + { + return $this->queryParams; + } + + /** + * Return value of the parameter, looking into both Grav parameters and query parameters. + * + * If the parameter exists in both, return Grav parameter. + * + * @param string $param + * @return string|array|null + */ + public function getParam($param) + { + return $this->getGravParam($param) ?? $this->getQueryParam($param); + } + + /** + * @param string $param + * @return string|null + */ + public function getGravParam($param) + { + return $this->gravParams[$param] ?? null; + } + + /** + * @param string $param + * @return string|array|null + */ + public function getQueryParam($param) + { + return $this->queryParams[$param] ?? null; + } + + /** + * Allow the ability to set the route to something else + * + * @param string $route + * @return Route + */ + public function withRoute($route) + { + $new = $this->copy(); + $new->route = $route; + + return $new; + } + + /** + * Allow the ability to set the root to something else + * + * @param string $root + * @return Route + */ + public function withRoot($root) + { + $new = $this->copy(); + $new->root = $root; + + return $new; + } + + /** + * @param string|null $language + * @return Route + */ + public function withLanguage($language) + { + $new = $this->copy(); + $new->language = $language ?? ''; + + return $new; + } + + /** + * @param string $path + * @return Route + */ + public function withAddedPath($path) + { + $new = $this->copy(); + $new->route .= '/' . ltrim($path, '/'); + + return $new; + } + + /** + * @param string $extension + * @return Route + */ + public function withExtension($extension) + { + $new = $this->copy(); + $new->extension = $extension; + + return $new; + } + + /** + * @param string $param + * @param mixed $value + * @return Route + */ + public function withGravParam($param, $value) + { + return $this->withParam('gravParams', $param, null !== $value ? (string)$value : null); + } + + /** + * @param string $param + * @param mixed $value + * @return Route + */ + public function withQueryParam($param, $value) + { + return $this->withParam('queryParams', $param, $value); + } + + /** + * @return Route + */ + public function withoutParams() + { + return $this->withoutGravParams()->withoutQueryParams(); + } + + /** + * @return Route + */ + public function withoutGravParams() + { + $new = $this->copy(); + $new->gravParams = []; + + return $new; + } + + /** + * @return Route + */ + public function withoutQueryParams() + { + $new = $this->copy(); + $new->queryParams = []; + + return $new; + } + + /** + * @return Uri + */ + public function getUri() + { + return UriFactory::createFromParts($this->getParts()); + } + + /** + * @param bool $includeRoot + * @return string + */ + public function toString(bool $includeRoot = false) + { + $url = $this->getUriPath($includeRoot); + + if ($this->queryParams) { + $url .= '?' . $this->getUriQuery(); + } + + return rtrim($url,'/'); + } + + /** + * @return string + * @deprecated 1.6 Use ->toString(true) or ->getUri() instead. + */ + #[\ReturnTypeWillChange] + public function __toString() + { + user_error(__CLASS__ . '::' . __FUNCTION__ . '() will change in the future to return route, not relative url: use ->toString(true) or ->getUri() instead.', E_USER_DEPRECATED); + + return $this->toString(true); + } + + /** + * @param string $type + * @param string $param + * @param mixed $value + * @return Route + */ + protected function withParam($type, $param, $value) + { + $values = $this->{$type} ?? []; + $oldValue = $values[$param] ?? null; + + if ($oldValue === $value) { + return $this; + } + + $new = $this->copy(); + if ($value === null) { + unset($values[$param]); + } else { + $values[$param] = $value; + } + + $new->{$type} = $values; + + return $new; + } + + /** + * @return Route + */ + protected function copy() + { + return clone $this; + } + + /** + * @param bool $includeRoot + * @return string + */ + protected function getUriPath($includeRoot = false) + { + $parts = $includeRoot ? [$this->root] : ['']; + + if ($this->language !== '') { + $parts[] = $this->language; + } + + $parts[] = $this->extension ? $this->route . '.' . $this->extension : $this->route; + + + if ($this->gravParams) { + $parts[] = RouteFactory::buildParams($this->gravParams); + } + + return implode('/', $parts); + } + + /** + * @return string + */ + protected function getUriQuery() + { + return UriFactory::buildQuery($this->queryParams); + } + + /** + * @param array $parts + * @return void + */ + protected function initParts(array $parts) + { + if (isset($parts['grav'])) { + $gravParts = $parts['grav']; + $this->root = $gravParts['root']; + $this->language = $gravParts['language']; + $this->route = $gravParts['route']; + $this->extension = $gravParts['extension'] ?? ''; + $this->gravParams = $gravParts['params'] ?? []; + $this->queryParams = $parts['query_params'] ?? []; + } else { + $this->root = RouteFactory::getRoot(); + $this->language = RouteFactory::getLanguage(); + + $path = $parts['path'] ?? '/'; + if (isset($parts['params'])) { + $this->route = trim(rawurldecode($path), '/'); + $this->gravParams = $parts['params']; + } else { + $this->route = trim(RouteFactory::stripParams($path, true), '/'); + $this->gravParams = RouteFactory::getParams($path); + } + if (isset($parts['query'])) { + $this->queryParams = UriFactory::parseQuery($parts['query']); + } + } + } +} diff --git a/system/src/Grav/Framework/Route/RouteFactory.php b/system/src/Grav/Framework/Route/RouteFactory.php new file mode 100644 index 0000000..6844e48 --- /dev/null +++ b/system/src/Grav/Framework/Route/RouteFactory.php @@ -0,0 +1,236 @@ +toArray(); + $parts += [ + 'grav' => [] + ]; + $path = $parts['path'] ?? ''; + $parts['grav'] += [ + 'root' => self::$root, + 'language' => self::$language, + 'route' => trim($path, '/'), + 'params' => $parts['params'] ?? [], + ]; + + return static::createFromParts($parts); + } + + /** + * @param string $path + * @return Route + */ + public static function createFromString(string $path): Route + { + $path = ltrim($path, '/'); + if (self::$language && mb_strpos($path, self::$language) === 0) { + $path = ltrim(mb_substr($path, mb_strlen(self::$language)), '/'); + } + + $parts = [ + 'path' => $path, + 'query' => '', + 'query_params' => [], + 'grav' => [ + 'root' => self::$root, + 'language' => self::$language, + 'route' => static::trimParams($path), + 'params' => static::getParams($path) + ], + ]; + + return new Route($parts); + } + + /** + * @return string + */ + public static function getRoot(): string + { + return self::$root; + } + + /** + * @param string $root + */ + public static function setRoot($root): void + { + self::$root = rtrim($root, '/'); + } + + /** + * @return string + */ + public static function getLanguage(): string + { + return self::$language; + } + + /** + * @param string $language + */ + public static function setLanguage(string $language): void + { + self::$language = trim($language, '/'); + } + + /** + * @return string + */ + public static function getParamValueDelimiter(): string + { + return self::$delimiter; + } + + /** + * @param string $delimiter + */ + public static function setParamValueDelimiter(string $delimiter): void + { + self::$delimiter = $delimiter ?: ':'; + } + + /** + * @param array $params + * @return string + */ + public static function buildParams(array $params): string + { + if (!$params) { + return ''; + } + + $delimiter = self::$delimiter; + + $output = []; + foreach ($params as $key => $value) { + $output[] = "{$key}{$delimiter}{$value}"; + } + + return implode('/', $output); + } + + /** + * @param string $path + * @param bool $decode + * @return string + */ + public static function stripParams(string $path, bool $decode = false): string + { + $pos = strpos($path, self::$delimiter); + + if ($pos === false) { + return $path; + } + + $path = dirname(substr($path, 0, $pos)); + if ($path === '.') { + return ''; + } + + return $decode ? rawurldecode($path) : $path; + } + + /** + * @param string $path + * @return array + */ + public static function getParams(string $path): array + { + $params = ltrim(substr($path, strlen(static::stripParams($path))), '/'); + + return $params !== '' ? static::parseParams($params) : []; + } + + /** + * @param string $str + * @return string + */ + public static function trimParams(string $str): string + { + if ($str === '') { + return $str; + } + + $delimiter = self::$delimiter; + + /** @var array $params */ + $params = explode('/', $str); + $list = []; + foreach ($params as $param) { + if (mb_strpos($param, $delimiter) === false) { + $list[] = $param; + } + } + + return implode('/', $list); + } + + /** + * @param string $str + * @return array + */ + public static function parseParams(string $str): array + { + if ($str === '') { + return []; + } + + $delimiter = self::$delimiter; + + /** @var array $params */ + $params = explode('/', $str); + $list = []; + foreach ($params as &$param) { + /** @var array $parts */ + $parts = explode($delimiter, $param, 2); + if (isset($parts[1])) { + $var = rawurldecode($parts[0]); + $val = rawurldecode($parts[1]); + $list[$var] = $val; + } + } + + return $list; + } +} diff --git a/system/src/Grav/Framework/Session/Exceptions/SessionException.php b/system/src/Grav/Framework/Session/Exceptions/SessionException.php new file mode 100644 index 0000000..7bcb97f --- /dev/null +++ b/system/src/Grav/Framework/Session/Exceptions/SessionException.php @@ -0,0 +1,20 @@ + $message, 'scope' => $scope]; + + // don't add duplicates + if (!array_key_exists($key, $this->messages)) { + $this->messages[$key] = $item; + } + + return $this; + } + + /** + * Clear message queue. + * + * @param string|null $scope + * @return $this + */ + public function clear(string $scope = null): Messages + { + if ($scope === null) { + if ($this->messages !== []) { + $this->isCleared = true; + $this->messages = []; + } + } else { + foreach ($this->messages as $key => $message) { + if ($message['scope'] === $scope) { + $this->isCleared = true; + unset($this->messages[$key]); + } + } + } + + return $this; + } + + /** + * @return bool + */ + public function isCleared(): bool + { + return $this->isCleared; + } + + /** + * Fetch all messages. + * + * @param string|null $scope + * @return array + */ + public function all(string $scope = null): array + { + if ($scope === null) { + return array_values($this->messages); + } + + $messages = []; + foreach ($this->messages as $message) { + if ($message['scope'] === $scope) { + $messages[] = $message; + } + } + + return $messages; + } + + /** + * Fetch and clear message queue. + * + * @param string|null $scope + * @return array + */ + public function fetch(string $scope = null): array + { + $messages = $this->all($scope); + $this->clear($scope); + + return $messages; + } + + /** + * @return array + */ + public function __serialize(): array + { + return [ + 'messages' => $this->messages + ]; + } + + /** + * @param array $data + * @return void + */ + public function __unserialize(array $data): void + { + $this->messages = $data['messages']; + } +} diff --git a/system/src/Grav/Framework/Session/Session.php b/system/src/Grav/Framework/Session/Session.php new file mode 100644 index 0000000..e30b03b --- /dev/null +++ b/system/src/Grav/Framework/Session/Session.php @@ -0,0 +1,562 @@ +isSessionStarted()) { + session_unset(); + session_destroy(); + } + + // Set default options. + $options += [ + 'cache_limiter' => 'nocache', + 'use_trans_sid' => 0, + 'use_cookies' => 1, + 'lazy_write' => 1, + 'use_strict_mode' => 1 + ]; + + $this->setOptions($options); + + session_register_shutdown(); + + self::$instance = $this; + } + + /** + * @inheritdoc + */ + public function getId() + { + return session_id() ?: null; + } + + /** + * @inheritdoc + */ + public function setId($id) + { + session_id($id); + + return $this; + } + + /** + * @inheritdoc + */ + public function getName() + { + return session_name() ?: null; + } + + /** + * @inheritdoc + */ + public function setName($name) + { + session_name($name); + + return $this; + } + + /** + * @inheritdoc + */ + public function setOptions(array $options) + { + if (headers_sent() || \PHP_SESSION_ACTIVE === session_status()) { + return; + } + + $allowedOptions = [ + 'save_path' => true, + 'name' => true, + 'save_handler' => true, + 'gc_probability' => true, + 'gc_divisor' => true, + 'gc_maxlifetime' => true, + 'serialize_handler' => true, + 'cookie_lifetime' => true, + 'cookie_path' => true, + 'cookie_domain' => true, + 'cookie_secure' => true, + 'cookie_httponly' => true, + 'use_strict_mode' => true, + 'use_cookies' => true, + 'use_only_cookies' => true, + 'cookie_samesite' => true, + 'referer_check' => true, + 'cache_limiter' => true, + 'cache_expire' => true, + 'use_trans_sid' => true, + 'trans_sid_tags' => true, + 'trans_sid_hosts' => true, + 'sid_length' => true, + 'sid_bits_per_character' => true, + 'upload_progress.enabled' => true, + 'upload_progress.cleanup' => true, + 'upload_progress.prefix' => true, + 'upload_progress.name' => true, + 'upload_progress.freq' => true, + 'upload_progress.min-freq' => true, + 'lazy_write' => true + ]; + + foreach ($options as $key => $value) { + if (is_array($value)) { + // Allow nested options. + foreach ($value as $key2 => $value2) { + $ckey = "{$key}.{$key2}"; + if (isset($value2, $allowedOptions[$ckey])) { + $this->setOption($ckey, $value2); + } + } + } elseif (isset($value, $allowedOptions[$key])) { + $this->setOption($key, $value); + } + } + } + + /** + * @inheritdoc + */ + public function start($readonly = false) + { + if (\PHP_SAPI === 'cli') { + return $this; + } + + $sessionName = $this->getName(); + if (null === $sessionName) { + return $this; + } + + $sessionExists = isset($_COOKIE[$sessionName]); + + // Protection against invalid session cookie names throwing exception: http://php.net/manual/en/function.session-id.php#116836 + if ($sessionExists && !preg_match('/^[-,a-zA-Z0-9]{1,128}$/', $_COOKIE[$sessionName])) { + unset($_COOKIE[$sessionName]); + $sessionExists = false; + } + + $options = $this->options; + if ($readonly) { + $options['read_and_close'] = '1'; + } + + try { + $success = @session_start($options); + if (!$success) { + $last = error_get_last(); + $error = $last ? $last['message'] : 'Unknown error'; + + throw new RuntimeException($error); + } + + // Handle changing session id. + if ($this->__isset('session_destroyed')) { + $newId = $this->__get('session_new_id'); + if (!$newId || $this->__get('session_destroyed') < time() - 300) { + // Should not happen usually. This could be attack or due to unstable network. Destroy this session. + $this->invalidate(); + + throw new RuntimeException('Obsolete session access.', 500); + } + + // Not fully expired yet. Could be lost cookie by unstable network. Start session with new session id. + session_write_close(); + + // Start session with new session id. + $useStrictMode = $options['use_strict_mode'] ?? 0; + if ($useStrictMode) { + ini_set('session.use_strict_mode', '0'); + } + session_id($newId); + if ($useStrictMode) { + ini_set('session.use_strict_mode', '1'); + } + + $success = @session_start($options); + if (!$success) { + $last = error_get_last(); + $error = $last ? $last['message'] : 'Unknown error'; + + throw new RuntimeException($error); + } + } + } catch (Exception $e) { + throw new SessionException('Failed to start session: ' . $e->getMessage(), 500); + } + + $this->started = true; + $this->onSessionStart(); + + try { + $user = $this->__get('user'); + if ($user && (!$user instanceof UserInterface || (method_exists($user, 'isValid') && !$user->isValid()))) { + throw new RuntimeException('Bad user'); + } + } catch (Throwable $e) { + $this->invalidate(); + throw new SessionException('Invalid User object, session destroyed.', 500); + } + + + // Extend the lifetime of the session. + if ($sessionExists) { + $this->setCookie(); + } + + return $this; + } + + /** + * Regenerate session id but keep the current session information. + * + * Session id must be regenerated on login, logout or after long time has been passed. + * + * @return $this + * @since 1.7 + */ + public function regenerateId() + { + if (!$this->isSessionStarted()) { + return $this; + } + + // TODO: session_create_id() segfaults in PHP 7.3 (PHP bug #73461), remove phpstan rule when removing this one. + if (PHP_VERSION_ID < 70400) { + $newId = 0; + } else { + // Session id creation may fail with some session storages. + $newId = @session_create_id() ?: 0; + } + + // Set destroyed timestamp for the old session as well as pointer to the new id. + $this->__set('session_destroyed', time()); + $this->__set('session_new_id', $newId); + + // Keep the old session alive to avoid lost sessions by unstable network. + if (!$newId) { + /** @var Debugger $debugger */ + $debugger = Grav::instance()['debugger']; + $debugger->addMessage('Session fixation lost session detection is turned of due to server limitations.', 'warning'); + + session_regenerate_id(false); + } else { + session_write_close(); + + // Start session with new session id. + $useStrictMode = $this->options['use_strict_mode'] ?? 0; + if ($useStrictMode) { + ini_set('session.use_strict_mode', '0'); + } + session_id($newId); + if ($useStrictMode) { + ini_set('session.use_strict_mode', '1'); + } + + $this->removeCookie(); + + $this->onBeforeSessionStart(); + + $success = @session_start($this->options); + if (!$success) { + $last = error_get_last(); + $error = $last ? $last['message'] : 'Unknown error'; + + throw new RuntimeException($error); + } + + $this->onSessionStart(); + } + + // New session does not have these. + $this->__unset('session_destroyed'); + $this->__unset('session_new_id'); + + return $this; + } + + /** + * @inheritdoc + */ + public function invalidate() + { + $name = $this->getName(); + if (null !== $name) { + $this->removeCookie(); + + setcookie( + $name, + '', + $this->getCookieOptions(-42000) + ); + } + + if ($this->isSessionStarted()) { + session_unset(); + session_destroy(); + } + + $this->started = false; + + return $this; + } + + /** + * @inheritdoc + */ + public function close() + { + if ($this->started) { + session_write_close(); + } + + $this->started = false; + + return $this; + } + + /** + * @inheritdoc + */ + public function clear() + { + session_unset(); + + return $this; + } + + /** + * @inheritdoc + */ + public function getAll() + { + return $_SESSION; + } + + /** + * @inheritdoc + */ + #[\ReturnTypeWillChange] + public function getIterator() + { + return new ArrayIterator($_SESSION); + } + + /** + * @inheritdoc + */ + public function isStarted() + { + return $this->started; + } + + /** + * @inheritdoc + */ + #[\ReturnTypeWillChange] + public function __isset($name) + { + return isset($_SESSION[$name]); + } + + /** + * @inheritdoc + */ + #[\ReturnTypeWillChange] + public function __get($name) + { + return $_SESSION[$name] ?? null; + } + + /** + * @inheritdoc + */ + #[\ReturnTypeWillChange] + public function __set($name, $value) + { + $_SESSION[$name] = $value; + } + + /** + * @inheritdoc + */ + #[\ReturnTypeWillChange] + public function __unset($name) + { + unset($_SESSION[$name]); + } + + /** + * http://php.net/manual/en/function.session-status.php#113468 + * Check if session is started nicely. + * @return bool + */ + protected function isSessionStarted() + { + return \PHP_SAPI !== 'cli' ? \PHP_SESSION_ACTIVE === session_status() : false; + } + + protected function onBeforeSessionStart(): void + { + } + + protected function onSessionStart(): void + { + } + + /** + * Store something in cookie temporarily. + * + * @param int|null $lifetime + * @return array + */ + public function getCookieOptions(int $lifetime = null): array + { + $params = session_get_cookie_params(); + + return [ + 'expires' => time() + ($lifetime ?? $params['lifetime']), + 'path' => $params['path'], + 'domain' => $params['domain'], + 'secure' => $params['secure'], + 'httponly' => $params['httponly'], + 'samesite' => $params['samesite'] + ]; + } + + /** + * @return void + */ + protected function setCookie(): void + { + $this->removeCookie(); + + $sessionName = $this->getName(); + $sessionId = $this->getId(); + if (null === $sessionName || null === $sessionId) { + return; + } + + setcookie( + $sessionName, + $sessionId, + $this->getCookieOptions() + ); + } + + protected function removeCookie(): void + { + $search = " {$this->getName()}="; + $cookies = []; + $found = false; + + foreach (headers_list() as $header) { + // Identify cookie headers + if (strpos($header, 'Set-Cookie:') === 0) { + // Add all but session cookie(s). + if (!str_contains($header, $search)) { + $cookies[] = $header; + } else { + $found = true; + } + } + } + + // Nothing to do. + if (false === $found) { + return; + } + + // Remove all cookies and put back all but session cookie. + header_remove('Set-Cookie'); + foreach($cookies as $cookie) { + header($cookie, false); + } + } + + /** + * @param string $key + * @param mixed $value + * @return void + */ + protected function setOption($key, $value) + { + if (!is_string($value)) { + if (is_bool($value)) { + $value = $value ? '1' : '0'; + } else { + $value = (string)$value; + } + } + + $this->options[$key] = $value; + ini_set("session.{$key}", $value); + } +} diff --git a/system/src/Grav/Framework/Session/SessionInterface.php b/system/src/Grav/Framework/Session/SessionInterface.php new file mode 100644 index 0000000..f160b10 --- /dev/null +++ b/system/src/Grav/Framework/Session/SessionInterface.php @@ -0,0 +1,159 @@ + + */ +interface SessionInterface extends IteratorAggregate +{ + /** + * Get current session instance. + * + * @return Session + * @throws RuntimeException + */ + public static function getInstance(); + + /** + * Get session ID + * + * @return string|null Session ID + */ + public function getId(); + + /** + * Set session ID + * + * @param string $id Session ID + * @return $this + */ + public function setId($id); + + /** + * Get session name + * + * @return string|null + */ + public function getName(); + + /** + * Set session name + * + * @param string $name + * @return $this + */ + public function setName($name); + + /** + * Sets session.* ini variables. + * + * @param array $options + * @return void + * @see http://php.net/session.configuration + */ + public function setOptions(array $options); + + /** + * Starts the session storage + * + * @param bool $readonly + * @return $this + * @throws RuntimeException + */ + public function start($readonly = false); + + /** + * Invalidates the current session. + * + * @return $this + */ + public function invalidate(); + + /** + * Force the session to be saved and closed + * + * @return $this + */ + public function close(); + + /** + * Free all session variables. + * + * @return $this + */ + public function clear(); + + /** + * Returns all session variables. + * + * @return array + */ + public function getAll(); + + /** + * Retrieve an external iterator + * + * @return ArrayIterator Return an ArrayIterator of $_SESSION + * @phpstan-return ArrayIterator + */ + #[\ReturnTypeWillChange] + public function getIterator(); + + /** + * Checks if the session was started. + * + * @return bool + */ + public function isStarted(); + + /** + * Checks if session variable is defined. + * + * @param string $name + * @return bool + */ + #[\ReturnTypeWillChange] + public function __isset($name); + + /** + * Returns session variable. + * + * @param string $name + * @return mixed + */ + #[\ReturnTypeWillChange] + public function __get($name); + + /** + * Sets session variable. + * + * @param string $name + * @param mixed $value + * @return void + */ + #[\ReturnTypeWillChange] + public function __set($name, $value); + + /** + * Removes session variable. + * + * @param string $name + * @return void + */ + #[\ReturnTypeWillChange] + public function __unset($name); +} diff --git a/system/src/Grav/Framework/Uri/Uri.php b/system/src/Grav/Framework/Uri/Uri.php new file mode 100644 index 0000000..d31937c --- /dev/null +++ b/system/src/Grav/Framework/Uri/Uri.php @@ -0,0 +1,216 @@ +initParts($parts); + } + + /** + * @return string + */ + public function getUser() + { + return parent::getUser(); + } + + /** + * @return string + */ + public function getPassword() + { + return parent::getPassword(); + } + + /** + * @return array + */ + public function getParts() + { + return parent::getParts(); + } + + /** + * @return string + */ + public function getUrl() + { + return parent::getUrl(); + } + + /** + * @return string + */ + public function getBaseUrl() + { + return parent::getBaseUrl(); + } + + /** + * @param string $key + * @return string|null + */ + public function getQueryParam($key) + { + $queryParams = $this->getQueryParams(); + + return $queryParams[$key] ?? null; + } + + /** + * @param string $key + * @return UriInterface + */ + public function withoutQueryParam($key) + { + return GuzzleUri::withoutQueryValue($this, $key); + } + + /** + * @param string $key + * @param string|null $value + * @return UriInterface + */ + public function withQueryParam($key, $value) + { + return GuzzleUri::withQueryValue($this, $key, $value); + } + + /** + * @return array + */ + public function getQueryParams() + { + if ($this->queryParams === null) { + $this->queryParams = UriFactory::parseQuery($this->getQuery()); + } + + return $this->queryParams; + } + + /** + * @param array $params + * @return UriInterface + */ + public function withQueryParams(array $params) + { + $query = UriFactory::buildQuery($params); + + return $this->withQuery($query); + } + + /** + * Whether the URI has the default port of the current scheme. + * + * `$uri->getPort()` may return the standard port. This method can be used for some non-http/https Uri. + * + * @return bool + */ + public function isDefaultPort() + { + return $this->getPort() === null || GuzzleUri::isDefaultPort($this); + } + + /** + * Whether the URI is absolute, i.e. it has a scheme. + * + * An instance of UriInterface can either be an absolute URI or a relative reference. This method returns true + * if it is the former. An absolute URI has a scheme. A relative reference is used to express a URI relative + * to another URI, the base URI. Relative references can be divided into several forms: + * - network-path references, e.g. '//example.com/path' + * - absolute-path references, e.g. '/path' + * - relative-path references, e.g. 'subpath' + * + * @return bool + * @link https://tools.ietf.org/html/rfc3986#section-4 + */ + public function isAbsolute() + { + return GuzzleUri::isAbsolute($this); + } + + /** + * Whether the URI is a network-path reference. + * + * A relative reference that begins with two slash characters is termed an network-path reference. + * + * @return bool + * @link https://tools.ietf.org/html/rfc3986#section-4.2 + */ + public function isNetworkPathReference() + { + return GuzzleUri::isNetworkPathReference($this); + } + + /** + * Whether the URI is a absolute-path reference. + * + * A relative reference that begins with a single slash character is termed an absolute-path reference. + * + * @return bool + * @link https://tools.ietf.org/html/rfc3986#section-4.2 + */ + public function isAbsolutePathReference() + { + return GuzzleUri::isAbsolutePathReference($this); + } + + /** + * Whether the URI is a relative-path reference. + * + * A relative reference that does not begin with a slash character is termed a relative-path reference. + * + * @return bool + * @link https://tools.ietf.org/html/rfc3986#section-4.2 + */ + public function isRelativePathReference() + { + return GuzzleUri::isRelativePathReference($this); + } + + /** + * Whether the URI is a same-document reference. + * + * A same-document reference refers to a URI that is, aside from its fragment + * component, identical to the base URI. When no base URI is given, only an empty + * URI reference (apart from its fragment) is considered a same-document reference. + * + * @param UriInterface|null $base An optional base URI to compare against + * @return bool + * @link https://tools.ietf.org/html/rfc3986#section-4.4 + */ + public function isSameDocumentReference(UriInterface $base = null) + { + return GuzzleUri::isSameDocumentReference($this, $base); + } +} diff --git a/system/src/Grav/Framework/Uri/UriFactory.php b/system/src/Grav/Framework/Uri/UriFactory.php new file mode 100644 index 0000000..cb917ed --- /dev/null +++ b/system/src/Grav/Framework/Uri/UriFactory.php @@ -0,0 +1,171 @@ + $scheme, + 'user' => $user, + 'pass' => $pass, + 'host' => $host, + 'port' => $port, + 'path' => $path, + 'query' => $query + ]; + } + + /** + * UTF-8 aware parse_url() implementation. + * + * @param string $url + * @return array + * @throws InvalidArgumentException + */ + public static function parseUrl($url) + { + if (!is_string($url)) { + throw new InvalidArgumentException('URL must be a string'); + } + + $encodedUrl = preg_replace_callback( + '%[^:/@?&=#]+%u', + static function ($matches) { + return rawurlencode($matches[0]); + }, + $url + ); + + $parts = is_string($encodedUrl) ? parse_url($encodedUrl) : false; + if ($parts === false) { + throw new InvalidArgumentException("Malformed URL: {$url}"); + } + + return $parts; + } + + /** + * Parse query string and return it as an array. + * + * @param string $query + * @return mixed + */ + public static function parseQuery($query) + { + parse_str($query, $params); + + return $params; + } + + /** + * Build query string from variables. + * + * @param array $params + * @return string + */ + public static function buildQuery(array $params) + { + if (!$params) { + return ''; + } + + $separator = ini_get('arg_separator.output') ?: '&'; + + return http_build_query($params, '', $separator, PHP_QUERY_RFC3986); + } +} diff --git a/system/src/Grav/Framework/Uri/UriPartsFilter.php b/system/src/Grav/Framework/Uri/UriPartsFilter.php new file mode 100644 index 0000000..27b72ac --- /dev/null +++ b/system/src/Grav/Framework/Uri/UriPartsFilter.php @@ -0,0 +1,145 @@ += 0 && $port <= 65535))) { + return $port; + } + + throw new InvalidArgumentException('Uri port must be null or an integer between 0 and 65535'); + } + + /** + * Filter Uri path. + * + * This method percent-encodes all reserved characters in the provided path string. This method + * will NOT double-encode characters that are already percent-encoded. + * + * @param string $path The raw uri path. + * @return string The RFC 3986 percent-encoded uri path. + * @throws InvalidArgumentException If the path is invalid. + * @link http://www.faqs.org/rfcs/rfc3986.html + */ + public static function filterPath($path) + { + if (!is_string($path)) { + throw new InvalidArgumentException('Uri path must be a string'); + } + + return preg_replace_callback( + '/(?:[^a-zA-Z0-9_\-\.~:@&=\+\$,\/;%]+|%(?![A-Fa-f0-9]{2}))/u', + function ($match) { + return rawurlencode($match[0]); + }, + $path + ) ?? ''; + } + + /** + * Filters the query string or fragment of a URI. + * + * @param string $query The raw uri query string. + * @return string The percent-encoded query string. + * @throws InvalidArgumentException If the query is invalid. + */ + public static function filterQueryOrFragment($query) + { + if (!is_string($query)) { + throw new InvalidArgumentException('Uri query string and fragment must be a string'); + } + + return preg_replace_callback( + '/(?:[^a-zA-Z0-9_\-\.~!\$&\'\(\)\*\+,;=%:@\/\?]+|%(?![A-Fa-f0-9]{2}))/u', + function ($match) { + return rawurlencode($match[0]); + }, + $query + ) ?? ''; + } +} diff --git a/system/src/Grav/Installer/Install.php b/system/src/Grav/Installer/Install.php new file mode 100644 index 0000000..3229100 --- /dev/null +++ b/system/src/Grav/Installer/Install.php @@ -0,0 +1,400 @@ + [ + 'name' => 'PHP', + 'versions' => [ + '8.1' => '8.1.0', + '8.0' => '8.0.0', + '7.4' => '7.4.1', + '7.3' => '7.3.6', + '' => '8.0.13' + ] + ], + 'grav' => [ + 'name' => 'Grav', + 'versions' => [ + '1.6' => '1.6.0', + '' => '1.6.28' + ] + ], + 'plugins' => [ + 'admin' => [ + 'name' => 'Admin', + 'optional' => true, + 'versions' => [ + '1.9' => '1.9.0', + '' => '1.9.13' + ] + ], + 'email' => [ + 'name' => 'Email', + 'optional' => true, + 'versions' => [ + '3.0' => '3.0.0', + '' => '3.0.10' + ] + ], + 'form' => [ + 'name' => 'Form', + 'optional' => true, + 'versions' => [ + '4.1' => '4.1.0', + '4.0' => '4.0.0', + '3.0' => '3.0.0', + '' => '4.1.2' + ] + ], + 'login' => [ + 'name' => 'Login', + 'optional' => true, + 'versions' => [ + '3.3' => '3.3.0', + '3.0' => '3.0.0', + '' => '3.3.6' + ] + ], + ] + ]; + + /** @var array */ + public $ignores = [ + 'backup', + 'cache', + 'images', + 'logs', + 'tmp', + 'user', + '.htaccess', + 'robots.txt' + ]; + + /** @var array */ + private $classMap = [ + InstallException::class => __DIR__ . '/InstallException.php', + Versions::class => __DIR__ . '/Versions.php', + VersionUpdate::class => __DIR__ . '/VersionUpdate.php', + VersionUpdater::class => __DIR__ . '/VersionUpdater.php', + YamlUpdater::class => __DIR__ . '/YamlUpdater.php', + ]; + + /** @var string|null */ + private $zip; + + /** @var string|null */ + private $location; + + /** @var VersionUpdater|null */ + private $updater; + + /** @var static */ + private static $instance; + + /** + * @return static + */ + public static function instance() + { + if (null === self::$instance) { + self::$instance = new static(); + } + + return self::$instance; + } + + private function __construct() + { + } + + /** + * @param string|null $zip + * @return $this + */ + public function setZip(?string $zip) + { + $this->zip = $zip; + + return $this; + } + + /** + * @param string|null $zip + * @return void + */ + #[\ReturnTypeWillChange] + public function __invoke(?string $zip) + { + $this->zip = $zip; + + $failedRequirements = $this->checkRequirements(); + if ($failedRequirements) { + $error = ['Following requirements have failed:']; + + foreach ($failedRequirements as $name => $req) { + $error[] = "{$req['title']} >= v{$req['minimum']} required, you have v{$req['installed']}"; + } + + $errors = implode("
    \n", $error); + if (\defined('GRAV_CLI') && GRAV_CLI) { + $errors = "\n\n" . strip_tags($errors) . "\n\n"; + $errors .= <<prepare(); + $this->install(); + $this->finalize(); + } + + /** + * NOTE: This method can only be called after $grav['plugins']->init(). + * + * @return array List of failed requirements. If the list is empty, installation can go on. + */ + public function checkRequirements(): array + { + $results = []; + + $this->checkVersion($results, 'php', 'php', $this->requires['php'], PHP_VERSION); + $this->checkVersion($results, 'grav', 'grav', $this->requires['grav'], GRAV_VERSION); + $this->checkPlugins($results, $this->requires['plugins']); + + return $results; + } + + /** + * @return void + * @throws RuntimeException + */ + public function prepare(): void + { + // Locate the new Grav update and the target site from the filesystem. + $location = realpath(__DIR__); + $target = realpath(GRAV_ROOT . '/index.php'); + + if (!$location) { + throw new RuntimeException('Internal Error', 500); + } + + if ($target && dirname($location, 4) === dirname($target)) { + // We cannot copy files into themselves, abort! + throw new RuntimeException('Grav has already been installed here!', 400); + } + + // Load the installer classes. + foreach ($this->classMap as $class_name => $path) { + // Make sure that none of the Grav\Installer classes have been loaded, otherwise installation may fail! + if (class_exists($class_name, false)) { + throw new RuntimeException(sprintf('Cannot update Grav, class %s has already been loaded!', $class_name), 500); + } + + require $path; + } + + $this->legacySupport(); + + $this->location = dirname($location, 4); + + $versions = Versions::instance(USER_DIR . 'config/versions.yaml'); + $this->updater = new VersionUpdater('core/grav', __DIR__ . '/updates', $this->getVersion(), $versions); + + $this->updater->preflight(); + } + + /** + * @return void + * @throws RuntimeException + */ + public function install(): void + { + if (!$this->location) { + throw new RuntimeException('Oops, installer was run without prepare()!', 500); + } + + try { + if (null === $this->updater) { + $versions = Versions::instance(USER_DIR . 'config/versions.yaml'); + $this->updater = new VersionUpdater('core/grav', __DIR__ . '/updates', $this->getVersion(), $versions); + } + + // Update user/config/version.yaml before copying the files to avoid frontend from setting the version schema. + $this->updater->install(); + + Installer::install( + $this->zip ?? '', + GRAV_ROOT, + ['sophisticated' => true, 'overwrite' => true, 'ignore_symlinks' => true, 'ignores' => $this->ignores], + $this->location, + !($this->zip && is_file($this->zip)) + ); + } catch (Exception $e) { + Installer::setError($e->getMessage()); + } + + $errorCode = Installer::lastErrorCode(); + + $success = !(is_string($errorCode) || ($errorCode & (Installer::ZIP_OPEN_ERROR | Installer::ZIP_EXTRACT_ERROR))); + + if (!$success) { + throw new RuntimeException(Installer::lastErrorMsg()); + } + } + + /** + * @return void + * @throws RuntimeException + */ + public function finalize(): void + { + // Finalize can be run without installing Grav first. + if (null === $this->updater) { + $versions = Versions::instance(USER_DIR . 'config/versions.yaml'); + $this->updater = new VersionUpdater('core/grav', __DIR__ . '/updates', GRAV_VERSION, $versions); + $this->updater->install(); + } + + $this->updater->postflight(); + + Cache::clearCache('all'); + + clearstatcache(); + if (function_exists('opcache_reset')) { + @opcache_reset(); + } + } + + /** + * @param array $results + * @param string $type + * @param string $name + * @param array $check + * @param string|null $version + * @return void + */ + protected function checkVersion(array &$results, $type, $name, array $check, $version): void + { + if (null === $version && !empty($check['optional'])) { + return; + } + + $major = $minor = 0; + $versions = $check['versions'] ?? []; + foreach ($versions as $major => $minor) { + if (!$major || version_compare($version ?? '0', $major, '<')) { + continue; + } + + if (version_compare($version ?? '0', $minor, '>=')) { + return; + } + + break; + } + + if (!$major) { + $minor = reset($versions); + } + + $recommended = end($versions); + + if (version_compare($recommended, $minor, '<=')) { + $recommended = null; + } + + $results[$name] = [ + 'type' => $type, + 'name' => $name, + 'title' => $check['name'] ?? $name, + 'installed' => $version, + 'minimum' => $minor, + 'recommended' => $recommended + ]; + } + + /** + * @param array $results + * @param array $plugins + * @return void + */ + protected function checkPlugins(array &$results, array $plugins): void + { + if (!class_exists('Plugins')) { + return; + } + + foreach ($plugins as $name => $check) { + $plugin = Plugins::get($name); + if (!$plugin) { + $this->checkVersion($results, 'plugin', $name, $check, null); + continue; + } + + $blueprint = $plugin->blueprints(); + $version = (string)$blueprint->get('version'); + $check['name'] = ($blueprint->get('name') ?? $check['name'] ?? $name) . ' Plugin'; + $this->checkVersion($results, 'plugin', $name, $check, $version); + } + } + + /** + * @return string + */ + protected function getVersion(): string + { + $definesFile = "{$this->location}/system/defines.php"; + $content = file_get_contents($definesFile); + if (false === $content) { + return ''; + } + + preg_match("/define\('GRAV_VERSION', '([^']+)'\);/mu", $content, $matches); + + return $matches[1] ?? ''; + } + + protected function legacySupport(): void + { + // Support install for Grav 1.6.0 - 1.6.20 by loading the original class from the older version of Grav. + class_exists(\Grav\Console\Cli\CacheCommand::class, true); + } +} diff --git a/system/src/Grav/Installer/InstallException.php b/system/src/Grav/Installer/InstallException.php new file mode 100644 index 0000000..6565355 --- /dev/null +++ b/system/src/Grav/Installer/InstallException.php @@ -0,0 +1,29 @@ +getCode(), $previous); + } +} diff --git a/system/src/Grav/Installer/VersionUpdate.php b/system/src/Grav/Installer/VersionUpdate.php new file mode 100644 index 0000000..1fde783 --- /dev/null +++ b/system/src/Grav/Installer/VersionUpdate.php @@ -0,0 +1,83 @@ +revision = $name; + [$this->version, $this->date, $this->patch] = explode('_', $name); + $this->updater = $updater; + $this->methods = require $file; + } + + public function getRevision(): string + { + return $this->revision; + } + + public function getVersion(): string + { + return $this->version; + } + + public function getDate(): string + { + return $this->date; + } + + public function getPatch(): string + { + return $this->patch; + } + + public function getUpdater(): VersionUpdater + { + return $this->updater; + } + + /** + * Run right before installation. + */ + public function preflight(VersionUpdater $updater): void + { + $method = $this->methods['preflight'] ?? null; + if ($method instanceof Closure) { + $method->call($this); + } + } + + /** + * Runs right after installation. + */ + public function postflight(VersionUpdater $updater): void + { + $method = $this->methods['postflight'] ?? null; + if ($method instanceof Closure) { + $method->call($this); + } + } +} diff --git a/system/src/Grav/Installer/VersionUpdater.php b/system/src/Grav/Installer/VersionUpdater.php new file mode 100644 index 0000000..75a3b04 --- /dev/null +++ b/system/src/Grav/Installer/VersionUpdater.php @@ -0,0 +1,133 @@ +name = $name; + $this->path = $path; + $this->version = $version; + $this->versions = $versions; + + $this->loadUpdates(); + } + + /** + * Pre-installation method. + */ + public function preflight(): void + { + foreach ($this->updates as $revision => $update) { + $update->preflight($this); + } + } + + /** + * Install method. + */ + public function install(): void + { + $versions = $this->getVersions(); + $versions->updateVersion($this->name, $this->version); + $versions->save(); + } + + /** + * Post-installation method. + */ + public function postflight(): void + { + $versions = $this->getVersions(); + + foreach ($this->updates as $revision => $update) { + $update->postflight($this); + + $versions->setSchema($this->name, $revision); + $versions->save(); + } + } + + /** + * @return Versions + */ + public function getVersions(): Versions + { + return $this->versions; + } + + /** + * @param string|null $name + * @return string|null + */ + public function getExtensionVersion(string $name = null): ?string + { + return $this->versions->getVersion($name ?? $this->name); + } + + /** + * @param string|null $name + * @return string|null + */ + public function getExtensionSchema(string $name = null): ?string + { + return $this->versions->getSchema($name ?? $this->name); + } + + /** + * @param string|null $name + * @return array + */ + public function getExtensionHistory(string $name = null): array + { + return $this->versions->getHistory($name ?? $this->name); + } + + protected function loadUpdates(): void + { + $this->updates = []; + + $schema = $this->getExtensionSchema(); + $iterator = new DirectoryIterator($this->path); + foreach ($iterator as $item) { + if (!$item->isFile() || $item->getExtension() !== 'php') { + continue; + } + + $revision = $item->getBasename('.php'); + if (!$schema || version_compare($revision, $schema, '>')) { + $realPath = $item->getRealPath(); + if ($realPath) { + $this->updates[$revision] = new VersionUpdate($realPath, $this); + } + } + } + + uksort($this->updates, 'version_compare'); + } +} diff --git a/system/src/Grav/Installer/Versions.php b/system/src/Grav/Installer/Versions.php new file mode 100644 index 0000000..201b9e8 --- /dev/null +++ b/system/src/Grav/Installer/Versions.php @@ -0,0 +1,329 @@ +updated) { + return false; + } + + file_put_contents($this->filename, Yaml::dump($this->items, 4, 2)); + + $this->updated = false; + + return true; + } + + /** + * @return array + */ + public function getAll(): array + { + return $this->items; + } + + /** + * @return array|null + */ + public function getGrav(): ?array + { + return $this->get('core/grav'); + } + + /** + * @return array + */ + public function getPlugins(): array + { + return $this->get('plugins', []); + } + + /** + * @param string $name + * @return array|null + */ + public function getPlugin(string $name): ?array + { + return $this->get("plugins/{$name}"); + } + + /** + * @return array + */ + public function getThemes(): array + { + return $this->get('themes', []); + } + + /** + * @param string $name + * @return array|null + */ + public function getTheme(string $name): ?array + { + return $this->get("themes/{$name}"); + } + + /** + * @param string $extension + * @return array|null + */ + public function getExtension(string $extension): ?array + { + return $this->get($extension); + } + + /** + * @param string $extension + * @param array|null $value + */ + public function setExtension(string $extension, ?array $value): void + { + if (null !== $value) { + $this->set($extension, $value); + } else { + $this->undef($extension); + } + } + + /** + * @param string $extension + * @return string|null + */ + public function getVersion(string $extension): ?string + { + $version = $this->get("{$extension}/version", null); + + return is_string($version) ? $version : null; + } + + /** + * @param string $extension + * @param string|null $version + */ + public function setVersion(string $extension, ?string $version): void + { + $this->updateHistory($extension, $version); + } + + /** + * NOTE: Updates also history. + * + * @param string $extension + * @param string|null $version + */ + public function updateVersion(string $extension, ?string $version): void + { + $this->set("{$extension}/version", $version); + $this->updateHistory($extension, $version); + } + + /** + * @param string $extension + * @return string|null + */ + public function getSchema(string $extension): ?string + { + $version = $this->get("{$extension}/schema", null); + + return is_string($version) ? $version : null; + } + + /** + * @param string $extension + * @param string|null $schema + */ + public function setSchema(string $extension, ?string $schema): void + { + if (null !== $schema) { + $this->set("{$extension}/schema", $schema); + } else { + $this->undef("{$extension}/schema"); + } + } + + /** + * @param string $extension + * @return array + */ + public function getHistory(string $extension): array + { + $name = "{$extension}/history"; + $history = $this->get($name, []); + + // Fix for broken Grav 1.6 history + if ($extension === 'grav') { + $history = $this->fixHistory($history); + } + + return $history; + } + + /** + * @param string $extension + * @param string|null $version + */ + public function updateHistory(string $extension, ?string $version): void + { + $name = "{$extension}/history"; + $history = $this->getHistory($extension); + $history[] = ['version' => $version, 'date' => gmdate('Y-m-d H:i:s')]; + $this->set($name, $history); + } + + /** + * Clears extension history. Useful when creating skeletons. + * + * @param string $extension + */ + public function removeHistory(string $extension): void + { + $this->undef("{$extension}/history"); + } + + /** + * @param array $history + * @return array + */ + private function fixHistory(array $history): array + { + if (isset($history['version'], $history['date'])) { + $fix = [['version' => $history['version'], 'date' => $history['date']]]; + unset($history['version'], $history['date']); + $history = array_merge($fix, $history); + } + + return $history; + } + + /** + * Get value by using dot notation for nested arrays/objects. + * + * @param string $name Slash separated path to the requested value. + * @param mixed $default Default value (or null). + * @return mixed Value. + */ + private function get(string $name, $default = null) + { + $path = explode('/', $name); + $current = $this->items; + + foreach ($path as $field) { + if (is_array($current) && isset($current[$field])) { + $current = $current[$field]; + } else { + return $default; + } + } + + return $current; + } + + /** + * Set value by using dot notation for nested arrays/objects. + * + * @param string $name Slash separated path to the requested value. + * @param mixed $value New value. + */ + private function set(string $name, $value): void + { + $path = explode('/', $name); + $current = &$this->items; + + foreach ($path as $field) { + // Handle arrays and scalars. + if (!is_array($current)) { + $current = [$field => []]; + } elseif (!isset($current[$field])) { + $current[$field] = []; + } + $current = &$current[$field]; + } + + $current = $value; + $this->updated = true; + } + + /** + * Unset value by using dot notation for nested arrays/objects. + * + * @param string $name Dot separated path to the requested value. + */ + private function undef(string $name): void + { + $path = $name !== '' ? explode('/', $name) : []; + if (!$path) { + return; + } + + $var = array_pop($path); + $current = &$this->items; + + foreach ($path as $field) { + if (!is_array($current) || !isset($current[$field])) { + return; + } + $current = &$current[$field]; + } + + unset($current[$var]); + $this->updated = true; + } + + private function __construct(string $filename) + { + $this->filename = $filename; + $content = is_file($filename) ? file_get_contents($filename) : null; + if (false === $content) { + throw new \RuntimeException('Versions file cannot be read'); + } + $this->items = $content ? Yaml::parse($content) : []; + } +} diff --git a/system/src/Grav/Installer/YamlUpdater.php b/system/src/Grav/Installer/YamlUpdater.php new file mode 100644 index 0000000..b8aa078 --- /dev/null +++ b/system/src/Grav/Installer/YamlUpdater.php @@ -0,0 +1,431 @@ +updated) { + return false; + } + + try { + if (!$this->isHandWritten()) { + $yaml = Yaml::dump($this->items, 5, 2); + } else { + $yaml = implode("\n", $this->lines); + + $items = Yaml::parse($yaml); + if ($items !== $this->items) { + throw new \RuntimeException('Failed saving the content'); + } + } + + file_put_contents($this->filename, $yaml); + + } catch (\Exception $e) { + throw new \RuntimeException('Failed to update ' . basename($this->filename) . ': ' . $e->getMessage()); + } + + return true; + } + + /** + * @return bool + */ + public function isHandWritten(): bool + { + return !empty($this->comments); + } + + /** + * @return array + */ + public function getComments(): array + { + $comments = []; + foreach ($this->lines as $i => $line) { + if ($this->isLineEmpty($line)) { + $comments[$i+1] = $line; + } elseif ($comment = $this->getInlineComment($line)) { + $comments[$i+1] = $comment; + } + } + + return $comments; + } + + /** + * @param string $variable + * @param mixed $value + */ + public function define(string $variable, $value): void + { + // If variable has already value, we're good. + if ($this->get($variable) !== null) { + return; + } + + // If one of the parents isn't array, we're good, too. + if (!$this->canDefine($variable)) { + return; + } + + $this->set($variable, $value); + if (!$this->isHandWritten()) { + return; + } + + $parts = explode('.', $variable); + + $lineNos = $this->findPath($this->lines, $parts); + $count = count($lineNos); + $last = array_key_last($lineNos); + + $value = explode("\n", trim(Yaml::dump([$last => $this->get(implode('.', array_keys($lineNos)))], max(0, 5-$count), 2))); + $currentLine = array_pop($lineNos) ?: 0; + $parentLine = array_pop($lineNos); + + if ($parentLine !== null) { + $c = $this->getLineIndentation($this->lines[$parentLine] ?? ''); + $n = $this->getLineIndentation($this->lines[$parentLine+1] ?? $this->lines[$parentLine] ?? ''); + $indent = $n > $c ? $n : $c + 2; + } else { + $indent = 0; + array_unshift($value, ''); + } + $spaces = str_repeat(' ', $indent); + foreach ($value as &$line) { + $line = $spaces . $line; + } + unset($line); + + array_splice($this->lines, abs($currentLine)+1, 0, $value); + } + + public function undefine(string $variable): void + { + // If variable does not have value, we're good. + if ($this->get($variable) === null) { + return; + } + + // If one of the parents isn't array, we're good, too. + if (!$this->canDefine($variable)) { + return; + } + + $this->undef($variable); + if (!$this->isHandWritten()) { + return; + } + + // TODO: support also removing property from handwritten configuration file. + } + + private function __construct(string $filename) + { + $content = is_file($filename) ? (string)file_get_contents($filename) : ''; + $content = rtrim(str_replace(["\r\n", "\r"], "\n", $content)); + + $this->filename = $filename; + $this->lines = explode("\n", $content); + $this->comments = $this->getComments(); + $this->items = $content ? Yaml::parse($content) : []; + } + + /** + * Return array of offsets for the parent nodes. Negative value means position, but not found. + * + * @param array $lines + * @param array $parts + * @return int[] + */ + private function findPath(array $lines, array $parts) + { + $test = true; + $indent = -1; + $current = array_shift($parts); + + $j = 1; + $found = []; + $space = ''; + foreach ($lines as $i => $line) { + if ($this->isLineEmpty($line)) { + if ($this->isLineComment($line) && $this->getLineIndentation($line) > $indent) { + $j = $i; + } + continue; + } + + if ($test === true) { + $test = false; + $spaces = strlen($line) - strlen(ltrim($line, ' ')); + if ($spaces <= $indent) { + $found[$current] = -$j; + + return $found; + } + + $indent = $spaces; + $space = $indent ? str_repeat(' ', $indent) : ''; + } + + + if (0 === \strncmp($line, $space, strlen($space))) { + $pattern = "/^{$space}(['\"]?){$current}\\1\:/"; + + if (preg_match($pattern, $line)) { + $found[$current] = $i; + $current = array_shift($parts); + if ($current === null) { + return $found; + } + $test = true; + } + } else { + $found[$current] = -$j; + + return $found; + } + + $j = $i; + } + + $found[$current] = -$j; + + return $found; + } + + /** + * Returns true if the current line is blank or if it is a comment line. + * + * @param string $line Contents of the line + * @return bool Returns true if the current line is empty or if it is a comment line, false otherwise + */ + private function isLineEmpty(string $line): bool + { + return $this->isLineBlank($line) || $this->isLineComment($line); + } + + /** + * Returns true if the current line is blank. + * + * @param string $line Contents of the line + * @return bool Returns true if the current line is blank, false otherwise + */ + private function isLineBlank(string $line): bool + { + return '' === trim($line, ' '); + } + + /** + * Returns true if the current line is a comment line. + * + * @param string $line Contents of the line + * @return bool Returns true if the current line is a comment line, false otherwise + */ + private function isLineComment(string $line): bool + { + //checking explicitly the first char of the trim is faster than loops or strpos + $ltrimmedLine = ltrim($line, ' '); + + return '' !== $ltrimmedLine && '#' === $ltrimmedLine[0]; + } + + /** + * @param string $line + * @return bool + */ + private function isInlineComment(string $line): bool + { + return $this->getInlineComment($line) !== null; + } + + /** + * @param string $line + * @return string|null + */ + private function getInlineComment(string $line): ?string + { + $pos = strpos($line, ' #'); + if (false === $pos) { + return null; + } + + $parts = explode(' #', $line); + $part = ''; + while ($part .= array_shift($parts)) { + // Remove quoted values. + $part = preg_replace('/(([\'"])[^\2]*\2)/', '', $part); + assert(null !== $part); + $part = preg_split('/[\'"]/', $part, 2); + assert(false !== $part); + if (!isset($part[1])) { + $part = $part[0]; + array_unshift($parts, str_repeat(' ', strlen($part) - strlen(trim($part, ' ')))); + break; + } + $part = $part[1]; + } + + + return implode(' #', $parts); + } + + /** + * Returns the current line indentation. + * + * @param string $line + * @return int The current line indentation + */ + private function getLineIndentation(string $line): int + { + return \strlen($line) - \strlen(ltrim($line, ' ')); + } + + /** + * Get value by using dot notation for nested arrays/objects. + * + * @param string $name Dot separated path to the requested value. + * @param mixed $default Default value (or null). + * @return mixed Value. + */ + private function get(string $name, $default = null) + { + $path = explode('.', $name); + $current = $this->items; + + foreach ($path as $field) { + if (is_array($current) && isset($current[$field])) { + $current = $current[$field]; + } else { + return $default; + } + } + + return $current; + } + + /** + * Set value by using dot notation for nested arrays/objects. + * + * @param string $name Dot separated path to the requested value. + * @param mixed $value New value. + */ + private function set(string $name, $value): void + { + $path = explode('.', $name); + $current = &$this->items; + + foreach ($path as $field) { + // Handle arrays and scalars. + if (!is_array($current)) { + $current = [$field => []]; + } elseif (!isset($current[$field])) { + $current[$field] = []; + } + $current = &$current[$field]; + } + + $current = $value; + $this->updated = true; + } + + /** + * Unset value by using dot notation for nested arrays/objects. + * + * @param string $name Dot separated path to the requested value. + */ + private function undef(string $name): void + { + $path = $name !== '' ? explode('.', $name) : []; + if (!$path) { + return; + } + + $var = array_pop($path); + $current = &$this->items; + + foreach ($path as $field) { + if (!is_array($current) || !isset($current[$field])) { + return; + } + $current = &$current[$field]; + } + + unset($current[$var]); + $this->updated = true; + } + + /** + * Get value by using dot notation for nested arrays/objects. + * + * @param string $name Dot separated path to the requested value. + * @return bool + */ + private function canDefine(string $name): bool + { + $path = explode('.', $name); + $current = $this->items; + + foreach ($path as $field) { + if (is_array($current)) { + if (!isset($current[$field])) { + return true; + } + $current = $current[$field]; + } else { + return false; + } + } + + return true; + } +} diff --git a/system/src/Grav/Installer/updates/1.7.0_2020-11-20_1.php b/system/src/Grav/Installer/updates/1.7.0_2020-11-20_1.php new file mode 100644 index 0000000..6120665 --- /dev/null +++ b/system/src/Grav/Installer/updates/1.7.0_2020-11-20_1.php @@ -0,0 +1,24 @@ + null, + 'postflight' => + function () { + /** @var VersionUpdate $this */ + try { + // Keep old defaults for backwards compatibility. + $yaml = YamlUpdater::instance(GRAV_ROOT . '/user/config/system.yaml'); + $yaml->define('twig.autoescape', false); + $yaml->define('strict_mode.yaml_compat', true); + $yaml->define('strict_mode.twig_compat', true); + $yaml->define('strict_mode.blueprint_compat', true); + $yaml->save(); + } catch (\Exception $e) { + throw new InstallException('Could not update system configuration to maintain backwards compatibility', $e); + } + } +]; diff --git a/system/src/Twig/DeferredExtension/DeferredBlockNode.php b/system/src/Twig/DeferredExtension/DeferredBlockNode.php new file mode 100755 index 0000000..6ae974f --- /dev/null +++ b/system/src/Twig/DeferredExtension/DeferredBlockNode.php @@ -0,0 +1,43 @@ + + * + * For the full copyright and license information, please view the LICENSE + * file that was distributed with this source code. + */ + +declare(strict_types=1); + +namespace Twig\DeferredExtension; + +use Twig\Compiler; +use Twig\Node\BlockNode; + +final class DeferredBlockNode extends BlockNode +{ + public function compile(Compiler $compiler) : void + { + $name = $this->getAttribute('name'); + + $compiler + ->write("public function block_$name(\$context, array \$blocks = [])\n", "{\n") + ->indent() + ->write("\$this->deferred->defer(\$this, '$name');\n") + ->outdent() + ->write("}\n\n") + ; + + $compiler + ->addDebugInfo($this) + ->write("public function block_{$name}_deferred(\$context, array \$blocks = [])\n", "{\n") + ->indent() + ->subcompile($this->getNode('body')) + ->write("\$this->deferred->resolve(\$this, \$context, \$blocks);\n") + ->outdent() + ->write("}\n\n") + ; + } +} diff --git a/system/src/Twig/DeferredExtension/DeferredDeclareNode.php b/system/src/Twig/DeferredExtension/DeferredDeclareNode.php new file mode 100644 index 0000000..ba05121 --- /dev/null +++ b/system/src/Twig/DeferredExtension/DeferredDeclareNode.php @@ -0,0 +1,27 @@ + + * + * For the full copyright and license information, please view the LICENSE + * file that was distributed with this source code. + */ + +declare(strict_types=1); + +namespace Twig\DeferredExtension; + +use Twig\Compiler; +use Twig\Node\Node; + +final class DeferredDeclareNode extends Node +{ + public function compile(Compiler $compiler) : void + { + $compiler + ->write("private \$deferred;\n") + ; + } +} \ No newline at end of file diff --git a/system/src/Twig/DeferredExtension/DeferredExtension.php b/system/src/Twig/DeferredExtension/DeferredExtension.php new file mode 100644 index 0000000..f27c2a3 --- /dev/null +++ b/system/src/Twig/DeferredExtension/DeferredExtension.php @@ -0,0 +1,72 @@ + + * + * For the full copyright and license information, please view the LICENSE + * file that was distributed with this source code. + */ + +declare(strict_types=1); + +namespace Twig\DeferredExtension; + +use Twig\Environment; +use Twig\Extension\AbstractExtension; +use Twig\Template; + +final class DeferredExtension extends AbstractExtension +{ + private $blocks = []; + + public function getTokenParsers() : array + { + return [new DeferredTokenParser()]; + } + + public function getNodeVisitors() : array + { + if (Environment::VERSION_ID < 20000) { + // Twig 1.x support + return [new DeferredNodeVisitorCompat()]; + } + + return [new DeferredNodeVisitor()]; + } + + public function defer(Template $template, string $blockName) : void + { + $templateName = $template->getTemplateName(); + $this->blocks[$templateName][] = $blockName; + $index = \count($this->blocks[$templateName]) - 1; + + \ob_start(function (string $buffer) use ($index, $templateName) { + unset($this->blocks[$templateName][$index]); + + return $buffer; + }); + } + + public function resolve(Template $template, array $context, array $blocks) : void + { + $templateName = $template->getTemplateName(); + if (empty($this->blocks[$templateName])) { + return; + } + + while ($blockName = \array_pop($this->blocks[$templateName])) { + $buffer = \ob_get_clean(); + + $blocks[$blockName] = [$template, 'block_'.$blockName.'_deferred']; + $template->displayBlock($blockName, $context, $blocks); + + echo $buffer; + } + + if ($parent = $template->getParent($context)) { + $this->resolve($parent, $context, $blocks); + } + } +} diff --git a/system/src/Twig/DeferredExtension/DeferredInitializeNode.php b/system/src/Twig/DeferredExtension/DeferredInitializeNode.php new file mode 100644 index 0000000..0653f5c --- /dev/null +++ b/system/src/Twig/DeferredExtension/DeferredInitializeNode.php @@ -0,0 +1,27 @@ + + * + * For the full copyright and license information, please view the LICENSE + * file that was distributed with this source code. + */ + +declare(strict_types=1); + +namespace Twig\DeferredExtension; + +use Twig\Compiler; +use Twig\Node\Node; + +final class DeferredInitializeNode extends Node +{ + public function compile(Compiler $compiler) : void + { + $compiler + ->write("\$this->deferred = \$this->env->getExtension('".DeferredExtension::class."');\n") + ; + } +} diff --git a/system/src/Twig/DeferredExtension/DeferredNode.php b/system/src/Twig/DeferredExtension/DeferredNode.php new file mode 100755 index 0000000..2ac73bd --- /dev/null +++ b/system/src/Twig/DeferredExtension/DeferredNode.php @@ -0,0 +1,27 @@ + + * + * For the full copyright and license information, please view the LICENSE + * file that was distributed with this source code. + */ + +declare(strict_types=1); + +namespace Twig\DeferredExtension; + +use Twig\Compiler; +use Twig\Node\Node; + +final class DeferredNode extends Node +{ + public function compile(Compiler $compiler) : void + { + $compiler + ->write("\$this->deferred->resolve(\$this, \$context, \$blocks);\n") + ; + } +} diff --git a/system/src/Twig/DeferredExtension/DeferredNodeVisitor.php b/system/src/Twig/DeferredExtension/DeferredNodeVisitor.php new file mode 100644 index 0000000..6f61487 --- /dev/null +++ b/system/src/Twig/DeferredExtension/DeferredNodeVisitor.php @@ -0,0 +1,50 @@ + + * + * For the full copyright and license information, please view the LICENSE + * file that was distributed with this source code. + */ + +declare(strict_types=1); + +namespace Twig\DeferredExtension; + +use Twig\Environment; +use Twig\Node\ModuleNode; +use Twig\Node\Node; +use Twig\NodeVisitor\NodeVisitorInterface; + +final class DeferredNodeVisitor implements NodeVisitorInterface +{ + private $hasDeferred = false; + + public function enterNode(Node $node, Environment $env) : Node + { + if (!$this->hasDeferred && $node instanceof DeferredBlockNode) { + $this->hasDeferred = true; + } + + return $node; + } + + public function leaveNode(Node $node, Environment $env) : ?Node + { + if ($this->hasDeferred && $node instanceof ModuleNode) { + $node->getNode('constructor_end')->setNode('deferred_initialize', new DeferredInitializeNode()); + $node->getNode('display_end')->setNode('deferred_resolve', new DeferredResolveNode()); + $node->getNode('class_end')->setNode('deferred_declare', new DeferredDeclareNode()); + $this->hasDeferred = false; + } + + return $node; + } + + public function getPriority() : int + { + return 0; + } +} diff --git a/system/src/Twig/DeferredExtension/DeferredNodeVisitorCompat.php b/system/src/Twig/DeferredExtension/DeferredNodeVisitorCompat.php new file mode 100644 index 0000000..aa61b72 --- /dev/null +++ b/system/src/Twig/DeferredExtension/DeferredNodeVisitorCompat.php @@ -0,0 +1,67 @@ + + * + * For the full copyright and license information, please view the LICENSE + * file that was distributed with this source code. + */ + +declare(strict_types=1); + +namespace Twig\DeferredExtension; + +use Twig\Environment; +use Twig\Node\ModuleNode; +use Twig\Node\Node; +use Twig\NodeVisitor\NodeVisitorInterface; + +final class DeferredNodeVisitorCompat implements NodeVisitorInterface +{ + private $hasDeferred = false; + + /** + * @param \Twig_NodeInterface $node + * @param Environment $env + * @return Node + */ + public function enterNode(\Twig_NodeInterface $node, Environment $env): Node + { + if (!$this->hasDeferred && $node instanceof DeferredBlockNode) { + $this->hasDeferred = true; + } + + \assert($node instanceof Node); + + return $node; + } + + /** + * @param \Twig_NodeInterface $node + * @param Environment $env + * @return Node|null + */ + public function leaveNode(\Twig_NodeInterface $node, Environment $env): ?Node + { + if ($this->hasDeferred && $node instanceof ModuleNode) { + $node->getNode('constructor_end')->setNode('deferred_initialize', new DeferredInitializeNode()); + $node->getNode('display_end')->setNode('deferred_resolve', new DeferredResolveNode()); + $node->getNode('class_end')->setNode('deferred_declare', new DeferredDeclareNode()); + $this->hasDeferred = false; + } + + \assert($node instanceof Node); + + return $node; + } + + /** + * @return int + */ + public function getPriority() : int + { + return 0; + } +} diff --git a/system/src/Twig/DeferredExtension/DeferredResolveNode.php b/system/src/Twig/DeferredExtension/DeferredResolveNode.php new file mode 100644 index 0000000..72e0e29 --- /dev/null +++ b/system/src/Twig/DeferredExtension/DeferredResolveNode.php @@ -0,0 +1,27 @@ + + * + * For the full copyright and license information, please view the LICENSE + * file that was distributed with this source code. + */ + +declare(strict_types=1); + +namespace Twig\DeferredExtension; + +use Twig\Compiler; +use Twig\Node\Node; + +final class DeferredResolveNode extends Node +{ + public function compile(Compiler $compiler) : void + { + $compiler + ->write("\$this->deferred->resolve(\$this, \$context, \$blocks);\n") + ; + } +} diff --git a/system/src/Twig/DeferredExtension/DeferredTokenParser.php b/system/src/Twig/DeferredExtension/DeferredTokenParser.php new file mode 100644 index 0000000..1870ae0 --- /dev/null +++ b/system/src/Twig/DeferredExtension/DeferredTokenParser.php @@ -0,0 +1,77 @@ + + * + * For the full copyright and license information, please view the LICENSE + * file that was distributed with this source code. + */ + +declare(strict_types=1); + +namespace Twig\DeferredExtension; + +use Twig\Node\BlockNode; +use Twig\Node\Node; +use Twig\Parser; +use Twig\Token; +use Twig\TokenParser\AbstractTokenParser; +use Twig\TokenParser\BlockTokenParser; + +final class DeferredTokenParser extends AbstractTokenParser +{ + private $blockTokenParser; + + public function setParser(Parser $parser) : void + { + parent::setParser($parser); + + $this->blockTokenParser = new BlockTokenParser(); + $this->blockTokenParser->setParser($parser); + } + + public function parse(Token $token) : Node + { + $stream = $this->parser->getStream(); + $nameToken = $stream->next(); + $deferredToken = $stream->nextIf(Token::NAME_TYPE, 'deferred'); + $stream->injectTokens([$nameToken]); + + $node = $this->blockTokenParser->parse($token); + + if ($deferredToken) { + $this->replaceBlockNode($nameToken->getValue()); + } + + return $node; + } + + public function getTag() : string + { + return 'block'; + } + + private function replaceBlockNode(string $name) : void + { + $block = $this->parser->getBlock($name)->getNode('0'); + $this->parser->setBlock($name, $this->createDeferredBlockNode($block)); + } + + private function createDeferredBlockNode(BlockNode $block) : DeferredBlockNode + { + $name = $block->getAttribute('name'); + $deferredBlock = new DeferredBlockNode($name, new Node([]), $block->getTemplateLine()); + + foreach ($block as $nodeName => $node) { + $deferredBlock->setNode($nodeName, $node); + } + + if ($sourceContext = $block->getSourceContext()) { + $deferredBlock->setSourceContext($sourceContext); + } + + return $deferredBlock; + } +} diff --git a/system/templates/default.html.twig b/system/templates/default.html.twig new file mode 100644 index 0000000..f18206b --- /dev/null +++ b/system/templates/default.html.twig @@ -0,0 +1,4 @@ +{# Default output if no theme #} +

    ERROR: {{ page.template() ~'.'~ page.templateFormat() ~".twig" }} template not found for page: {{ page.route() }}

    +

    {{ page.title() }}

    +{{ page.content()|raw }} diff --git a/system/templates/external.html.twig b/system/templates/external.html.twig new file mode 100644 index 0000000..3fa3508 --- /dev/null +++ b/system/templates/external.html.twig @@ -0,0 +1 @@ +{# Default external template #} diff --git a/system/templates/flex/404.html.twig b/system/templates/flex/404.html.twig new file mode 100644 index 0000000..adf4f65 --- /dev/null +++ b/system/templates/flex/404.html.twig @@ -0,0 +1,4 @@ +{% set item = collection ?? object %} +{% set type = collection ? 'collection' : 'object' %} + +ERROR: Layout '{{ layout }}' for flex {{ type }} '{{ item.flexType() }}' was not found. \ No newline at end of file diff --git a/system/templates/flex/_default/collection/debug.html.twig b/system/templates/flex/_default/collection/debug.html.twig new file mode 100644 index 0000000..5a37835 --- /dev/null +++ b/system/templates/flex/_default/collection/debug.html.twig @@ -0,0 +1,5 @@ +

    {{ directory.getTitle() }} debug dump

    + +{% for object in collection %} + {% render object layout: layout %} +{% endfor %} diff --git a/system/templates/flex/_default/object/debug.html.twig b/system/templates/flex/_default/object/debug.html.twig new file mode 100644 index 0000000..dc961cd --- /dev/null +++ b/system/templates/flex/_default/object/debug.html.twig @@ -0,0 +1,4 @@ +
    +

    {{ object.key }}

    + 
    {{ object.jsonSerialize()|yaml_encode }}
    +
    \ No newline at end of file diff --git a/system/templates/modular/default.html.twig b/system/templates/modular/default.html.twig new file mode 100644 index 0000000..f18206b --- /dev/null +++ b/system/templates/modular/default.html.twig @@ -0,0 +1,4 @@ +{# Default output if no theme #} +

    ERROR: {{ page.template() ~'.'~ page.templateFormat() ~".twig" }} template not found for page: {{ page.route() }}

    +

    {{ page.title() }}

    +{{ page.content()|raw }} diff --git a/system/templates/partials/messages.html.twig b/system/templates/partials/messages.html.twig new file mode 100644 index 0000000..261b3fc --- /dev/null +++ b/system/templates/partials/messages.html.twig @@ -0,0 +1,14 @@ +{% set status_mapping = {'info':'green', 'error': 'red', 'warning': 'yellow'} %} + +{% if grav.messages.all %} +
    + {% for message in grav.messages.fetch %} + + {% set scope = message.scope|e %} + {% set color = status_mapping[scope] %} + +

    {{ message.message|raw }}

    + + {% endfor %} +
    +{% endif %} diff --git a/system/templates/partials/metadata.html.twig b/system/templates/partials/metadata.html.twig new file mode 100644 index 0000000..fcf1217 --- /dev/null +++ b/system/templates/partials/metadata.html.twig @@ -0,0 +1,3 @@ +{% for meta in page.metadata %} + +{% endfor %} diff --git a/tests/_bootstrap.php b/tests/_bootstrap.php new file mode 100644 index 0000000..618781d --- /dev/null +++ b/tests/_bootstrap.php @@ -0,0 +1,35 @@ +init(); + + // This must be set first before the other init + $grav['config']->set('system.languages.supported', ['en', 'fr', 'vi']); + $grav['config']->set('system.languages.default_lang', 'en'); + + foreach (array_keys($grav['setup']->getStreams()) as $stream) { + @stream_wrapper_unregister($stream); + } + + $grav['streams']; + + $grav['uri']->init(); + $grav['debugger']->init(); + $grav['assets']->init(); + + $grav['config']->set('system.cache.enabled', false); + $grav['locator']->addPath('tests', '', 'tests', false); + + return $grav; +}; + +Fixtures::add('grav', $grav); diff --git a/tests/_support/AcceptanceTester.php b/tests/_support/AcceptanceTester.php new file mode 100644 index 0000000..4c7dcbb --- /dev/null +++ b/tests/_support/AcceptanceTester.php @@ -0,0 +1,26 @@ +t!fmROooqL-Tz8o|Tx<=pzP32bY^zA}n1m`*SZ zayH~~sh*$2f56|-lb6+ai;Tk!uM0i7lF_H0{5Zi`GEH@D+5JM9lSj1nKe)T&;m-;` z_diSd=LVjNxEHYH)e#|P({1W0Z@V{d{K+CJxk<%)f5U2*^1@Eu4L`D?f>!k1m^N>z z$H%+^=cVf}u-|r`eeuO5&XA|aU$*!&muD*Wsr@eOopdYsS7GFfT{%^Z_bbv2jV|)7 zpBi*{E6Yu+0_pvPdZ<#k#~Xw_4`vsh3VLn7h~tUHZ`TtSwkz_?3jAU7@a?opiQms8cudkC$rRsg7umFT zp>6NVpdI;LvqNOg#<43ZIh=ofz(-?G#k;)AyK*nEsWc}4E&N*MwLid{oujB&wp)>r zf#C)a2Y53wi83RC8d;8ufd>}w4oezAOyq#)fCqelH!B-RmJtYDfOIC%Tm}XJO6sxU literal 0 HcmV?d00001 diff --git a/tests/fake/nested-site/user/pages/01.item1/home-cache-image.jpg b/tests/fake/nested-site/user/pages/01.item1/home-cache-image.jpg new file mode 100644 index 0000000000000000000000000000000000000000..3170ac497409e7c7923d25e3eae4b9e4a920b211 GIT binary patch literal 156699 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�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

    xa_u8c)hsQoXBakm44Rj@Hu~WCdpmw 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�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

    xa_u8c)hsQoXBakm44Rj@Hu~WCdpmw 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�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

    xa_u8c)hsQoXBakm44Rj@Hu~WCdpmw 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 literal 0 HcmV?d00001 diff --git a/tests/fake/nested-site/user/pages/02.item2/02.item2-2/sample-image.jpg b/tests/fake/nested-site/user/pages/02.item2/02.item2-2/sample-image.jpg new file mode 100644 index 0000000000000000000000000000000000000000..3170ac497409e7c7923d25e3eae4b9e4a920b211 GIT binary patch literal 156699 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�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

    xa_u8c)hsQoXBakm44Rj@Hu~WCdpmw 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: animalgrav = Fixtures::get('grav'); + $this->directInstallCommand = new DirectInstallCommand(); + } +} + +/** + * Why this test file is empty + * + * Wasn't able to call a symfony\console. Kept having $output problem. + * symfony console \NullOutput didn't cut it. + * + * We would also need to Mock tests since downloading packages would + * make tests slow and unreliable. But it's not worth the time ATM. + * + * Look at Gpm/InstallCommandTest.php + * + * For the full story: https://git.io/vSlI3 + */ diff --git a/tests/functional/_bootstrap.php b/tests/functional/_bootstrap.php new file mode 100644 index 0000000..8a88555 --- /dev/null +++ b/tests/functional/_bootstrap.php @@ -0,0 +1,2 @@ +getName() === 'findResource'; + } + + /** + * @param MethodReflection $methodReflection + * @param MethodCall $methodCall + * @param Scope $scope + * @return Type + */ + public function getTypeFromMethodCall(MethodReflection $methodReflection, MethodCall $methodCall, Scope $scope): Type + { + $first = $methodCall->getArgs()[2] ?? false; + if ($first) { + return new StringType(); + } + + return ParametersAcceptorSelector::selectSingle($methodReflection->getVariants())->getReturnType(); + } +} diff --git a/tests/phpstan/extension.neon b/tests/phpstan/extension.neon new file mode 100644 index 0000000..ef44d0b --- /dev/null +++ b/tests/phpstan/extension.neon @@ -0,0 +1,5 @@ +services: + - + class: PHPStan\Toolbox\UniformResourceLocatorExtension + tags: + - phpstan.broker.dynamicMethodReturnTypeExtension diff --git a/tests/phpstan/phpstan-bootstrap.php b/tests/phpstan/phpstan-bootstrap.php new file mode 100644 index 0000000..b145fa1 --- /dev/null +++ b/tests/phpstan/phpstan-bootstrap.php @@ -0,0 +1,7 @@ + $autoload]); +$grav->setup('tests'); +$grav['config']->init(); + +// Find all plugins in Grav installation and autoload their classes. + +/** @var UniformResourceLocator $locator */ +$locator = Grav::instance()['locator']; +$iterator = $locator->getIterator('plugins://'); +/** @var DirectoryIterator $directory */ +foreach ($iterator as $directory) { + if (!$directory->isDir()) { + continue; + } + $plugin = $directory->getBasename(); + $file = $directory->getPathname() . '/' . $plugin . '.php'; + $classloader = null; + if (file_exists($file)) { + require_once $file; + + $pluginClass = "\\Grav\\Plugin\\{$plugin}Plugin"; + + if (is_subclass_of($pluginClass, Plugin::class, true)) { + $class = new $pluginClass($plugin, $grav); + if (is_callable([$class, 'autoload'])) { + $classloader = $class->autoload(); + } + } + } + if (null === $classloader) { + $autoloader = $directory->getPathname() . '/vendor/autoload.php'; + if (file_exists($autoloader)) { + require $autoloader; + } + } +} + +define('GANTRY_DEBUGGER', true); +define('GANTRY5_DEBUG', true); +define('GANTRY5_PLATFORM', 'grav'); +define('GANTRY5_ROOT', GRAV_ROOT); +define('GANTRY5_VERSION', '@version@'); +define('GANTRY5_VERSION_DATE', '@versiondate@'); +define('GANTRYADMIN_PATH', ''); diff --git a/tests/phpstan/plugins.neon b/tests/phpstan/plugins.neon new file mode 100644 index 0000000..82570cc --- /dev/null +++ b/tests/phpstan/plugins.neon @@ -0,0 +1,70 @@ +includes: + #- '../../vendor/phpstan/phpstan-strict-rules/rules.neon' + - '../../vendor/phpstan/phpstan-deprecation-rules/rules.neon' + - 'extension.neon' +parameters: + fileExtensions: + - php + excludePaths: + - %currentWorkingDirectory%/user/plugins/*/vendor/* + - %currentWorkingDirectory%/user/plugins/*/tests/* + - %currentWorkingDirectory%/user/plugins/gantry5/src/platforms + - %currentWorkingDirectory%/user/plugins/gantry5/src/classes/Gantry/Framework/Services/ErrorServiceProvider.php + # Ignore vendor dev dependencies and tests + - */vendor/*/*/tests + - */vendor/behat + - */vendor/codeception + - */vendor/phpstan + - */vendor/phpunit + - */vendor/phpspec + - */vendor/phpdocumentor + - */vendor/sebastian + - */vendor/theseer + - */vendor/webmozart + bootstrapFiles: + - plugins-bootstrap.php + inferPrivatePropertyTypeFromConstructor: true + reportUnmatchedIgnoredErrors: false + + # These checks are new in phpstan 1, ignore them for now. + checkMissingIterableValueType: false + checkGenericClassInNonGenericObjectType: false + + universalObjectCratesClasses: + - Grav\Common\Config\Config + - Grav\Common\Config\Languages + - Grav\Common\Config\Setup + - Grav\Common\Data\Data + - Grav\Common\GPM\Common\Package + - Grav\Common\GPM\Local\Package + - Grav\Common\GPM\Remote\Package + - Grav\Common\Page\Header + - Grav\Common\Session + - Gantry\Component\Config\Config + dynamicConstantNames: + - GRAV_CLI + - GANTRY_DEBUGGER + - GANTRY5_DEBUG + - GANTRY5_VERSION + - GANTRY5_VERSION_DATE + - GANTRY5_PLATFORM + - GANTRY5_ROOT + ignoreErrors: + # New in phpstan 1, ignore them for now. + - '#Unsafe usage of new static\(\)#' + - '#Cannot instantiate interface Grav\\Framework\\#' + + # PSR-16 Exception interfaces do not extend \Throwable + - '#PHPDoc tag \@throws with type (.*|)?Psr\\SimpleCache\\(CacheException|InvalidArgumentException)(|.*)? is not subtype of Throwable#' + + - '#Access to an undefined property RocketTheme\\Toolbox\\Event\\Event::#' + - '#Instantiation of deprecated class RocketTheme\\Toolbox\\Event\\Event#' + - '#extends deprecated class RocketTheme\\Toolbox\\Event\\Event#' + - '#implements deprecated interface RocketTheme\\Toolbox\\Event\\EventSubscriberInterface#' + - '#Call to method __construct\(\) of deprecated class RocketTheme\\Toolbox\\Event\\Event#' + - '#Call to deprecated method (stopPropagation|isPropagationStopped)\(\) of class Symfony\\Component\\EventDispatcher\\Event#' + - '#Call to an undefined method Grav\\Plugin\\ApartmentData\\Application\\Application::#' + - '#Parameter \#1 \$lineNumberStyle of method ScssPhp\\ScssPhp\\Compiler::setLineNumberStyle\(\) expects string, int given#' + + # Deprecated event class + - '#has typehint with deprecated class RocketTheme\\Toolbox\\Event\\Event#' diff --git a/tests/unit.suite.yml b/tests/unit.suite.yml new file mode 100644 index 0000000..02dc9b1 --- /dev/null +++ b/tests/unit.suite.yml @@ -0,0 +1,9 @@ +# Codeception Test Suite Configuration +# +# Suite for unit (internal) tests. + +class_name: UnitTester +modules: + enabled: + - Asserts + - \Helper\Unit \ No newline at end of file diff --git a/tests/unit/Grav/Common/AssetsTest.php b/tests/unit/Grav/Common/AssetsTest.php new file mode 100644 index 0000000..57539a6 --- /dev/null +++ b/tests/unit/Grav/Common/AssetsTest.php @@ -0,0 +1,847 @@ +grav = $grav(); + $this->assets = $this->grav['assets']; + } + + protected function _after(): void + { + } + + public function testAddingAssets(): void + { + //test add() + $this->assets->add('test.css'); + + $css = $this->assets->css(); + self::assertSame('' . PHP_EOL, $css); + + $array = $this->assets->getCss(); + + /** @var Assets\BaseAsset $item */ + $item = reset($array); + $actual = json_encode($item); + $expected = ' + { + "type":"css", + "elements":{ + "asset":"\/test.css", + "asset_type":"css", + "order":0, + "group":"head", + "position":"pipeline", + "priority":10, + "attributes":{ + "type":"text\/css", + "rel":"stylesheet" + }, + "modified":false, + "query":"" + } + }'; + self::assertJsonStringEqualsJsonString($expected, $actual); + + $this->assets->add('test.js'); + $js = $this->assets->js(); + self::assertSame('' . PHP_EOL, $js); + + $array = $this->assets->getJs(); + + /** @var Assets\BaseAsset $item */ + $item = reset($array); + $actual = json_encode($item); + $expected = ' + { + "type":"js", + "elements":{ + "asset":"\/test.js", + "asset_type":"js", + "order":0, + "group":"head", + "position":"pipeline", + "priority":10, + "attributes":[ + + ], + "modified":false, + "query":"" + } + }'; + self::assertJsonStringEqualsJsonString($expected, $actual); + + //test addCss(). Test adding asset to a separate group + $this->assets->reset(); + $this->assets->addCSS('test.css'); + $css = $this->assets->css(); + self::assertSame('' . PHP_EOL, $css); + + $array = $this->assets->getCss(); + /** @var Assets\BaseAsset $item */ + $item = reset($array); + $actual = json_encode($item); + $expected = ' + { + "type":"css", + "elements":{ + "asset":"\/test.css", + "asset_type":"css", + "order":0, + "group":"head", + "position":"pipeline", + "priority":10, + "attributes":{ + "type":"text\/css", + "rel":"stylesheet" + }, + "modified":false, + "query":"" + } + }'; + self::assertJsonStringEqualsJsonString($expected, $actual); + + //test addCss(). Testing with remote URL + $this->assets->reset(); + $this->assets->addCSS('http://www.somesite.com/test.css'); + $css = $this->assets->css(); + self::assertSame('' . PHP_EOL, $css); + + $array = $this->assets->getCss(); + /** @var Assets\BaseAsset $item */ + $item = reset($array); + $actual = json_encode($item); + $expected = ' + { + "type":"css", + "elements":{ + "asset":"http:\/\/www.somesite.com\/test.css", + "asset_type":"css", + "order":0, + "group":"head", + "position":"pipeline", + "priority":10, + "attributes":{ + "type":"text\/css", + "rel":"stylesheet" + }, + "query":"" + } + }'; + self::assertJsonStringEqualsJsonString($expected, $actual); + + //test addCss() adding asset to a separate group, and with an alternate rel attribute + $this->assets->reset(); + $this->assets->addCSS('test.css', ['group' => 'alternate', 'rel' => 'alternate']); + $css = $this->assets->css('alternate'); + self::assertSame('' . PHP_EOL, $css); + + //test addJs() + $this->assets->reset(); + $this->assets->addJs('test.js'); + $js = $this->assets->js(); + self::assertSame('' . PHP_EOL, $js); + + $array = $this->assets->getJs(); + /** @var Assets\BaseAsset $item */ + $item = reset($array); + $actual = json_encode($item); + $expected = ' + { + "type":"js", + "elements":{ + "asset":"\/test.js", + "asset_type":"js", + "order":0, + "group":"head", + "position":"pipeline", + "priority":10, + "attributes":[], + "modified":false, + "query":"" + } + }'; + self::assertJsonStringEqualsJsonString($expected, $actual); + + //Test CSS Groups + $this->assets->reset(); + $this->assets->addCSS('test.css', ['group' => 'footer']); + $css = $this->assets->css(); + self::assertEmpty($css); + $css = $this->assets->css('footer'); + self::assertSame('' . PHP_EOL, $css); + + $array = $this->assets->getCss(); + /** @var Assets\BaseAsset $item */ + $item = reset($array); + $actual = json_encode($item); + $expected = ' + { + "type": "css", + "elements": { + "asset": "/test.css", + "asset_type": "css", + "order": 0, + "group": "footer", + "position": "pipeline", + "priority": 10, + "attributes": { + "type": "text/css", + "rel": "stylesheet" + }, + "modified": false, + "query": "" + } + } + '; + self::assertJsonStringEqualsJsonString($expected, $actual); + + //Test JS Groups + $this->assets->reset(); + $this->assets->addJs('test.js', ['group' => 'footer']); + $js = $this->assets->js(); + self::assertEmpty($js); + $js = $this->assets->js('footer'); + self::assertSame('' . PHP_EOL, $js); + + $array = $this->assets->getJs(); + /** @var Assets\BaseAsset $item */ + $item = reset($array); + $actual = json_encode($item); + $expected = ' + { + "type": "js", + "elements": { + "asset": "/test.js", + "asset_type": "js", + "order": 0, + "group": "footer", + "position": "pipeline", + "priority": 10, + "attributes": [], + "modified": false, + "query": "" + } + }'; + self::assertJsonStringEqualsJsonString($expected, $actual); + + //Test async / defer + $this->assets->reset(); + $this->assets->addJs('test.js', ['loading' => 'async']); + $js = $this->assets->js(); + self::assertSame('' . PHP_EOL, $js); + + $array = $this->assets->getJs(); + /** @var Assets\BaseAsset $item */ + $item = reset($array); + $actual = json_encode($item); + $expected = ' + { + "type": "js", + "elements": { + "asset": "/test.js", + "asset_type": "js", + "order": 0, + "group": "head", + "position": "pipeline", + "priority": 10, + "attributes": { + "loading": "async" + }, + "modified": false, + "query": "" + } + }'; + self::assertJsonStringEqualsJsonString($expected, $actual); + + $this->assets->reset(); + $this->assets->addJs('test.js', ['loading' => 'defer']); + $js = $this->assets->js(); + self::assertSame('' . PHP_EOL, $js); + + $array = $this->assets->getJs(); + /** @var Assets\BaseAsset $item */ + $item = reset($array); + $actual = json_encode($item); + $expected = ' + { + "type": "js", + "elements": { + "asset": "/test.js", + "asset_type": "js", + "order": 0, + "group": "head", + "position": "pipeline", + "priority": 10, + "attributes": { + "loading": "defer" + }, + "modified": false, + "query": "" + } + }'; + self::assertJsonStringEqualsJsonString($expected, $actual); + + //Test inline + $this->assets->reset(); + $this->assets->setJsPipeline(true); + $this->assets->addJs('/system/assets/jquery/jquery-3.x.min.js'); + $js = $this->assets->js('head', ['loading' => 'inline']); + self::assertStringContainsString('"jquery",[],function()', $js); + + $this->assets->reset(); + $this->assets->setCssPipeline(true); + $this->assets->addCss('/system/assets/debugger/phpdebugbar.css'); + $css = $this->assets->css('head', ['loading' => 'inline']); + self::assertStringContainsString('div.phpdebugbar', $css); + + $this->assets->reset(); + $this->assets->setCssPipeline(true); + $this->assets->addCss('https://fonts.googleapis.com/css?family=Roboto'); + $css = $this->assets->css('head', ['loading' => 'inline']); + self::assertStringContainsString('font-family:\'Roboto\';', $css); + + //Test adding media queries + $this->assets->reset(); + $this->assets->add('test.css', ['media' => 'only screen and (min-width: 640px)']); + $css = $this->assets->css(); + self::assertSame('' . PHP_EOL, $css); + } + + public function testAddingAssetPropertiesWithArray(): void + { + //Test adding assets with object to define properties + $this->assets->reset(); + $this->assets->addJs('test.js', ['loading' => 'async']); + $js = $this->assets->js(); + self::assertSame('' . PHP_EOL, $js); + $this->assets->reset(); + } + + public function testAddingJSAssetPropertiesWithArrayFromCollection(): void + { + //Test adding properties with array + $this->assets->reset(); + $this->assets->addJs('jquery', ['loading' => 'async']); + $js = $this->assets->js(); + self::assertSame('' . PHP_EOL, $js); + + //Test priority too + $this->assets->reset(); + $this->assets->addJs('jquery', ['loading' => 'async', 'priority' => 1]); + $this->assets->addJs('test.js', ['loading' => 'async', 'priority' => 2]); + $js = $this->assets->js(); + self::assertSame('' . PHP_EOL . + '' . PHP_EOL, $js); + + //Test multiple groups + $this->assets->reset(); + $this->assets->addJs('jquery', ['loading' => 'async', 'priority' => 1, 'group' => 'footer']); + $this->assets->addJs('test.js', ['loading' => 'async', 'priority' => 2]); + $js = $this->assets->js(); + self::assertSame('' . PHP_EOL, $js); + $js = $this->assets->js('footer'); + self::assertSame('' . PHP_EOL, $js); + + //Test adding array of assets + //Test priority too + $this->assets->reset(); + $this->assets->addJs(['jquery', 'test.js'], ['loading' => 'async']); + $js = $this->assets->js(); + + self::assertSame('' . PHP_EOL . + '' . PHP_EOL, $js); + } + + public function testAddingLegacyFormat(): void + { + // regular CSS add + //test addCss(). Test adding asset to a separate group + $this->assets->reset(); + $this->assets->addCSS('test.css', 15, true, 'bottom', 'async'); + $css = $this->assets->css('bottom'); + self::assertSame('' . PHP_EOL, $css); + + $array = $this->assets->getCss(); + /** @var Assets\BaseAsset $item */ + $item = reset($array); + $actual = json_encode($item); + $expected = ' + { + "type":"css", + "elements":{ + "asset":"\/test.css", + "asset_type":"css", + "order":0, + "group":"bottom", + "position":"pipeline", + "priority":15, + "attributes":{ + "type":"text\/css", + "rel":"stylesheet", + "loading":"async" + }, + "modified":false, + "query":"" + } + }'; + self::assertJsonStringEqualsJsonString($expected, $actual); + + $this->assets->reset(); + $this->assets->addJs('test.js', 15, false, 'defer', 'bottom'); + $js = $this->assets->js('bottom'); + self::assertSame('' . PHP_EOL, $js); + + $array = $this->assets->getJs(); + /** @var Assets\BaseAsset $item */ + $item = reset($array); + $actual = json_encode($item); + $expected = ' + { + "type": "js", + "elements": { + "asset": "/test.js", + "asset_type": "js", + "order": 0, + "group": "bottom", + "position": "after", + "priority": 15, + "attributes": { + "loading": "defer" + }, + "modified": false, + "query": "" + } + }'; + self::assertJsonStringEqualsJsonString($expected, $actual); + + + $this->assets->reset(); + $this->assets->addInlineCss('body { color: black }', 15, 'bottom'); + $css = $this->assets->css('bottom'); + self::assertSame('' . PHP_EOL, $css); + + $this->assets->reset(); + $this->assets->addInlineJs('alert("test")', 15, 'bottom', ['id' => 'foo']); + $js = $this->assets->js('bottom'); + self::assertSame('' . PHP_EOL, $js); + } + + public function testAddingCSSAssetPropertiesWithArrayFromCollection(): void + { + $this->assets->registerCollection('test', ['/system/assets/whoops.css']); + + //Test priority too + $this->assets->reset(); + $this->assets->addCss('test', ['priority' => 1]); + $this->assets->addCss('test.css', ['priority' => 2]); + $css = $this->assets->css(); + self::assertSame('' . PHP_EOL . + '' . PHP_EOL, $css); + + //Test multiple groups + $this->assets->reset(); + $this->assets->addCss('test', ['priority' => 1, 'group' => 'footer']); + $this->assets->addCss('test.css', ['priority' => 2]); + $css = $this->assets->css(); + self::assertSame('' . PHP_EOL, $css); + $css = $this->assets->css('footer'); + self::assertSame('' . PHP_EOL, $css); + + //Test adding array of assets + //Test priority too + $this->assets->reset(); + $this->assets->addCss(['test', 'test.css'], ['loading' => 'async']); + $css = $this->assets->css(); + self::assertSame('' . PHP_EOL . + '' . PHP_EOL, $css); + } + + public function testAddingAssetPropertiesWithArrayFromCollectionAndParameters(): void + { + $this->assets->registerCollection('collection_multi_params', [ + 'foo.js' => [ 'defer' => true ], + 'bar.js' => [ 'integrity' => 'sha512-abc123' ], + 'foobar.css' => [ 'defer' => null, 'loading' => null ] + ]); + + // # Test adding properties with array + $this->assets->addJs('collection_multi_params', ['loading' => 'async']); + $js = $this->assets->js(); + + // expected output + $expected = [ + '', + '', + '', + ]; + + self::assertCount(count($expected), array_filter(explode("\n", $js))); + self::assertSame(implode("\n", $expected) . PHP_EOL, $js); + + // # Test priority as second argument + render JS should not have any css + $this->assets->reset(); + $this->assets->add('low_priority.js', 1); + $this->assets->add('collection_multi_params', 2); + $js = $this->assets->js(); + + // expected output + $expected = [ + '', + '', + '', + ]; + + self::assertCount(3, array_filter(explode("\n", $js))); + self::assertSame(implode("\n", $expected) . PHP_EOL, $js); + + // # Test rendering CSS, should not have any JS + $this->assets->reset(); + $this->assets->add('collection_multi_params', [ 'class' => '__classname' ]); + $css = $this->assets->css(); + + // expected output + $expected = [ + '', + ]; + + + self::assertCount(1, array_filter(explode("\n", $css))); + self::assertSame(implode("\n", $expected) . PHP_EOL, $css); + } + + public function testPriorityOfAssets(): void + { + $this->assets->reset(); + $this->assets->add('test.css'); + $this->assets->add('test-after.css'); + + $css = $this->assets->css(); + self::assertSame('' . PHP_EOL . + '' . PHP_EOL, $css); + + //---------------- + $this->assets->reset(); + $this->assets->add('test-after.css', 1); + $this->assets->add('test.css', 2); + + $css = $this->assets->css(); + self::assertSame('' . PHP_EOL . + '' . PHP_EOL, $css); + + //---------------- + $this->assets->reset(); + $this->assets->add('test-after.css', 1); + $this->assets->add('test.css', 2); + $this->assets->add('test-before.css', 3); + + $css = $this->assets->css(); + self::assertSame('' . PHP_EOL . + '' . PHP_EOL . + '' . PHP_EOL, $css); + } + + public function testPipeline(): void + { + $this->assets->reset(); + + //File not existing. Pipeline searches for that file without reaching it. Output is empty. + $this->assets->add('test.css', null, true); + $this->assets->setCssPipeline(true); + $css = $this->assets->css(); + self::assertRegExp('##', $css); + + //Add a core Grav CSS file, which is found. Pipeline will now return a file + $this->assets->add('/system/assets/debugger/phpdebugbar', null, true); + $css = $this->assets->css(); + self::assertRegExp('##', $css); + } + + public function testPipelineWithTimestamp(): void + { + $this->assets->reset(); + $this->assets->setTimestamp('foo'); + $this->assets->setCssPipeline(true); + + //Add a core Grav CSS file, which is found. Pipeline will now return a file + $this->assets->add('/system/assets/debugger.css', null, true); + $css = $this->assets->css(); + self::assertRegExp('##', $css); + } + + public function testInline(): void + { + $this->assets->reset(); + + //File not existing. Pipeline searches for that file without reaching it. Output is empty. + $this->assets->add('test.css', ['loading' => 'inline']); + $css = $this->assets->css(); + self::assertSame("\n", $css); + + $this->assets->reset(); + //Add a core Grav CSS file, which is found. Pipeline will now return its content. + $this->assets->addCss('https://fonts.googleapis.com/css?family=Roboto', ['loading' => 'inline']); + $this->assets->addCss('/system/assets/debugger/phpdebugbar.css', ['loading' => 'inline']); + $css = $this->assets->css(); + self::assertStringContainsString('font-family: \'Roboto\';', $css); + self::assertStringContainsString('div.phpdebugbar-header', $css); + } + + public function testInlinePipeline(): void + { + $this->assets->reset(); + $this->assets->setCssPipeline(true); + + //File not existing. Pipeline searches for that file without reaching it. Output is empty. + $this->assets->add('test.css'); + $css = $this->assets->css('head', ['loading' => 'inline']); + self::assertSame("\n", $css); + + //Add a core Grav CSS file, which is found. Pipeline will now return its content. + $this->assets->addCss('https://fonts.googleapis.com/css?family=Roboto', null, true); + $this->assets->add('/system/assets/debugger/phpdebugbar.css', null, true); + $css = $this->assets->css('head', ['loading' => 'inline']); + self::assertStringContainsString('font-family:\'Roboto\';', $css); + self::assertStringContainsString('div.phpdebugbar', $css); + } + + public function testAddAsyncJs(): void + { + $this->assets->reset(); + $this->assets->addAsyncJs('jquery'); + $js = $this->assets->js(); + self::assertSame('' . PHP_EOL, $js); + } + + public function testAddDeferJs(): void + { + $this->assets->reset(); + $this->assets->addDeferJs('jquery'); + $js = $this->assets->js(); + self::assertSame('' . PHP_EOL, $js); + } + + public function testTimestamps(): void + { + // local CSS nothing extra + $this->assets->reset(); + $this->assets->setTimestamp('foo'); + $this->assets->addCSS('test.css'); + $css = $this->assets->css(); + self::assertSame('' . PHP_EOL, $css); + + // local CSS already with param + $this->assets->reset(); + $this->assets->setTimestamp('foo'); + $this->assets->addCSS('test.css?bar'); + $css = $this->assets->css(); + self::assertSame('' . PHP_EOL, $css); + + // external CSS already + $this->assets->reset(); + $this->assets->setTimestamp('foo'); + $this->assets->addCSS('http://somesite.com/test.css'); + $css = $this->assets->css(); + self::assertSame('' . PHP_EOL, $css); + + // external CSS already with param + $this->assets->reset(); + $this->assets->setTimestamp('foo'); + $this->assets->addCSS('http://somesite.com/test.css?bar'); + $css = $this->assets->css(); + self::assertSame('' . PHP_EOL, $css); + + // local JS nothing extra + $this->assets->reset(); + $this->assets->setTimestamp('foo'); + $this->assets->addJs('test.js'); + $css = $this->assets->js(); + self::assertSame('' . PHP_EOL, $css); + + // local JS already with param + $this->assets->reset(); + $this->assets->setTimestamp('foo'); + $this->assets->addJs('test.js?bar'); + $css = $this->assets->js(); + self::assertSame('' . PHP_EOL, $css); + + // external JS already + $this->assets->reset(); + $this->assets->setTimestamp('foo'); + $this->assets->addJs('http://somesite.com/test.js'); + $css = $this->assets->js(); + self::assertSame('' . PHP_EOL, $css); + + // external JS already with param + $this->assets->reset(); + $this->assets->setTimestamp('foo'); + $this->assets->addJs('http://somesite.com/test.js?bar'); + $css = $this->assets->js(); + self::assertSame('' . PHP_EOL, $css); + } + + public function testAddInlineCss(): void + { + $this->assets->reset(); + $this->assets->addInlineCss('body { color: black }'); + $css = $this->assets->css(); + self::assertSame('' . PHP_EOL, $css); + } + + public function testAddInlineJs(): void + { + $this->assets->reset(); + $this->assets->addInlineJs('alert("test")'); + $js = $this->assets->js(); + self::assertSame('' . PHP_EOL, $js); + } + + public function testGetCollections(): void + { + self::assertIsArray($this->assets->getCollections()); + self::assertContains('jquery', array_keys($this->assets->getCollections())); + self::assertContains('system://assets/jquery/jquery-3.x.min.js', $this->assets->getCollections()); + } + + public function testExists(): void + { + self::assertTrue($this->assets->exists('jquery')); + self::assertFalse($this->assets->exists('another-unexisting-library')); + } + + public function testRegisterCollection(): void + { + $this->assets->registerCollection('debugger', ['/system/assets/debugger.css']); + self::assertTrue($this->assets->exists('debugger')); + self::assertContains('debugger', array_keys($this->assets->getCollections())); + } + + public function testRegisterCollectionWithParameters(): void + { + $this->assets->registerCollection('collection_multi_params', [ + 'foo.js' => [ 'defer' => true ], + 'bar.js' => [ 'integrity' => 'sha512-abc123' ], + 'foobar.css' => [ 'defer' => null ], + ]); + + self::assertTrue($this->assets->exists('collection_multi_params')); + + $collection = $this->assets->getCollections()['collection_multi_params']; + self::assertArrayHasKey('foo.js', $collection); + self::assertArrayHasKey('bar.js', $collection); + self::assertArrayHasKey('foobar.css', $collection); + self::assertArrayHasKey('defer', $collection['foo.js']); + self::assertArrayHasKey('defer', $collection['foobar.css']); + + self::assertNull($collection['foobar.css']['defer']); + self::assertTrue($collection['foo.js']['defer']); + } + + public function testReset(): void + { + $this->assets->addInlineJs('alert("test")'); + $this->assets->reset(); + self::assertCount(0, (array) $this->assets->getJs()); + + $this->assets->addAsyncJs('jquery'); + $this->assets->reset(); + self::assertCount(0, (array) $this->assets->getJs()); + + $this->assets->addInlineCss('body { color: black }'); + $this->assets->reset(); + self::assertCount(0, (array) $this->assets->getCss()); + + $this->assets->add('/system/assets/debugger.css', null, true); + $this->assets->reset(); + self::assertCount(0, (array) $this->assets->getCss()); + } + + public function testResetJs(): void + { + $this->assets->addInlineJs('alert("test")'); + $this->assets->resetJs(); + self::assertCount(0, (array) $this->assets->getJs()); + + $this->assets->addAsyncJs('jquery'); + $this->assets->resetJs(); + self::assertCount(0, (array) $this->assets->getJs()); + } + + public function testResetCss(): void + { + $this->assets->addInlineCss('body { color: black }'); + $this->assets->resetCss(); + self::assertCount(0, (array) $this->assets->getCss()); + + $this->assets->add('/system/assets/debugger.css', null, true); + $this->assets->resetCss(); + self::assertCount(0, (array) $this->assets->getCss()); + } + + public function testAddDirCss(): void + { + $this->assets->addDirCss('/system'); + + self::assertIsArray($this->assets->getCss()); + self::assertGreaterThan(0, (array) $this->assets->getCss()); + self::assertIsArray($this->assets->getJs()); + self::assertCount(0, (array) $this->assets->getJs()); + + $this->assets->reset(); + $this->assets->addDirCss('/system/assets'); + + self::assertIsArray($this->assets->getCss()); + self::assertGreaterThan(0, (array) $this->assets->getCss()); + self::assertIsArray($this->assets->getJs()); + self::assertCount(0, (array) $this->assets->getJs()); + + $this->assets->reset(); + $this->assets->addDirJs('/system'); + + self::assertIsArray($this->assets->getCss()); + self::assertCount(0, (array) $this->assets->getCss()); + self::assertIsArray($this->assets->getJs()); + self::assertGreaterThan(0, (array) $this->assets->getJs()); + + $this->assets->reset(); + $this->assets->addDirJs('/system/assets'); + + self::assertIsArray($this->assets->getCss()); + self::assertCount(0, (array) $this->assets->getCss()); + self::assertIsArray($this->assets->getJs()); + self::assertGreaterThan(0, (array) $this->assets->getJs()); + + $this->assets->reset(); + $this->assets->addDir('/system/assets'); + + self::assertIsArray($this->assets->getCss()); + self::assertGreaterThan(0, (array) $this->assets->getCss()); + self::assertIsArray($this->assets->getJs()); + self::assertGreaterThan(0, (array) $this->assets->getJs()); + + //Use streams + $this->assets->reset(); + $this->assets->addDir('system://assets'); + + self::assertIsArray($this->assets->getCss()); + self::assertGreaterThan(0, (array) $this->assets->getCss()); + self::assertIsArray($this->assets->getJs()); + self::assertGreaterThan(0, (array) $this->assets->getJs()); + } +} diff --git a/tests/unit/Grav/Common/BrowserTest.php b/tests/unit/Grav/Common/BrowserTest.php new file mode 100644 index 0000000..a1033d8 --- /dev/null +++ b/tests/unit/Grav/Common/BrowserTest.php @@ -0,0 +1,51 @@ +grav = $grav(); + } + + protected function _after(): void + { + } + + public function testGetBrowser(): void + { + /* Already covered by PhpUserAgent tests */ + } + + public function testGetPlatform(): void + { + /* Already covered by PhpUserAgent tests */ + } + + public function testGetLongVersion(): void + { + /* Already covered by PhpUserAgent tests */ + } + + public function testGetVersion(): void + { + /* Already covered by PhpUserAgent tests */ + } + + public function testIsHuman(): void + { + //Already Partially covered by PhpUserAgent tests + + //Make sure it recognizes the test as not human + self::assertFalse($this->grav['browser']->isHuman()); + } +} diff --git a/tests/unit/Grav/Common/ComposerTest.php b/tests/unit/Grav/Common/ComposerTest.php new file mode 100644 index 0000000..8c73a1f --- /dev/null +++ b/tests/unit/Grav/Common/ComposerTest.php @@ -0,0 +1,31 @@ +loadBlueprint('strict'); + + $blueprint->validate(['test' => 'string']); + } + + /** + * @depends testValidateStrict + */ + public function testValidateStrictRequired(): void + { + $blueprint = $this->loadBlueprint('strict'); + + $this->expectException(\Grav\Common\Data\ValidationException::class); + $blueprint->validate([]); + } + + /** + * @depends testValidateStrict + */ + public function testValidateStrictExtra(): void + { + $blueprint = $this->loadBlueprint('strict'); + + $blueprint->validate(['test' => 'string', 'wrong' => 'field']); + } + + /** + * @depends testValidateStrict + */ + public function testValidateStrictExtraException(): void + { + $blueprint = $this->loadBlueprint('strict'); + + /** @var Config $config */ + $config = Grav::instance()['config']; + $var = 'system.strict_mode.blueprint_strict_compat'; + $config->set($var, false); + + $this->expectException(\Grav\Common\Data\ValidationException::class); + $blueprint->validate(['test' => 'string', 'wrong' => 'field']); + + $config->set($var, true); + } + + /** + * @param string $filename + * @return Blueprint + */ + protected function loadBlueprint($filename): Blueprint + { + $blueprint = new Blueprint('strict'); + $blueprint->setContext(dirname(__DIR__, 3). '/data/blueprints'); + $blueprint->load()->init(); + + return $blueprint; + } +} diff --git a/tests/unit/Grav/Common/GPM/GPMTest.php b/tests/unit/Grav/Common/GPM/GPMTest.php new file mode 100644 index 0000000..684ed3d --- /dev/null +++ b/tests/unit/Grav/Common/GPM/GPMTest.php @@ -0,0 +1,329 @@ +data[$search] ?? false; + } + + /** + * @inheritdoc + */ + public function findPackages($searches = []) + { + return $this->data; + } +} + +/** + * Class InstallCommandTest + */ +class GpmTest extends \Codeception\TestCase\Test +{ + /** @var Grav $grav */ + protected $grav; + + /** @var GpmStub */ + protected $gpm; + + protected function _before(): void + { + $this->grav = Fixtures::get('grav'); + $this->gpm = new GpmStub(); + } + + protected function _after(): void + { + } + + public function testCalculateMergedDependenciesOfPackages(): void + { + ////////////////////////////////////////////////////////////////////////////////////////// + // First working example + ////////////////////////////////////////////////////////////////////////////////////////// + $this->gpm->data = [ + 'admin' => (object)[ + 'dependencies' => [ + ['name' => 'grav', 'version' => '>=1.0.10'], + ['name' => 'form', 'version' => '~2.0'], + ['name' => 'login', 'version' => '>=2.0'], + ['name' => 'errors', 'version' => '*'], + ['name' => 'problems'], + ] + ], + 'test' => (object)[ + 'dependencies' => [ + ['name' => 'errors', 'version' => '>=1.0'] + ] + ], + 'grav', + 'form' => (object)[ + 'dependencies' => [ + ['name' => 'errors', 'version' => '>=3.2'] + ] + ] + + + ]; + + $packages = ['admin', 'test']; + + $dependencies = $this->gpm->calculateMergedDependenciesOfPackages($packages); + + self::assertIsArray($dependencies); + self::assertCount(5, $dependencies); + + self::assertSame('>=1.0.10', $dependencies['grav']); + self::assertArrayHasKey('errors', $dependencies); + self::assertArrayHasKey('problems', $dependencies); + + ////////////////////////////////////////////////////////////////////////////////////////// + // Second working example + ////////////////////////////////////////////////////////////////////////////////////////// + $packages = ['admin', 'form']; + + $dependencies = $this->gpm->calculateMergedDependenciesOfPackages($packages); + self::assertIsArray($dependencies); + self::assertCount(5, $dependencies); + self::assertSame('>=3.2', $dependencies['errors']); + + ////////////////////////////////////////////////////////////////////////////////////////// + // Third working example + ////////////////////////////////////////////////////////////////////////////////////////// + $this->gpm->data = [ + + 'admin' => (object)[ + 'dependencies' => [ + ['name' => 'errors', 'version' => '>=4.0'], + ] + ], + 'test' => (object)[ + 'dependencies' => [ + ['name' => 'errors', 'version' => '>=1.0'] + ] + ], + 'another' => (object)[ + 'dependencies' => [ + ['name' => 'errors', 'version' => '>=3.2'] + ] + ] + + ]; + + $packages = ['admin', 'test', 'another']; + + + $dependencies = $this->gpm->calculateMergedDependenciesOfPackages($packages); + self::assertIsArray($dependencies); + self::assertCount(1, $dependencies); + self::assertSame('>=4.0', $dependencies['errors']); + + + + ////////////////////////////////////////////////////////////////////////////////////////// + // Test alpha / beta / rc + ////////////////////////////////////////////////////////////////////////////////////////// + $this->gpm->data = [ + 'admin' => (object)[ + 'dependencies' => [ + ['name' => 'package1', 'version' => '>=4.0.0-rc1'], + ['name' => 'package4', 'version' => '>=3.2.0'], + ] + ], + 'test' => (object)[ + 'dependencies' => [ + ['name' => 'package1', 'version' => '>=4.0.0-rc2'], + ['name' => 'package2', 'version' => '>=3.2.0-alpha'], + ['name' => 'package3', 'version' => '>=3.2.0-alpha.2'], + ['name' => 'package4', 'version' => '>=3.2.0-alpha'], + ] + ], + 'another' => (object)[ + 'dependencies' => [ + ['name' => 'package2', 'version' => '>=3.2.0-beta.11'], + ['name' => 'package3', 'version' => '>=3.2.0-alpha.1'], + ['name' => 'package4', 'version' => '>=3.2.0-beta'], + ] + ] + ]; + + $packages = ['admin', 'test', 'another']; + + + $dependencies = $this->gpm->calculateMergedDependenciesOfPackages($packages); + self::assertSame('>=4.0.0-rc2', $dependencies['package1']); + self::assertSame('>=3.2.0-beta.11', $dependencies['package2']); + self::assertSame('>=3.2.0-alpha.2', $dependencies['package3']); + self::assertSame('>=3.2.0', $dependencies['package4']); + + + ////////////////////////////////////////////////////////////////////////////////////////// + // Raise exception if no version is specified + ////////////////////////////////////////////////////////////////////////////////////////// + $this->gpm->data = [ + + 'admin' => (object)[ + 'dependencies' => [ + ['name' => 'errors', 'version' => '>=4.0'], + ] + ], + 'test' => (object)[ + 'dependencies' => [ + ['name' => 'errors', 'version' => '>='] + ] + ], + + ]; + + $packages = ['admin', 'test']; + + try { + $this->gpm->calculateMergedDependenciesOfPackages($packages); + self::fail('Expected Exception not thrown'); + } catch (Exception $e) { + self::assertEquals(EXCEPTION_BAD_FORMAT, $e->getCode()); + self::assertStringStartsWith('Bad format for version of dependency', $e->getMessage()); + } + + ////////////////////////////////////////////////////////////////////////////////////////// + // Raise exception if incompatible versions are specified + ////////////////////////////////////////////////////////////////////////////////////////// + $this->gpm->data = [ + 'admin' => (object)[ + 'dependencies' => [ + ['name' => 'errors', 'version' => '~4.0'], + ] + ], + 'test' => (object)[ + 'dependencies' => [ + ['name' => 'errors', 'version' => '~3.0'] + ] + ], + ]; + + $packages = ['admin', 'test']; + + try { + $this->gpm->calculateMergedDependenciesOfPackages($packages); + self::fail('Expected Exception not thrown'); + } catch (Exception $e) { + self::assertEquals(EXCEPTION_INCOMPATIBLE_VERSIONS, $e->getCode()); + self::assertStringEndsWith('required in two incompatible versions', $e->getMessage()); + } + + ////////////////////////////////////////////////////////////////////////////////////////// + // Test dependencies of dependencies + ////////////////////////////////////////////////////////////////////////////////////////// + $this->gpm->data = [ + 'admin' => (object)[ + 'dependencies' => [ + ['name' => 'grav', 'version' => '>=1.0.10'], + ['name' => 'form', 'version' => '~2.0'], + ['name' => 'login', 'version' => '>=2.0'], + ['name' => 'errors', 'version' => '*'], + ['name' => 'problems'], + ] + ], + 'login' => (object)[ + 'dependencies' => [ + ['name' => 'antimatter', 'version' => '>=1.0'] + ] + ], + 'grav', + 'antimatter' => (object)[ + 'dependencies' => [ + ['name' => 'something', 'version' => '>=3.2'] + ] + ] + + + ]; + + $packages = ['admin']; + + $dependencies = $this->gpm->calculateMergedDependenciesOfPackages($packages); + + self::assertIsArray($dependencies); + self::assertCount(7, $dependencies); + + self::assertSame('>=1.0.10', $dependencies['grav']); + self::assertArrayHasKey('errors', $dependencies); + self::assertArrayHasKey('problems', $dependencies); + self::assertArrayHasKey('antimatter', $dependencies); + self::assertArrayHasKey('something', $dependencies); + self::assertSame('>=3.2', $dependencies['something']); + } + + public function testVersionFormatIsNextSignificantRelease(): void + { + self::assertFalse($this->gpm->versionFormatIsNextSignificantRelease('>=1.0')); + self::assertFalse($this->gpm->versionFormatIsNextSignificantRelease('>=2.3.4')); + self::assertFalse($this->gpm->versionFormatIsNextSignificantRelease('>=2.3.x')); + self::assertFalse($this->gpm->versionFormatIsNextSignificantRelease('1.0')); + self::assertTrue($this->gpm->versionFormatIsNextSignificantRelease('~2.3.x')); + self::assertTrue($this->gpm->versionFormatIsNextSignificantRelease('~2.0')); + } + + public function testVersionFormatIsEqualOrHigher(): void + { + self::assertTrue($this->gpm->versionFormatIsEqualOrHigher('>=1.0')); + self::assertTrue($this->gpm->versionFormatIsEqualOrHigher('>=2.3.4')); + self::assertTrue($this->gpm->versionFormatIsEqualOrHigher('>=2.3.x')); + self::assertFalse($this->gpm->versionFormatIsEqualOrHigher('~2.3.x')); + self::assertFalse($this->gpm->versionFormatIsEqualOrHigher('1.0')); + } + + public function testCheckNextSignificantReleasesAreCompatible(): void + { + /* + * ~1.0 is equivalent to >=1.0 < 2.0.0 + * ~1.2 is equivalent to >=1.2 <2.0.0 + * ~1.2.3 is equivalent to >=1.2.3 <1.3.0 + */ + self::assertTrue($this->gpm->checkNextSignificantReleasesAreCompatible('1.0', '1.2')); + self::assertTrue($this->gpm->checkNextSignificantReleasesAreCompatible('1.2', '1.0')); + self::assertTrue($this->gpm->checkNextSignificantReleasesAreCompatible('1.0', '1.0.10')); + self::assertTrue($this->gpm->checkNextSignificantReleasesAreCompatible('1.1', '1.1.10')); + self::assertTrue($this->gpm->checkNextSignificantReleasesAreCompatible('30.0', '30.10')); + self::assertTrue($this->gpm->checkNextSignificantReleasesAreCompatible('1.0', '1.1.10')); + self::assertTrue($this->gpm->checkNextSignificantReleasesAreCompatible('1.0', '1.8')); + self::assertTrue($this->gpm->checkNextSignificantReleasesAreCompatible('1.0.1', '1.1')); + self::assertTrue($this->gpm->checkNextSignificantReleasesAreCompatible('2.0.0-beta', '2.0')); + self::assertTrue($this->gpm->checkNextSignificantReleasesAreCompatible('2.0.0-rc.1', '2.0')); + self::assertTrue($this->gpm->checkNextSignificantReleasesAreCompatible('2.0', '2.0.0-alpha')); + + self::assertFalse($this->gpm->checkNextSignificantReleasesAreCompatible('1.0', '2.2')); + self::assertFalse($this->gpm->checkNextSignificantReleasesAreCompatible('1.0.0-beta.1', '2.0')); + self::assertFalse($this->gpm->checkNextSignificantReleasesAreCompatible('0.9.99', '1.0.0')); + self::assertFalse($this->gpm->checkNextSignificantReleasesAreCompatible('0.9.99', '1.0.10')); + self::assertFalse($this->gpm->checkNextSignificantReleasesAreCompatible('0.9.99', '1.0.10.2')); + } + + public function testCalculateVersionNumberFromDependencyVersion(): void + { + self::assertSame('2.0', $this->gpm->calculateVersionNumberFromDependencyVersion('>=2.0')); + self::assertSame('2.0.2', $this->gpm->calculateVersionNumberFromDependencyVersion('>=2.0.2')); + self::assertSame('2.0.2', $this->gpm->calculateVersionNumberFromDependencyVersion('~2.0.2')); + self::assertSame('1', $this->gpm->calculateVersionNumberFromDependencyVersion('~1')); + self::assertNull($this->gpm->calculateVersionNumberFromDependencyVersion('')); + self::assertNull($this->gpm->calculateVersionNumberFromDependencyVersion('*')); + self::assertSame('2.0.2', $this->gpm->calculateVersionNumberFromDependencyVersion('2.0.2')); + } +} diff --git a/tests/unit/Grav/Common/Helpers/ExcerptsTest.php b/tests/unit/Grav/Common/Helpers/ExcerptsTest.php new file mode 100644 index 0000000..8cb473c --- /dev/null +++ b/tests/unit/Grav/Common/Helpers/ExcerptsTest.php @@ -0,0 +1,120 @@ +grav = $grav(); + $this->pages = $this->grav['pages']; + $this->config = $this->grav['config']; + $this->uri = $this->grav['uri']; + $this->language = $this->grav['language']; + $this->old_home = $this->config->get('system.home.alias'); + $this->config->set('system.home.alias', '/item1'); + $this->config->set('system.absolute_urls', false); + $this->config->set('system.languages.supported', []); + + unset($this->grav['language']); + $this->grav['language'] = new Language($this->grav); + + /** @var UniformResourceLocator $locator */ + $locator = $this->grav['locator']; + $locator->addPath('page', '', 'tests/fake/nested-site/user/pages', false); + $this->pages->init(); + + $defaults = [ + 'extra' => false, + 'auto_line_breaks' => false, + 'auto_url_links' => false, + 'escape_markup' => false, + 'special_chars' => ['>' => 'gt', '<' => 'lt'], + ]; + $this->page = $this->pages->find('/item2/item2-2'); + $this->uri->initializeWithURL('http://testing.dev/item2/item2-2')->init(); + } + + protected function _after(): void + { + $this->config->set('system.home.alias', $this->old_home); + } + + + public function testProcessImageHtml(): void + { + self::assertRegexp( + '|Sample Image|', + Excerpts::processImageHtml('Sample Image', $this->page) + ); + self::assertRegexp( + '|Sample Image|', + Excerpts::processImageHtml('Sample Image', $this->page) + ); + } + + public function testNoProcess(): void + { + self::assertStringStartsWith( + 'regular process') + ); + + self::assertStringStartsWith( + 'noprocess') + ); + + self::assertStringStartsWith( + 'noprocess=id') + ); + } + + public function testTarget(): void + { + self::assertStringStartsWith( + 'only target') + ); + self::assertStringStartsWith( + 'target and rel') + ); + } +} diff --git a/tests/unit/Grav/Common/InflectorTest.php b/tests/unit/Grav/Common/InflectorTest.php new file mode 100644 index 0000000..1db51a2 --- /dev/null +++ b/tests/unit/Grav/Common/InflectorTest.php @@ -0,0 +1,145 @@ +grav = $grav(); + $this->inflector = $this->grav['inflector']; + } + + protected function _after(): void + { + } + + public function testPluralize(): void + { + self::assertSame('words', $this->inflector->pluralize('word')); + self::assertSame('kisses', $this->inflector->pluralize('kiss')); + self::assertSame('volcanoes', $this->inflector->pluralize('volcanoe')); + self::assertSame('cherries', $this->inflector->pluralize('cherry')); + self::assertSame('days', $this->inflector->pluralize('day')); + self::assertSame('knives', $this->inflector->pluralize('knife')); + } + + public function testSingularize(): void + { + self::assertSame('word', $this->inflector->singularize('words')); + self::assertSame('kiss', $this->inflector->singularize('kisses')); + self::assertSame('volcanoe', $this->inflector->singularize('volcanoe')); + self::assertSame('cherry', $this->inflector->singularize('cherries')); + self::assertSame('day', $this->inflector->singularize('days')); + self::assertSame('knife', $this->inflector->singularize('knives')); + } + + public function testTitleize(): void + { + self::assertSame('This String Is Titleized', $this->inflector->titleize('ThisStringIsTitleized')); + self::assertSame('This String Is Titleized', $this->inflector->titleize('this string is titleized')); + self::assertSame('This String Is Titleized', $this->inflector->titleize('this_string_is_titleized')); + self::assertSame('This String Is Titleized', $this->inflector->titleize('this-string-is-titleized')); + + self::assertSame('This string is titleized', $this->inflector->titleize('ThisStringIsTitleized', 'first')); + self::assertSame('This string is titleized', $this->inflector->titleize('this string is titleized', 'first')); + self::assertSame('This string is titleized', $this->inflector->titleize('this_string_is_titleized', 'first')); + self::assertSame('This string is titleized', $this->inflector->titleize('this-string-is-titleized', 'first')); + } + + public function testCamelize(): void + { + self::assertSame('ThisStringIsCamelized', $this->inflector->camelize('This String Is Camelized')); + self::assertSame('ThisStringIsCamelized', $this->inflector->camelize('thisStringIsCamelized')); + self::assertSame('ThisStringIsCamelized', $this->inflector->camelize('This_String_Is_Camelized')); + self::assertSame('ThisStringIsCamelized', $this->inflector->camelize('this string is camelized')); + self::assertSame('GravSPrettyCoolMy1', $this->inflector->camelize("Grav's Pretty Cool. My #1!")); + } + + public function testUnderscorize(): void + { + self::assertSame('this_string_is_underscorized', $this->inflector->underscorize('This String Is Underscorized')); + self::assertSame('this_string_is_underscorized', $this->inflector->underscorize('ThisStringIsUnderscorized')); + self::assertSame('this_string_is_underscorized', $this->inflector->underscorize('This_String_Is_Underscorized')); + self::assertSame('this_string_is_underscorized', $this->inflector->underscorize('This-String-Is-Underscorized')); + } + + public function testHyphenize(): void + { + self::assertSame('this-string-is-hyphenized', $this->inflector->hyphenize('This String Is Hyphenized')); + self::assertSame('this-string-is-hyphenized', $this->inflector->hyphenize('ThisStringIsHyphenized')); + self::assertSame('this-string-is-hyphenized', $this->inflector->hyphenize('This-String-Is-Hyphenized')); + self::assertSame('this-string-is-hyphenized', $this->inflector->hyphenize('This_String_Is_Hyphenized')); + } + + public function testHumanize(): void + { + //self::assertSame('This string is humanized', $this->inflector->humanize('ThisStringIsHumanized')); + self::assertSame('This string is humanized', $this->inflector->humanize('this_string_is_humanized')); + //self::assertSame('This string is humanized', $this->inflector->humanize('this-string-is-humanized')); + + self::assertSame('This String Is Humanized', $this->inflector->humanize('this_string_is_humanized', 'all')); + //self::assertSame('This String Is Humanized', $this->inflector->humanize('this-string-is-humanized'), 'all'); + } + + public function testVariablize(): void + { + self::assertSame('thisStringIsVariablized', $this->inflector->variablize('This String Is Variablized')); + self::assertSame('thisStringIsVariablized', $this->inflector->variablize('ThisStringIsVariablized')); + self::assertSame('thisStringIsVariablized', $this->inflector->variablize('This_String_Is_Variablized')); + self::assertSame('thisStringIsVariablized', $this->inflector->variablize('this string is variablized')); + self::assertSame('gravSPrettyCoolMy1', $this->inflector->variablize("Grav's Pretty Cool. My #1!")); + } + + public function testTableize(): void + { + self::assertSame('people', $this->inflector->tableize('Person')); + self::assertSame('pages', $this->inflector->tableize('Page')); + self::assertSame('blog_pages', $this->inflector->tableize('BlogPage')); + self::assertSame('admin_dependencies', $this->inflector->tableize('adminDependency')); + self::assertSame('admin_dependencies', $this->inflector->tableize('admin-dependency')); + self::assertSame('admin_dependencies', $this->inflector->tableize('admin_dependency')); + } + + public function testClassify(): void + { + self::assertSame('Person', $this->inflector->classify('people')); + self::assertSame('Page', $this->inflector->classify('pages')); + self::assertSame('BlogPage', $this->inflector->classify('blog_pages')); + self::assertSame('AdminDependency', $this->inflector->classify('admin_dependencies')); + } + + public function testOrdinalize(): void + { + self::assertSame('1st', $this->inflector->ordinalize(1)); + self::assertSame('2nd', $this->inflector->ordinalize(2)); + self::assertSame('3rd', $this->inflector->ordinalize(3)); + self::assertSame('4th', $this->inflector->ordinalize(4)); + self::assertSame('5th', $this->inflector->ordinalize(5)); + self::assertSame('16th', $this->inflector->ordinalize(16)); + self::assertSame('51st', $this->inflector->ordinalize(51)); + self::assertSame('111th', $this->inflector->ordinalize(111)); + self::assertSame('123rd', $this->inflector->ordinalize(123)); + } + + public function testMonthize(): void + { + self::assertSame(0, $this->inflector->monthize(10)); + self::assertSame(1, $this->inflector->monthize(33)); + self::assertSame(1, $this->inflector->monthize(41)); + self::assertSame(11, $this->inflector->monthize(364)); + } +} diff --git a/tests/unit/Grav/Common/Language/LanguageCodesTest.php b/tests/unit/Grav/Common/Language/LanguageCodesTest.php new file mode 100644 index 0000000..3450c88 --- /dev/null +++ b/tests/unit/Grav/Common/Language/LanguageCodesTest.php @@ -0,0 +1,27 @@ +grav = $grav(); + $this->pages = $this->grav['pages']; + $this->config = $this->grav['config']; + $this->uri = $this->grav['uri']; + $this->language = $this->grav['language']; + $this->old_home = $this->config->get('system.home.alias'); + $this->config->set('system.home.alias', '/item1'); + $this->config->set('system.absolute_urls', false); + $this->config->set('system.languages.supported', []); + + unset($this->grav['language']); + $this->grav['language'] = new Language($this->grav); + + /** @var UniformResourceLocator $locator */ + $locator = $this->grav['locator']; + $locator->addPath('page', '', 'tests/fake/nested-site/user/pages', false); + $this->pages->init(); + + $defaults = [ + 'markdown' => [ + 'extra' => false, + 'auto_line_breaks' => false, + 'auto_url_links' => false, + 'escape_markup' => false, + 'special_chars' => ['>' => 'gt', '<' => 'lt'], + ], + 'images' => $this->config->get('system.images', []) + ]; + $page = $this->pages->find('/item2/item2-2'); + + $excerpts = new Excerpts($page, $defaults); + $this->parsedown = new Parsedown($excerpts); + } + + protected function _after(): void + { + $this->config->set('system.home.alias', $this->old_home); + } + + public function testImages(): void + { + $this->config->set('system.languages.supported', ['fr','en']); + unset($this->grav['language']); + $this->grav['language'] = new Language($this->grav); + $this->uri->initializeWithURL('http://testing.dev/fr/item2/item2-2')->init(); + + self::assertSame( + '

    ', + $this->parsedown->text('![](sample-image.jpg)') + ); + self::assertRegexp( + '|

    <\/p>|', + $this->parsedown->text('![](cache-image.jpg?cropResize=200,200&foo)') + ); + + $this->uri->initializeWithURL('http://testing.dev/item2/item2-2')->init(); + + self::assertSame( + '

    ', + $this->parsedown->text('![](sample-image.jpg)') + ); + self::assertRegexp( + '|

    <\/p>|', + $this->parsedown->text('![](cache-image.jpg?cropResize=200,200&foo)') + ); + self::assertRegexp( + '|

    <\/p>|', + $this->parsedown->text('![](/home-cache-image.jpg?cache)') + ); + self::assertSame( + '

    ', + $this->parsedown->text('![](missing-image.jpg)') + ); + self::assertSame( + '

    ', + $this->parsedown->text('![](/home-missing-image.jpg)') + ); + self::assertSame( + '

    ', + $this->parsedown->text('![](/home-missing-image.jpg)') + ); + self::assertSame( + '

    ', + $this->parsedown->text('![](https://getgrav-grav.netdna-ssl.com/user/pages/media/grav-logo.svg)') + ); + } + + public function testImagesSubDir(): void + { + $this->config->set('system.images.cache_all', false); + $this->uri->initializeWithUrlAndRootPath('http://testing.dev/subdir/item2/item2-2', '/subdir')->init(); + + self::assertRegexp( + '|

    <\/p>|', + $this->parsedown->text('![](/home-cache-image.jpg?cache)') + ); + self::assertSame( + '

    ', + $this->parsedown->text('![](sample-image.jpg)') + ); + self::assertRegexp( + '|

    <\/p>|', + $this->parsedown->text('![](cache-image.jpg?cache)') + ); + self::assertSame( + '

    ', + $this->parsedown->text('![](missing-image.jpg)') + ); + self::assertSame( + '

    ', + $this->parsedown->text('![](/home-missing-image.jpg)') + ); + } + + public function testImagesAbsoluteUrls(): void + { + $this->config->set('system.absolute_urls', true); + $this->uri->initializeWithURL('http://testing.dev/item2/item2-2')->init(); + + self::assertSame( + '

    ', + $this->parsedown->text('![](sample-image.jpg)') + ); + self::assertRegexp( + '|

    <\/p>|', + $this->parsedown->text('![](cache-image.jpg?cache)') + ); + self::assertRegexp( + '|

    <\/p>|', + $this->parsedown->text('![](/home-cache-image.jpg?cache)') + ); + self::assertSame( + '

    ', + $this->parsedown->text('![](missing-image.jpg)') + ); + self::assertSame( + '

    ', + $this->parsedown->text('![](/home-missing-image.jpg)') + ); + } + + public function testImagesSubDirAbsoluteUrls(): void + { + $this->config->set('system.absolute_urls', true); + $this->uri->initializeWithUrlAndRootPath('http://testing.dev/subdir/item2/item2-2', '/subdir')->init(); + + self::assertSame( + '

    ', + $this->parsedown->text('![](sample-image.jpg)') + ); + self::assertRegexp( + '|

    <\/p>|', + $this->parsedown->text('![](cache-image.jpg?cache)') + ); + self::assertRegexp( + '|

    <\/p>|', + $this->parsedown->text('![](/home-cache-image.jpg?cropResize=200,200)') + ); + self::assertSame( + '

    ', + $this->parsedown->text('![](missing-image.jpg)') + ); + self::assertSame( + '

    ', + $this->parsedown->text('![](/home-missing-image.jpg)') + ); + } + + public function testImagesAttributes(): void + { + $this->uri->initializeWithURL('http://testing.dev/item2/item2-2')->init(); + + self::assertSame( + '

    ', + $this->parsedown->text('![](sample-image.jpg "My Title")') + ); + self::assertSame( + '

    ', + $this->parsedown->text('![](sample-image.jpg?classes=foo)') + ); + self::assertSame( + '

    ', + $this->parsedown->text('![](sample-image.jpg?classes=foo,bar)') + ); + self::assertSame( + '

    ', + $this->parsedown->text('![](sample-image.jpg?id=foo)') + ); + self::assertSame( + '

    Alt Text

    ', + $this->parsedown->text('![Alt Text](sample-image.jpg?id=foo)') + ); + self::assertSame( + '

    Alt Text

    ', + $this->parsedown->text('![Alt Text](sample-image.jpg?class=bar&id=foo)') + ); + self::assertSame( + '

    Alt Text

    ', + $this->parsedown->text('![Alt Text](sample-image.jpg?class=bar&id=foo "My Title")') + ); + } + + public function testImagesDefaults(): void + { + /** + * Testing default 'loading' + */ + + $this->setImagesDefaults(['loading' => 'auto']); + + + // loading should NOT be added to image by default + self::assertSame( + '

    ', + $this->parsedown->text('![](sample-image.jpg)') + ); + + // loading="lazy" should be added when default is overridden by ?loading=lazy + self::assertSame( + '

    ', + $this->parsedown->text('![](sample-image.jpg?loading=lazy)') + ); + + $this->setImagesDefaults(['loading' => 'lazy']); + + // loading="lazy" should be added by default + self::assertSame( + '

    ', + $this->parsedown->text('![](sample-image.jpg)') + ); + + // loading should not be added when default is overridden by ?loading=auto + self::assertSame( + '

    ', + $this->parsedown->text('![](sample-image.jpg?loading=auto)') + ); + + // loading="eager" should be added when default is overridden by ?loading=eager + self::assertSame( + '

    ', + $this->parsedown->text('![](sample-image.jpg?loading=eager)') + ); + + } + + public function testCLSAutoSizes(): void + { + $this->config->set('system.images.cls.auto_sizes', false); + $this->uri->initializeWithURL('http://testing.dev/item2/item2-2')->init(); + + self::assertSame( + '

    ', + $this->parsedown->text('![](sample-image.jpg)') + ); + + self::assertSame( + '

    ', + $this->parsedown->text('![](sample-image.jpg?height=1&width=1)') + ); + + self::assertSame( + '

    ', + $this->parsedown->text('![](sample-image.jpg?autoSizes=true)') + ); + + $this->config->set('system.images.cls.auto_sizes', true); + + self::assertSame( + '

    ', + $this->parsedown->text('![](sample-image.jpg?reset)') + ); + + self::assertSame( + '

    ', + $this->parsedown->text('![](sample-image.jpg?height=1&width=1)') + ); + + self::assertSame( + '

    ', + $this->parsedown->text('![](sample-image.jpg?autoSizes=false)') + ); + + self::assertRegExp( + '/width="400" height="200"/', + $this->parsedown->text('![](sample-image.jpg?reset&resize=400,200)') + ); + + $this->config->set('system.images.cls.retina_scale', 2); + + + self::assertRegExp( + '/width="400" height="200"/', + $this->parsedown->text('![](sample-image.jpg?reset&resize=800,400)') + ); + + $this->config->set('system.images.cls.retina_scale', 4); + + self::assertRegExp( + '/width="200" height="100"/', + $this->parsedown->text('![](sample-image.jpg?reset&resize=800,400)') + ); + + self::assertRegExp( + '/width="266" height="133"/', + $this->parsedown->text('![](sample-image.jpg?reset&resize=800,400&retinaScale=3)') + ); + + $this->config->set('system.images.cls.aspect_ratio', true); + + self::assertRegExp( + '/style="--aspect-ratio: 800\/400;"/', + $this->parsedown->text('![](sample-image.jpg?reset&resize=800,400)') + ); + + $this->config->set('system.images.cls.aspect_ratio', false); + + self::assertRegExp( + '/style="--aspect-ratio: 800\/400;"/', + $this->parsedown->text('![](sample-image.jpg?reset&resize=800,400&aspectRatio=true)') + ); + + } + + public function testRootImages(): void + { + $this->uri->initializeWithURL('http://testing.dev/')->init(); + + $defaults = [ + 'markdown' => [ + 'extra' => false, + 'auto_line_breaks' => false, + 'auto_url_links' => false, + 'escape_markup' => false, + 'special_chars' => ['>' => 'gt', '<' => 'lt'], + ], + 'images' => $this->config->get('system.images', []) + ]; + $page = $this->pages->find('/'); + $excerpts = new Excerpts($page, $defaults); + $this->parsedown = new Parsedown($excerpts); + + self::assertSame( + '

    ', + $this->parsedown->text('![](home-sample-image.jpg)') + ); + self::assertRegexp( + '|

    <\/p>|', + $this->parsedown->text('![](home-cache-image.jpg?cache)') + ); + self::assertRegexp( + '|

    <\/p>|', + $this->parsedown->text('![](home-cache-image.jpg?cropResize=200,200&foo)') + ); + self::assertSame( + '

    ', + $this->parsedown->text('![](/home-missing-image.jpg)') + ); + + $this->config->set('system.languages.supported', ['fr','en']); + unset($this->grav['language']); + $this->grav['language'] = new Language($this->grav); + $this->uri->initializeWithURL('http://testing.dev/fr/item2/item2-2')->init(); + + self::assertSame( + '

    ', + $this->parsedown->text('![](home-sample-image.jpg)') + ); + } + + public function testRootImagesSubDirAbsoluteUrls(): void + { + $this->config->set('system.absolute_urls', true); + $this->uri->initializeWithUrlAndRootPath('http://testing.dev/subdir/item2/item2-2', '/subdir')->init(); + + self::assertSame( + '

    ', + $this->parsedown->text('![](sample-image.jpg)') + ); + self::assertRegexp( + '|

    <\/p>|', + $this->parsedown->text('![](cache-image.jpg?cache)') + ); + self::assertRegexp( + '|

    <\/p>|', + $this->parsedown->text('![](/home-cache-image.jpg?cropResize=200,200)') + ); + self::assertSame( + '

    ', + $this->parsedown->text('![](missing-image.jpg)') + ); + self::assertSame( + '

    ', + $this->parsedown->text('![](/home-missing-image.jpg)') + ); + } + + public function testRootAbsoluteLinks(): void + { + $this->uri->initializeWithURL('http://testing.dev/')->init(); + + $defaults = [ + 'markdown' => [ + 'extra' => false, + 'auto_line_breaks' => false, + 'auto_url_links' => false, + 'escape_markup' => false, + 'special_chars' => ['>' => 'gt', '<' => 'lt'], + ], + 'images' => $this->config->get('system.images', []) + ]; + $page = $this->pages->find('/'); + $excerpts = new Excerpts($page, $defaults); + $this->parsedown = new Parsedown($excerpts); + + self::assertSame( + '

    Down a Level

    ', + $this->parsedown->text('[Down a Level](item1-3)') + ); + + self::assertSame( + '

    Peer Page

    ', + $this->parsedown->text('[Peer Page](../item2)') + ); + + self::assertSame( + '

    With Query

    ', + $this->parsedown->text('[With Query](?foo=bar)') + ); + self::assertSame( + '

    With Param

    ', + $this->parsedown->text('[With Param](/foo:bar)') + ); + self::assertSame( + '

    With Anchor

    ', + $this->parsedown->text('[With Anchor](#foo)') + ); + + $this->config->set('system.languages.supported', ['fr','en']); + unset($this->grav['language']); + $this->grav['language'] = new Language($this->grav); + $this->uri->initializeWithURL('http://testing.dev/fr/item2/item2-2')->init(); + + self::assertSame( + '

    Peer Page

    ', + $this->parsedown->text('[Peer Page](../item2)') + ); + self::assertSame( + '

    Down a Level

    ', + $this->parsedown->text('[Down a Level](item1-3)') + ); + self::assertSame( + '

    With Query

    ', + $this->parsedown->text('[With Query](?foo=bar)') + ); + self::assertSame( + '

    With Param

    ', + $this->parsedown->text('[With Param](/foo:bar)') + ); + self::assertSame( + '

    With Anchor

    ', + $this->parsedown->text('[With Anchor](#foo)') + ); + } + + + public function testAnchorLinksLangRelativeUrls(): void + { + $this->config->set('system.languages.supported', ['fr','en']); + unset($this->grav['language']); + $this->grav['language'] = new Language($this->grav); + $this->uri->initializeWithURL('http://testing.dev/fr/item2/item2-2')->init(); + + self::assertSame( + '

    Current Anchor

    ', + $this->parsedown->text('[Current Anchor](#foo)') + ); + self::assertSame( + '

    Root Anchor

    ', + $this->parsedown->text('[Root Anchor](/#foo)') + ); + self::assertSame( + '

    Peer Anchor

    ', + $this->parsedown->text('[Peer Anchor](../item2-1#foo)') + ); + self::assertSame( + '

    Peer Anchor 2

    ', + $this->parsedown->text('[Peer Anchor 2](../item2-1/#foo)') + ); + } + + public function testAnchorLinksLangAbsoluteUrls(): void + { + $this->config->set('system.absolute_urls', true); + $this->config->set('system.languages.supported', ['fr','en']); + unset($this->grav['language']); + $this->grav['language'] = new Language($this->grav); + $this->uri->initializeWithURL('http://testing.dev/fr/item2/item2-2')->init(); + + self::assertSame( + '

    Current Anchor

    ', + $this->parsedown->text('[Current Anchor](#foo)') + ); + self::assertSame( + '

    Peer Anchor

    ', + $this->parsedown->text('[Peer Anchor](../item2-1#foo)') + ); + self::assertSame( + '

    Peer Anchor 2

    ', + $this->parsedown->text('[Peer Anchor 2](../item2-1/#foo)') + ); + self::assertSame( + '

    Root Anchor

    ', + $this->parsedown->text('[Root Anchor](/#foo)') + ); + } + + + public function testExternalLinks(): void + { + self::assertSame( + '

    cnn.com

    ', + $this->parsedown->text('[cnn.com](http://www.cnn.com)') + ); + self::assertSame( + '

    google.com

    ', + $this->parsedown->text('[google.com](https://www.google.com)') + ); + self::assertSame( + '

    complex url

    ', + $this->parsedown->text('[complex url](https://github.com/getgrav/grav/issues/new?title=[add-resource]%20New%20Plugin/Theme&body=Hello%20**There**)') + ); + } + + public function testExternalLinksSubDir(): void + { + $this->uri->initializeWithUrlAndRootPath('http://testing.dev/subdir/item2/item2-2', '/subdir')->init(); + + self::assertSame( + '

    cnn.com

    ', + $this->parsedown->text('[cnn.com](http://www.cnn.com)') + ); + self::assertSame( + '

    google.com

    ', + $this->parsedown->text('[google.com](https://www.google.com)') + ); + } + + public function testExternalLinksSubDirAbsoluteUrls(): void + { + $this->config->set('system.absolute_urls', true); + $this->uri->initializeWithUrlAndRootPath('http://testing.dev/subdir/item2/item2-2', '/subdir')->init(); + + self::assertSame( + '

    cnn.com

    ', + $this->parsedown->text('[cnn.com](http://www.cnn.com)') + ); + self::assertSame( + '

    google.com

    ', + $this->parsedown->text('[google.com](https://www.google.com)') + ); + } + + public function testAnchorLinksRelativeUrls(): void + { + $this->uri->initializeWithURL('http://testing.dev/item2/item2-2')->init(); + + self::assertSame( + '

    Current Anchor

    ', + $this->parsedown->text('[Current Anchor](#foo)') + ); + self::assertSame( + '

    Root Anchor

    ', + $this->parsedown->text('[Root Anchor](/#foo)') + ); + self::assertSame( + '

    Peer Anchor

    ', + $this->parsedown->text('[Peer Anchor](../item2-1#foo)') + ); + self::assertSame( + '

    Peer Anchor 2

    ', + $this->parsedown->text('[Peer Anchor 2](../item2-1/#foo)') + ); + } + + public function testAnchorLinksAbsoluteUrls(): void + { + $this->config->set('system.absolute_urls', true); + $this->uri->initializeWithURL('http://testing.dev/item2/item2-2')->init(); + + self::assertSame( + '

    Current Anchor

    ', + $this->parsedown->text('[Current Anchor](#foo)') + ); + self::assertSame( + '

    Peer Anchor

    ', + $this->parsedown->text('[Peer Anchor](../item2-1#foo)') + ); + self::assertSame( + '

    Peer Anchor 2

    ', + $this->parsedown->text('[Peer Anchor 2](../item2-1/#foo)') + ); + self::assertSame( + '

    Root Anchor

    ', + $this->parsedown->text('[Root Anchor](/#foo)') + ); + } + + public function testAnchorLinksWithPortAbsoluteUrls(): void + { + $this->config->set('system.absolute_urls', true); + $this->uri->initializeWithURL('http://testing.dev:8080/item2/item2-2')->init(); + + self::assertSame( + '

    Peer Anchor

    ', + $this->parsedown->text('[Peer Anchor](../item2-1#foo)') + ); + self::assertSame( + '

    Peer Anchor 2

    ', + $this->parsedown->text('[Peer Anchor 2](../item2-1/#foo)') + ); + self::assertSame( + '

    Current Anchor

    ', + $this->parsedown->text('[Current Anchor](#foo)') + ); + self::assertSame( + '

    Root Anchor

    ', + $this->parsedown->text('[Root Anchor](/#foo)') + ); + } + + public function testAnchorLinksSubDirRelativeUrls(): void + { + $this->uri->initializeWithUrlAndRootPath('http://testing.dev/subdir/item2/item2-2', '/subdir')->init(); + + self::assertSame( + '

    Peer Anchor

    ', + $this->parsedown->text('[Peer Anchor](../item2-1#foo)') + ); + self::assertSame( + '

    Peer Anchor 2

    ', + $this->parsedown->text('[Peer Anchor 2](../item2-1/#foo)') + ); + self::assertSame( + '

    Current Anchor

    ', + $this->parsedown->text('[Current Anchor](#foo)') + ); + self::assertSame( + '

    Root Anchor

    ', + $this->parsedown->text('[Root Anchor](/#foo)') + ); + } + + public function testAnchorLinksSubDirAbsoluteUrls(): void + { + $this->config->set('system.absolute_urls', true); + $this->uri->initializeWithUrlAndRootPath('http://testing.dev/subdir/item2/item2-2', '/subdir')->init(); + + self::assertSame( + '

    Peer Anchor

    ', + $this->parsedown->text('[Peer Anchor](../item2-1#foo)') + ); + self::assertSame( + '

    Peer Anchor 2

    ', + $this->parsedown->text('[Peer Anchor 2](../item2-1/#foo)') + ); + self::assertSame( + '

    Current Anchor

    ', + $this->parsedown->text('[Current Anchor](#foo)') + ); + self::assertSame( + '

    Root Anchor

    ', + $this->parsedown->text('[Root Anchor](/#foo)') + ); + } + + public function testSlugRelativeLinks(): void + { + $this->uri->initializeWithURL('http://testing.dev/item2/item2-2')->init(); + + self::assertSame( + '

    Up to Root Level

    ', + $this->parsedown->text('[Up to Root Level](../..)') + ); + self::assertSame( + '

    Peer Page

    ', + $this->parsedown->text('[Peer Page](../item2-1)') + ); + self::assertSame( + '

    Down a Level

    ', + $this->parsedown->text('[Down a Level](item2-2-1)') + ); + self::assertSame( + '

    Up a Level

    ', + $this->parsedown->text('[Up a Level](..)') + ); + self::assertSame( + '

    Up and Down

    ', + $this->parsedown->text('[Up and Down](../../item3/item3-3)') + ); + self::assertSame( + '

    Down a Level with Query

    ', + $this->parsedown->text('[Down a Level with Query](item2-2-1?foo=bar)') + ); + self::assertSame( + '

    Up a Level with Query

    ', + $this->parsedown->text('[Up a Level with Query](../?foo=bar)') + ); + self::assertSame( + '

    Up and Down with Query

    ', + $this->parsedown->text('[Up and Down with Query](../../item3/item3-3?foo=bar)') + ); + self::assertSame( + '

    Up and Down with Param

    ', + $this->parsedown->text('[Up and Down with Param](../../item3/item3-3/foo:bar)') + ); + self::assertSame( + '

    Up and Down with Anchor

    ', + $this->parsedown->text('[Up and Down with Anchor](../../item3/item3-3#foo)') + ); + } + + public function testSlugRelativeLinksAbsoluteUrls(): void + { + $this->config->set('system.absolute_urls', true); + $this->uri->initializeWithURL('http://testing.dev/item2/item2-2')->init(); + + self::assertSame( + '

    Peer Page

    ', + $this->parsedown->text('[Peer Page](../item2-1)') + ); + self::assertSame( + '

    Down a Level

    ', + $this->parsedown->text('[Down a Level](item2-2-1)') + ); + self::assertSame( + '

    Up a Level

    ', + $this->parsedown->text('[Up a Level](..)') + ); + self::assertSame( + '

    Up to Root Level

    ', + $this->parsedown->text('[Up to Root Level](../..)') + ); + self::assertSame( + '

    Up and Down

    ', + $this->parsedown->text('[Up and Down](../../item3/item3-3)') + ); + self::assertSame( + '

    Down a Level with Query

    ', + $this->parsedown->text('[Down a Level with Query](item2-2-1?foo=bar)') + ); + self::assertSame( + '

    Up a Level with Query

    ', + $this->parsedown->text('[Up a Level with Query](../?foo=bar)') + ); + self::assertSame( + '

    Up and Down with Query

    ', + $this->parsedown->text('[Up and Down with Query](../../item3/item3-3?foo=bar)') + ); + self::assertSame( + '

    Up and Down with Param

    ', + $this->parsedown->text('[Up and Down with Param](../../item3/item3-3/foo:bar)') + ); + self::assertSame( + '

    Up and Down with Anchor

    ', + $this->parsedown->text('[Up and Down with Anchor](../../item3/item3-3#foo)') + ); + } + + public function testSlugRelativeLinksSubDir(): void + { + $this->uri->initializeWithUrlAndRootPath('http://testing.dev/subdir/item2/item2-2', '/subdir')->init(); + + self::assertSame( + '

    Peer Page

    ', + $this->parsedown->text('[Peer Page](../item2-1)') + ); + self::assertSame( + '

    Down a Level

    ', + $this->parsedown->text('[Down a Level](item2-2-1)') + ); + self::assertSame( + '

    Up a Level

    ', + $this->parsedown->text('[Up a Level](..)') + ); + self::assertSame( + '

    Up to Root Level

    ', + $this->parsedown->text('[Up to Root Level](../..)') + ); + self::assertSame( + '

    Up and Down

    ', + $this->parsedown->text('[Up and Down](../../item3/item3-3)') + ); + self::assertSame( + '

    Down a Level with Query

    ', + $this->parsedown->text('[Down a Level with Query](item2-2-1?foo=bar)') + ); + self::assertSame( + '

    Up a Level with Query

    ', + $this->parsedown->text('[Up a Level with Query](../?foo=bar)') + ); + self::assertSame( + '

    Up and Down with Query

    ', + $this->parsedown->text('[Up and Down with Query](../../item3/item3-3?foo=bar)') + ); + self::assertSame( + '

    Up and Down with Param

    ', + $this->parsedown->text('[Up and Down with Param](../../item3/item3-3/foo:bar)') + ); + self::assertSame( + '

    Up and Down with Anchor

    ', + $this->parsedown->text('[Up and Down with Anchor](../../item3/item3-3#foo)') + ); + } + + public function testSlugRelativeLinksSubDirAbsoluteUrls(): void + { + $this->config->set('system.absolute_urls', true); + $this->uri->initializeWithUrlAndRootPath('http://testing.dev/subdir/item2/item2-2', '/subdir')->init(); + + self::assertSame( + '

    Peer Page

    ', + $this->parsedown->text('[Peer Page](../item2-1)') + ); + self::assertSame( + '

    Down a Level

    ', + $this->parsedown->text('[Down a Level](item2-2-1)') + ); + self::assertSame( + '

    Up a Level

    ', + $this->parsedown->text('[Up a Level](..)') + ); + self::assertSame( + '

    Up to Root Level

    ', + $this->parsedown->text('[Up to Root Level](../..)') + ); + self::assertSame( + '

    Up and Down

    ', + $this->parsedown->text('[Up and Down](../../item3/item3-3)') + ); + self::assertSame( + '

    Down a Level with Query

    ', + $this->parsedown->text('[Down a Level with Query](item2-2-1?foo=bar)') + ); + self::assertSame( + '

    Up a Level with Query

    ', + $this->parsedown->text('[Up a Level with Query](../?foo=bar)') + ); + self::assertSame( + '

    Up and Down with Query

    ', + $this->parsedown->text('[Up and Down with Query](../../item3/item3-3?foo=bar)') + ); + self::assertSame( + '

    Up and Down with Param

    ', + $this->parsedown->text('[Up and Down with Param](../../item3/item3-3/foo:bar)') + ); + self::assertSame( + '

    Up and Down with Anchor

    ', + $this->parsedown->text('[Up and Down with Anchor](../../item3/item3-3#foo)') + ); + } + + + public function testDirectoryRelativeLinks(): void + { + $this->uri->initializeWithURL('http://testing.dev/item2/item2-2')->init(); + + self::assertSame( + '

    Up and Down with Param

    ', + $this->parsedown->text('[Up and Down with Param](../../03.item3/03.item3-3/foo:bar)') + ); + self::assertSame( + '

    Peer Page

    ', + $this->parsedown->text('[Peer Page](../01.item2-1)') + ); + self::assertSame( + '

    Down a Level

    ', + $this->parsedown->text('[Down a Level](01.item2-2-1)') + ); + self::assertSame( + '

    Up and Down

    ', + $this->parsedown->text('[Up and Down](../../03.item3/03.item3-3)') + ); + self::assertSame( + '

    Down a Level with Query

    ', + $this->parsedown->text('[Down a Level with Query](01.item2-2-1?foo=bar)') + ); + self::assertSame( + '

    Up and Down with Query

    ', + $this->parsedown->text('[Up and Down with Query](../../03.item3/03.item3-3?foo=bar)') + ); + self::assertSame( + '

    Up and Down with Anchor

    ', + $this->parsedown->text('[Up and Down with Anchor](../../03.item3/03.item3-3#foo)') + ); + } + + + public function testAbsoluteLinks(): void + { + $this->uri->initializeWithURL('http://testing.dev/item2/item2-2')->init(); + + self::assertSame( + '

    Root

    ', + $this->parsedown->text('[Root](/)') + ); + self::assertSame( + '

    Peer Page

    ', + $this->parsedown->text('[Peer Page](/item2/item2-1)') + ); + self::assertSame( + '

    Down a Level

    ', + $this->parsedown->text('[Down a Level](/item2/item2-2/item2-2-1)') + ); + self::assertSame( + '

    Up a Level

    ', + $this->parsedown->text('[Up a Level](/item2)') + ); + self::assertSame( + '

    With Query

    ', + $this->parsedown->text('[With Query](/item2?foo=bar)') + ); + self::assertSame( + '

    With Param

    ', + $this->parsedown->text('[With Param](/item2/foo:bar)') + ); + self::assertSame( + '

    With Anchor

    ', + $this->parsedown->text('[With Anchor](/item2#foo)') + ); + } + + public function testDirectoryAbsoluteLinksSubDir(): void + { + $this->uri->initializeWithUrlAndRootPath('http://testing.dev/subdir/item2/item2-2', '/subdir')->init(); + + self::assertSame( + '

    Root

    ', + $this->parsedown->text('[Root](/)') + ); + self::assertSame( + '

    Peer Page

    ', + $this->parsedown->text('[Peer Page](/item2/item2-1)') + ); + self::assertSame( + '

    Down a Level

    ', + $this->parsedown->text('[Down a Level](/item2/item2-2/item2-2-1)') + ); + self::assertSame( + '

    Up a Level

    ', + $this->parsedown->text('[Up a Level](/item2)') + ); + self::assertSame( + '

    With Query

    ', + $this->parsedown->text('[With Query](/item2?foo=bar)') + ); + self::assertSame( + '

    With Param

    ', + $this->parsedown->text('[With Param](/item2/foo:bar)') + ); + self::assertSame( + '

    With Anchor

    ', + $this->parsedown->text('[With Anchor](/item2#foo)') + ); + } + + public function testDirectoryAbsoluteLinksSubDirAbsoluteUrl(): void + { + $this->config->set('system.absolute_urls', true); + $this->uri->initializeWithUrlAndRootPath('http://testing.dev/subdir/item2/item2-2', '/subdir')->init(); + + self::assertSame( + '

    Root

    ', + $this->parsedown->text('[Root](/)') + ); + self::assertSame( + '

    Peer Page

    ', + $this->parsedown->text('[Peer Page](/item2/item2-1)') + ); + self::assertSame( + '

    Down a Level

    ', + $this->parsedown->text('[Down a Level](/item2/item2-2/item2-2-1)') + ); + self::assertSame( + '

    Up a Level

    ', + $this->parsedown->text('[Up a Level](/item2)') + ); + self::assertSame( + '

    With Query

    ', + $this->parsedown->text('[With Query](/item2?foo=bar)') + ); + self::assertSame( + '

    With Param

    ', + $this->parsedown->text('[With Param](/item2/foo:bar)') + ); + self::assertSame( + '

    With Anchor

    ', + $this->parsedown->text('[With Anchor](/item2#foo)') + ); + } + + public function testSpecialProtocols(): void + { + $this->uri->initializeWithURL('http://testing.dev/item2/item2-2')->init(); + + self::assertSame( + '

    mailto

    ', + $this->parsedown->text('[mailto](mailto:user@domain.com)') + ); + self::assertSame( + '

    xmpp

    ', + $this->parsedown->text('[xmpp](xmpp:xyx@domain.com)') + ); + self::assertSame( + '

    tel

    ', + $this->parsedown->text('[tel](tel:123-555-12345)') + ); + self::assertSame( + '

    sms

    ', + $this->parsedown->text('[sms](sms:123-555-12345)') + ); + self::assertSame( + '

    ts.example.com

    ', + $this->parsedown->text('[ts.example.com](rdp://ts.example.com)') + ); + } + + public function testSpecialProtocolsSubDir(): void + { + $this->uri->initializeWithUrlAndRootPath('http://testing.dev/subdir/item2/item2-2', '/subdir')->init(); + + self::assertSame( + '

    mailto

    ', + $this->parsedown->text('[mailto](mailto:user@domain.com)') + ); + self::assertSame( + '

    xmpp

    ', + $this->parsedown->text('[xmpp](xmpp:xyx@domain.com)') + ); + self::assertSame( + '

    tel

    ', + $this->parsedown->text('[tel](tel:123-555-12345)') + ); + self::assertSame( + '

    sms

    ', + $this->parsedown->text('[sms](sms:123-555-12345)') + ); + self::assertSame( + '

    ts.example.com

    ', + $this->parsedown->text('[ts.example.com](rdp://ts.example.com)') + ); + } + + public function testSpecialProtocolsSubDirAbsoluteUrl(): void + { + $this->config->set('system.absolute_urls', true); + $this->uri->initializeWithUrlAndRootPath('http://testing.dev/subdir/item2/item2-2', '/subdir')->init(); + + self::assertSame( + '

    mailto

    ', + $this->parsedown->text('[mailto](mailto:user@domain.com)') + ); + self::assertSame( + '

    xmpp

    ', + $this->parsedown->text('[xmpp](xmpp:xyx@domain.com)') + ); + self::assertSame( + '

    tel

    ', + $this->parsedown->text('[tel](tel:123-555-12345)') + ); + self::assertSame( + '

    sms

    ', + $this->parsedown->text('[sms](sms:123-555-12345)') + ); + self::assertSame( + '

    ts.example.com

    ', + $this->parsedown->text('[ts.example.com](rdp://ts.example.com)') + ); + } + + public function testReferenceLinks(): void + { + $this->uri->initializeWithURL('http://testing.dev/item2/item2-2')->init(); + + $sample = '[relative link][r_relative] + [r_relative]: ../item2-3#blah'; + self::assertSame( + '

    relative link

    ', + $this->parsedown->text($sample) + ); + + $sample = '[absolute link][r_absolute] + [r_absolute]: /item3#blah'; + self::assertSame( + '

    absolute link

    ', + $this->parsedown->text($sample) + ); + + $sample = '[external link][r_external] + [r_external]: http://www.cnn.com'; + self::assertSame( + '

    external link

    ', + $this->parsedown->text($sample) + ); + } + + public function testAttributeLinks(): void + { + $this->uri->initializeWithURL('http://testing.dev/item2/item2-2')->init(); + + self::assertSame( + '

    Anchor Class

    ', + $this->parsedown->text('[Anchor Class](?classes=button#something)') + ); + self::assertSame( + '

    Relative Class

    ', + $this->parsedown->text('[Relative Class](../item2-3?classes=button)') + ); + self::assertSame( + '

    Relative ID

    ', + $this->parsedown->text('[Relative ID](../item2-3?id=unique)') + ); + self::assertSame( + '

    External

    ', + $this->parsedown->text('[External](https://github.com/getgrav/grav?classes=button,big)') + ); + self::assertSame( + '

    Relative Noprocess

    ', + $this->parsedown->text('[Relative Noprocess](../item2-3?id=unique&noprocess)') + ); + self::assertSame( + '

    Relative Target

    ', + $this->parsedown->text('[Relative Target](../item2-3?target=_blank)') + ); + self::assertSame( + '

    Relative Rel

    ', + $this->parsedown->text('[Relative Rel](../item2-3?rel=nofollow)') + ); + self::assertSame( + '

    Relative Mixed

    ', + $this->parsedown->text('[Relative Mixed](../item2-3?foo=bar&baz=qux&rel=nofollow&class=button)') + ); + } + + public function testInvalidLinks(): void + { + $this->uri->initializeWithURL('http://testing.dev/item2/item2-2')->init(); + + self::assertSame( + '

    Non Existent Page

    ', + $this->parsedown->text('[Non Existent Page](no-page)') + ); + self::assertSame( + '

    Existent File

    ', + $this->parsedown->text('[Existent File](existing-file.zip)') + ); + self::assertSame( + '

    Non Existent File

    ', + $this->parsedown->text('[Non Existent File](missing-file.zip)') + ); + } + + public function testInvalidLinksSubDir(): void + { + $this->uri->initializeWithUrlAndRootPath('http://testing.dev/subdir/item2/item2-2', '/subdir')->init(); + + self::assertSame( + '

    Non Existent Page

    ', + $this->parsedown->text('[Non Existent Page](no-page)') + ); + self::assertSame( + '

    Existent File

    ', + $this->parsedown->text('[Existent File](existing-file.zip)') + ); + self::assertSame( + '

    Non Existent File

    ', + $this->parsedown->text('[Non Existent File](missing-file.zip)') + ); + } + + public function testInvalidLinksSubDirAbsoluteUrl(): void + { + $this->config->set('system.absolute_urls', true); + $this->uri->initializeWithUrlAndRootPath('http://testing.dev/subdir/item2/item2-2', '/subdir')->init(); + + self::assertSame( + '

    Non Existent Page

    ', + $this->parsedown->text('[Non Existent Page](no-page)') + ); + self::assertSame( + '

    Existent File

    ', + $this->parsedown->text('[Existent File](existing-file.zip)') + ); + self::assertSame( + '

    Non Existent File

    ', + $this->parsedown->text('[Non Existent File](missing-file.zip)') + ); + } + + + /** + * @param $string + * + * @return mixed + */ + private function stripLeadingWhitespace($string) + { + return preg_replace('/^\s*(.*)/', '', $string); + } + + private function setImagesDefaults($defaults) { + $defaults = [ + 'images' => [ + 'defaults' => $defaults + ], + ]; + $page = $this->pages->find('/item2/item2-2'); + $excerpts = new Excerpts($page, $defaults); + $this->parsedown = new Parsedown($excerpts); + } +} diff --git a/tests/unit/Grav/Common/Page/PagesTest.php b/tests/unit/Grav/Common/Page/PagesTest.php new file mode 100644 index 0000000..edff75b --- /dev/null +++ b/tests/unit/Grav/Common/Page/PagesTest.php @@ -0,0 +1,299 @@ +grav = $grav(); + $this->pages = $this->grav['pages']; + $this->grav['config']->set('system.home.alias', '/home'); + + /** @var UniformResourceLocator $locator */ + $locator = $this->grav['locator']; + + $locator->addPath('page', '', 'tests/fake/simple-site/user/pages', false); + $this->pages->init(); + } + + public function testBase(): void + { + self::assertSame('', $this->pages->base()); + $this->pages->base('/test'); + self::assertSame('/test', $this->pages->base()); + $this->pages->base(''); + self::assertSame($this->pages->base(), ''); + } + + public function testLastModified(): void + { + self::assertNull($this->pages->lastModified()); + $this->pages->lastModified('test'); + self::assertSame('test', $this->pages->lastModified()); + } + + public function testInstances(): void + { + self::assertIsArray($this->pages->instances()); + foreach ($this->pages->instances() as $instance) { + self::assertInstanceOf(PageInterface::class, $instance); + } + } + + public function testRoutes(): void + { + /** @var UniformResourceLocator $locator */ + $locator = $this->grav['locator']; + $folder = $locator->findResource('tests://'); + + self::assertIsArray($this->pages->routes()); + self::assertSame($folder . '/fake/simple-site/user/pages/01.home', $this->pages->routes()['/']); + self::assertSame($folder . '/fake/simple-site/user/pages/01.home', $this->pages->routes()['/home']); + self::assertSame($folder . '/fake/simple-site/user/pages/02.blog', $this->pages->routes()['/blog']); + self::assertSame($folder . '/fake/simple-site/user/pages/02.blog/post-one', $this->pages->routes()['/blog/post-one']); + self::assertSame($folder . '/fake/simple-site/user/pages/02.blog/post-two', $this->pages->routes()['/blog/post-two']); + self::assertSame($folder . '/fake/simple-site/user/pages/03.about', $this->pages->routes()['/about']); + } + + public function testAddPage(): void + { + /** @var UniformResourceLocator $locator */ + $locator = $this->grav['locator']; + $folder = $locator->findResource('tests://'); + + $path = $folder . '/fake/single-pages/01.simple-page/default.md'; + $aPage = new Page(); + $aPage->init(new \SplFileInfo($path)); + + $this->pages->addPage($aPage, '/new-page'); + + self::assertContains('/new-page', array_keys($this->pages->routes())); + self::assertSame($folder . '/fake/single-pages/01.simple-page', $this->pages->routes()['/new-page']); + } + + public function testSort(): void + { + /** @var UniformResourceLocator $locator */ + $locator = $this->grav['locator']; + $folder = $locator->findResource('tests://'); + + $aPage = $this->pages->find('/blog'); + $subPagesSorted = $this->pages->sort($aPage); + + self::assertIsArray($subPagesSorted); + self::assertCount(2, $subPagesSorted); + + self::assertSame($folder . '/fake/simple-site/user/pages/02.blog/post-one', array_keys($subPagesSorted)[0]); + self::assertSame($folder . '/fake/simple-site/user/pages/02.blog/post-two', array_keys($subPagesSorted)[1]); + + self::assertContains($folder . '/fake/simple-site/user/pages/02.blog/post-one', array_keys($subPagesSorted)); + self::assertContains($folder . '/fake/simple-site/user/pages/02.blog/post-two', array_keys($subPagesSorted)); + + self::assertSame(['slug' => 'post-one'], $subPagesSorted[$folder . '/fake/simple-site/user/pages/02.blog/post-one']); + self::assertSame(['slug' => 'post-two'], $subPagesSorted[$folder . '/fake/simple-site/user/pages/02.blog/post-two']); + + $subPagesSorted = $this->pages->sort($aPage, null, 'desc'); + + self::assertIsArray($subPagesSorted); + self::assertCount(2, $subPagesSorted); + + self::assertSame($folder . '/fake/simple-site/user/pages/02.blog/post-two', array_keys($subPagesSorted)[0]); + self::assertSame($folder . '/fake/simple-site/user/pages/02.blog/post-one', array_keys($subPagesSorted)[1]); + + self::assertContains($folder . '/fake/simple-site/user/pages/02.blog/post-one', array_keys($subPagesSorted)); + self::assertContains($folder . '/fake/simple-site/user/pages/02.blog/post-two', array_keys($subPagesSorted)); + + self::assertSame(['slug' => 'post-one'], $subPagesSorted[$folder . '/fake/simple-site/user/pages/02.blog/post-one']); + self::assertSame(['slug' => 'post-two'], $subPagesSorted[$folder . '/fake/simple-site/user/pages/02.blog/post-two']); + } + + public function testSortCollection(): void + { + /** @var UniformResourceLocator $locator */ + $locator = $this->grav['locator']; + $folder = $locator->findResource('tests://'); + + $aPage = $this->pages->find('/blog'); + $subPagesSorted = $this->pages->sortCollection($aPage->children(), $aPage->orderBy()); + + self::assertIsArray($subPagesSorted); + self::assertCount(2, $subPagesSorted); + + self::assertSame($folder . '/fake/simple-site/user/pages/02.blog/post-one', array_keys($subPagesSorted)[0]); + self::assertSame($folder . '/fake/simple-site/user/pages/02.blog/post-two', array_keys($subPagesSorted)[1]); + + self::assertContains($folder . '/fake/simple-site/user/pages/02.blog/post-one', array_keys($subPagesSorted)); + self::assertContains($folder . '/fake/simple-site/user/pages/02.blog/post-two', array_keys($subPagesSorted)); + + self::assertSame(['slug' => 'post-one'], $subPagesSorted[$folder . '/fake/simple-site/user/pages/02.blog/post-one']); + self::assertSame(['slug' => 'post-two'], $subPagesSorted[$folder . '/fake/simple-site/user/pages/02.blog/post-two']); + + $subPagesSorted = $this->pages->sortCollection($aPage->children(), $aPage->orderBy(), 'desc'); + + self::assertIsArray($subPagesSorted); + self::assertCount(2, $subPagesSorted); + + self::assertSame($folder . '/fake/simple-site/user/pages/02.blog/post-two', array_keys($subPagesSorted)[0]); + self::assertSame($folder . '/fake/simple-site/user/pages/02.blog/post-one', array_keys($subPagesSorted)[1]); + + self::assertContains($folder . '/fake/simple-site/user/pages/02.blog/post-one', array_keys($subPagesSorted)); + self::assertContains($folder . '/fake/simple-site/user/pages/02.blog/post-two', array_keys($subPagesSorted)); + + self::assertSame(['slug' => 'post-one'], $subPagesSorted[$folder . '/fake/simple-site/user/pages/02.blog/post-one']); + self::assertSame(['slug' => 'post-two'], $subPagesSorted[$folder . '/fake/simple-site/user/pages/02.blog/post-two']); + } + + public function testGet(): void + { + /** @var UniformResourceLocator $locator */ + $locator = $this->grav['locator']; + $folder = $locator->findResource('tests://'); + + //Page existing + $aPage = $this->pages->get($folder . '/fake/simple-site/user/pages/03.about'); + self::assertInstanceOf(PageInterface::class, $aPage); + + //Page not existing + $anotherPage = $this->pages->get($folder . '/fake/simple-site/user/pages/03.non-existing'); + self::assertNull($anotherPage); + } + + public function testChildren(): void + { + /** @var UniformResourceLocator $locator */ + $locator = $this->grav['locator']; + $folder = $locator->findResource('tests://'); + + //Page existing + $children = $this->pages->children($folder . '/fake/simple-site/user/pages/02.blog'); + self::assertInstanceOf('Grav\Common\Page\Collection', $children); + + //Page not existing + $children = $this->pages->children($folder . '/fake/whatever/non-existing'); + self::assertSame([], $children->toArray()); + } + + public function testDispatch(): void + { + $aPage = $this->pages->dispatch('/blog'); + self::assertInstanceOf(PageInterface::class, $aPage); + + $aPage = $this->pages->dispatch('/about'); + self::assertInstanceOf(PageInterface::class, $aPage); + + $aPage = $this->pages->dispatch('/blog/post-one'); + self::assertInstanceOf(PageInterface::class, $aPage); + + //Page not existing + $aPage = $this->pages->dispatch('/non-existing'); + self::assertNull($aPage); + } + + public function testRoot(): void + { + $root = $this->pages->root(); + self::assertInstanceOf(PageInterface::class, $root); + self::assertSame('pages', $root->folder()); + } + + public function testBlueprints(): void + { + } + + public function testAll() + { + self::assertIsObject($this->pages->all()); + self::assertIsArray($this->pages->all()->toArray()); + foreach ($this->pages->all() as $page) { + self::assertInstanceOf(PageInterface::class, $page); + } + } + + public function testGetList(): void + { + $list = $this->pages->getList(); + self::assertIsArray($list); + self::assertSame('—-▸ Home', $list['/']); + self::assertSame('—-▸ Blog', $list['/blog']); + } + + public function testTranslatedLanguages(): void + { + /** @var UniformResourceLocator $locator */ + $locator = $this->grav['locator']; + $folder = $locator->findResource('tests://'); + + $page = $this->pages->get($folder . '/fake/simple-site/user/pages/04.page-translated'); + $this->assertInstanceOf(PageInterface::class, $page); + $translatedLanguages = $page->translatedLanguages(); + $this->assertIsArray($translatedLanguages); + $this->assertSame(["en" => "/page-translated", "fr" => "/page-translated"], $translatedLanguages); + } + + public function testLongPathTranslatedLanguages(): void + { + /** @var UniformResourceLocator $locator */ + $locator = $this->grav['locator']; + $folder = $locator->findResource('tests://'); + $page = $this->pages->get($folder . '/fake/simple-site/user/pages/05.translatedlong/part2'); + $this->assertInstanceOf(PageInterface::class, $page); + $translatedLanguages = $page->translatedLanguages(); + $this->assertIsArray($translatedLanguages); + $this->assertSame(["en" => "/translatedlong/part2", "fr" => "/translatedlong/part2"], $translatedLanguages); + } + + public function testGetTypes(): void + { + } + + public function testTypes(): void + { + } + + public function testModularTypes(): void + { + } + + public function testPageTypes(): void + { + } + + public function testAccessLevels(): void + { + } + + public function testParents(): void + { + } + + public function testParentsRawRoutes(): void + { + } + + public function testGetHomeRoute(): void + { + } + + public function testResetPages(): void + { + } +} diff --git a/tests/unit/Grav/Common/Twig/Extensions/GravExtensionTest.php b/tests/unit/Grav/Common/Twig/Extensions/GravExtensionTest.php new file mode 100644 index 0000000..2adb023 --- /dev/null +++ b/tests/unit/Grav/Common/Twig/Extensions/GravExtensionTest.php @@ -0,0 +1,202 @@ +grav = Fixtures::get('grav'); + $this->twig_ext = new GravExtension(); + } + + public function testInflectorFilter(): void + { + self::assertSame('people', $this->twig_ext->inflectorFilter('plural', 'person')); + self::assertSame('shoe', $this->twig_ext->inflectorFilter('singular', 'shoes')); + self::assertSame('Welcome Page', $this->twig_ext->inflectorFilter('title', 'welcome page')); + self::assertSame('SendEmail', $this->twig_ext->inflectorFilter('camel', 'send_email')); + self::assertSame('camel_cased', $this->twig_ext->inflectorFilter('underscor', 'CamelCased')); + self::assertSame('something-text', $this->twig_ext->inflectorFilter('hyphen', 'Something Text')); + self::assertSame('Something text to read', $this->twig_ext->inflectorFilter('human', 'something_text_to_read')); + self::assertSame(5, $this->twig_ext->inflectorFilter('month', '175')); + self::assertSame('10th', $this->twig_ext->inflectorFilter('ordinal', '10')); + } + + public function testMd5Filter(): void + { + self::assertSame(md5('grav'), $this->twig_ext->md5Filter('grav')); + self::assertSame(md5('devs@getgrav.org'), $this->twig_ext->md5Filter('devs@getgrav.org')); + } + + public function testKsortFilter(): void + { + $object = array("name"=>"Bob","age"=>8,"colour"=>"red"); + self::assertSame(array("age"=>8,"colour"=>"red","name"=>"Bob"), $this->twig_ext->ksortFilter($object)); + } + + public function testContainsFilter(): void + { + self::assertTrue($this->twig_ext->containsFilter('grav', 'grav')); + self::assertTrue($this->twig_ext->containsFilter('So, I found this new cms, called grav, and it\'s pretty awesome guys', 'grav')); + } + + public function testNicetimeFilter(): void + { + $now = time(); + $threeMinutes = time() - (60*3); + $threeHours = time() - (60*60*3); + $threeDays = time() - (60*60*24*3); + $threeMonths = time() - (60*60*24*30*3); + $threeYears = time() - (60*60*24*365*3); + $measures = ['minutes','hours','days','months','years']; + + self::assertSame('No date provided', $this->twig_ext->nicetimeFunc(null)); + + for ($i=0; $itwig_ext->nicetimeFunc($$time)); + } + } + + public function testRandomizeFilter(): void + { + $array = [1,2,3,4,5]; + self::assertContains(2, $this->twig_ext->randomizeFilter($array)); + self::assertSame($array, $this->twig_ext->randomizeFilter($array, 5)); + self::assertSame($array[0], $this->twig_ext->randomizeFilter($array, 1)[0]); + self::assertSame($array[3], $this->twig_ext->randomizeFilter($array, 4)[3]); + self::assertSame($array[1], $this->twig_ext->randomizeFilter($array, 4)[1]); + } + + public function testModulusFilter(): void + { + self::assertSame(3, $this->twig_ext->modulusFilter(3, 4)); + self::assertSame(1, $this->twig_ext->modulusFilter(11, 2)); + self::assertSame(0, $this->twig_ext->modulusFilter(10, 2)); + self::assertSame(2, $this->twig_ext->modulusFilter(10, 4)); + } + + public function testAbsoluteUrlFilter(): void + { + } + + public function testMarkdownFilter(): void + { + } + + public function testStartsWithFilter(): void + { + } + + public function testEndsWithFilter(): void + { + } + + public function testDefinedDefaultFilter(): void + { + } + + public function testRtrimFilter(): void + { + } + + public function testLtrimFilter(): void + { + } + + public function testRepeatFunc(): void + { + } + + public function testRegexReplace(): void + { + } + + public function testUrlFunc(): void + { + } + + public function testEvaluateFunc(): void + { + } + + public function testDump(): void + { + } + + public function testGistFunc(): void + { + } + + public function testRandomStringFunc(): void + { + } + + public function testPadFilter(): void + { + } + + public function testArrayFunc(): void + { + self::assertSame( + 'this is my text', + $this->twig_ext->regexReplace('

    this is my text

    ', '(<\/?p>)', '') + ); + self::assertSame( + 'this is my text', + $this->twig_ext->regexReplace('

    this is my text

    ', ['(

    )','(<\/p>)'], ['','']) + ); + } + + public function testArrayKeyValue(): void + { + self::assertSame( + ['meat' => 'steak'], + $this->twig_ext->arrayKeyValueFunc('meat', 'steak') + ); + self::assertSame( + ['fruit' => 'apple', 'meat' => 'steak'], + $this->twig_ext->arrayKeyValueFunc('meat', 'steak', ['fruit' => 'apple']) + ); + } + + public function stringFunc(): void + { + } + + public function testRangeFunc(): void + { + $hundred = []; + for ($i = 0; $i <= 100; $i++) { + $hundred[] = $i; + } + + + self::assertSame([0], $this->twig_ext->rangeFunc(0, 0)); + self::assertSame([0, 1, 2], $this->twig_ext->rangeFunc(0, 2)); + + self::assertSame([0, 5, 10, 15], $this->twig_ext->rangeFunc(0, 16, 5)); + + // default (min 0, max 100, step 1) + self::assertSame($hundred, $this->twig_ext->rangeFunc()); + + // 95 items, starting from 5, (min 5, max 100, step 1) + self::assertSame(array_slice($hundred, 5), $this->twig_ext->rangeFunc(5)); + + // reversed range + self::assertSame(array_reverse($hundred), $this->twig_ext->rangeFunc(100, 0)); + self::assertSame([4, 2, 0], $this->twig_ext->rangeFunc(4, 0, 2)); + } +} diff --git a/tests/unit/Grav/Common/UriTest.php b/tests/unit/Grav/Common/UriTest.php new file mode 100644 index 0000000..3e52ef8 --- /dev/null +++ b/tests/unit/Grav/Common/UriTest.php @@ -0,0 +1,1152 @@ + [ + 'scheme' => '', + 'user' => null, + 'password' => null, + 'host' => null, + 'port' => null, + 'path' => '/path', + 'query' => '', + 'fragment' => null, + + 'route' => '/path', + 'paths' => ['path'], + 'params' => null, + 'url' => '/path', + 'environment' => 'unknown', + 'basename' => 'path', + 'base' => '', + 'currentPage' => 1, + 'rootUrl' => '', + 'extension' => null, + 'addNonce' => '/path/nonce:{{nonce}}', + ], + '//localhost/' => [ + 'scheme' => '//', + 'user' => null, + 'password' => null, + 'host' => 'localhost', + 'port' => null, + 'path' => '/', + 'query' => '', + 'fragment' => null, + + 'route' => '/', + 'paths' => [], + 'params' => null, + 'url' => '/', + 'environment' => 'localhost', + 'basename' => '', + 'base' => '//localhost', + 'currentPage' => 1, + 'rootUrl' => '//localhost', + 'extension' => null, + 'addNonce' => '//localhost/nonce:{{nonce}}', + ], + 'http://localhost/' => [ + 'scheme' => 'http://', + 'user' => null, + 'password' => null, + 'host' => 'localhost', + 'port' => 80, + 'path' => '/', + 'query' => '', + 'fragment' => null, + + 'route' => '/', + 'paths' => [], + 'params' => null, + 'url' => '/', + 'environment' => 'localhost', + 'basename' => '', + 'base' => 'http://localhost', + 'currentPage' => 1, + 'rootUrl' => 'http://localhost', + 'extension' => null, + 'addNonce' => 'http://localhost/nonce:{{nonce}}', + ], + 'http://127.0.0.1/' => [ + 'scheme' => 'http://', + 'user' => null, + 'password' => null, + 'host' => '127.0.0.1', + 'port' => 80, + 'path' => '/', + 'query' => '', + 'fragment' => null, + + 'route' => '/', + 'paths' => [], + 'params' => null, + 'url' => '/', + 'environment' => 'localhost', + 'basename' => '', + 'base' => 'http://127.0.0.1', + 'currentPage' => 1, + 'rootUrl' => 'http://127.0.0.1', + 'extension' => null, + 'addNonce' => 'http://127.0.0.1/nonce:{{nonce}}', + ], + 'https://localhost/' => [ + 'scheme' => 'https://', + 'user' => null, + 'password' => null, + 'host' => 'localhost', + 'port' => 443, + 'path' => '/', + 'query' => '', + 'fragment' => null, + + 'route' => '/', + 'paths' => [], + 'params' => null, + 'url' => '/', + 'environment' => 'localhost', + 'basename' => '', + 'base' => 'https://localhost', + 'currentPage' => 1, + 'rootUrl' => 'https://localhost', + 'extension' => null, + 'addNonce' => 'https://localhost/nonce:{{nonce}}', + ], + 'http://localhost:8080/grav/it/ueper' => [ + 'scheme' => 'http://', + 'user' => null, + 'password' => null, + 'host' => 'localhost', + 'port' => 8080, + 'path' => '/grav/it/ueper', + 'query' => '', + 'fragment' => null, + + 'route' => '/grav/it/ueper', + 'paths' => ['grav', 'it', 'ueper'], + 'params' => null, + 'url' => '/grav/it/ueper', + 'environment' => 'localhost', + 'basename' => 'ueper', + 'base' => 'http://localhost:8080', + 'currentPage' => 1, + 'rootUrl' => 'http://localhost:8080', + 'extension' => null, + 'addNonce' => 'http://localhost:8080/grav/it/ueper/nonce:{{nonce}}', + ], + 'http://localhost:8080/grav/it/ueper:xxx' => [ + 'scheme' => 'http://', + 'user' => null, + 'password' => null, + 'host' => 'localhost', + 'port' => 8080, + 'path' => '/grav/it', + 'query' => '', + 'fragment' => null, + + 'route' => '/grav/it', + 'paths' => ['grav', 'it'], + 'params' => '/ueper:xxx', + 'url' => '/grav/it', + 'environment' => 'localhost', + 'basename' => 'it', + 'base' => 'http://localhost:8080', + 'currentPage' => 1, + 'rootUrl' => 'http://localhost:8080', + 'extension' => null, + 'addNonce' => 'http://localhost:8080/grav/it/ueper:xxx/nonce:{{nonce}}', + ], + 'http://localhost:8080/grav/it/ueper:xxx/page:/test:yyy' => [ + 'scheme' => 'http://', + 'user' => null, + 'password' => null, + 'host' => 'localhost', + 'port' => 8080, + 'path' => '/grav/it', + 'query' => '', + 'fragment' => null, + + 'route' => '/grav/it', + 'paths' => ['grav', 'it'], + 'params' => '/ueper:xxx/page:/test:yyy', + 'url' => '/grav/it', + 'environment' => 'localhost', + 'basename' => 'it', + 'base' => 'http://localhost:8080', + 'currentPage' => 1, + 'rootUrl' => 'http://localhost:8080', + 'extension' => null, + 'addNonce' => 'http://localhost:8080/grav/it/ueper:xxx/page:/test:yyy/nonce:{{nonce}}', + ], + 'http://localhost:8080/grav/it/ueper?test=x' => [ + 'scheme' => 'http://', + 'user' => null, + 'password' => null, + 'host' => 'localhost', + 'port' => 8080, + 'path' => '/grav/it/ueper', + 'query' => 'test=x', + 'fragment' => null, + + 'route' => '/grav/it/ueper', + 'paths' => ['grav', 'it', 'ueper'], + 'params' => null, + 'url' => '/grav/it/ueper', + 'environment' => 'localhost', + 'basename' => 'ueper', + 'base' => 'http://localhost:8080', + 'currentPage' => 1, + 'rootUrl' => 'http://localhost:8080', + 'extension' => null, + 'addNonce' => 'http://localhost:8080/grav/it/ueper/nonce:{{nonce}}?test=x', + ], + 'http://localhost:80/grav/it/ueper?test=x' => [ + 'scheme' => 'http://', + 'user' => null, + 'password' => null, + 'host' => 'localhost', + 'port' => 80, + 'path' => '/grav/it/ueper', + 'query' => 'test=x', + 'fragment' => null, + + 'route' => '/grav/it/ueper', + 'paths' => ['grav', 'it', 'ueper'], + 'params' => null, + 'url' => '/grav/it/ueper', + 'environment' => 'localhost', + 'basename' => 'ueper', + 'base' => 'http://localhost:80', + 'currentPage' => 1, + 'rootUrl' => 'http://localhost:80', + 'extension' => null, + 'addNonce' => 'http://localhost:80/grav/it/ueper/nonce:{{nonce}}?test=x', + ], + 'http://localhost/grav/it/ueper?test=x' => [ + 'scheme' => 'http://', + 'user' => null, + 'password' => null, + 'host' => 'localhost', + 'port' => 80, + 'path' => '/grav/it/ueper', + 'query' => 'test=x', + 'fragment' => null, + + 'route' => '/grav/it/ueper', + 'paths' => ['grav', 'it', 'ueper'], + 'params' => null, + 'url' => '/grav/it/ueper', + 'environment' => 'localhost', + 'basename' => 'ueper', + 'base' => 'http://localhost', + 'currentPage' => 1, + 'rootUrl' => 'http://localhost', + 'extension' => null, + 'addNonce' => 'http://localhost/grav/it/ueper/nonce:{{nonce}}?test=x', + ], + 'http://grav/grav/it/ueper' => [ + 'scheme' => 'http://', + 'user' => null, + 'password' => null, + 'host' => 'grav', + 'port' => 80, + 'path' => '/grav/it/ueper', + 'query' => '', + 'fragment' => null, + + 'route' => '/grav/it/ueper', + 'paths' => ['grav', 'it', 'ueper'], + 'params' => null, + 'url' => '/grav/it/ueper', + 'environment' => 'grav', + 'basename' => 'ueper', + 'base' => 'http://grav', + 'currentPage' => 1, + 'rootUrl' => 'http://grav', + 'extension' => null, + 'addNonce' => 'http://grav/grav/it/ueper/nonce:{{nonce}}', + ], + 'https://username:password@api.getgrav.com:4040/v1/post/128/page:x/?all=1' => [ + 'scheme' => 'https://', + 'user' => 'username', + 'password' => 'password', + 'host' => 'api.getgrav.com', + 'port' => 4040, + 'path' => '/v1/post/128/', // FIXME <- + 'query' => 'all=1', + 'fragment' => null, + + 'route' => '/v1/post/128', + 'paths' => ['v1', 'post', '128'], + 'params' => '/page:x', + 'url' => '/v1/post/128', + 'environment' => 'api.getgrav.com', + 'basename' => '128', + 'base' => 'https://api.getgrav.com:4040', + 'currentPage' => 1, + 'rootUrl' => 'https://api.getgrav.com:4040', + 'extension' => null, + 'addNonce' => 'https://username:password@api.getgrav.com:4040/v1/post/128/page:x/nonce:{{nonce}}?all=1', + 'toOriginalString' => 'https://username:password@api.getgrav.com:4040/v1/post/128/page:x?all=1' + ], + 'https://google.com:443/' => [ + 'scheme' => 'https://', + 'user' => null, + 'password' => null, + 'host' => 'google.com', + 'port' => 443, + 'path' => '/', + 'query' => '', + 'fragment' => null, + + 'route' => '/', + 'paths' => [], + 'params' => null, + 'url' => '/', + 'environment' => 'google.com', + 'basename' => '', + 'base' => 'https://google.com:443', + 'currentPage' => 1, + 'rootUrl' => 'https://google.com:443', + 'extension' => null, + 'addNonce' => 'https://google.com:443/nonce:{{nonce}}', + ], + // Path tests. + 'http://localhost:8080/a/b/c/d' => [ + 'scheme' => 'http://', + 'user' => null, + 'password' => null, + 'host' => 'localhost', + 'port' => 8080, + 'path' => '/a/b/c/d', + 'query' => '', + 'fragment' => null, + + 'route' => '/a/b/c/d', + 'paths' => ['a', 'b', 'c', 'd'], + 'params' => null, + 'url' => '/a/b/c/d', + 'environment' => 'localhost', + 'basename' => 'd', + 'base' => 'http://localhost:8080', + 'currentPage' => 1, + 'rootUrl' => 'http://localhost:8080', + 'extension' => null, + 'addNonce' => 'http://localhost:8080/a/b/c/d/nonce:{{nonce}}', + ], + 'http://localhost:8080/a/b/c/d/e/f/a/b/c/d/e/f/a/b/c/d/e/f' => [ + 'scheme' => 'http://', + 'user' => null, + 'password' => null, + 'host' => 'localhost', + 'port' => 8080, + 'path' => '/a/b/c/d/e/f/a/b/c/d/e/f/a/b/c/d/e/f', + 'query' => '', + 'fragment' => null, + + 'route' => '/a/b/c/d/e/f/a/b/c/d/e/f/a/b/c/d/e/f', + 'paths' => ['a', 'b', 'c', 'd', 'e', 'f', 'a', 'b', 'c', 'd', 'e', 'f', 'a', 'b', 'c', 'd', 'e', 'f'], + 'params' => null, + 'url' => '/a/b/c/d/e/f/a/b/c/d/e/f/a/b/c/d/e/f', + 'environment' => 'localhost', + 'basename' => 'f', + 'base' => 'http://localhost:8080', + 'currentPage' => 1, + 'rootUrl' => 'http://localhost:8080', + 'extension' => null, + 'addNonce' => 'http://localhost:8080/a/b/c/d/e/f/a/b/c/d/e/f/a/b/c/d/e/f/nonce:{{nonce}}', + ], + 'http://localhost/this is the path/my page' => [ + 'scheme' => 'http://', + 'user' => null, + 'password' => null, + 'host' => 'localhost', + 'port' => 80, + 'path' => '/this%20is%20the%20path/my%20page', + 'query' => '', + 'fragment' => null, + + 'route' => '/this%20is%20the%20path/my%20page', + 'paths' => ['this%20is%20the%20path', 'my%20page'], + 'params' => null, + 'url' => '/this%20is%20the%20path/my%20page', + 'environment' => 'localhost', + 'basename' => 'my%20page', + 'base' => 'http://localhost', + 'currentPage' => 1, + 'rootUrl' => 'http://localhost', + 'extension' => null, + 'addNonce' => 'http://localhost/this%20is%20the%20path/my%20page/nonce:{{nonce}}', + 'toOriginalString' => 'http://localhost/this%20is%20the%20path/my%20page' + ], + 'http://localhost/pölöpölö/päläpälä' => [ + 'scheme' => 'http://', + 'user' => null, + 'password' => null, + 'host' => 'localhost', + 'port' => 80, + 'path' => '/p%C3%B6l%C3%B6p%C3%B6l%C3%B6/p%C3%A4l%C3%A4p%C3%A4l%C3%A4', + 'query' => '', + 'fragment' => null, + + 'route' => '/p%C3%B6l%C3%B6p%C3%B6l%C3%B6/p%C3%A4l%C3%A4p%C3%A4l%C3%A4', + 'paths' => ['p%C3%B6l%C3%B6p%C3%B6l%C3%B6', 'p%C3%A4l%C3%A4p%C3%A4l%C3%A4'], + 'params' => null, + 'url' => '/p%C3%B6l%C3%B6p%C3%B6l%C3%B6/p%C3%A4l%C3%A4p%C3%A4l%C3%A4', + 'environment' => 'localhost', + 'basename' => 'p%C3%A4l%C3%A4p%C3%A4l%C3%A4', + 'base' => 'http://localhost', + 'currentPage' => 1, + 'rootUrl' => 'http://localhost', + 'extension' => null, + 'addNonce' => 'http://localhost/p%C3%B6l%C3%B6p%C3%B6l%C3%B6/p%C3%A4l%C3%A4p%C3%A4l%C3%A4/nonce:{{nonce}}', + 'toOriginalString' => 'http://localhost/p%C3%B6l%C3%B6p%C3%B6l%C3%B6/p%C3%A4l%C3%A4p%C3%A4l%C3%A4' + ], + // Query params tests. + 'http://localhost:8080/grav/it/ueper?test=x&test2=y' => [ + 'scheme' => 'http://', + 'user' => null, + 'password' => null, + 'host' => 'localhost', + 'port' => 8080, + 'path' => '/grav/it/ueper', + 'query' => 'test=x&test2=y', + 'fragment' => null, + + 'route' => '/grav/it/ueper', + 'paths' => ['grav', 'it', 'ueper'], + 'params' => null, + 'url' => '/grav/it/ueper', + 'environment' => 'localhost', + 'basename' => 'ueper', + 'base' => 'http://localhost:8080', + 'currentPage' => 1, + 'rootUrl' => 'http://localhost:8080', + 'extension' => null, + 'addNonce' => 'http://localhost:8080/grav/it/ueper/nonce:{{nonce}}?test=x&test2=y', + ], + 'http://localhost:8080/grav/it/ueper?test=x&test2=y&test3=x&test4=y' => [ + 'scheme' => 'http://', + 'user' => null, + 'password' => null, + 'host' => 'localhost', + 'port' => 8080, + 'path' => '/grav/it/ueper', + 'query' => 'test=x&test2=y&test3=x&test4=y', + 'fragment' => null, + + 'route' => '/grav/it/ueper', + 'paths' => ['grav', 'it', 'ueper'], + 'params' => null, + 'url' => '/grav/it/ueper', + 'environment' => 'localhost', + 'basename' => 'ueper', + 'base' => 'http://localhost:8080', + 'currentPage' => 1, + 'rootUrl' => 'http://localhost:8080', + 'extension' => null, + 'addNonce' => 'http://localhost:8080/grav/it/ueper/nonce:{{nonce}}?test=x&test2=y&test3=x&test4=y', + ], + 'http://localhost:8080/grav/it/ueper?test=x&test2=y&test3=x&test4=y/test' => [ + 'scheme' => 'http://', + 'user' => null, + 'password' => null, + 'host' => 'localhost', + 'port' => 8080, + 'path' => '/grav/it/ueper', + 'query' => 'test=x&test2=y&test3=x&test4=y%2Ftest', + 'fragment' => null, + + 'route' => '/grav/it/ueper', + 'paths' => ['grav', 'it', 'ueper'], + 'params' => null, + 'url' => '/grav/it/ueper', + 'environment' => 'localhost', + 'basename' => 'ueper', + 'base' => 'http://localhost:8080', + 'currentPage' => 1, + 'rootUrl' => 'http://localhost:8080', + 'extension' => null, + 'addNonce' => 'http://localhost:8080/grav/it/ueper/nonce:{{nonce}}?test=x&test2=y&test3=x&test4=y/test', + ], + // Port tests. + 'http://localhost/a-page' => [ + 'scheme' => 'http://', + 'user' => null, + 'password' => null, + 'host' => 'localhost', + 'port' => 80, + 'path' => '/a-page', + 'query' => '', + 'fragment' => null, + + 'route' => '/a-page', + 'paths' => ['a-page'], + 'params' => null, + 'url' => '/a-page', + 'environment' => 'localhost', + 'basename' => 'a-page', + 'base' => 'http://localhost', + 'currentPage' => 1, + 'rootUrl' => 'http://localhost', + 'extension' => null, + 'addNonce' => 'http://localhost/a-page/nonce:{{nonce}}', + ], + 'http://localhost:8080/a-page' => [ + 'scheme' => 'http://', + 'user' => null, + 'password' => null, + 'host' => 'localhost', + 'port' => 8080, + 'path' => '/a-page', + 'query' => '', + 'fragment' => null, + + 'route' => '/a-page', + 'paths' => ['a-page'], + 'params' => null, + 'url' => '/a-page', + 'environment' => 'localhost', + 'basename' => 'a-page', + 'base' => 'http://localhost:8080', + 'currentPage' => 1, + 'rootUrl' => 'http://localhost:8080', + 'extension' => null, + 'addNonce' => 'http://localhost:8080/a-page/nonce:{{nonce}}', + ], + 'http://localhost:443/a-page' => [ + 'scheme' => 'http://', + 'user' => null, + 'password' => null, + 'host' => 'localhost', + 'port' => 443, + 'path' => '/a-page', + 'query' => '', + 'fragment' => null, + + 'route' => '/a-page', + 'paths' => ['a-page'], + 'params' => null, + 'url' => '/a-page', + 'environment' => 'localhost', + 'basename' => 'a-page', + 'base' => 'http://localhost:443', + 'currentPage' => 1, + 'rootUrl' => 'http://localhost:443', + 'extension' => null, + 'addNonce' => 'http://localhost:443/a-page/nonce:{{nonce}}', + ], + // Extension tests. + 'http://localhost/a-page.html' => [ + 'scheme' => 'http://', + 'user' => null, + 'password' => null, + 'host' => 'localhost', + 'port' => 80, + 'path' => '/a-page', + 'query' => '', + 'fragment' => null, + + 'route' => '/a-page', + 'paths' => ['a-page'], + 'params' => null, + 'url' => '/a-page', + 'environment' => 'localhost', + 'basename' => 'a-page.html', + 'base' => 'http://localhost', + 'currentPage' => 1, + 'rootUrl' => 'http://localhost', + 'extension' => 'html', + 'addNonce' => 'http://localhost/a-page.html/nonce:{{nonce}}', + 'toOriginalString' => 'http://localhost/a-page.html', + ], + 'http://localhost/a-page.json' => [ + 'scheme' => 'http://', + 'user' => null, + 'password' => null, + 'host' => 'localhost', + 'port' => 80, + 'path' => '/a-page', + 'query' => '', + 'fragment' => null, + + 'route' => '/a-page', + 'paths' => ['a-page'], + 'params' => null, + 'url' => '/a-page', + 'environment' => 'localhost', + 'basename' => 'a-page.json', + 'base' => 'http://localhost', + 'currentPage' => 1, + 'rootUrl' => 'http://localhost', + 'extension' => 'json', + 'addNonce' => 'http://localhost/a-page.json/nonce:{{nonce}}', + 'toOriginalString' => 'http://localhost/a-page.json', + ], + 'http://localhost/admin/ajax.json/task:getnewsfeed' => [ + 'scheme' => 'http://', + 'user' => null, + 'password' => null, + 'host' => 'localhost', + 'port' => 80, + 'path' => '/admin/ajax', + 'query' => '', + 'fragment' => null, + + 'route' => '/admin/ajax', + 'paths' => ['admin', 'ajax'], + 'params' => '/task:getnewsfeed', + 'url' => '/admin/ajax', + 'environment' => 'localhost', + 'basename' => 'ajax.json', + 'base' => 'http://localhost', + 'currentPage' => 1, + 'rootUrl' => 'http://localhost', + 'extension' => 'json', + 'addNonce' => 'http://localhost/admin/ajax.json/task:getnewsfeed/nonce:{{nonce}}', + 'toOriginalString' => 'http://localhost/admin/ajax.json/task:getnewsfeed', + ], + 'http://localhost/grav/admin/media.json/route:L1VzZXJzL3JodWsvd29ya3NwYWNlL2dyYXYtZGVtby1zYW1wbGVyL3VzZXIvYXNzZXRzL3FRMXB4Vk1ERTNJZzh5Ni5qcGc=/task:removeFileFromBlueprint/proute:/blueprint:Y29uZmlnL2RldGFpbHM=/type:config/field:deep.nested.custom_file/path:dXNlci9hc3NldHMvcVExcHhWTURFM0lnOHk2LmpwZw==' => [ + 'scheme' => 'http://', + 'user' => null, + 'password' => null, + 'host' => 'localhost', + 'port' => 80, + 'path' => '/grav/admin/media', + 'query' => '', + 'fragment' => null, + + 'route' => '/grav/admin/media', + 'paths' => ['grav','admin','media'], + 'params' => '/route:L1VzZXJzL3JodWsvd29ya3NwYWNlL2dyYXYtZGVtby1zYW1wbGVyL3VzZXIvYXNzZXRzL3FRMXB4Vk1ERTNJZzh5Ni5qcGc=/task:removeFileFromBlueprint/proute:/blueprint:Y29uZmlnL2RldGFpbHM=/type:config/field:deep.nested.custom_file/path:dXNlci9hc3NldHMvcVExcHhWTURFM0lnOHk2LmpwZw==', + 'url' => '/grav/admin/media', + 'environment' => 'localhost', + 'basename' => 'media.json', + 'base' => 'http://localhost', + 'currentPage' => 1, + 'rootUrl' => 'http://localhost', + 'extension' => 'json', + 'addNonce' => 'http://localhost/grav/admin/media.json/route:L1VzZXJzL3JodWsvd29ya3NwYWNlL2dyYXYtZGVtby1zYW1wbGVyL3VzZXIvYXNzZXRzL3FRMXB4Vk1ERTNJZzh5Ni5qcGc=/task:removeFileFromBlueprint/proute:/blueprint:Y29uZmlnL2RldGFpbHM=/type:config/field:deep.nested.custom_file/path:dXNlci9hc3NldHMvcVExcHhWTURFM0lnOHk2LmpwZw==/nonce:{{nonce}}', + 'toOriginalString' => 'http://localhost/grav/admin/media.json/route:L1VzZXJzL3JodWsvd29ya3NwYWNlL2dyYXYtZGVtby1zYW1wbGVyL3VzZXIvYXNzZXRzL3FRMXB4Vk1ERTNJZzh5Ni5qcGc=/task:removeFileFromBlueprint/proute:/blueprint:Y29uZmlnL2RldGFpbHM=/type:config/field:deep.nested.custom_file/path:dXNlci9hc3NldHMvcVExcHhWTURFM0lnOHk2LmpwZw==', + ], + 'http://localhost/a-page.foo' => [ + 'scheme' => 'http://', + 'user' => null, + 'password' => null, + 'host' => 'localhost', + 'port' => 80, + 'path' => '/a-page.foo', + 'query' => '', + 'fragment' => null, + + 'route' => '/a-page.foo', + 'paths' => ['a-page.foo'], + 'params' => null, + 'url' => '/a-page.foo', + 'environment' => 'localhost', + 'basename' => 'a-page.foo', + 'base' => 'http://localhost', + 'currentPage' => 1, + 'rootUrl' => 'http://localhost', + 'extension' => 'foo', + 'addNonce' => 'http://localhost/a-page.foo/nonce:{{nonce}}', + 'toOriginalString' => 'http://localhost/a-page.foo' + ], + // Fragment tests. + 'http://localhost:8080/a/b/c#my-fragment' => [ + 'scheme' => 'http://', + 'user' => null, + 'password' => null, + 'host' => 'localhost', + 'port' => 8080, + 'path' => '/a/b/c', + 'query' => '', + 'fragment' => 'my-fragment', + + 'route' => '/a/b/c', + 'paths' => ['a', 'b', 'c'], + 'params' => null, + 'url' => '/a/b/c', + 'environment' => 'localhost', + 'basename' => 'c', + 'base' => 'http://localhost:8080', + 'currentPage' => 1, + 'rootUrl' => 'http://localhost:8080', + 'extension' => null, + 'addNonce' => 'http://localhost:8080/a/b/c/nonce:{{nonce}}#my-fragment', + ], + // Attacks. + '">://localhost' => [ + 'scheme' => '', + 'user' => null, + 'password' => null, + 'host' => null, + 'port' => null, + 'path' => '/localhost', + 'query' => '', + 'fragment' => null, + + 'route' => '/localhost', + 'paths' => ['localhost'], + 'params' => '/script%3E:', + 'url' => '//localhost', + 'environment' => 'unknown', + 'basename' => 'localhost', + 'base' => '', + 'currentPage' => 1, + 'rootUrl' => '', + 'extension' => null, + //'addNonce' => '%22%3E%3Cscript%3Ealert%3C/localhost/script%3E:/nonce:{{nonce}}', // FIXME <- + 'toOriginalString' => '/localhost/script%3E:' // FIXME <- + ], + 'http://">' => [ + 'scheme' => 'http://', + 'user' => null, + 'password' => null, + 'host' => 'unknown', + 'port' => 80, + 'path' => '/script%3E', + 'query' => '', + 'fragment' => null, + + 'route' => '/script%3E', + 'paths' => ['script%3E'], + 'params' => null, + 'url' => '/script%3E', + 'environment' => 'unknown', + 'basename' => 'script%3E', + 'base' => 'http://unknown', + 'currentPage' => 1, + 'rootUrl' => 'http://unknown', + 'extension' => null, + 'addNonce' => 'http://unknown/script%3E/nonce:{{nonce}}', + 'toOriginalString' => 'http://unknown/script%3E' + ], + 'http://localhost/">' => [ + 'scheme' => 'http://', + 'user' => null, + 'password' => null, + 'host' => 'localhost', + 'port' => 80, + 'path' => '/%22%3E%3Cscript%3Ealert%3C/script%3E', + 'query' => '', + 'fragment' => null, + + 'route' => '/%22%3E%3Cscript%3Ealert%3C/script%3E', + 'paths' => ['%22%3E%3Cscript%3Ealert%3C', 'script%3E'], + 'params' => null, + 'url' => '/%22%3E%3Cscript%3Ealert%3C/script%3E', + 'environment' => 'localhost', + 'basename' => 'script%3E', + 'base' => 'http://localhost', + 'currentPage' => 1, + 'rootUrl' => 'http://localhost', + 'extension' => null, + 'addNonce' => 'http://localhost/%22%3E%3Cscript%3Ealert%3C/script%3E/nonce:{{nonce}}', + 'toOriginalString' => 'http://localhost/%22%3E%3Cscript%3Ealert%3C/script%3E' + ], + 'http://localhost/something/p1:foo/p2:">' => [ + 'scheme' => 'http://', + 'user' => null, + 'password' => null, + 'host' => 'localhost', + 'port' => 80, + 'path' => '/something/script%3E', + 'query' => '', + 'fragment' => null, + + 'route' => '/something/script%3E', + 'paths' => ['something', 'script%3E'], + 'params' => '/p1:foo/p2:%22%3E%3Cscript%3Ealert%3C', + 'url' => '/something/script%3E', + 'environment' => 'localhost', + 'basename' => 'script%3E', + 'base' => 'http://localhost', + 'currentPage' => 1, + 'rootUrl' => 'http://localhost', + 'extension' => null, + //'addNonce' => 'http://localhost/something/script%3E/p1:foo/p2:%22%3E%3Cscript%3Ealert%3C/nonce:{{nonce}}', // FIXME <- + 'toOriginalString' => 'http://localhost/something/script%3E/p1:foo/p2:%22%3E%3Cscript%3Ealert%3C' + ], + 'http://localhost/something?p=">' => [ + 'scheme' => 'http://', + 'user' => null, + 'password' => null, + 'host' => 'localhost', + 'port' => 80, + 'path' => '/something', + 'query' => 'p=%22%3E%3Cscript%3Ealert%3C%2Fscript%3E', + 'fragment' => null, + + 'route' => '/something', + 'paths' => ['something'], + 'params' => null, + 'url' => '/something', + 'environment' => 'localhost', + 'basename' => 'something', + 'base' => 'http://localhost', + 'currentPage' => 1, + 'rootUrl' => 'http://localhost', + 'extension' => null, + 'addNonce' => 'http://localhost/something/nonce:{{nonce}}?p=%22%3E%3Cscript%3Ealert%3C/script%3E', + 'toOriginalString' => 'http://localhost/something?p=%22%3E%3Cscript%3Ealert%3C/script%3E' + ], + 'http://localhost/something#">' => [ + 'scheme' => 'http://', + 'user' => null, + 'password' => null, + 'host' => 'localhost', + 'port' => 80, + 'path' => '/something', + 'query' => '', + 'fragment' => '%22%3E%3Cscript%3Ealert%3C/script%3E', + + 'route' => '/something', + 'paths' => ['something'], + 'params' => null, + 'url' => '/something', + 'environment' => 'localhost', + 'basename' => 'something', + 'base' => 'http://localhost', + 'currentPage' => 1, + 'rootUrl' => 'http://localhost', + 'extension' => null, + 'addNonce' => 'http://localhost/something/nonce:{{nonce}}#%22%3E%3Cscript%3Ealert%3C/script%3E', + 'toOriginalString' => 'http://localhost/something#%22%3E%3Cscript%3Ealert%3C/script%3E' + ], + 'https://www.getgrav.org/something/"><' => [ + 'scheme' => 'https://', + 'user' => null, + 'password' => null, + 'host' => 'www.getgrav.org', + 'port' => 443, + 'path' => '/something/%22%3E%3Cscript%3Eeval%28atob%28%22aGlzdG9yeS5wdXNoU3RhdGUoJycsJycsJy8nKTskKCdoZWFkLGJvZHknKS5odG1sKCcnKS5sb2FkKCcvJyk7JC5wb3N0KCcvYWRtaW4nLGZ1bmN0aW9uKGRhdGEpeyQucG9zdCgkKGRhdGEpLmZpbmQoJ1tpZD1hZG1pbi11c2VyLWRldGFpbHNdIGEnKS5hdHRyKCdocmVmJykseydhZG1pbi1ub25jZSc6JChkYXRhKS5maW5kKCdbZGF0YS1jbGVhci1jYWNoZV0nKS5hdHRyKCdkYXRhLWNsZWFyLWNhY2hlJykuc3BsaXQoJzonKS5wb3AoKS50cmltKCksJ2RhdGFbcGFzc3dvcmRdJzonSW0zdjFsaDR4eDByJywndGFzayc6J3NhdmUnfSl9KQ==%22%29%29%3C/script%3E%3C', + 'query' => '', + 'fragment' => null, + + 'route' => '/something/%22%3E%3Cscript%3Eeval%28atob%28%22aGlzdG9yeS5wdXNoU3RhdGUoJycsJycsJy8nKTskKCdoZWFkLGJvZHknKS5odG1sKCcnKS5sb2FkKCcvJyk7JC5wb3N0KCcvYWRtaW4nLGZ1bmN0aW9uKGRhdGEpeyQucG9zdCgkKGRhdGEpLmZpbmQoJ1tpZD1hZG1pbi11c2VyLWRldGFpbHNdIGEnKS5hdHRyKCdocmVmJykseydhZG1pbi1ub25jZSc6JChkYXRhKS5maW5kKCdbZGF0YS1jbGVhci1jYWNoZV0nKS5hdHRyKCdkYXRhLWNsZWFyLWNhY2hlJykuc3BsaXQoJzonKS5wb3AoKS50cmltKCksJ2RhdGFbcGFzc3dvcmRdJzonSW0zdjFsaDR4eDByJywndGFzayc6J3NhdmUnfSl9KQ==%22%29%29%3C/script%3E%3C', + 'paths' => ['something', '%22%3E%3Cscript%3Eeval%28atob%28%22aGlzdG9yeS5wdXNoU3RhdGUoJycsJycsJy8nKTskKCdoZWFkLGJvZHknKS5odG1sKCcnKS5sb2FkKCcvJyk7JC5wb3N0KCcvYWRtaW4nLGZ1bmN0aW9uKGRhdGEpeyQucG9zdCgkKGRhdGEpLmZpbmQoJ1tpZD1hZG1pbi11c2VyLWRldGFpbHNdIGEnKS5hdHRyKCdocmVmJykseydhZG1pbi1ub25jZSc6JChkYXRhKS5maW5kKCdbZGF0YS1jbGVhci1jYWNoZV0nKS5hdHRyKCdkYXRhLWNsZWFyLWNhY2hlJykuc3BsaXQoJzonKS5wb3AoKS50cmltKCksJ2RhdGFbcGFzc3dvcmRdJzonSW0zdjFsaDR4eDByJywndGFzayc6J3NhdmUnfSl9KQ==%22%29%29%3C', 'script%3E%3C'], + 'params' => null, + 'url' => '/something/%22%3E%3Cscript%3Eeval%28atob%28%22aGlzdG9yeS5wdXNoU3RhdGUoJycsJycsJy8nKTskKCdoZWFkLGJvZHknKS5odG1sKCcnKS5sb2FkKCcvJyk7JC5wb3N0KCcvYWRtaW4nLGZ1bmN0aW9uKGRhdGEpeyQucG9zdCgkKGRhdGEpLmZpbmQoJ1tpZD1hZG1pbi11c2VyLWRldGFpbHNdIGEnKS5hdHRyKCdocmVmJykseydhZG1pbi1ub25jZSc6JChkYXRhKS5maW5kKCdbZGF0YS1jbGVhci1jYWNoZV0nKS5hdHRyKCdkYXRhLWNsZWFyLWNhY2hlJykuc3BsaXQoJzonKS5wb3AoKS50cmltKCksJ2RhdGFbcGFzc3dvcmRdJzonSW0zdjFsaDR4eDByJywndGFzayc6J3NhdmUnfSl9KQ==%22%29%29%3C/script%3E%3C', + 'environment' => 'www.getgrav.org', + 'basename' => 'script%3E%3C', + 'base' => 'https://www.getgrav.org', + 'currentPage' => 1, + 'rootUrl' => 'https://www.getgrav.org', + 'extension' => null, + 'addNonce' => 'https://www.getgrav.org/something/%22%3E%3Cscript%3Eeval%28atob%28%22aGlzdG9yeS5wdXNoU3RhdGUoJycsJycsJy8nKTskKCdoZWFkLGJvZHknKS5odG1sKCcnKS5sb2FkKCcvJyk7JC5wb3N0KCcvYWRtaW4nLGZ1bmN0aW9uKGRhdGEpeyQucG9zdCgkKGRhdGEpLmZpbmQoJ1tpZD1hZG1pbi11c2VyLWRldGFpbHNdIGEnKS5hdHRyKCdocmVmJykseydhZG1pbi1ub25jZSc6JChkYXRhKS5maW5kKCdbZGF0YS1jbGVhci1jYWNoZV0nKS5hdHRyKCdkYXRhLWNsZWFyLWNhY2hlJykuc3BsaXQoJzonKS5wb3AoKS50cmltKCksJ2RhdGFbcGFzc3dvcmRdJzonSW0zdjFsaDR4eDByJywndGFzayc6J3NhdmUnfSl9KQ==%22%29%29%3C/script%3E%3C/nonce:{{nonce}}', + 'toOriginalString' => 'https://www.getgrav.org/something/%22%3E%3Cscript%3Eeval%28atob%28%22aGlzdG9yeS5wdXNoU3RhdGUoJycsJycsJy8nKTskKCdoZWFkLGJvZHknKS5odG1sKCcnKS5sb2FkKCcvJyk7JC5wb3N0KCcvYWRtaW4nLGZ1bmN0aW9uKGRhdGEpeyQucG9zdCgkKGRhdGEpLmZpbmQoJ1tpZD1hZG1pbi11c2VyLWRldGFpbHNdIGEnKS5hdHRyKCdocmVmJykseydhZG1pbi1ub25jZSc6JChkYXRhKS5maW5kKCdbZGF0YS1jbGVhci1jYWNoZV0nKS5hdHRyKCdkYXRhLWNsZWFyLWNhY2hlJykuc3BsaXQoJzonKS5wb3AoKS50cmltKCksJ2RhdGFbcGFzc3dvcmRdJzonSW0zdjFsaDR4eDByJywndGFzayc6J3NhdmUnfSl9KQ==%22%29%29%3C/script%3E%3C' + ], + ]; + + protected function _before(): void + { + $grav = Fixtures::get('grav'); + $this->grav = $grav(); + $this->uri = $this->grav['uri']; + } + + protected function _after(): void + { + } + + protected function runTestSet(array $tests, $method, $params = []): void + { + foreach ($tests as $url => $candidates) { + if (!array_key_exists($method, $candidates) && $method !== 'toOriginalString') { + continue; + } + if ($method === 'addNonce') { + $nonce = Utils::getNonce('test-action'); + $expected = str_replace('{{nonce}}', $nonce, $candidates[$method]); + + self::assertSame($expected, Uri::addNonce($url, 'test-action')); + + continue; + } + + $this->uri->initializeWithURL($url)->init(); + if ($method === 'toOriginalString' && !isset($candidates[$method])) { + $expected = $url; + } else { + $expected = $candidates[$method]; + } + + if ($params) { + $result = call_user_func_array([$this->uri, $method], $params); + } else { + $result = $this->uri->{$method}(); + } + + self::assertSame($expected, $result, "Test \$url->{$method}() for {$url}"); + // Deal with $url->query($key) + if ($method === 'query') { + parse_str($expected, $queryParams); + foreach ($queryParams as $key => $value) { + self::assertSame($value, $this->uri->{$method}($key), "Test \$url->{$method}('{$key}') for {$url}"); + } + self::assertNull($this->uri->{$method}('non-existing'), "Test \$url->{$method}('non-existing') for {$url}"); + } + } + } + + public function testValidatingHostname(): void + { + self::assertTrue($this->uri->validateHostname('localhost')); + self::assertTrue($this->uri->validateHostname('google.com')); + self::assertTrue($this->uri->validateHostname('google.it')); + self::assertTrue($this->uri->validateHostname('goog.le')); + self::assertTrue($this->uri->validateHostname('goog.wine')); + self::assertTrue($this->uri->validateHostname('goog.localhost')); + + self::assertFalse($this->uri->validateHostname('localhost:80')); + self::assertFalse($this->uri->validateHostname('http://localhost')); + self::assertFalse($this->uri->validateHostname('localhost!')); + } + + public function testToString(): void + { + $this->runTestSet($this->tests, 'toOriginalString'); + } + + public function testScheme(): void + { + $this->runTestSet($this->tests, 'scheme'); + } + + public function testUser(): void + { + $this->runTestSet($this->tests, 'user'); + } + + public function testPassword(): void + { + $this->runTestSet($this->tests, 'password'); + } + + public function testHost(): void + { + $this->runTestSet($this->tests, 'host'); + } + + public function testPort(): void + { + $this->runTestSet($this->tests, 'port'); + } + + public function testPath(): void + { + $this->runTestSet($this->tests, 'path'); + } + + public function testQuery(): void + { + $this->runTestSet($this->tests, 'query'); + } + + public function testFragment(): void + { + $this->runTestSet($this->tests, 'fragment'); + + $this->uri->fragment('something-new'); + self::assertSame('something-new', $this->uri->fragment()); + } + + public function testPaths(): void + { + $this->runTestSet($this->tests, 'paths'); + } + + public function testRoute(): void + { + $this->runTestSet($this->tests, 'route'); + } + + public function testParams(): void + { + $this->runTestSet($this->tests, 'params'); + + $this->uri->initializeWithURL('http://localhost:8080/grav/it/ueper:xxx')->init(); + self::assertSame('/ueper:xxx', $this->uri->params('ueper')); + $this->uri->initializeWithURL('http://localhost:8080/grav/it/ueper:xxx/test:yyy')->init(); + self::assertSame('/ueper:xxx', $this->uri->params('ueper')); + self::assertSame('/test:yyy', $this->uri->params('test')); + $this->uri->initializeWithURL('http://localhost:8080/grav/it/ueper:xxx++/test:yyy')->init(); + self::assertSame('/ueper:xxx++/test:yyy', $this->uri->params()); + self::assertSame('/ueper:xxx++', $this->uri->params('ueper')); + self::assertSame('/test:yyy', $this->uri->params('test')); + $this->uri->initializeWithURL('http://localhost:8080/grav/it/ueper:xxx++/test:yyy#something')->init(); + self::assertSame('/ueper:xxx++/test:yyy', $this->uri->params()); + self::assertSame('/ueper:xxx++', $this->uri->params('ueper')); + self::assertSame('/test:yyy', $this->uri->params('test')); + $this->uri->initializeWithURL('http://localhost:8080/grav/it/ueper:xxx++/test:yyy?foo=bar')->init(); + self::assertSame('/ueper:xxx++/test:yyy', $this->uri->params()); + self::assertSame('/ueper:xxx++', $this->uri->params('ueper')); + self::assertSame('/test:yyy', $this->uri->params('test')); + $this->uri->initializeWithURL('http://localhost:8080/grav/it/ueper?test=x')->init(); + self::assertNull($this->uri->params()); + self::assertNull($this->uri->params('ueper')); + $this->uri->initializeWithURL('http://localhost:8080/grav/it/ueper?test=x&test2=y')->init(); + self::assertNull($this->uri->params()); + self::assertNull($this->uri->params('ueper')); + $this->uri->initializeWithURL('http://localhost:8080/grav/it/ueper?test=x&test2=y&test3=x&test4=y')->init(); + self::assertNull($this->uri->params()); + self::assertNull($this->uri->params('ueper')); + $this->uri->initializeWithURL('http://localhost:8080/grav/it/ueper?test=x&test2=y&test3=x&test4=y/test')->init(); + self::assertNull($this->uri->params()); + self::assertNull($this->uri->params('ueper')); + $this->uri->initializeWithURL('http://localhost:8080/a/b/c/d')->init(); + self::assertNull($this->uri->params()); + self::assertNull($this->uri->params('ueper')); + $this->uri->initializeWithURL('http://localhost:8080/a/b/c/d/e/f/a/b/c/d/e/f/a/b/c/d/e/f')->init(); + self::assertNull($this->uri->params()); + self::assertNull($this->uri->params('ueper')); + } + + public function testParam(): void + { + $this->uri->initializeWithURL('http://localhost:8080/grav/it/ueper:xxx')->init(); + self::assertSame('xxx', $this->uri->param('ueper')); + $this->uri->initializeWithURL('http://localhost:8080/grav/it/ueper:xxx/test:yyy')->init(); + self::assertSame('xxx', $this->uri->param('ueper')); + self::assertSame('yyy', $this->uri->param('test')); + $this->uri->initializeWithURL('http://localhost:8080/grav/it/ueper:xxx++/test:yy%20y/foo:bar_baz-bank')->init(); + self::assertSame('xxx++', $this->uri->param('ueper')); + self::assertSame('yy y', $this->uri->param('test')); + self::assertSame('bar_baz-bank', $this->uri->param('foo')); + } + + public function testUrl(): void + { + $this->runTestSet($this->tests, 'url'); + } + + public function testExtension(): void + { + $this->runTestSet($this->tests, 'extension'); + + $this->uri->initializeWithURL('http://localhost/a-page')->init(); + self::assertSame('x', $this->uri->extension('x')); + } + + public function testEnvironment(): void + { + $this->runTestSet($this->tests, 'environment'); + } + + public function testBasename(): void + { + $this->runTestSet($this->tests, 'basename'); + } + + public function testBase(): void + { + $this->runTestSet($this->tests, 'base'); + } + + public function testRootUrl(): void + { + $this->runTestSet($this->tests, 'rootUrl', [true]); + + $this->uri->initializeWithUrlAndRootPath('https://localhost/grav/page-foo', '/grav')->init(); + self::assertSame('/grav', $this->uri->rootUrl()); + self::assertSame('https://localhost/grav', $this->uri->rootUrl(true)); + } + + public function testCurrentPage(): void + { + $this->runTestSet($this->tests, 'currentPage'); + + $this->uri->initializeWithURL('http://localhost:8080/a-page/page:2')->init(); + self::assertSame(2, $this->uri->currentPage()); + } + + public function testReferrer(): void + { + $this->uri->initializeWithURL('http://localhost/foo/page:test')->init(); + self::assertSame('/foo', $this->uri->referrer()); + $this->uri->initializeWithURL('http://localhost/foo/bar/page:test')->init(); + self::assertSame('/foo/bar', $this->uri->referrer()); + } + + public function testIp(): void + { + $this->uri->initializeWithURL('http://localhost/foo/page:test')->init(); + self::assertSame('UNKNOWN', Uri::ip()); + } + + public function testIsExternal(): void + { + $this->uri->initializeWithURL('http://localhost/')->init(); + self::assertFalse(Uri::isExternal('/test')); + self::assertFalse(Uri::isExternal('/foo/bar')); + self::assertTrue(Uri::isExternal('http://localhost/test')); + self::assertTrue(Uri::isExternal('http://google.it/test')); + } + + public function testBuildUrl(): void + { + $parsed_url = [ + 'scheme' => 'http', + 'host' => 'localhost', + 'port' => 8080, + ]; + + self::assertSame('http://localhost:8080', Uri::buildUrl($parsed_url)); + + $parsed_url = [ + 'scheme' => 'http', + 'host' => 'localhost', + 'port' => 8080, + 'user' => 'foo', + 'pass' => 'bar', + 'path' => '/test', + 'query' => 'x=2', + 'fragment' => 'xxx', + ]; + + self::assertSame('http://foo:bar@localhost:8080/test?x=2#xxx', Uri::buildUrl($parsed_url)); + + /** @var Uri $uri */ + $uri = Grav::instance()['uri']; + + $uri->initializeWithUrlAndRootPath('https://testing.dev/subdir/path1/path2/file.html', '/subdir')->init(); + self::assertSame('https://testing.dev/subdir/path1/path2/file.html', Uri::buildUrl($uri->toArray(true))); + + $uri->initializeWithUrlAndRootPath('https://testing.dev/subdir/path1/path2/file.foo', '/subdir')->init(); + self::assertSame('https://testing.dev/subdir/path1/path2/file.foo', Uri::buildUrl($uri->toArray(true))); + + $uri->initializeWithUrlAndRootPath('https://testing.dev/subdir/path1/path2/file.html', '/subdir/path1')->init(); + self::assertSame('https://testing.dev/subdir/path1/path2/file.html', Uri::buildUrl($uri->toArray(true))); + + $uri->initializeWithUrlAndRootPath('https://testing.dev/subdir/path1/path2/file.html/foo:blah/bang:boom', '/subdir')->init(); + self::assertSame('https://testing.dev/subdir/path1/path2/file.html/foo:blah/bang:boom', Uri::buildUrl($uri->toArray(true))); + + $uri->initializeWithUrlAndRootPath('https://testing.dev/subdir/path1/path2/file.html/foo:blah/bang:boom?fig=something', '/subdir')->init(); + self::assertSame('https://testing.dev/subdir/path1/path2/file.html/foo:blah/bang:boom?fig=something', Uri::buildUrl($uri->toArray(true))); + } + + public function testConvertUrl(): void + { + } + + public function testAddNonce(): void + { + $this->runTestSet($this->tests, 'addNonce'); + } +} diff --git a/tests/unit/Grav/Common/UtilsTest.php b/tests/unit/Grav/Common/UtilsTest.php new file mode 100644 index 0000000..0e53049 --- /dev/null +++ b/tests/unit/Grav/Common/UtilsTest.php @@ -0,0 +1,572 @@ +grav = $grav(); + $this->uri = $this->grav['uri']; + } + + protected function _after(): void + { + } + + public function testStartsWith(): void + { + self::assertTrue(Utils::startsWith('english', 'en')); + self::assertTrue(Utils::startsWith('English', 'En')); + self::assertTrue(Utils::startsWith('ENGLISH', 'EN')); + self::assertTrue(Utils::startsWith( + 'ENGLISHENGLISHENGLISHENGLISHENGLISHENGLISHENGLISHENGLISHENGLISHENGLISH', + 'EN' + )); + + self::assertFalse(Utils::startsWith('english', 'En')); + self::assertFalse(Utils::startsWith('English', 'EN')); + self::assertFalse(Utils::startsWith('ENGLISH', 'en')); + self::assertFalse(Utils::startsWith( + 'ENGLISHENGLISHENGLISHENGLISHENGLISHENGLISHENGLISHENGLISHENGLISHENGLISH', + 'e' + )); + + self::assertTrue(Utils::startsWith('english', 'En', false)); + self::assertTrue(Utils::startsWith('English', 'EN', false)); + self::assertTrue(Utils::startsWith('ENGLISH', 'en', false)); + self::assertTrue(Utils::startsWith( + 'ENGLISHENGLISHENGLISHENGLISHENGLISHENGLISHENGLISHENGLISHENGLISHENGLISH', + 'e', + false + )); + } + + public function testEndsWith(): void + { + self::assertTrue(Utils::endsWith('english', 'sh')); + self::assertTrue(Utils::endsWith('EngliSh', 'Sh')); + self::assertTrue(Utils::endsWith('ENGLISH', 'SH')); + self::assertTrue(Utils::endsWith( + 'ENGLISHENGLISHENGLISHENGLISHENGLISHENGLISHENGLISHENGLISHENGLISHENGLISH', + 'ENGLISH' + )); + + self::assertFalse(Utils::endsWith('english', 'de')); + self::assertFalse(Utils::endsWith('EngliSh', 'sh')); + self::assertFalse(Utils::endsWith('ENGLISH', 'Sh')); + self::assertFalse(Utils::endsWith( + 'ENGLISHENGLISHENGLISHENGLISHENGLISHENGLISHENGLISHENGLISHENGLISHENGLISH', + 'DEUSTCH' + )); + + self::assertTrue(Utils::endsWith('english', 'SH', false)); + self::assertTrue(Utils::endsWith('EngliSh', 'sH', false)); + self::assertTrue(Utils::endsWith('ENGLISH', 'sh', false)); + self::assertTrue(Utils::endsWith( + 'ENGLISHENGLISHENGLISHENGLISHENGLISHENGLISHENGLISHENGLISHENGLISHENGLISH', + 'english', + false + )); + } + + public function testContains(): void + { + self::assertTrue(Utils::contains('english', 'nglis')); + self::assertTrue(Utils::contains('EngliSh', 'gliSh')); + self::assertTrue(Utils::contains('ENGLISH', 'ENGLI')); + self::assertTrue(Utils::contains( + 'ENGLISHENGLISHENGLISHENGLISHENGLISHENGLISHENGLISHENGLISHENGLISHENGLISH', + 'ENGLISH' + )); + + self::assertFalse(Utils::contains('EngliSh', 'GLI')); + self::assertFalse(Utils::contains('EngliSh', 'English')); + self::assertFalse(Utils::contains('ENGLISH', 'SCH')); + self::assertFalse(Utils::contains( + 'ENGLISHENGLISHENGLISHENGLISHENGLISHENGLISHENGLISHENGLISHENGLISHENGLISH', + 'DEUSTCH' + )); + + self::assertTrue(Utils::contains('EngliSh', 'GLI', false)); + self::assertTrue(Utils::contains('EngliSh', 'ENGLISH', false)); + self::assertTrue(Utils::contains('ENGLISH', 'ish', false)); + self::assertTrue(Utils::contains( + 'ENGLISHENGLISHENGLISHENGLISHENGLISHENGLISHENGLISHENGLISHENGLISHENGLISH', + 'english', + false + )); + } + + public function testSubstrToString(): void + { + self::assertEquals('en', Utils::substrToString('english', 'glish')); + self::assertEquals('english', Utils::substrToString('english', 'test')); + self::assertNotEquals('en', Utils::substrToString('english', 'lish')); + + self::assertEquals('en', Utils::substrToString('english', 'GLISH', false)); + self::assertEquals('english', Utils::substrToString('english', 'TEST', false)); + self::assertNotEquals('en', Utils::substrToString('english', 'LISH', false)); + } + + public function testMergeObjects(): void + { + $obj1 = new stdClass(); + $obj1->test1 = 'x'; + $obj2 = new stdClass(); + $obj2->test2 = 'y'; + + $objMerged = Utils::mergeObjects($obj1, $obj2); + + self::arrayHasKey('test1', (array) $objMerged); + self::arrayHasKey('test2', (array) $objMerged); + } + + public function testDateFormats(): void + { + $dateFormats = Utils::dateFormats(); + self::assertIsArray($dateFormats); + self::assertContainsOnly('string', $dateFormats); + + $default_format = $this->grav['config']->get('system.pages.dateformat.default'); + + if ($default_format !== null) { + self::assertArrayHasKey($default_format, $dateFormats); + } + } + + public function testTruncate(): void + { + self::assertEquals('engli' . '…', Utils::truncate('english', 5)); + self::assertEquals('english', Utils::truncate('english')); + self::assertEquals('This is a string to truncate', Utils::truncate('This is a string to truncate')); + self::assertEquals('Th' . '…', Utils::truncate('This is a string to truncate', 2)); + self::assertEquals('engli' . '...', Utils::truncate('english', 5, true, " ", "...")); + self::assertEquals('english', Utils::truncate('english')); + self::assertEquals('This is a string to truncate', Utils::truncate('This is a string to truncate')); + self::assertEquals('This' . '…', Utils::truncate('This is a string to truncate', 3, true)); + self::assertEquals('', 6, true)); + } + + public function testSafeTruncate(): void + { + self::assertEquals('This' . '…', Utils::safeTruncate('This is a string to truncate', 1)); + self::assertEquals('This' . '…', Utils::safeTruncate('This is a string to truncate', 4)); + self::assertEquals('This is' . '…', Utils::safeTruncate('This is a string to truncate', 5)); + } + + public function testTruncateHtml(): void + { + self::assertEquals('T...', Utils::truncateHtml('This is a string to truncate', 1)); + self::assertEquals('This is...', Utils::truncateHtml('This is a string to truncate', 7)); + self::assertEquals('

    T...

    ', Utils::truncateHtml('

    This is a string to truncate

    ', 1)); + self::assertEquals('

    This...

    ', Utils::truncateHtml('

    This is a string to truncate

    ', 4)); + self::assertEquals('

    This is a...

    ', Utils::truncateHtml('

    This is a string to truncate

    ', 10)); + self::assertEquals('

    This is a string to truncate

    ', Utils::truncateHtml('

    This is a string to truncate

    ', 100)); + self::assertEquals('', Utils::truncateHtml('', 6)); + self::assertEquals('
    1. item 1 so...
    ', Utils::truncateHtml('
    1. item 1 something
    2. item 2 bold
    ', 10)); + self::assertEquals("

    This is a string.

    \n

    It splits two lines.

    ", Utils::truncateHtml("

    This is a string.

    \n

    It splits two lines.

    ", 100)); + } + + public function testSafeTruncateHtml(): void + { + self::assertEquals('This...', Utils::safeTruncateHtml('This is a string to truncate', 1)); + self::assertEquals('This is a...', Utils::safeTruncateHtml('This is a string to truncate', 3)); + self::assertEquals('

    This...

    ', Utils::safeTruncateHtml('

    This is a string to truncate

    ', 1)); + self::assertEquals('

    This is...

    ', Utils::safeTruncateHtml('

    This is a string to truncate

    ', 2)); + self::assertEquals('

    This is a string to...

    ', Utils::safeTruncateHtml('

    This is a string to truncate

    ', 5)); + self::assertEquals('

    This is a string to truncate

    ', Utils::safeTruncateHtml('

    This is a string to truncate

    ', 20)); + self::assertEquals('', Utils::safeTruncateHtml('', 6)); + self::assertEquals('
    1. item 1 something
    2. item 2...
    ', Utils::safeTruncateHtml('
    1. item 1 something
    2. item 2 bold
    ', 5)); + } + + public function testGenerateRandomString(): void + { + self::assertNotEquals(Utils::generateRandomString(), Utils::generateRandomString()); + self::assertNotEquals(Utils::generateRandomString(20), Utils::generateRandomString(20)); + } + + public function download(): void + { + } + + public function testGetMimeByExtension(): void + { + self::assertEquals('application/octet-stream', Utils::getMimeByExtension('')); + self::assertEquals('text/html', Utils::getMimeByExtension('html')); + self::assertEquals('application/json', Utils::getMimeByExtension('json')); + self::assertEquals('application/atom+xml', Utils::getMimeByExtension('atom')); + self::assertEquals('application/rss+xml', Utils::getMimeByExtension('rss')); + self::assertEquals('image/jpeg', Utils::getMimeByExtension('jpg')); + self::assertEquals('image/png', Utils::getMimeByExtension('png')); + self::assertEquals('text/plain', Utils::getMimeByExtension('txt')); + self::assertEquals('application/msword', Utils::getMimeByExtension('doc')); + self::assertEquals('application/octet-stream', Utils::getMimeByExtension('foo')); + self::assertEquals('foo/bar', Utils::getMimeByExtension('foo', 'foo/bar')); + self::assertEquals('text/html', Utils::getMimeByExtension('foo', 'text/html')); + } + + public function testGetExtensionByMime(): void + { + self::assertEquals('html', Utils::getExtensionByMime('*/*')); + self::assertEquals('html', Utils::getExtensionByMime('text/*')); + self::assertEquals('html', Utils::getExtensionByMime('text/html')); + self::assertEquals('json', Utils::getExtensionByMime('application/json')); + self::assertEquals('atom', Utils::getExtensionByMime('application/atom+xml')); + self::assertEquals('rss', Utils::getExtensionByMime('application/rss+xml')); + self::assertEquals('jpg', Utils::getExtensionByMime('image/jpeg')); + self::assertEquals('png', Utils::getExtensionByMime('image/png')); + self::assertEquals('txt', Utils::getExtensionByMime('text/plain')); + self::assertEquals('doc', Utils::getExtensionByMime('application/msword')); + self::assertEquals('html', Utils::getExtensionByMime('foo/bar')); + self::assertEquals('baz', Utils::getExtensionByMime('foo/bar', 'baz')); + } + + public function testNormalizePath(): void + { + self::assertEquals('/test', Utils::normalizePath('/test')); + self::assertEquals('test', Utils::normalizePath('test')); + self::assertEquals('test', Utils::normalizePath('../test')); + self::assertEquals('/test', Utils::normalizePath('/../test')); + self::assertEquals('/test2', Utils::normalizePath('/test/../test2')); + self::assertEquals('/test3', Utils::normalizePath('/test/../test2/../test3')); + + self::assertEquals('//cdnjs.cloudflare.com/ajax/libs/Leaflet.awesome-markers/2.0.2/leaflet.awesome-markers.css', Utils::normalizePath('//cdnjs.cloudflare.com/ajax/libs/Leaflet.awesome-markers/2.0.2/leaflet.awesome-markers.css')); + self::assertEquals('//use.fontawesome.com/releases/v5.8.1/css/all.css', Utils::normalizePath('//use.fontawesome.com/releases/v5.8.1/css/all.css')); + self::assertEquals('//use.fontawesome.com/releases/v5.8.1/webfonts/fa-brands-400.eot', Utils::normalizePath('//use.fontawesome.com/releases/v5.8.1/css/../webfonts/fa-brands-400.eot')); + + self::assertEquals('http://cdnjs.cloudflare.com/ajax/libs/Leaflet.awesome-markers/2.0.2/leaflet.awesome-markers.css', Utils::normalizePath('http://cdnjs.cloudflare.com/ajax/libs/Leaflet.awesome-markers/2.0.2/leaflet.awesome-markers.css')); + self::assertEquals('http://use.fontawesome.com/releases/v5.8.1/css/all.css', Utils::normalizePath('http://use.fontawesome.com/releases/v5.8.1/css/all.css')); + self::assertEquals('http://use.fontawesome.com/releases/v5.8.1/webfonts/fa-brands-400.eot', Utils::normalizePath('http://use.fontawesome.com/releases/v5.8.1/css/../webfonts/fa-brands-400.eot')); + + self::assertEquals('https://cdnjs.cloudflare.com/ajax/libs/Leaflet.awesome-markers/2.0.2/leaflet.awesome-markers.css', Utils::normalizePath('https://cdnjs.cloudflare.com/ajax/libs/Leaflet.awesome-markers/2.0.2/leaflet.awesome-markers.css')); + self::assertEquals('https://use.fontawesome.com/releases/v5.8.1/css/all.css', Utils::normalizePath('https://use.fontawesome.com/releases/v5.8.1/css/all.css')); + self::assertEquals('https://use.fontawesome.com/releases/v5.8.1/webfonts/fa-brands-400.eot', Utils::normalizePath('https://use.fontawesome.com/releases/v5.8.1/css/../webfonts/fa-brands-400.eot')); + } + + public function testIsFunctionDisabled(): void + { + $disabledFunctions = explode(',', ini_get('disable_functions')); + + if ($disabledFunctions[0]) { + self::assertEquals(Utils::isFunctionDisabled($disabledFunctions[0]), true); + } + } + + public function testTimezones(): void + { + $timezones = Utils::timezones(); + + self::assertIsArray($timezones); + self::assertContainsOnly('string', $timezones); + } + + public function testArrayFilterRecursive(): void + { + $array = [ + 'test' => '', + 'test2' => 'test2' + ]; + + $array = Utils::arrayFilterRecursive($array, function ($k, $v) { + return !(is_null($v) || $v === ''); + }); + + self::assertContainsOnly('string', $array); + self::assertArrayNotHasKey('test', $array); + self::assertArrayHasKey('test2', $array); + self::assertEquals('test2', $array['test2']); + } + + public function testPathPrefixedByLangCode(): void + { + $languagesEnabled = $this->grav['config']->get('system.languages.supported', []); + $arrayOfLanguages = ['en', 'de', 'it', 'es', 'dk', 'el']; + $languagesNotEnabled = array_diff($arrayOfLanguages, $languagesEnabled); + $oneLanguageNotEnabled = reset($languagesNotEnabled); + + if (count($languagesEnabled)) { + $languageCodePathPrefix = Utils::pathPrefixedByLangCode('/' . $languagesEnabled[0] . '/test'); + $this->assertIsString($languageCodePathPrefix); + $this->assertTrue(in_array($languageCodePathPrefix, $languagesEnabled)); + } + + self::assertFalse(Utils::pathPrefixedByLangCode('/' . $oneLanguageNotEnabled . '/test')); + self::assertFalse(Utils::pathPrefixedByLangCode('/test')); + self::assertFalse(Utils::pathPrefixedByLangCode('/xx')); + self::assertFalse(Utils::pathPrefixedByLangCode('/xx/')); + self::assertFalse(Utils::pathPrefixedByLangCode('/')); + } + + public function testDate2timestamp(): void + { + $timestamp = strtotime('10 September 2000'); + self::assertSame($timestamp, Utils::date2timestamp('10 September 2000')); + self::assertSame($timestamp, Utils::date2timestamp('2000-09-10 00:00:00')); + } + + public function testResolve(): void + { + $array = [ + 'test' => [ + 'test2' => 'test2Value' + ] + ]; + + self::assertEquals('test2Value', Utils::resolve($array, 'test.test2')); + } + + public function testGetDotNotation(): void + { + $array = [ + 'test' => [ + 'test2' => 'test2Value', + 'test3' => [ + 'test4' => 'test4Value' + ] + ] + ]; + + self::assertEquals('test2Value', Utils::getDotNotation($array, 'test.test2')); + self::assertEquals('test4Value', Utils::getDotNotation($array, 'test.test3.test4')); + self::assertEquals('defaultValue', Utils::getDotNotation($array, 'test.non_existent', 'defaultValue')); + } + + public function testSetDotNotation(): void + { + $array = [ + 'test' => [ + 'test2' => 'test2Value', + 'test3' => [ + 'test4' => 'test4Value' + ] + ] + ]; + + $new = [ + 'test1' => 'test1Value' + ]; + + Utils::setDotNotation($array, 'test.test3.test4', $new); + self::assertEquals('test1Value', $array['test']['test3']['test4']['test1']); + } + + public function testIsPositive(): void + { + self::assertTrue(Utils::isPositive(true)); + self::assertTrue(Utils::isPositive(1)); + self::assertTrue(Utils::isPositive('1')); + self::assertTrue(Utils::isPositive('yes')); + self::assertTrue(Utils::isPositive('on')); + self::assertTrue(Utils::isPositive('true')); + self::assertFalse(Utils::isPositive(false)); + self::assertFalse(Utils::isPositive(0)); + self::assertFalse(Utils::isPositive('0')); + self::assertFalse(Utils::isPositive('no')); + self::assertFalse(Utils::isPositive('off')); + self::assertFalse(Utils::isPositive('false')); + self::assertFalse(Utils::isPositive('some')); + self::assertFalse(Utils::isPositive(2)); + } + + public function testGetNonce(): void + { + self::assertIsString(Utils::getNonce('test-action')); + self::assertIsString(Utils::getNonce('test-action', true)); + self::assertSame(Utils::getNonce('test-action'), Utils::getNonce('test-action')); + self::assertNotSame(Utils::getNonce('test-action'), Utils::getNonce('test-action2')); + } + + public function testVerifyNonce(): void + { + self::assertTrue(Utils::verifyNonce(Utils::getNonce('test-action'), 'test-action')); + } + + public function testGetPagePathFromToken(): void + { + self::assertEquals('', Utils::getPagePathFromToken('')); + self::assertEquals('/test/path', Utils::getPagePathFromToken('/test/path')); + } + + public function testUrl(): void + { + $this->uri->initializeWithUrl('http://testing.dev/path1/path2')->init(); + + // Fail hard + self::assertSame(false, Utils::url('', true)); + self::assertSame(false, Utils::url('')); + self::assertSame(false, Utils::url(new stdClass())); + self::assertSame(false, Utils::url(['foo','bar','baz'])); + self::assertSame(false, Utils::url('user://does/not/exist')); + + // Fail Gracefully + self::assertSame('/', Utils::url('/', false, true)); + self::assertSame('/', Utils::url('', false, true)); + self::assertSame('/', Utils::url(new stdClass(), false, true)); + self::assertSame('/', Utils::url(['foo','bar','baz'], false, true)); + self::assertSame('/user/does/not/exist', Utils::url('user://does/not/exist', false, true)); + + // Simple paths + self::assertSame('/', Utils::url('/')); + self::assertSame('/path1', Utils::url('/path1')); + self::assertSame('/path1/path2', Utils::url('/path1/path2')); + self::assertSame('/random/path1/path2', Utils::url('/random/path1/path2')); + self::assertSame('/foobar.jpg', Utils::url('/foobar.jpg')); + self::assertSame('/path1/foobar.jpg', Utils::url('/path1/foobar.jpg')); + self::assertSame('/path1/path2/foobar.jpg', Utils::url('/path1/path2/foobar.jpg')); + self::assertSame('/random/path1/path2/foobar.jpg', Utils::url('/random/path1/path2/foobar.jpg')); + + // Simple paths with domain + self::assertSame('http://testing.dev/', Utils::url('/', true)); + self::assertSame('http://testing.dev/path1', Utils::url('/path1', true)); + self::assertSame('http://testing.dev/path1/path2', Utils::url('/path1/path2', true)); + self::assertSame('http://testing.dev/random/path1/path2', Utils::url('/random/path1/path2', true)); + self::assertSame('http://testing.dev/foobar.jpg', Utils::url('/foobar.jpg', true)); + self::assertSame('http://testing.dev/path1/foobar.jpg', Utils::url('/path1/foobar.jpg', true)); + self::assertSame('http://testing.dev/path1/path2/foobar.jpg', Utils::url('/path1/path2/foobar.jpg', true)); + self::assertSame('http://testing.dev/random/path1/path2/foobar.jpg', Utils::url('/random/path1/path2/foobar.jpg', true)); + + // Relative paths from Grav root. + self::assertSame('/subdir', Utils::url('subdir')); + self::assertSame('/subdir/path1', Utils::url('subdir/path1')); + self::assertSame('/subdir/path1/path2', Utils::url('subdir/path1/path2')); + self::assertSame('/path1', Utils::url('path1')); + self::assertSame('/path1/path2', Utils::url('path1/path2')); + self::assertSame('/foobar.jpg', Utils::url('foobar.jpg')); + self::assertSame('http://testing.dev/foobar.jpg', Utils::url('foobar.jpg', true)); + + // Relative paths from Grav root with domain. + self::assertSame('http://testing.dev/foobar.jpg', Utils::url('foobar.jpg', true)); + self::assertSame('http://testing.dev/foobar.jpg', Utils::url('/foobar.jpg', true)); + self::assertSame('http://testing.dev/path1/foobar.jpg', Utils::url('/path1/foobar.jpg', true)); + + // All Non-existing streams should be treated as external URI / protocol. + self::assertSame('http://domain.com/path', Utils::url('http://domain.com/path')); + self::assertSame('ftp://domain.com/path', Utils::url('ftp://domain.com/path')); + self::assertSame('sftp://domain.com/path', Utils::url('sftp://domain.com/path')); + self::assertSame('ssh://domain.com', Utils::url('ssh://domain.com')); + self::assertSame('pop://domain.com', Utils::url('pop://domain.com')); + self::assertSame('foo://bar/baz', Utils::url('foo://bar/baz')); + self::assertSame('foo://bar/baz', Utils::url('foo://bar/baz', true)); + // self::assertSame('mailto:joe@domain.com', Utils::url('mailto:joe@domain.com', true)); // FIXME <- + } + + public function testUrlWithRoot(): void + { + $this->uri->initializeWithUrlAndRootPath('http://testing.dev/subdir/path1/path2', '/subdir')->init(); + + // Fail hard + self::assertSame(false, Utils::url('', true)); + self::assertSame(false, Utils::url('')); + self::assertSame(false, Utils::url(new stdClass())); + self::assertSame(false, Utils::url(['foo','bar','baz'])); + self::assertSame(false, Utils::url('user://does/not/exist')); + + // Fail Gracefully + self::assertSame('/subdir/', Utils::url('/', false, true)); + self::assertSame('/subdir/', Utils::url('', false, true)); + self::assertSame('/subdir/', Utils::url(new stdClass(), false, true)); + self::assertSame('/subdir/', Utils::url(['foo','bar','baz'], false, true)); + self::assertSame('/subdir/user/does/not/exist', Utils::url('user://does/not/exist', false, true)); + + // Simple paths + self::assertSame('/subdir/', Utils::url('/')); + self::assertSame('/subdir/path1', Utils::url('/path1')); + self::assertSame('/subdir/path1/path2', Utils::url('/path1/path2')); + self::assertSame('/subdir/random/path1/path2', Utils::url('/random/path1/path2')); + self::assertSame('/subdir/foobar.jpg', Utils::url('/foobar.jpg')); + self::assertSame('/subdir/path1/foobar.jpg', Utils::url('/path1/foobar.jpg')); + self::assertSame('/subdir/path1/path2/foobar.jpg', Utils::url('/path1/path2/foobar.jpg')); + self::assertSame('/subdir/random/path1/path2/foobar.jpg', Utils::url('/random/path1/path2/foobar.jpg')); + + // Simple paths with domain + self::assertSame('http://testing.dev/subdir/', Utils::url('/', true)); + self::assertSame('http://testing.dev/subdir/path1', Utils::url('/path1', true)); + self::assertSame('http://testing.dev/subdir/path1/path2', Utils::url('/path1/path2', true)); + self::assertSame('http://testing.dev/subdir/random/path1/path2', Utils::url('/random/path1/path2', true)); + self::assertSame('http://testing.dev/subdir/foobar.jpg', Utils::url('/foobar.jpg', true)); + self::assertSame('http://testing.dev/subdir/path1/foobar.jpg', Utils::url('/path1/foobar.jpg', true)); + self::assertSame('http://testing.dev/subdir/path1/path2/foobar.jpg', Utils::url('/path1/path2/foobar.jpg', true)); + self::assertSame('http://testing.dev/subdir/random/path1/path2/foobar.jpg', Utils::url('/random/path1/path2/foobar.jpg', true)); + + // Absolute Paths including the grav base. + self::assertSame('/subdir/', Utils::url('/subdir')); + self::assertSame('/subdir/', Utils::url('/subdir/')); + self::assertSame('/subdir/path1', Utils::url('/subdir/path1')); + self::assertSame('/subdir/path1/path2', Utils::url('/subdir/path1/path2')); + self::assertSame('/subdir/foobar.jpg', Utils::url('/subdir/foobar.jpg')); + self::assertSame('/subdir/path1/foobar.jpg', Utils::url('/subdir/path1/foobar.jpg')); + + // Absolute paths from Grav root with domain. + self::assertSame('http://testing.dev/subdir/', Utils::url('/subdir', true)); + self::assertSame('http://testing.dev/subdir/', Utils::url('/subdir/', true)); + self::assertSame('http://testing.dev/subdir/path1', Utils::url('/subdir/path1', true)); + self::assertSame('http://testing.dev/subdir/path1/path2', Utils::url('/subdir/path1/path2', true)); + self::assertSame('http://testing.dev/subdir/foobar.jpg', Utils::url('/subdir/foobar.jpg', true)); + self::assertSame('http://testing.dev/subdir/path1/foobar.jpg', Utils::url('/subdir/path1/foobar.jpg', true)); + + // Relative paths from Grav root. + self::assertSame('/subdir/sub', Utils::url('/sub')); + self::assertSame('/subdir/subdir', Utils::url('subdir')); + self::assertSame('/subdir/subdir2/sub', Utils::url('/subdir2/sub')); + self::assertSame('/subdir/subdir/path1', Utils::url('subdir/path1')); + self::assertSame('/subdir/subdir/path1/path2', Utils::url('subdir/path1/path2')); + self::assertSame('/subdir/path1', Utils::url('path1')); + self::assertSame('/subdir/path1/path2', Utils::url('path1/path2')); + self::assertSame('/subdir/foobar.jpg', Utils::url('foobar.jpg')); + self::assertSame('http://testing.dev/subdir/foobar.jpg', Utils::url('foobar.jpg', true)); + + // All Non-existing streams should be treated as external URI / protocol. + self::assertSame('http://domain.com/path', Utils::url('http://domain.com/path')); + self::assertSame('ftp://domain.com/path', Utils::url('ftp://domain.com/path')); + self::assertSame('sftp://domain.com/path', Utils::url('sftp://domain.com/path')); + self::assertSame('ssh://domain.com', Utils::url('ssh://domain.com')); + self::assertSame('pop://domain.com', Utils::url('pop://domain.com')); + self::assertSame('foo://bar/baz', Utils::url('foo://bar/baz')); + self::assertSame('foo://bar/baz', Utils::url('foo://bar/baz', true)); + // self::assertSame('mailto:joe@domain.com', Utils::url('mailto:joe@domain.com', true)); // FIXME <- + } + + public function testUrlWithStreams(): void + { + } + + public function testUrlwithExternals(): void + { + $this->uri->initializeWithUrl('http://testing.dev/path1/path2')->init(); + self::assertSame('http://foo.com', Utils::url('http://foo.com')); + self::assertSame('https://foo.com', Utils::url('https://foo.com')); + self::assertSame('//foo.com', Utils::url('//foo.com')); + self::assertSame('//foo.com?param=x', Utils::url('//foo.com?param=x')); + } + + public function testCheckFilename(): void + { + // configure extension for consistent results + /** @var \Grav\Common\Config\Config $config */ + $config = $this->grav['config']; + $config->set('security.uploads_dangerous_extensions', ['php', 'html', 'htm', 'exe', 'js']); + + self::assertFalse(Utils::checkFilename('foo.php')); + self::assertFalse(Utils::checkFilename('foo.PHP')); + self::assertFalse(Utils::checkFilename('bar.js')); + + self::assertTrue(Utils::checkFilename('foo.json')); + self::assertTrue(Utils::checkFilename('foo.xml')); + self::assertTrue(Utils::checkFilename('foo.yaml')); + self::assertTrue(Utils::checkFilename('foo.yml')); + } +} diff --git a/tests/unit/Grav/Console/Gpm/InstallCommandTest.php b/tests/unit/Grav/Console/Gpm/InstallCommandTest.php new file mode 100644 index 0000000..94aef1a --- /dev/null +++ b/tests/unit/Grav/Console/Gpm/InstallCommandTest.php @@ -0,0 +1,28 @@ +grav = Fixtures::get('grav'); + $this->installCommand = new InstallCommand(); + } + + protected function _after(): void + { + } +} diff --git a/tests/unit/Grav/Framework/File/Formatter/CsvFormatterTest.php b/tests/unit/Grav/Framework/File/Formatter/CsvFormatterTest.php new file mode 100644 index 0000000..7bff4e2 --- /dev/null +++ b/tests/unit/Grav/Framework/File/Formatter/CsvFormatterTest.php @@ -0,0 +1,48 @@ + 1, 'col2' => 2, 'col3' => 3], + ['col1' => 'aaa', 'col2' => 'bbb', 'col3' => 'ccc'], + ]; + + $encoded = (new CsvFormatter())->encode($data); + + $lines = array_filter(explode(PHP_EOL, $encoded)); + + self::assertCount(3, $lines); + self::assertEquals('col1,col2,col3', $lines[0]); + } + + /** + * TBD - If indexes are all numeric, what's the purpose + * of displaying header + */ + public function testEncodeWithIndexColumns(): void + { + $data = [ + [0 => 1, 1 => 2, 2 => 3], + ]; + + $encoded = (new CsvFormatter())->encode($data); + + $lines = array_filter(explode(PHP_EOL, $encoded)); + + self::assertCount(2, $lines); + self::assertEquals('0,1,2', $lines[0]); + } + + public function testEncodeEmptyData(): void + { + $encoded = (new CsvFormatter())->encode([]); + self::assertEquals('', $encoded); + } +} diff --git a/tests/unit/Grav/Framework/Filesystem/FilesystemTest.php b/tests/unit/Grav/Framework/Filesystem/FilesystemTest.php new file mode 100644 index 0000000..2aea40c --- /dev/null +++ b/tests/unit/Grav/Framework/Filesystem/FilesystemTest.php @@ -0,0 +1,338 @@ + [ + 'parent' => '', + 'normalize' => '', + 'dirname' => '', + 'pathinfo' => [ + 'basename' => '', + 'filename' => '', + ] + ], + '.' => [ + 'parent' => '', + 'normalize' => '', + 'dirname' => '.', + 'pathinfo' => [ + 'dirname' => '.', + 'basename' => '.', + 'extension' => '', + 'filename' => '', + ] + ], + './' => [ + 'parent' => '', + 'normalize' => '', + 'dirname' => '.', + 'pathinfo' => [ + 'dirname' => '.', + 'basename' => '.', + 'extension' => '', + 'filename' => '', + ] + ], + '././.' => [ + 'parent' => '', + 'normalize' => '', + 'dirname' => './.', + 'pathinfo' => [ + 'dirname' => './.', + 'basename' => '.', + 'extension' => '', + 'filename' => '', + ] + ], + '.file' => [ + 'parent' => '.', + 'normalize' => '.file', + 'dirname' => '.', + 'pathinfo' => [ + 'dirname' => '.', + 'basename' => '.file', + 'extension' => 'file', + 'filename' => '', + ] + ], + '/' => [ + 'parent' => '', + 'normalize' => '/', + 'dirname' => '/', + 'pathinfo' => [ + 'dirname' => '/', + 'basename' => '', + 'filename' => '', + ] + ], + '/absolute' => [ + 'parent' => '/', + 'normalize' => '/absolute', + 'dirname' => '/', + 'pathinfo' => [ + 'dirname' => '/', + 'basename' => 'absolute', + 'filename' => 'absolute', + ] + ], + '/absolute/' => [ + 'parent' => '/', + 'normalize' => '/absolute', + 'dirname' => '/', + 'pathinfo' => [ + 'dirname' => '/', + 'basename' => 'absolute', + 'filename' => 'absolute', + ] + ], + '/very/long/absolute/path' => [ + 'parent' => '/very/long/absolute', + 'normalize' => '/very/long/absolute/path', + 'dirname' => '/very/long/absolute', + 'pathinfo' => [ + 'dirname' => '/very/long/absolute', + 'basename' => 'path', + 'filename' => 'path', + ] + ], + '/very/long/absolute/../path' => [ + 'parent' => '/very/long', + 'normalize' => '/very/long/path', + 'dirname' => '/very/long/absolute/..', + 'pathinfo' => [ + 'dirname' => '/very/long/absolute/..', + 'basename' => 'path', + 'filename' => 'path', + ] + ], + 'relative' => [ + 'parent' => '.', + 'normalize' => 'relative', + 'dirname' => '.', + 'pathinfo' => [ + 'dirname' => '.', + 'basename' => 'relative', + 'filename' => 'relative', + ] + ], + 'very/long/relative/path' => [ + 'parent' => 'very/long/relative', + 'normalize' => 'very/long/relative/path', + 'dirname' => 'very/long/relative', + 'pathinfo' => [ + 'dirname' => 'very/long/relative', + 'basename' => 'path', + 'filename' => 'path', + ] + ], + 'path/to/file.jpg' => [ + 'parent' => 'path/to', + 'normalize' => 'path/to/file.jpg', + 'dirname' => 'path/to', + 'pathinfo' => [ + 'dirname' => 'path/to', + 'basename' => 'file.jpg', + 'extension' => 'jpg', + 'filename' => 'file', + ] + ], + 'user://' => [ + 'parent' => '', + 'normalize' => 'user://', + 'dirname' => 'user://', + 'pathinfo' => [ + 'dirname' => 'user://', + 'basename' => '', + 'filename' => '', + 'scheme' => 'user', + ] + ], + 'user://.' => [ + 'parent' => '', + 'normalize' => 'user://', + 'dirname' => 'user://', + 'pathinfo' => [ + 'dirname' => 'user://', + 'basename' => '', + 'filename' => '', + 'scheme' => 'user', + ] + ], + 'user://././.' => [ + 'parent' => '', + 'normalize' => 'user://', + 'dirname' => 'user://', + 'pathinfo' => [ + 'dirname' => 'user://', + 'basename' => '', + 'filename' => '', + 'scheme' => 'user', + ] + ], + 'user://./././file' => [ + 'parent' => 'user://', + 'normalize' => 'user://file', + 'dirname' => 'user://', + 'pathinfo' => [ + 'dirname' => 'user://', + 'basename' => 'file', + 'filename' => 'file', + 'scheme' => 'user', + ] + ], + 'user://./././folder/file' => [ + 'parent' => 'user://folder', + 'normalize' => 'user://folder/file', + 'dirname' => 'user://folder', + 'pathinfo' => [ + 'dirname' => 'user://folder', + 'basename' => 'file', + 'filename' => 'file', + 'scheme' => 'user', + ] + ], + 'user://.file' => [ + 'parent' => 'user://', + 'normalize' => 'user://.file', + 'dirname' => 'user://', + 'pathinfo' => [ + 'dirname' => 'user://', + 'basename' => '.file', + 'extension' => 'file', + 'filename' => '', + 'scheme' => 'user', + ] + ], + 'user:///' => [ + 'parent' => '', + 'normalize' => 'user:///', + 'dirname' => 'user:///', + 'pathinfo' => [ + 'dirname' => 'user:///', + 'basename' => '', + 'filename' => '', + 'scheme' => 'user', + ] + ], + 'user:///absolute' => [ + 'parent' => 'user:///', + 'normalize' => 'user:///absolute', + 'dirname' => 'user:///', + 'pathinfo' => [ + 'dirname' => 'user:///', + 'basename' => 'absolute', + 'filename' => 'absolute', + 'scheme' => 'user', + ] + ], + 'user:///very/long/absolute/path' => [ + 'parent' => 'user:///very/long/absolute', + 'normalize' => 'user:///very/long/absolute/path', + 'dirname' => 'user:///very/long/absolute', + 'pathinfo' => [ + 'dirname' => 'user:///very/long/absolute', + 'basename' => 'path', + 'filename' => 'path', + 'scheme' => 'user', + ] + ], + 'user://relative' => [ + 'parent' => 'user://', + 'normalize' => 'user://relative', + 'dirname' => 'user://', + 'pathinfo' => [ + 'dirname' => 'user://', + 'basename' => 'relative', + 'filename' => 'relative', + 'scheme' => 'user', + ] + ], + 'user://very/long/relative/path' => [ + 'parent' => 'user://very/long/relative', + 'normalize' => 'user://very/long/relative/path', + 'dirname' => 'user://very/long/relative', + 'pathinfo' => [ + 'dirname' => 'user://very/long/relative', + 'basename' => 'path', + 'filename' => 'path', + 'scheme' => 'user', + ] + ], + 'user://path/to/file.jpg' => [ + 'parent' => 'user://path/to', + 'normalize' => 'user://path/to/file.jpg', + 'dirname' => 'user://path/to', + 'pathinfo' => [ + 'dirname' => 'user://path/to', + 'basename' => 'file.jpg', + 'extension' => 'jpg', + 'filename' => 'file', + 'scheme' => 'user', + ] + ], + ]; + + protected function _before(): void + { + $this->class = Filesystem::getInstance(); + } + + protected function _after(): void + { + unset($this->class); + } + + /** + * @param array $tests + * @param string $method + */ + protected function runTestSet(array $tests, $method): void + { + $class = $this->class; + foreach ($tests as $path => $candidates) { + if (!array_key_exists($method, $candidates)) { + continue; + } + + $expected = $candidates[$method]; + + $result = $class->{$method}($path); + + self::assertSame($expected, $result, "Test {$method}('{$path}')"); + + if (function_exists($method) && !strpos($path, '://')) { + $cmp_result = $method($path); + + self::assertSame($cmp_result, $result, "Compare to original {$method}('{$path}')"); + } + } + } + + public function testParent(): void + { + $this->runTestSet($this->tests, 'parent'); + } + + public function testNormalize(): void + { + $this->runTestSet($this->tests, 'normalize'); + } + + public function testDirname(): void + { + $this->runTestSet($this->tests, 'dirname'); + } + + public function testPathinfo(): void + { + $this->runTestSet($this->tests, 'pathinfo'); + } +} diff --git a/tests/unit/_bootstrap.php b/tests/unit/_bootstrap.php new file mode 100644 index 0000000..5a76515 --- /dev/null +++ b/tests/unit/_bootstrap.php @@ -0,0 +1,3 @@ +': gt + '<': lt + valid_link_attributes: + - rel + - target + - id + - class + - classes + types: + - html + - htm + - xml + - txt + - json + - rss + - atom + append_url_extension: null + expires: 604800 + cache_control: null + last_modified: false + etag: true + vary_accept_encoding: false + redirect_default_code: '302' + redirect_trailing_slash: 1 + redirect_default_route: 0 + ignore_files: + - .DS_Store + ignore_folders: + - .git + - .idea + ignore_hidden: true + hide_empty_folders: false + url_taxonomy_filters: true + frontmatter: + process_twig: false + ignore_fields: + - form + - forms +cache: + enabled: true + check: + method: file + driver: auto + prefix: g + purge_at: '0 4 * * *' + clear_at: '0 3 * * *' + clear_job_type: standard + clear_images_by_default: false + cli_compatibility: false + lifetime: 604800 + gzip: false + allow_webserver_gzip: false + redis: + socket: '0' + password: null + database: null + server: null + port: null + memcache: + server: null + port: null + memcached: + server: null + port: null +twig: + cache: true + debug: true + auto_reload: true + autoescape: true + undefined_functions: true + undefined_filters: true + safe_functions: { } + safe_filters: { } + umask_fix: false +assets: + css_pipeline: false + css_pipeline_include_externals: true + css_pipeline_before_excludes: true + css_minify: true + css_minify_windows: false + css_rewrite: true + js_pipeline: false + js_pipeline_include_externals: true + js_pipeline_before_excludes: true + js_module_pipeline: false + js_module_pipeline_include_externals: true + js_module_pipeline_before_excludes: true + js_minify: true + enable_asset_timestamp: false + enable_asset_sri: false + collections: + jquery: 'system://assets/jquery/jquery-3.x.min.js' +errors: + display: 1 + log: true +log: + handler: file + syslog: + facility: local6 + tag: grav +debugger: + enabled: false + provider: clockwork + censored: false + shutdown: + close_connection: true + twig: true +images: + default_image_quality: 85 + cache_all: false + cache_perms: '0755' + debug: false + auto_fix_orientation: true + seofriendly: false + cls: + auto_sizes: false + aspect_ratio: false + retina_scale: '1' + defaults: + loading: auto + watermark: + image: 'system://images/watermark.png' + position_y: center + position_x: center + scale: 33 + watermark_all: false +media: + enable_media_timestamp: false + unsupported_inline_types: null + allowed_fallback_types: null + auto_metadata_exif: false + upload_limit: 2097152 +session: + enabled: true + initialize: true + timeout: 1800 + name: grav-site + uniqueness: path + secure: false + secure_https: true + httponly: true + samesite: Lax + split: true + domain: null + path: null +gpm: + releases: stable + official_gpm_only: true + verify_peer: true +http: + method: auto + enable_proxy: true + proxy_url: null + proxy_cert_path: null + concurrent_connections: 5 + verify_peer: true + verify_host: true +accounts: + type: regular + storage: file + avatar: gravatar +flex: + cache: + index: + enabled: true + lifetime: 60 + object: + enabled: true + lifetime: 600 + render: + enabled: true + lifetime: 600 +strict_mode: + yaml_compat: false + twig_compat: false + blueprint_compat: false diff --git a/user/config/themes/ateliers-55.yaml b/user/config/themes/ateliers-55.yaml new file mode 100644 index 0000000..fdcf423 --- /dev/null +++ b/user/config/themes/ateliers-55.yaml @@ -0,0 +1,3 @@ +enabled: true +dropdown: + enabled: true diff --git a/user/data/.gitkeep b/user/data/.gitkeep new file mode 100644 index 0000000..8c3b423 --- /dev/null +++ b/user/data/.gitkeep @@ -0,0 +1 @@ +/* @copyright Copyright (c) 2015 - 2023 Trilby Media, LLC. All rights reserved. */ diff --git a/user/pages/01.home/default.md b/user/pages/01.home/default.md new file mode 100644 index 0000000..90da410 --- /dev/null +++ b/user/pages/01.home/default.md @@ -0,0 +1,10 @@ +--- +title: 'Journal d''un chantier' +body_classes: 'title-center title-h1h2' +--- + +Les Ateliers 55 rentrent en travaux pour 18 mois à compter du 1er février 2024. Objectif : création de 6 ateliers d'artistes, 4 ateliers-logements, 1 studio et 1 appartement en location à l'été 2025. Une construction en matériaux biosourcés (bois, paille et terre). + +=== + +Lorem ipsum dolor sit amet, consectetur adipiscing elit. Cras nec ullamcorper lacus, eu elementum quam. In hac habitasse platea dictumst. Duis egestas justo eget massa congue rhoncus. Pellentesque ex urna, dictum nec dapibus vitae, bibendum quis diam. Nunc ut euismod risus, non placerat nisi. Sed maximus luctus sapien at porttitor. Suspendisse pulvinar dui leo, aliquet pulvinar lectus egestas et. Morbi rutrum blandit eleifend. Maecenas ac massa eget ante ultricies tempus. Suspendisse at lobortis ligula, a aliquam eros. Phasellus in ligula et lorem malesuada volutpat. Sed ex massa, luctus sed egestas ut, feugiat in libero. \ No newline at end of file diff --git a/user/pages/02.articles/article-1/cat-8436843_1280.jpg b/user/pages/02.articles/article-1/cat-8436843_1280.jpg new file mode 100644 index 0000000000000000000000000000000000000000..7be1cb363a16d51338fbba13faec4db5c70829c8 GIT binary patch literal 212962 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 mIZ7#HJ+BT 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 JWR3qV{~zf6uEYQU literal 0 HcmV?d00001 diff --git a/user/pages/02.articles/article-1/default.md b/user/pages/02.articles/article-1/default.md new file mode 100644 index 0000000..7e2b630 --- /dev/null +++ b/user/pages/02.articles/article-1/default.md @@ -0,0 +1,9 @@ +--- +title: 'Article 1' +media_order: 'cat-8436843_1280.jpg,forsythia-8595521_1280.jpg,labrador-8554882_1280.jpg,lake-8357182_1280.jpg,landscape-8592826_1280.jpg' +date: '05-03-2024 11:34' +--- + +Lorem ipsum dolor sit amet, consectetur adipiscing elit. Donec ut purus congue, accumsan erat varius, auctor sapien. Aliquam in molestie leo. Curabitur ut elit tellus. Vivamus neque metus, rhoncus quis erat sit amet, congue luctus arcu. Ut porttitor id enim in lobortis. Pellentesque consequat tincidunt est finibus pharetra. Phasellus ligula leo, efficitur at porttitor ac, scelerisque non nunc. Fusce ac ultricies elit. + +Curabitur porttitor felis ac diam aliquam pretium. Suspendisse a augue vehicula, consectetur arcu id, lobortis leo. Duis venenatis eget metus quis lacinia. Sed placerat consequat nisl sed fermentum. Vivamus tristique diam a mi eleifend, sed interdum tellus laoreet. Ut eu lorem ut mi rutrum ornare et vitae mi. Sed dictum sapien justo, a finibus magna aliquam eu. Mauris vel metus sit amet elit tincidunt tincidunt. Nunc venenatis tellus velit, ut accumsan turpis gravida a. Nullam sapien odio, feugiat nec condimentum id, dapibus nec felis. Nullam et placerat nisi. Proin finibus, lorem sit amet faucibus gravida, ligula urna mattis ligula, vel commodo ex ex vitae nisi. \ No newline at end of file diff --git a/user/pages/02.articles/article-1/forsythia-8595521_1280.jpg b/user/pages/02.articles/article-1/forsythia-8595521_1280.jpg new file mode 100644 index 0000000000000000000000000000000000000000..08439a27dc6e6cc337857628e3825cab591929c5 GIT binary patch literal 113878 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 z%0D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≤6?MK$)EHi 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 z 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�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

    JqMMQM|k_U~o0fZ>=@c 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

    H%Xb&fGB}1BE+tw+=PkCB@iOUnNL&fe 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 TroheAvl(;ygP%TL`nU0ai*8sn literal 0 HcmV?d00001 diff --git a/user/pages/02.articles/article-1/lake-8357182_1280.jpg b/user/pages/02.articles/article-1/lake-8357182_1280.jpg new file mode 100644 index 0000000000000000000000000000000000000000..cbdf6854d5209939efd29a36cbc9dfbccccc4de0 GIT binary patch literal 267148 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

    CEFt&So8Tc*%m|2!nBTA_>B( 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

    #hM{lO8$|L(;fO`J9Re1x4y34+n$mTA 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%0DryJk2dGxmzJ>LQ%eWhGMn( z9yGYb==&ART$