Config...rlFile(3pm)

💖 Config::Model::Backend::PerlFile 💖

okay bestie, so this is Config::Model::Backend::PerlFile(3pm) — User Contributed Perl Documentation, and it is literally the moment. it does one thing and it does it gorgeously: read and write your config as a Perl data structure. 💅

---

✨ NAME ✨

Config::Model::Backend::PerlFile — Read and write config as a Perl data structure. that's it. that's the gig. 🎀

🌸 VERSION 🌸

version 2.166. periodt.

🦋 SYNOPSIS 🦋

not me giving you the whole recipe, no gatekeeping, we share ✨

use Config::Model ;
use Data::Dumper ;

# define configuration tree object
my $model = Config::Model->new ;
$model ->create_config_class (
   name => "MyClass",
   element => [
       [qw/foo bar/] => {
           type => 'leaf',
           value_type => 'string'
       },
       baz => {
           type => 'hash',
           index_type => 'string' ,
           cargo => {
               type => 'leaf',
               value_type => 'string',
           },
       },
   ],
 rw_config  => {
    backend => 'perl_file' ,
    config_dir => '/tmp',
    file  => 'foo.pl',
    auto_create => 1,
 },
) ;

my $inst = $model->instance(root_class_name => 'MyClass' );

my $root = $inst->config_root ;

my $steps = 'foo=yada bar="bla bla" baz:en=hello
            baz:fr=bonjour baz:hr="dobar dan"';
$root->load( steps => $steps ) ;
$inst->write_back ;

and then — the glow up — now, "/tmp/foo.pl" contains:

{
  bar => 'bla bla',
  baz => {
    en => 'hello',
    fr => 'bonjour',
    hr => 'dobar dan'
  },
  foo => 'yada'
}

ate. no crumbs. 😌

---

👑 DESCRIPTION 👑

Config::Model calls this module directly to read or write the contents of a configuration tree that's written with Perl syntax inside a Config::Model configuration tree. it's the translator between your cute tree and a real file, iykyk 🫶

Note: heads up, two things, both important, don't skip:

• Undefined values get skipped for list elements. like, if a list element holds ('a',undef,'b'), the data structure you get just contains 'a','b'. the undef? ghosted. 👻
• The Perl file is not created (and may honestly get deleted 😭) when there's no data to write. it's giving "if I have nothing to say I stay home".

🎀 backend parameter 🎀

config_dir

A mandoatory parameter — you have to pass it, bestie, no exceptions — and it says where the Perl configuration file lives. 📂

🌈 CONSTRUCTOR 🌈

new

Inherited from Config::Model::Backend::Any. you don't call it yourself, it gets called by Config::Model::BackendMgr. it's the main character that just shows up. ✨

read

Out of all the parameters handed to this read call-back, only ifile_path actually gets used. and that parameter has to be an IO::File object that's already opened for read. 📖

It can also be undef — in which case read returns 0.

When a file is read, read returns 1.

write

Out of all the parameters passed to this write call-back, only file_path is used, and it must be a Path::Tiny object. ✍️

write returns 1.

---

💜 AUTHOR 💜

Dominique Dumont, (ddumont at cpan dot org)

⭐ SEE ALSO ⭐

Config::Model, Config::Model::BackendMgr, Config::Model::Backend::Any,

💖 AUTHOR 💖

Dominique Dumont

🔥 COPYRIGHT AND LICENSE 🔥

This software is Copyright (c) 2005-2022 by Dominique Dumont.

This is free software, licensed under:

The GNU Lesser General Public License, Version 2.1, February 1999

---

and that's the whole page, bestie 🧚 this was perl v5.42.3, dated 2026-07-23 — go forth and configure, you're gonna slay 💅🌸🦋