# phpman > perldoc > HTML::Mason::ComponentSource

## NAME
    [HTML::Mason::ComponentSource](https://www.chedong.com/phpMan.php/perldoc/HTML%3A%3AMason%3A%3AComponentSource/markdown) - represents information about an component

## SYNOPSIS
        my $info = $resolver->get_info($comp_path);

## DESCRIPTION
    Mason uses the ComponentSource class to store information about a source component, one that has
    yet to be compiled.

## METHODS
    new This method takes the following arguments:

        *   comp_path

            The component's component path.

        *   last_modified

            This is the last modification time for the component, in Unix time (seconds since the
            epoch).

        *   comp_id

            This is a unique id for the component used to distinguish two components with the same
            name in different component roots.

            If your resolver does not support multiple component roots, this can simply be the same
            as the "comp_path" key or it can be any other id you wish.

            This value will be used when constructing filesystem paths so it needs to be something
            that works on different filesystems. If it contains forward slashes, these will be
            converted to the appropriate filesystem-specific path separator.

            In fact, we encourage you to make sure that your component ids have some forward slashes
            in them or also all of your generated object files will end up in a single directory,
            which could affect performance.

        *   comp_class

            The component class into which this particular component should be blessed when it is
            created. This must be a subclass of "[HTML::Mason::Component](https://www.chedong.com/phpMan.php/perldoc/HTML%3A%3AMason%3A%3AComponent/markdown)", which is the default.

        *   friendly_name

            This is used when displaying error messages related to the component, like parsing
            errors. This should be something that will help whoever sees the message identify the
            component. For example, for component stored on the filesystem, this should be the
            absolute path to the component.

        *   source_callback

            This is a subroutine reference which, when called, returns the component source.

            The reasoning behind using this parameter is that it helps avoid a profusion of tiny
            little "[HTML::Mason::ComponentSource](https://www.chedong.com/phpMan.php/perldoc/HTML%3A%3AMason%3A%3AComponentSource/markdown)" subclasses that don't do very much.

        *   extra

            This optional parameter should be a hash reference. It is used to pass information from
            the resolver to the component class.

            This is needed since a "[HTML::Mason::Resolver](https://www.chedong.com/phpMan.php/perldoc/HTML%3A%3AMason%3A%3AResolver/markdown)" subclass and a "[HTML::Mason::Component](https://www.chedong.com/phpMan.php/perldoc/HTML%3A%3AMason%3A%3AComponent/markdown)"
            subclass can be rather tightly coupled, but they must communicate with each through the
            interpreter (this may change in the future).

    comp_path
    last_modified
    comp_id
    comp_class
    friendly_name
    extra
        These are all simple accessors that return the value given to the constructor.

    comp_source
        Returns the source of the component.

    object_code ( compiler => $compiler )
        Given a compiler, this method returns the object code for the component.

    [HTML::Mason](https://www.chedong.com/phpMan.php/perldoc/HTML%3A%3AMason/markdown), [HTML::Mason::Admin](https://www.chedong.com/phpMan.php/perldoc/HTML%3A%3AMason%3A%3AAdmin/markdown), [HTML::Mason::Component](https://www.chedong.com/phpMan.php/perldoc/HTML%3A%3AMason%3A%3AComponent/markdown)

